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.

CONFORMITÉ

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

GNU                                               19 août 2008                                     GETSERVENT(3)