summaryrefslogtreecommitdiff
path: root/usr/src/man/man3socket/getservbyname.3socket
diff options
context:
space:
mode:
authorYuri Pankov <yuri.pankov@nexenta.com>2018-08-03 21:34:10 +0300
committerRichard Lowe <richlowe@richlowe.net>2018-08-06 19:38:36 +0000
commitcc581a18c90036f3cc09e518f22af9b2f11b2a8d (patch)
tree45cb4d3dbb1afc1f1f182daef02bffebd624ea13 /usr/src/man/man3socket/getservbyname.3socket
parent8cd3131235b232e4d63be3cf95ce9be87907e74f (diff)
downloadillumos-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.3socket15
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