Loading

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);

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

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
       francophone de traduction de Debian.

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