home | help
HESIOD(3)		    Library Functions Manual		       HESIOD(3)

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   hes-
     iod_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'' Hes-
     iod 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 ser-
     vice.  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_re-
     solve may fail.

SEE ALSO
     hesiod(3)

				30 November 1996		       HESIOD(3)

home | help