132 The functions getrpcbyname(), getrpcbyname_r(), getrpcbynumber(), and
133 getrpcbynumber_r() each return a pointer to a struct rpcent if they
134 successfully locate the requested entry; otherwise they return NULL.
135
136
137 The functions getrpcent() and getrpcent_r() each return a pointer to a
138 struct rpcent if they successfully enumerate an entry; otherwise they
139 return NULL, indicating the end of the enumeration.
140
141
142 The functions getrpcbyname(), getrpcbynumber(), and getrpcent() use
143 static storage, so returned data must be copied before a subsequent
144 call to any of these functions if the data is to be saved.
145
146
147 When the pointer returned by the reentrant functions getrpcbyname_r(),
148 getrpcbynumber_r(), and getrpcent_r() is non-NULL, it is always equal
149 to the result pointer that was supplied by the caller.
150
151 ERRORS
152 The reentrant functions getrpcyname_r(), getrpcbynumber_r() and
153 getrpcent_r() will return NULL and set errno to ERANGE if the length of
154 the buffer supplied by caller is not large enough to store the result.
155 See Intro(2) for the proper usage and interpretation of errno in
156 multithreaded applications.
157
158 FILES
159 /etc/rpc
160
161
162 /etc/nsswitch.conf
163
164 ATTRIBUTES
165 See attributes(5) for descriptions of the following attributes:
166
167
168
169
170 +---------------+--------------------------------------------+
171 |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
172 +---------------+--------------------------------------------+
|
132 The functions getrpcbyname(), getrpcbyname_r(), getrpcbynumber(), and
133 getrpcbynumber_r() each return a pointer to a struct rpcent if they
134 successfully locate the requested entry; otherwise they return NULL.
135
136
137 The functions getrpcent() and getrpcent_r() each return a pointer to a
138 struct rpcent if they successfully enumerate an entry; otherwise they
139 return NULL, indicating the end of the enumeration.
140
141
142 The functions getrpcbyname(), getrpcbynumber(), and getrpcent() use
143 static storage, so returned data must be copied before a subsequent
144 call to any of these functions if the data is to be saved.
145
146
147 When the pointer returned by the reentrant functions getrpcbyname_r(),
148 getrpcbynumber_r(), and getrpcent_r() is non-NULL, it is always equal
149 to the result pointer that was supplied by the caller.
150
151 ERRORS
152 The reentrant functions getrpcbyname_r(), getrpcbynumber_r() and
153 getrpcent_r() will return NULL and set errno to ERANGE if the length of
154 the buffer supplied by caller is not large enough to store the result.
155 See Intro(2) for the proper usage and interpretation of errno in
156 multithreaded applications.
157
158 FILES
159 /etc/rpc
160
161
162 /etc/nsswitch.conf
163
164 ATTRIBUTES
165 See attributes(5) for descriptions of the following attributes:
166
167
168
169
170 +---------------+--------------------------------------------+
171 |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
172 +---------------+--------------------------------------------+
|