• 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)

Current Users: 96 © 1999-2009 PenguinSoft. All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.