Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


BYTEORDER(3)               Library Functions Manual               BYTEORDER(3)

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

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <arpa/inet.h>

     uint32_t
     htonl(uint32_t host32);

     uint16_t
     htons(uint16_t host16);

     uint32_t
     ntohl(uint32_t net32);

     uint16_t
     ntohs(uint16_t net16);

DESCRIPTION
     These routines convert 16 and 32 bit quantities between network byte
     order and host byte order.

     On machines which have a byte order which is the same as the network
     order, these routines are defined as macros that expand to the value of
     their argument.

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

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

STANDARDS
     The described functions conform to IEEE Std 1003.1-2001 ("POSIX.1").

HISTORY
     The byteorder functions appeared in 4.2BSD.

BUGS
     The `l' and `s' suffixes in the names are not meaningful in machines
     where long integers are not 32 bits.

NetBSD 10.99                      May 3, 2011                     NetBSD 10.99