getrpcent

Autres langues

Langue: es

Autres versions - même langue

Version: 14 diciembre 1987 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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.