.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 19:19:11 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Wed Oct 18 20:23:54 1995 by Martin Schulze <joey@infodrom.north.de>
.\" Modified Mon Apr 22 01:50:54 1996 by Martin Schulze <joey@infodrom.north.de>
.\" 2001-07-25 added a clause about NULL proto (Martin Michlmayr or David N. Welton)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getservent 3 "20 ​​Julio 2023" "Páginas de manual de Linux 6.05.01" 
.SH NOMBRE
getservent, getservbyname, getservbyport, setservent, endservent \- obtiene
valores de servicios
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <netdb.h>\fP
.PP
\fBstruct servent *getservent(void);\fP
.PP
\fBstruct servent *getservbyname(const char *\fP\fInombre\fP\fB, const char *\fP\fIproto\fP\fB);\fP
\fBstruct servent *getservbyport(int \fP\fIpuerto\fP\fB, const char *\fP\fIproto\fP\fB);\fP
.PP
\fBvoid setservent(int \fP\fIsigue_abierto\fP\fB);\fP
\fBvoid endservent(void);\fP
.fi
.SH DESCRIPCIÓN
La función \fBgetservent\fP() lee la siguiente línea de la base de datos de
servicios (consulte \fBservices\fP(5)) y devuelve una estructura \fIservent\fP que
contiene en sus campos los campos de la línea.  Si es necesario, se abre una
conexión a la base de datos
.PP
The \fBgetservbyname\fP()  function returns a \fIservent\fP structure for the
entry from the database that matches the service \fIname\fP using protocol
\fIproto\fP.  If \fIproto\fP is NULL, any protocol will be matched.  A connection
is opened to the database if necessary.
.PP
La función \fBgetservbyport\fP() devuelve una estructura de tipo \fIservent\fP con
los datos de la línea que contiene el puerto \fIport\fP (con los bytes en el
orden de red) y usa el protocolo \fIproto\fP.  Si \fIproto\fP vale NULL, cualquier
protocolo se dará como válido. Si necesarios, se abrirá una conexión con la
base de datos.
.PP
La función \fBsetservent\fP() abre una conexión con la base de datos y define
la siguiente entrada como la primera.  Si \fIstayopen\fP es distinto de cero,
entonces no se cerrará la conexión a la base de datos entre llamadas a las
funciones \fBgetserv*\fP().
.PP
La función \fBendservent\fP() cierra la conexión a la base de datos.
.PP
La estructura \fIservent\fP está definida en \fI<netdb.h>\fP como sigue:
.PP
.in +4n
.EX
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 */
}
.EE
.in
.PP
Los miembros de la estructura \fIservent\fP son:
.TP 
\fIs_name\fP
El nombre oficial del servicio.
.TP 
\fIs_aliases\fP
Una lista terminada en NULL de nombres alternativos para el servicio.
.TP 
\fIs_port\fP
El numero de puerto para el servicio, con sus bytes en el orden de red.
.TP 
\fIs_proto\fP
El nombre del protoclo a usar con este servicio.
.SH "VALOR DEVUELTO"
Las funciones \fBgetservent\fP(), \fBgetservbyname\fP() y \fBgetservbyport\fP()
devuelve una estructura de tipo \fIservent\fP, o un puntero NULL si ha ocurrido
un error o se ha alcanzado el final del archivo.
.SH ARCHIVOS
.TP 
\fI/etc/services\fP
Fichero de base de datos de servicios
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.TS
allbox;
lb lb lbx
l l l.
Interfaz	Atributo	Valor
T{
.na
.nh
\fBgetservent\fP()
T}	Seguridad del hilo	T{
.na
.nh
MT\-Unsafe race:servent
race:serventbuf locale
T}
T{
.na
.nh
\fBgetservbyname\fP()
T}	Seguridad del hilo	T{
.na
.nh
MT\-Unsafe race:servbyname
locale
T}
T{
.na
.nh
\fBgetservbyport\fP()
T}	Seguridad del hilo	T{
.na
.nh
MT\-Unsafe race:servbyport
locale
T}
T{
.na
.nh
\fBsetservent\fP(),
\fBendservent\fP()
T}	Seguridad del hilo	T{
.na
.nh
MT\-Unsafe race:servent
locale
T}
.TE
.sp 1
In the above table, \fIservent\fP in \fIrace:servent\fP signifies that if any of
the functions \fBsetservent\fP(), \fBgetservent\fP(), or \fBendservent\fP()  are used
in parallel in different threads of a program, then data races could occur.
.SH ESTÁNDARES
POSIX.1\-2008.
.SH HISTORIAL
POSIX.1\-2001, 4.3BSD.
.SH "VÉASE TAMBIÉN"
\fBgetnetent\fP(3), \fBgetprotoent\fP(3), \fBgetservent_r\fP(3), \fBservices\fP(5)
.PP
.SH 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>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .