]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/getrpcent.3
fuse.4: ffix
[thirdparty/man-pages.git] / man3 / getrpcent.3
index dc2213beb763311ee26256d3772c169211729505..191e31c7d0742bf15483aee4b6d9d5bdffbd81f4 100644 (file)
@@ -1,26 +1,30 @@
 .\" 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 (),
@@ -29,17 +33,17 @@ and
 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
@@ -52,26 +56,28 @@ A NULL-terminated list of alternate names for the RPC program.
 .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
@@ -88,13 +94,33 @@ 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