4.3BSD-UWisc/man/cat3/byteorder.3n




BYTEORDER(3N)       UNIX Programmer's Manual        BYTEORDER(3N)



NAME
     htonl, htons, ntohl, ntohs - convert values between host and
     network byte order

SYNOPSIS
     #include <sys/types.h>
     #include <netinet/in.h>

     netlong = htonl(hostlong);
     u_long netlong, hostlong;

     netshort = htons(hostshort);
     u_short netshort, hostshort;

     hostlong = ntohl(netlong);
     u_long hostlong, netlong;

     hostshort = ntohs(netshort);
     u_short hostshort, netshort;

DESCRIPTION
     These routines convert 16 and 32 bit quantities between net-
     work byte order and host byte order.  On machines such as
     the SUN these routines are defined as null macros in the
     include file <_n_e_t_i_n_e_t/_i_n._h>.

     These routines are most often used in conjunction with
     Internet addresses and ports as returned by
     _g_e_t_h_o_s_t_b_y_n_a_m_e(3N) and _g_e_t_s_e_r_v_e_n_t(3N).

SEE ALSO
     gethostbyname(3N), getservent(3N)

BUGS
     The VAX handles bytes backwards from most everyone else in
     the world.  This is not expected to be fixed in the near
     future.


















Printed 12/27/86          May 15, 1986                          1