|
|
1.1 root 1: .\" Copyright (c) 1983 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)byteorder.3n 6.2 (Berkeley) 5/15/86
6: .\"
7: .TH BYTEORDER 3N "May 15, 1986"
8: .UC 5
9: .SH NAME
10: htonl, htons, ntohl, ntohs \- convert values between host and network byte order
11: .SH SYNOPSIS
12: .nf
13: .B #include <sys/types.h>
14: .B #include <netinet/in.h>
15: .PP
16: .B netlong = htonl(hostlong);
17: .B u_long netlong, hostlong;
18: .PP
19: .B netshort = htons(hostshort);
20: .B u_short netshort, hostshort;
21: .PP
22: .B hostlong = ntohl(netlong);
23: .B u_long hostlong, netlong;
24: .PP
25: .B hostshort = ntohs(netshort);
26: .B u_short hostshort, netshort;
27: .fi
28: .SH DESCRIPTION
29: These routines convert 16 and 32 bit quantities between network
30: byte order and host byte order. On machines such as the SUN
31: these routines are defined as null macros in the include file
32: .RI < netinet/in.h >.
33: .PP
34: These routines are most often used in conjunction with Internet
35: addresses and ports as returned by
36: .IR gethostbyname (3N)
37: and
38: .IR getservent (3N).
39: .SH "SEE ALSO"
40: gethostbyname(3N),
41: getservent(3N)
42: .SH BUGS
43: The VAX handles bytes backwards from most everyone else in
44: the world. This is not expected to be fixed in the near future.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.