1 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
3 .\" %%%LICENSE_START(BSD_ONELINE_CDROM)
4 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
7 .\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
8 .TH GETRPCENT 3 2020-04-11 "" "Linux Programmer's Manual"
10 getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \- get
16 .BI "struct rpcent *getrpcent(void);"
18 .BI "struct rpcent *getrpcbyname(const char *" name );
20 .BI "struct rpcent *getrpcbynumber(int " number );
22 .BI "void setrpcent(int " stayopen );
24 .BI "void endrpcent(void);"
33 functions each return a pointer to an object with the
34 following structure containing the broken-out
35 fields of an entry in the RPC program number data base.
40 char *r_name; /* name of server for this RPC program */
41 char **r_aliases; /* alias list */
42 long r_number; /* RPC program number */
47 The members of this structure are:
50 The name of the server for this RPC program.
53 A NULL-terminated list of alternate names for the RPC program.
56 The RPC program number for this service.
60 function reads the next entry from the database.
61 A connection is opened to the database if necessary.
65 function opens a connection to the database,
66 and sets the next entry to the first entry.
70 then the connection to the database
71 will not be closed between calls to one of the
77 function closes the connection to the database.
83 functions sequentially search from the beginning
84 of the file until a matching RPC program name or
85 program number is found, or until end-of-file is encountered.
92 return a pointer to a statically allocated
95 NULL is returned on EOF or error.
99 RPC program number database.
101 For an explanation of the terms used in this section, see
107 Interface Attribute Value
112 .BR getrpcbynumber ()
113 T} Thread safety MT-Unsafe
117 T} Thread safety MT-Safe locale
122 Present on the BSDs, Solaris, and many other systems.
125 is contained in a static area
126 so it must be copied if it is