Provided by: manpages-es_1.55-3_all bug

NOMBRE

       getrpcent, getrpcbyname, getrpcbynumber - obtienen una entrada RPC

SINOPSIS

       #include <netdb.h>

       struct rpcent *getrpcent()

       struct rpcent *getrpcbyname(name)
       char *name;

       struct rpcent *getrpcbynumber(number)
       int number;

       setrpcent (stayopen)
       int stayopen;

       endrpcent ()

DESCRIPCIÓN

       getrpcent(),  getrpcbyname()  y getrpcbynumber() devuelven un puntero a
       un  objeto  con  la  siguiente  estructura,  que  contiene  los  campos
       extraídos de una línea de la base de datos de números de programas RPC,
       /etc/rpc.

              struct    rpcent {
                   char *r_name;  /* nom. del servidor para este programa RPC */
                   char **r_aliases;   /* lista de alias */
                   long r_number; /* número del programa RPC */
              };

       Los miembros de esta estructura son:
              r_name              El nombre del servidor  para  este  programa
                                  RPC.
              r_aliases           Una  lista  terminada  en  NULL  de  nombres
                                  alternativos para el programa RPC.
              r_number            El  número  del  programa  RPC   para   este
                                  servicio.

       getrpcent()  lee la siguiente línea del fichero, abriendo el fichero si
       es necesario.

       setrpcent() abre el fichero y coloca su puntero de lectura/escritura al
       principio. Si la opción stayopen no es cero, la base de datos de red no
       se cerrará tras cada llamada  a  getrpcent()  (tampoco  ni  directa  ni
       indirectamente a través de alguna de las otras llamadas “getrpc”).

       endrpcent cierra el fichero.

       getrpcbyname()  y getrpcbynumber() examinan secuencialmente el fichero,
       desde el principio, hasta que encuentran un nombre de programa RPC o un
       número  de  programa coincidente, o hasta que se encuentre el final del
       fichero.

FICHEROS

       /etc/rpc

VÉASE TAMBIÉN

       rpc(5), rpcinfo(8), ypserv(8)

DIAGNÓSTICOS

       Se devuelve un puntero NULL si se encuentra un EOF o si se  produce  un
       error.

FALLOS

       Toda  la  información se almacenada en un área estática por lo que debe
       copiarse a otro sitio si se va a guardar.

                               14 diciembre 1987                  GETRPCENT(3)