4.3BSD-UWisc/man/cat3/getrpcbynumber.3n

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