diff options
Diffstat (limited to 'lib/libc/net/hesiod.3')
-rw-r--r-- | lib/libc/net/hesiod.3 | 19 |
1 files changed, 18 insertions, 1 deletions
diff --git a/lib/libc/net/hesiod.3 b/lib/libc/net/hesiod.3 index 9b9ad1c..d91db9e 100644 --- a/lib/libc/net/hesiod.3 +++ b/lib/libc/net/hesiod.3 @@ -1,5 +1,4 @@ .\" $NetBSD: hesiod.3,v 1.1 1999/01/25 03:43:04 lukem Exp $ -.\" $FreeBSD$ .\" .\" from: #Id: hesiod.3,v 1.9.2.1 1997/01/03 21:02:23 ghudson Exp # .\" @@ -17,6 +16,8 @@ .\" this software for any purpose. It is provided "as is" .\" without express or implied warranty. .\" +.\" $FreeBSD$ +.\" .Dd November 30, 1996 .Dt HESIOD 3 .Os @@ -50,15 +51,21 @@ To perform lookups, you must first initialize a .Fa context , an opaque object which stores information used internally by the library between calls. +The .Fn hesiod_init +function initializes a context, storing a pointer to the context in the location pointed to by the .Fa context argument. +The .Fn hesiod_end +function frees the resources used by a context. .Pp +The .Fn hesiod_resolve +function is the primary interface to the library. If successful, it returns a list of one or more strings giving the records matching @@ -73,7 +80,9 @@ caller's responsibility to call .Fn hesiod_free_list to free the resources used by the returned list. .Pp +The .Fn hesiod_to_bind +function converts .Fa name and @@ -117,19 +126,27 @@ Hesiod calls may fail because of: Insufficient memory was available to carry out the requested operation. .It Bq Er ENOEXEC +The .Fn hesiod_init +function failed because the Hesiod configuration file was invalid. .It Bq Er ECONNREFUSED +The .Fn hesiod_resolve +function failed because no name server could be contacted to answer the query. .It Bq Er EMSGSIZE +The .Fn hesiod_resolve or .Fn hesiod_to_bind +function failed because the query or response was too big to fit into the packet buffers. .It Bq Er ENOENT +The .Fn hesiod_resolve +function failed because the name server had no text records matching .Fa name and |