setrpcent(3) [osf1 man page]

getrpcent(3)						     Library Functions Manual						      getrpcent(3)

NAME

       getrpcent, getrpcbynumber, getrpcbyname, setrpcent, endrpcent - Get rpc entry

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include </rpc/netdb.h>
       struct rpcent *getrpcent(void);

       struct rpcent *getrpcbynumber(
	       int number);

       struct rpcent *getrpcbyname(
	       char *name);

       void setrpcent(
	       int stayopen);

       void endrpcent(void);

DESCRIPTION

       The  getrpcent,	getrpcbynumber and getrpcbyname functions return pointers to an object with the following structure containing the broken-
       out fields of a line in the rpc database: struct  rpcent {		/* see getrpcent(3) */
	       char    *r_name;
	       char    **r_aliases;   /* alias list */
	       int     r_number;      /* rpc program number */ }; struct group *getrpcent(), *getrpcbynumber(), *getrpcbyname();

       The members of this structure are:

       r_name	  The name of the rpc.
       r_aliases A zero-terminated list of alternate names for the rpc.
       r_number   The rpc program number for the rpc.

       If the stayopen flag on the setrpcent subroutine is null, the rpc database is opened.  Otherwise the setrpcent has the effect of  rewinding
       the rpc database.  The endrpcent may be called to close the rpc file when processing is complete.

       The  getrpcent subroutine simply reads the next line while getrpcbynumber and getrpcbyname search until a matching gid or name is found (or
       until EOF is encountered).  The getrpcent subroutine keeps a pointer in the database, allowing successive calls to be used  to  search  the
       entire file.

       A call to setrpcent must be made before a while loop using getrpcent in order to perform initialization and an endrpcent must be used after
       the loop.  Both getrpcbynumber and getrpcbyname make calls to setrpcent and endrpcent.

NOTES

       The getrpcent(), getrpcbynumber(), and getrpcbyname() functions return pointers to thread-specific data.  Subsequent calls to  these  func-
       tions from the same thread overwrite this data.

       If NIS (formerly YP) is running, getrpcent does not return the entries in any particular order. See the Network Administration for NIS set-
       up information.

       The rpc information is stored locally in /etc/rpc or is distributed by NIS, or both.  To determine which file or files to  search,  and	in
       which order, the system uses the switches in the /etc/svc.conf file.

RETURN VALUES

       A null pointer (0) is returned on EOF or error.

FILES

       /etc/rpc

RELATED INFORMATION

       rpc(4), svc.conf(4)

       delim off

																      getrpcent(3)

Check Out this Related Man Page

getrpcent(3n)															     getrpcent(3n)

Name
       getrpcent, getrpcbynumber, getrpcbyname, setrpcent, endrpcent - get rpc entry

Syntax
       #include <netdb.h>

       struct rpcent *getrpcent()

       struct rpcent *getrpcbynumber(number)
       int number;

       struct rpcent *getrpcbyname(name)
       char *name;

       setrpcent(stayopen)
       int stayopen;

       endrpcent( )

Description
       The  and  subroutines  each return pointers to an object with the following structure containing the broken-out fields of a line in the rpc
       database:
       struct  rpcent { 	      /* see getrpcent(3) */
	       char    *r_name;
	       char    **r_aliases;   /* alias list */
	       char    r_number;      /* rpc program number */
       };
       struct group *getrpcent(), *getrpcbynumber(), *getrpcbyname();

       The members of this structure are:

       r_name	  The name of the rpc.
       r_aliases A zero-terminated list of alternate names for the rpc.
       r_number   The rpc program number for the rpc.

       If the stayopen flag on the subroutine is NULL, the database is opened.	Otherwise the has the effect of rewinding the database.   The  may
       be called to close the file when processing is complete.

       The  subroutine	simply reads the next line while and search until a matching gid or name is found (or until EOF is encountered).  The sub-
       routine keeps a pointer in the database, allowing successive calls to be used to search the entire file.

       A call to must be made before a loop using in order to perform initialization and an must be used after the loop.  Both and make  calls	to
       and

Restrictions
       All information is contained in a static area so it must be copied if it is to be saved.

       If YP is running, does not return the entries in any particular order.  See the Guide to the Yellow Pages Service for setup information.

       The database may also be distributed by the BIND/Hesiod naming service.	See the Guide to the BIND/Hesiod Service for more information.

Return Values
       A null pointer(0) is returned on EOF or error.

Files
See Also
       rpc(5), svc.conf(5)
       Guide to the BIND/Hesiod Service
       Guide to the Yellow Pages Service

																     getrpcent(3n)

Linux and UNIX Man Pages

setrpcent(3) [osf1 man page]

Check Out this Related Man Page