GETSERVENT(3N)      RISC/os Reference Manual       GETSERVENT(3N)



NAME
     getservent, getservbyport, getservbyname, setservent,
     endservent - get service entry

SYNOPSIS
   Headers
     For -systype sysv:

     #include <bsd/sys/types.h>
     #include <bsd/netdb.h>

     For -systype bsd43:

     #include <netdb.h>

   Declarations
     struct servent *getservent()

     struct servent *getservbyname(name, proto)
     char *name, *proto;

     struct servent *getservbyport(port, proto)
     int port; char *proto;

     setservent(stayopen)
     int stayopen

     endservent()

DESCRIPTION
     getservent, getservbyname, and getservbyport each return a
     pointer to an object with the following structure containing
     the broken-out fields of a line in the network services data
     base, /etc/services.

          struct   servent {
              char   *s_name;      /* official name of service */
              char   **s_aliases;  /* alias list */
              int    s_port;       /* port service resides at */
              char   *s_proto;     /* protocol to use */
          };

     The members of this structure are:

          s_name     The official name of the service.

          s_aliases  A zero terminated list of alternate names
                     for the service.

          s_port     The port number at which the service
                     resides.  Port numbers are returned in net-
                     work byte order.



                         Printed 1/15/91                   Page 1

GETSERVENT(3N)      RISC/os Reference Manual       GETSERVENT(3N)



          s_proto    The name of the protocol to use when con-
                     tacting the service.

     getservent reads the next line of the file, opening the file
     if necessary.

     setservent opens and rewinds the file.  If the stayopen flag
     is non-zero, the net data base will not be closed after each
     call to getservbyname or getservbyport.

     endservent closes the file.

     getservbyname and getservbyport sequentially search from the
     beginning of the file until a matching protocol name or port
     number is found, or until EOF is encountered.  If a protocol
     name is also supplied (non-NULL), searches must also match
     the protocol.

FILES
     /etc/services

SEE ALSO
     getprotoent(3N), services(4).

DIAGNOSTICS
     Null pointer (0) returned on EOF or error.

ERRORS
     All information is contained in a static area so it must be
     copied if it is to be saved.  Expecting port numbers to fit
     in a 32 bit quantity is probably naive.

NOTE
     When these routines are used in a program which is compiled
     in -systype sysv, they are not resolved by libc.a.  See
     intro(3-SysV) for more information.



















 Page 2                  Printed 1/15/91