Print this page
10067 Miscellaneous man page typos
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Andy Fiddaman <andy@omniosce.org>
Reviewed by: Volker A. Brandt <vab@bb-c.de>
*** 55,65 ****
.nf
\fBvoid\fR \fBendrpcent\fR(\fBvoid\fR);
.fi
.SH DESCRIPTION
- .sp
.LP
These functions are used to obtain entries for RPC (Remote Procedure Call)
services. An entry may come from any of the sources for \fBrpc\fR specified in
the \fB/etc/nsswitch.conf\fR file (see \fBnsswitch.conf\fR(4)).
.sp
--- 55,64 ----
*** 92,102 ****
further RPC entry retrieval operations; the system may then deallocate
resources it was using. It is still allowed, but possibly less efficient, for
the process to call more RPC entry retrieval functions after calling
\fBendrpcent()\fR.
.SS "Reentrant Interfaces"
- .sp
.LP
The functions \fBgetrpcbyname()\fR, \fBgetrpcbynumber()\fR, and
\fBgetrpcent()\fR use static storage that is re-used in each call, making these
routines unsafe for use in multithreaded applications.
.sp
--- 91,100 ----
*** 134,144 ****
.LP
Like their non-reentrant counterparts, \fBgetrpcbyname_r()\fR and
\fBgetrpcbynumber_r()\fR leave the enumeration position in an indeterminate
state.
.SH RETURN VALUES
- .sp
.LP
RPC entries are represented by the \fBstruct rpcent\fR structure defined in
\fB<rpc/rpcent.h>\fR:
.sp
.in +2
--- 132,141 ----
*** 171,196 ****
.LP
When the pointer returned by the reentrant functions \fBgetrpcbyname_r()\fR,
\fBgetrpcbynumber_r()\fR, and \fBgetrpcent_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 \fBgetrpcyname_r()\fR, \fBgetrpcbynumber_r(\|)\fR and
\fBgetrpcent_r()\fR will return \fBNULL\fR and set \fBerrno\fR to \fBERANGE\fR
if 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
.LP
\fB/etc/rpc\fR
.sp
.LP
\fB/etc/nsswitch.conf\fR
.SH ATTRIBUTES
- .sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
--- 168,190 ----
.LP
When the pointer returned by the reentrant functions \fBgetrpcbyname_r()\fR,
\fBgetrpcbynumber_r()\fR, and \fBgetrpcent_r()\fR is non-NULL, it is always
equal to the \fIresult\fR pointer that was supplied by the caller.
.SH ERRORS
.LP
! The reentrant functions \fBgetrpcbyname_r()\fR, \fBgetrpcbynumber_r(\|)\fR and
\fBgetrpcent_r()\fR will return \fBNULL\fR and set \fBerrno\fR to \fBERANGE\fR
if 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
.LP
\fB/etc/rpc\fR
.sp
.LP
\fB/etc/nsswitch.conf\fR
.SH ATTRIBUTES
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
*** 204,225 ****
See "Reentrant Interfaces" in \fBDESCRIPTION\fR.
T}
.TE
.SH SEE ALSO
- .sp
.LP
\fBrpcinfo\fR(1M), \fBrpc\fR(3NSL), \fBnsswitch.conf\fR(4), \fBrpc\fR(4),
\fBattributes\fR(5)
.SH WARNINGS
- .sp
.LP
The reentrant interfaces \fBgetrpcbyname_r()\fR, \fBgetrpcbynumber_r()\fR, and
\fBgetrpcent_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
When compiling multithreaded applications, see \fBIntro\fR(3), \fINotes On
Multithreaded Applications\fR, for information about the use of the
\fB_REENTRANT\fR flag.
.sp
--- 198,216 ----