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 ----