oracular (3) getservbyname.3.gz
NOMBRE
getservent, getservbyname, getservbyport, setservent, endservent - obtiene valores de servicios
BIBLIOTECA
Biblioteca Estándar C (libc, -lc)
SINOPSIS
#include <netdb.h> struct servent *getservent(void); struct servent *getservbyname(const char *nombre, const char *proto); struct servent *getservbyport(int puerto, const char *proto); void setservent(int sigue_abierto); void endservent(void);
DESCRIPCIÓN
La función getservent() lee la siguiente línea de la base de datos de servicios (consulte services(5)) y devuelve una estructura servent que contiene en sus campos los campos de la línea. Si es necesario, se abre una conexión a la base de datos The getservbyname() function returns a servent structure for the entry from the database that matches the service name using protocol proto. If proto is NULL, any protocol will be matched. A connection is opened to the database if necessary. La función getservbyport() devuelve una estructura de tipo servent con los datos de la línea que contiene el puerto port (con los bytes en el orden de red) y usa el protocolo proto. Si proto vale NULL, cualquier protocolo se dará como válido. Si necesarios, se abrirá una conexión con la base de datos. La función setservent() abre una conexión con la base de datos y define la siguiente entrada como la primera. Si stayopen es distinto de cero, entonces no se cerrará la conexión a la base de datos entre llamadas a las funciones getserv*(). La función endservent() cierra la conexión a la base de datos. La estructura servent está definida en <netdb.h> como sigue: struct servent { char *s_name; /* nombre oficial del servicio */ char **s_aliases; /* lista de alias */ int s_port; /* número de puerto */ char *s_proto; /* protocolo a usar */ } Los miembros de la estructura servent son: s_name El nombre oficial del servicio. s_aliases Una lista terminada en NULL de nombres alternativos para el servicio. s_port El numero de puerto para el servicio, con sus bytes en el orden de red. s_proto El nombre del protoclo a usar con este servicio.
VALOR DEVUELTO
Las funciones getservent(), getservbyname() y getservbyport() devuelve una estructura de tipo servent, o
un puntero NULL si ha ocurrido un error o se ha alcanzado el final del archivo.
ARCHIVOS
/etc/services Fichero de base de datos de servicios
ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase attributes(7). ┌───────────────────────────┬────────────────────┬───────────────────────────────────────────────────────┐ │Interfaz │ Atributo │ Valor │ ├───────────────────────────┼────────────────────┼───────────────────────────────────────────────────────┤ │getservent() │ Seguridad del hilo │ MT-Unsafe race:servent race:serventbuf locale │ ├───────────────────────────┼────────────────────┼───────────────────────────────────────────────────────┤ │getservbyname() │ Seguridad del hilo │ MT-Unsafe race:servbyname locale │ ├───────────────────────────┼────────────────────┼───────────────────────────────────────────────────────┤ │getservbyport() │ Seguridad del hilo │ MT-Unsafe race:servbyport locale │ ├───────────────────────────┼────────────────────┼───────────────────────────────────────────────────────┤ │setservent(), endservent() │ Seguridad del hilo │ MT-Unsafe race:servent locale │ └───────────────────────────┴────────────────────┴───────────────────────────────────────────────────────┘ In the above table, servent in race:servent signifies that if any of the functions setservent(), getservent(), or endservent() 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(3), getservent_r(3), services(5)
TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars <mpi79470@alu.um.es> y Marcos Fouces <marcos@debian.org> Esta traducción es documentación libre; lea la GNU General Public License Version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.