Scroll to navigation

getprotoent(3) Library Functions Manual getprotoent(3)

NOMBRE

getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - obtienen una entrada del fichero de protocolos

BIBLIOTECA

Biblioteca Estándar C (libc, -lc)

SINOPSIS

#include <netdb.h>
struct protoent *getprotoent(void);
struct protoent *getprotobyname(const char *nombre);
struct protoent *getprotobynumber(int proto);
void setprotoent(int sigue_abierto);
void endprotoent(void);

DESCRIPCIÓN

La función getprotoent() lee la siguiente línea de la base de datos de protocolos (consulte protocols(5)) y devuelve una estructura protoent que contiene los campos de que consta la línea. Si necesario, se abre una conexión a la base de datos.

La función getprotobyname() devuelve una estructura protoent para la línea de /etc/protocols que concuerde con el nombre de protocolo nombre. Si necesario, se abre una conexión a la base de datos.

The getprotobynumber() function returns a protoent structure for the entry from the database that matches the protocol number number. A connection is opened to the database if necessary.

The setprotoent() 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 getproto*() functions.

The endprotoent() function closes the connection to the database.

La estructura protoent se define en <netdb.h> así:


struct protoent {

char *p_name; /* nombre oficial de protocolo */
char **p_aliases; /* lista de sinónimos */
int p_proto; /* número de protocolo */ }

Los miembros de la estructura protoent son:

El nombre oficial del protocolo.
Una lista terminada en NULL de nombres alternos para el protocolo.
El número del protocolo.

VALOR DEVUELTO

The getprotoent(), getprotobyname(), and getprotobynumber() functions return a pointer to a statically allocated protoent structure, or a null pointer if an error occurs or the end of the file is reached.

ARCHIVOS

/etc/protocols
fichero con los datos de protocolos

ATRIBUTOS

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

Interfaz Atributo Valor
getprotoent() Seguridad del hilo MT-Unsafe race:protoent race:protoentbuf locale
getprotobyname() Seguridad del hilo MT-Unsafe race:protobyname locale
getprotobynumber() Seguridad del hilo MT-Unsafe race:protobynumber locale
setprotoent(), endprotoent() Seguridad del hilo MT-Unsafe race:protoent locale

In the above table, protoent in race:protoent signifies that if any of the functions setprotoent(), getprotoent(), or endprotoent() are used in parallel in different threads of a program, then data races could occur.

ESTÁNDARES

POSIX.1-2008.

HISTORIAL

POSIX.1-2001, 4.3BSD.

VÉASE TAMBIÉN

getnetent(3), getprotoent_r(3), getservent(3), protocols(5)

TRADUCCIÓN

La traducción al español de esta página del manual fue creada por Gerardo Aburruzaga García <gerardo.aburruzaga@uca.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.

2 Mayo 2024 Páginas de Manual de Linux (no publicadas)