.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
.\"
+.\" %%%LICENSE_START(BSD_ONELINE_CDROM)
+.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
+.\" %%%LICENSE_END
+.\"
.\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
-.TH GETRPCENT 3 2008-08-19 "" "Linux Programmer's Manual"
+.TH GETRPCENT 3 2017-09-15 "" "Linux Programmer's Manual"
.SH NAME
getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \- get
RPC entry
.SH SYNOPSIS
.nf
.B #include <netdb.h>
-
+.PP
.BI "struct rpcent *getrpcent(void);"
-
-.BI "struct rpcent *getrpcbyname(char *" name );
-
+.PP
+.BI "struct rpcent *getrpcbyname(const char *" name );
+.PP
.BI "struct rpcent *getrpcbynumber(int " number );
-
+.PP
.BI "void setrpcent(int " stayopen );
-
+.PP
.BI "void endrpcent(void);"
.fi
.SH DESCRIPTION
-.LP
+.PP
The
.BR getrpcent (),
.BR getrpcbyname (),
functions each return a pointer to an object with the
following structure containing the broken-out
fields of an entry in the RPC program number data base.
+.PP
.in +4n
-.nf
-
+.EX
struct rpcent {
char *r_name; /* name of server for this RPC program */
char **r_aliases; /* alias list */
long r_number; /* RPC program number */
};
-.fi
+.EE
.in
-.LP
+.PP
The members of this structure are:
.RS 4
.TP 12
.I r_number
The RPC program number for this service.
.RE
-.LP
+.PP
The
.BR getrpcent ()
function reads the next entry from the database.
A connection is opened to the database if necessary.
-.LP
+.PP
The
.BR setrpcent ()
function opens a connection to the database,
and sets the next entry to the first entry.
-If \fIstayopen\fP is nonzero,
+If
+.I stayopen
+is nonzero,
then the connection to the database
will not be closed between calls to one of the
.BR getrpc* ()
functions.
-.LP
+.PP
The
.BR endrpcent ()
function closes the connection to the database.
-.LP
+.PP
The
.BR getrpcbyname ()
and
return a pointer to a statically allocated
.I rpcent
structure.
-A NULL pointer is returned on EOF or error.
+NULL is returned on EOF or error.
.SH FILES
.TP
.I /etc/rpc
RPC program number database.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw28 lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR getrpcent (),
+.BR getrpcbyname (),
+.br
+.BR getrpcbynumber ()
+T} Thread safety MT-Unsafe
+T{
+.BR setrpcent (),
+.BR endrpcent ()
+T} Thread safety MT-Safe locale
+.TE
+.sp 1
.SH CONFORMING TO
-Not in POSIX.1-2001.
+Not in POSIX.1.
Present on the BSDs, Solaris, and many other systems.
.SH BUGS
All information