getservent, getservbyname, getservbyport, setservent, endservent - obtiene
valores de servicios
Biblioteca Estándar C (
libc,
-lc)
#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);
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.
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.
- /etc/services
- Fichero de base de datos de servicios
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.
POSIX.1-2001, POSIX.1-2008, 4.3BSD.
getnetent(3),
getprotoent(3),
getservent_r(3),
services(5)
La traducción al español de esta página del manual fue
creada por Miguel Pérez Ibars <
[email protected]> y Marcos
Fouces <
[email protected]>
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
[email protected]