NOMBRE

getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent - obtienen una entrada RPC

BIBLIOTECA

Biblioteca Estándar C (libc, -lc)

SINOPSIS

#include <netdb.h>

struct rpcent *getrpcent(void);

struct rpcent *getrpcbyname(const char *nombre);
struct rpcent *getrpcbynumber(int número);

void setrpcent(int sigue_abierto);
void endrpcent(void);

DESCRIPCIÓN

The getrpcent(), getrpcbyname(), and getrpcbynumber() functions each return a pointer to an object with the following structure containing the broken-out fields of an entry in the RPC program number data base.

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.

La función getrpcent() lee la siguiente línea de la base de datos. Si necesario se abre una conexión a la base de datos.

The setrpcent() function opens a connection to the database, and sets the next entry to the first entry. If stayopen is nonzero, then the connection to the database will not be closed between calls to one of the getrpc*() functions.

La función endrpcent() cierra la conexión a la base de datos.

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.

VALOR DEVUELTO

On success, getrpcent(), getrpcbyname(), and getrpcbynumber() return a pointer to a statically allocated rpcent structure. NULL is returned on EOF or error.

ARCHIVOS

/etc/rpc

RPC program number database.

ATRIBUTOS

Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

ESTÁNDARES

BSD.

HISTORIAL

BSD, Solaris.

ERRORES

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

VÉASE TAMBIÉN

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

TRADUCCIÓN

La traducción al español de esta página del manual fue creada por Juan Piernas <piernas@ditec.um.es> y Marcos Fouces <marcos@debian.org>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.