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