NAME

       hesiod_getservbyname,  hesiod_free_servent  -  Hesiod  functions  for  retrieving  service
       information

SYNOPSIS

       #include <hesiod.h>

       struct servent *hesiod_getservbyname(void *context,
            const char *name, const char *proto)
       void hesiod_free_servent(void *context, struct servent *serv)

       cc file.c -lhesiod

DESCRIPTION

       This family of functions allows you to retrieve service to port mappings using Hesiod.  To
       perform  lookups,  you  need  an  initialized  Hesiod  context; see hesiod(3) for details.
       Information is returned in the same format  as  by  getservbyname.   It  is  the  caller's
       responsibility  to  call  hesiod_free_servent  with the returned service entry to free the
       resources used by the service entry.

       Hesiod queries for service information are made using the ``service'' Hesiod  type,  using
       the  service name as the Hesiod name.  The corresponding records should be space-separated
       lists of strings giving the service name, protocol, port number (in decimal), and zero  or
       more  aliases  for  the  service.   There  may  be  multiple  records  per  service  name;
       hesiod_getservbyname will pick the first one whose protocol matches proto.

RETURN VALUES

       On failure, hesiod_getservbyname returns NULL  and  sets  the  global  variable  errno  to
       indicate the error.

ERRORS

       hesiod_getservbyname may fail for any of the reasons the routine hesiod_resolve may fail.

SEE ALSO

       hesiod(3)

                                         30 November 1996                               HESIOD(3)