Poster of Linux kernelThe best gift for a Linux geek
HESIOD

HESIOD

Section: C Library Functions (3) Updated: 30 November 1996
Local index Up
 

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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:47:47 GMT, April 16, 2011