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)