GETSERVENT(3N)                                                  GETSERVENT(3N)



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

SYNOPSIS
       #include <netdb.h>

       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
       _G_e_t_s_e_r_v_e_n_t, _g_e_t_s_e_r_v_b_y_n_a_m_e, and _g_e_t_s_e_r_v_b_y_p_o_r_t 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, _/_e_t_c_/_s_e_r_v_i_c_e_s.

              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 network byte order.

       s_proto    The name of the protocol to use when contacting the service.

       _G_e_t_s_e_r_v_e_n_t reads the next line of the file, opening the file if  neces‐
       sary.

       _S_e_t_s_e_r_v_e_n_t  opens  and  rewinds the file.  If the _s_t_a_y_o_p_e_n flag is non-
       zero, the net data base will not be closed  after  each  call  to  _g_e_t_‐
       _s_e_r_v_b_y_n_a_m_e or .IR getservbyport .

       _E_n_d_s_e_r_v_e_n_t closes the file.

       _G_e_t_s_e_r_v_b_y_n_a_m_e  and _g_e_t_s_e_r_v_b_y_p_o_r_t 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(5)

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

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



4.2 Berkeley Distribution        May 19, 1986                   GETSERVENT(3N)