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 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.

Páginas de Manual de Linux 6.9.1                   2 Mayo 2024                                     getservent(3)