diff options
author | Yuri Pankov <yuri.pankov@nexenta.com> | 2018-08-03 21:34:10 +0300 |
---|---|---|
committer | Richard Lowe <richlowe@richlowe.net> | 2018-08-06 19:38:36 +0000 |
commit | cc581a18c90036f3cc09e518f22af9b2f11b2a8d (patch) | |
tree | 45cb4d3dbb1afc1f1f182daef02bffebd624ea13 /usr/src/man/man3socket/getservbyname.3socket | |
parent | 8cd3131235b232e4d63be3cf95ce9be87907e74f (diff) | |
download | illumos-gate-cc581a18c90036f3cc09e518f22af9b2f11b2a8d.tar.gz |
9701 byteorder functions are in libc for a long time
Reviewed by: Toomas Soome <tsoome@me.com>
Reviewed by: Peter Tribble <peter.tribble@gmail.com>
Reviewed by: Igor Kozhukhov <igor@dilos.org>
Approved by: Richard Lowe <richlowe@richlowe.net>
Diffstat (limited to 'usr/src/man/man3socket/getservbyname.3socket')
-rw-r--r-- | usr/src/man/man3socket/getservbyname.3socket | 15 |
1 files changed, 3 insertions, 12 deletions
diff --git a/usr/src/man/man3socket/getservbyname.3socket b/usr/src/man/man3socket/getservbyname.3socket index cc251a2252..b9b2f1a98b 100644 --- a/usr/src/man/man3socket/getservbyname.3socket +++ b/usr/src/man/man3socket/getservbyname.3socket @@ -53,7 +53,6 @@ getservent_r, setservent, endservent \- get service entry .fi .SH DESCRIPTION -.sp .LP These functions are used to obtain entries for Internet services. An entry may come from any of the sources for \fBservices\fR specified in the @@ -75,7 +74,7 @@ number \fIport\fR. .sp .LP All addresses are returned in network order. In order to interpret the -addresses, \fBbyteorder\fR(3SOCKET) must be used for byte order conversion. The +addresses, \fBbyteorder\fR(3C) must be used for byte order conversion. The string \fIproto\fR is used by both \fBgetservbyname()\fR and \fBgetservbyport()\fR to restrict the search to entries with the specified protocol. If \fIproto\fR is \fINULL\fR, entries with any protocol can be @@ -113,7 +112,6 @@ was using. It is still allowed, but possibly less efficient, for the process to call more service entry retrieval functions after calling \fBendservent()\fR. .SS "Reentrant Interfaces" -.sp .LP The functions \fBgetservbyname()\fR, \fBgetservbyport()\fR, and \fBgetservent()\fR use static storage that is re-used in each call, making @@ -156,7 +154,6 @@ Like their non-reentrant counterparts, \fBgetservbyname_r()\fR and \fBgetservbyport_r()\fR leave the enumeration position in an indeterminate state. .SH RETURN VALUES -.sp .LP Service entries are represented by the \fBstruct servent\fR structure defined in <\fBnetdb.h\fR>: @@ -234,7 +231,6 @@ When the pointer returned by the reentrant functions \fBgetservbyname_r()\fR, \fBgetservbyport_r()\fR, and \fBgetservent_r()\fR is non-null, it is always equal to the \fIresult\fR pointer that was supplied by the caller. .SH ERRORS -.sp .LP The reentrant functions \fBgetservbyname_r()\fR, \fBgetservbyport_r()\fR, and \fBgetservent_r()\fR return \fINULL\fR and set \fBerrno\fR to \fBERANGE\fR if @@ -242,7 +238,6 @@ the length of the buffer supplied by caller is not large enough to store the result. See \fBIntro\fR(2) for the proper usage and interpretation of \fBerrno\fR in multithreaded applications. .SH FILES -.sp .ne 2 .na \fB\fB/etc/services\fR\fR @@ -270,7 +265,6 @@ configuration file for the name-service switch .RE .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -288,24 +282,21 @@ T} .TE .SH SEE ALSO -.sp .LP -\fBIntro\fR(2), \fBIntro\fR(3), \fBbyteorder\fR(3SOCKET), \fBnetdir\fR(3NSL), +\fBIntro\fR(2), \fBIntro\fR(3), \fBbyteorder\fR(3C), \fBnetdir\fR(3NSL), \fBnetconfig\fR(4), \fBnsswitch.conf\fR(4), \fBservices\fR(4), \fBattributes\fR(5), \fBnetdb.h\fR(3HEAD) .SH WARNINGS -.sp .LP The reentrant interfaces \fBgetservbyname_r()\fR, \fBgetservbyport_r()\fR, and \fBgetservent_r()\fR are included in this release on an uncommitted basis only, and are subject to change or removal in future minor releases. .SH NOTES -.sp .LP The functions that return \fBstruct servent\fR return the least significant 16-bits of the \fIs_port\fR field in \fInetwork byte order\fR. \fBgetservbyport()\fR and \fBgetservbyport_r()\fR also expect the input -parameter \fIport\fR in the \fInetwork byte order\fR. See \fBhtons\fR(3SOCKET) +parameter \fIport\fR in the \fInetwork byte order\fR. See \fBhtons\fR(3C) for more details on converting between host and network byte orders. .sp .LP |