GETRPCENT(3N) UNIX Programmer's Manual GETRPCENT(3N) NAME getrpcent, getrpcbyname, getrpcbynumber - get rpc entry SYNOPSIS #include <netdb.h> struct rpcent *getrpcent() struct rpcent *getrpcbyname(name) char *name; struct rpcent *getrpcbynumber(number) int number; setrpcent(stayopen) int stayopen endrpcent() DESCRIPTION _G_e_t_r_p_c_e_n_t, _g_e_t_r_p_c_b_y_n_a_m_e, and _g_e_t_r_p_c_b_y_n_u_m_b_e_r each return a pointer to an object with the following structure containing the broken-out fields of a line in the rpc program number data base, /_e_t_c/_r_p_c. struct rpcent { char *r_name; /* name of server for this rpc program */ char **r_aliases; /* alias list */ long r_number; /* rpc program number */ }; The members of this structure are: r_name The name of the server for this rpc program. r_aliases A zero terminated list of alternate names for the rpc program. r_number The rpc program number for this service. _G_e_t_r_p_c_e_n_t reads the next line of the file, opening the file if necessary. _S_e_t_r_p_c_e_n_t opens and rewinds the file. If the _s_t_a_y_o_p_e_n flag is non-zero, the net data base will not be closed after each call to _g_e_t_r_p_c_e_n_t (either directly, or indirectly through one of the other "getrpc" calls). _E_n_d_r_p_c_e_n_t closes the file. _G_e_t_r_p_c_b_y_n_a_m_e and _g_e_t_r_p_c_b_y_n_u_m_b_e_r sequentially search from the beginning of the file until a matching rpc program name or Printed 12/27/86 26 September 1985 1 GETRPCENT(3N) UNIX Programmer's Manual GETRPCENT(3N) program number is found, or until EOF is encountered. FILES /etc/rpc /etc/yp/_d_o_m_a_i_n_n_a_m_e/rpc.bynumber SEE ALSO rpc(5), rpcinfo(8), ypservices(8) DIAGNOSTICS Null pointer (0) returned on EOF or error. BUGS All information is contained in a static area so it must be copied if it is to be saved. Printed 12/27/86 26 September 1985 2