Man Linux: Main Page and Category List

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)