Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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

NAME
       hesiod_getservbyname,  hesiod_free_servent  -  Hesiod functions for re-
       trieving	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	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	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 vari-
       able 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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=hesiod_getservbyname&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help