.\" Copyright 2008, Linux Foundation, written by Michael Kerrisk
.\" <mtk.manpages@gmail.com>
.\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date. The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein. The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
-.\"
-.TH GETRPCENT_R 3 2015-07-23 "GNU" "Linux Programmer's Manual"
+.TH GETRPCENT_R 3 (date) "Linux man-pages (unreleased)"
.SH NAME
getrpcent_r, getrpcbyname_r, getrpcbynumber_r \- get
RPC entry (reentrant)
+.SH LIBRARY
+Standard C library
+.RI ( libc ", " \-lc )
.SH SYNOPSIS
.nf
.B #include <netdb.h>
-.sp
+.PP
.BI "int getrpcent_r(struct rpcent *" result_buf ", char *" buf ,
.BI " size_t " buflen ", struct rpcent **" result );
-.sp
.BI "int getrpcbyname_r(const char *" name ,
.BI " struct rpcent *" result_buf ", char *" buf ,
.BI " size_t " buflen ", struct rpcent **" result );
-.sp
.BI "int getrpcbynumber_r(int " number ,
.BI " struct rpcent *" result_buf ", char *" buf ,
.BI " size_t " buflen ", struct rpcent **" result );
-.sp
+.PP
.fi
-.in -4n
+.RS -4
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
-.ad l
-.in
-.sp
+.RE
+.PP
.BR getrpcent_r (),
.BR getrpcbyname_r (),
.BR getrpcbynumber_r ():
+.nf
Since glibc 2.19:
_DEFAULT_SOURCE
Glibc 2.19 and earlier:
_BSD_SOURCE || _SVID_SOURCE
-.ad b
+.fi
.SH DESCRIPTION
The
.BR getrpcent_r (),
and in the function calling signature and return value.
This manual page describes just the differences from
the nonreentrant functions.
-
+.PP
Instead of returning a pointer to a statically allocated
.I rpcent
structure as the function result,
these functions copy the structure into the location pointed to by
.IR result_buf .
-
+.PP
The
.I buf
array is used to store the string fields pointed to by the returned
(A buffer of length 1024 bytes should be sufficient for most applications.)
.\" I can find no information on the required/recommended buffer size;
.\" the nonreentrant functions use a 1024 byte buffer -- mtk.
-
+.PP
If the function call successfully obtains an RPC record, then
.I *result
is set pointing to
.SH RETURN VALUE
On success, these functions return 0.
On error, they return one of the positive error numbers listed in ERRORS.
-
+.PP
On error, record not found
.RB ( getrpcbyname_r (),
.BR getrpcbynumber_r ()),
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
+.ad l
+.nh
.TS
allbox;
-lbw19 lb lb
+lbx lb lb
l l l.
Interface Attribute Value
T{
.BR getrpcbynumber_r ()
T} Thread safety MT-Safe locale
.TE
-
-.SH CONFORMING TO
+.hy
+.ad
+.sp 1
+.SH STANDARDS
These functions are GNU extensions.
Functions with similar names exist on some other systems,
though typically with different calling signatures.