NOM¶
getservent, getservbyname, getservbyport, setservent, endservent - Accéder
aux informations sur les services
SYNOPSIS¶
#include <netdb.h>
struct servent *getservent(void);
struct servent *getservbyname(const char *name, const char *proto);
struct servent *getservbyport(int port, const char *proto);
void setservent(int stayopen);
void endservent(void);
DESCRIPTION¶
La fonction
getservent() lit l'enregistrement suivant de la base de
données de services (consultez
services(5)) et renvoie une
structure
servent contenant les champs de l'enregistrement. Une
connexion est crée si nécessaire.
La fonction
getservbyname() renvoie une structure
servent pour
l'enregistrement du fichier
/etc/services qui correspond au service
nommé
name et utilisant le protocole
proto. Si
proto
est NULL, n'importe quel protocole sera accepté.
getservbyport() renvoie une structure
servent de l'enregistrement
correspondant au port
port indiqué (dans l'ordre des octets du
réseau) et utilisant le protocole
proto. Si
proto est NULL,
tout protocole sera accepté. Une connexion est créée si
nécessaire.
setservent() ouvre une connexion à la base et définit la
prochaine entrée à la première entrée. Si
stayopen
est non nul, alors la connexion ne sera pas fermée entre deux appels aux
fonctions
getserv*().
endservent() ferme la connexion à la base.
La structure
servent est définie dans
<netdb.h>
ainsi :
struct servent {
char *s_name; /* Nom officiel du service */
char **s_aliases; /* Liste d'alias */
int s_port; /* Numéro de port */
char *s_proto; /* Protocole à utiliser */
}
Les membres de la structure
servent sont :
- s_name
- Le nom officiel du service.
- s_aliases
- Une liste alias de noms de service terminée par
NULL.
- s_port
- Le numéro de port, donné dans l'ordre des octets
du réseau.
- s_proto
- Le nom du protocole utilisé par ce service.
VALEUR RENVOYÉE¶
Les fonctions
getservent(),
getservbyname() et
getservbyport() renvoient un pointeur vers une structure
servent
statiquement allouée, ou un pointeur NULL si une erreur se produit, ou si
la fin du fichier est atteinte.
FICHIERS¶
- /etc/services
- Base de données des services.
BSD 4.3, POSIX.1-2001.
VOIR AUSSI¶
getnetent(3),
getprotoent(3),
getservent_r(3),
services(5)
COLOPHON¶
Cette page fait partie de la publication 3.44 du projet
man-pages Linux.
Une description du projet et des instructions pour signaler des anomalies
peuvent être trouvées à l'adresse
<
http://www.kernel.org/doc/man-pages/>.
TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone au sein du projet perkamon
<
http://perkamon.alioth.debian.org/>.
Christophe Blaess <
http://www.blaess.fr/christophe/> (1996-2003), Alain
Portal <
http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau et
l'équipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet
manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande «
man -L C
<section> <page_de_man> ».