hesiod.3 (84306) | hesiod.3 (108037) |
---|---|
1.\" $NetBSD: hesiod.3,v 1.1 1999/01/25 03:43:04 lukem Exp $ | 1.\" $NetBSD: hesiod.3,v 1.1 1999/01/25 03:43:04 lukem Exp $ |
2.\" $FreeBSD: head/lib/libc/net/hesiod.3 84306 2001-10-01 16:09:29Z ru $ | |
3.\" 4.\" from: #Id: hesiod.3,v 1.9.2.1 1997/01/03 21:02:23 ghudson Exp # 5.\" 6.\" Copyright 1988, 1996 by the Massachusetts Institute of Technology. 7.\" 8.\" Permission to use, copy, modify, and distribute this 9.\" software and its documentation for any purpose and without 10.\" fee is hereby granted, provided that the above copyright 11.\" notice appear in all copies and that both that copyright 12.\" notice and this permission notice appear in supporting 13.\" documentation, and that the name of M.I.T. not be used in 14.\" advertising or publicity pertaining to distribution of the 15.\" software without specific, written prior permission. 16.\" M.I.T. makes no representations about the suitability of 17.\" this software for any purpose. It is provided "as is" 18.\" without express or implied warranty. 19.\" | 2.\" 3.\" from: #Id: hesiod.3,v 1.9.2.1 1997/01/03 21:02:23 ghudson Exp # 4.\" 5.\" Copyright 1988, 1996 by the Massachusetts Institute of Technology. 6.\" 7.\" Permission to use, copy, modify, and distribute this 8.\" software and its documentation for any purpose and without 9.\" fee is hereby granted, provided that the above copyright 10.\" notice appear in all copies and that both that copyright 11.\" notice and this permission notice appear in supporting 12.\" documentation, and that the name of M.I.T. not be used in 13.\" advertising or publicity pertaining to distribution of the 14.\" software without specific, written prior permission. 15.\" M.I.T. makes no representations about the suitability of 16.\" this software for any purpose. It is provided "as is" 17.\" without express or implied warranty. 18.\" |
19.\" $FreeBSD: head/lib/libc/net/hesiod.3 108037 2002-12-18 12:45:11Z ru $ 20.\" |
|
20.Dd November 30, 1996 21.Dt HESIOD 3 22.Os 23.Sh NAME 24.Nm hesiod , 25.Nm hesiod_init , 26.Nm hesiod_resolve , 27.Nm hesiod_free_list , --- 17 unchanged lines hidden (view full) --- 45.Sh DESCRIPTION 46This family of functions allows you to perform lookups of Hesiod 47information, which is stored as text records in the Domain Name 48Service. 49To perform lookups, you must first initialize a 50.Fa context , 51an opaque object which stores information used internally by the 52library between calls. | 21.Dd November 30, 1996 22.Dt HESIOD 3 23.Os 24.Sh NAME 25.Nm hesiod , 26.Nm hesiod_init , 27.Nm hesiod_resolve , 28.Nm hesiod_free_list , --- 17 unchanged lines hidden (view full) --- 46.Sh DESCRIPTION 47This family of functions allows you to perform lookups of Hesiod 48information, which is stored as text records in the Domain Name 49Service. 50To perform lookups, you must first initialize a 51.Fa context , 52an opaque object which stores information used internally by the 53library between calls. |
54The |
|
53.Fn hesiod_init | 55.Fn hesiod_init |
56function |
|
54initializes a context, storing a pointer to the context in the 55location pointed to by the 56.Fa context 57argument. | 57initializes a context, storing a pointer to the context in the 58location pointed to by the 59.Fa context 60argument. |
61The |
|
58.Fn hesiod_end | 62.Fn hesiod_end |
63function |
|
59frees the resources used by a context. 60.Pp | 64frees the resources used by a context. 65.Pp |
66The |
|
61.Fn hesiod_resolve | 67.Fn hesiod_resolve |
68function |
|
62is the primary interface to the library. 63If successful, it returns a 64list of one or more strings giving the records matching 65.Fa name 66and 67.Fa type . 68The last element of the list is followed by a 69.Dv NULL 70pointer. 71It is the 72caller's responsibility to call 73.Fn hesiod_free_list 74to free the resources used by the returned list. 75.Pp | 69is the primary interface to the library. 70If successful, it returns a 71list of one or more strings giving the records matching 72.Fa name 73and 74.Fa type . 75The last element of the list is followed by a 76.Dv NULL 77pointer. 78It is the 79caller's responsibility to call 80.Fn hesiod_free_list 81to free the resources used by the returned list. 82.Pp |
83The |
|
76.Fn hesiod_to_bind | 84.Fn hesiod_to_bind |
85function |
|
77converts 78.Fa name 79and 80.Fa type 81into the DNS name used by 82.Fn hesiod_resolve . 83It is the caller's responsibility to free the returned string using 84.Fn free . --- 27 unchanged lines hidden (view full) --- 112.Re 113.Sh ERRORS 114Hesiod calls may fail because of: 115.Bl -tag -width Er 116.It Bq Er ENOMEM 117Insufficient memory was available to carry out the requested 118operation. 119.It Bq Er ENOEXEC | 86converts 87.Fa name 88and 89.Fa type 90into the DNS name used by 91.Fn hesiod_resolve . 92It is the caller's responsibility to free the returned string using 93.Fn free . --- 27 unchanged lines hidden (view full) --- 121.Re 122.Sh ERRORS 123Hesiod calls may fail because of: 124.Bl -tag -width Er 125.It Bq Er ENOMEM 126Insufficient memory was available to carry out the requested 127operation. 128.It Bq Er ENOEXEC |
129The |
|
120.Fn hesiod_init | 130.Fn hesiod_init |
131function |
|
121failed because the Hesiod configuration file was invalid. 122.It Bq Er ECONNREFUSED | 132failed because the Hesiod configuration file was invalid. 133.It Bq Er ECONNREFUSED |
134The |
|
123.Fn hesiod_resolve | 135.Fn hesiod_resolve |
136function |
|
124failed because no name server could be contacted to answer the query. 125.It Bq Er EMSGSIZE | 137failed because no name server could be contacted to answer the query. 138.It Bq Er EMSGSIZE |
139The |
|
126.Fn hesiod_resolve 127or 128.Fn hesiod_to_bind | 140.Fn hesiod_resolve 141or 142.Fn hesiod_to_bind |
143function |
|
129failed because the query or response was too big to fit into the 130packet buffers. 131.It Bq Er ENOENT | 144failed because the query or response was too big to fit into the 145packet buffers. 146.It Bq Er ENOENT |
147The |
|
132.Fn hesiod_resolve | 148.Fn hesiod_resolve |
149function |
|
133failed because the name server had no text records matching 134.Fa name 135and 136.Fa type , 137or 138.Fn hesiod_to_bind 139failed because the 140.Fa name --- 19 unchanged lines hidden --- | 150failed because the name server had no text records matching 151.Fa name 152and 153.Fa type , 154or 155.Fn hesiod_to_bind 156failed because the 157.Fa name --- 19 unchanged lines hidden --- |