hesiod_free_servent

HESIOD(3)							    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	 map-
       pings  using Hesiod.  To perform lookups, you need an initialized Hes-
       iod context; see hesiod(3) for details.	Information  is	 returned  in
       the  same format as by getservbyname.  It is the caller’s responsibil-
       ity 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  corre-
       sponding 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	 hes-
       iod_resolve may fail.

SEE ALSO
       hesiod(3)



			       30 November 1996			    HESIOD(3)