Accesses the /etc/rpc file.
Standard C Library (libc.a)
struct rpcent *getrpcent () struct rpcent *getrpcbyname (Name) char *Name; struct rpcent *getrpcbynumber (Number) int Number; void setrpcent (StayOpen) int StayOpen void endrpcent
Attention: Do not use the getrpcent, getrpcbyname, getrpcbynumber, setrpcent, or endrpcent subroutine in a multithreaded environment.
Attention: The information returned by the getrpcbyname, and getrpcbynumber subroutines is stored in a static area and is overwritten on subsequent calls. Copy the information to save it.
The getprcbyname and getrpcbynumber subroutines each return a pointer to an object with the rpcent structure. This structure contains the broken-out fields of a line from the /etc/rpc file. The getprcbyname and getrpcbynumber subroutines searches the rpc file sequentially from the beginning of the file until it finds a matching RPC program name or number, or until it reaches the end of the file. The getrpcent subroutine reads the next line of the file, opening the file if necessary.
The setrpcent subroutine opens and rewinds the /etc/rpc file. If the StayOpen parameter does not equal 0, the rpc file is not closed after a call to the getrpcent subroutine.
The setrpcent subroutine rewinds the rpc file. The endrpcent subroutine closes it.
The rpc file contains information about Remote Procedure Call (RPC) programs. The rpcent structure is in the /usr/include/sys/rpcent.h file and contains the following fields:
|r_name||Contains the name of the server for an RPC program|
|r_aliases||Contains an alternate list of names for RPC programs. This list ends with a 0.|
|r_number||Contains a number associated with an RPC program.|
|Name||Specifies the name of a server for rpc program.|
|Number||Specifies the rpc program number for service.|
|StayOpen||Contains a value used to indicate whether to close the rpc file.|
These subroutines return a null pointer when they encounter the end of a file or an error.
These subroutines are part of Base Operating System (BOS) Runtime.
|/etc/rpc||Contains information about Remote Procedure Call (RPC) programs.|
Remote Procedure Call (RPC) for Programming in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs