diff options
Diffstat (limited to 'src/lib/libc/net/getrrsetbyname.3')
-rw-r--r-- | src/lib/libc/net/getrrsetbyname.3 | 53 |
1 files changed, 27 insertions, 26 deletions
diff --git a/src/lib/libc/net/getrrsetbyname.3 b/src/lib/libc/net/getrrsetbyname.3 index 621ff31b81..c951f905ab 100644 --- a/src/lib/libc/net/getrrsetbyname.3 +++ b/src/lib/libc/net/getrrsetbyname.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: getrrsetbyname.3,v 1.13 2005/02/25 03:12:43 cloder Exp $ | 1 | .\" $OpenBSD: getrrsetbyname.3,v 1.14 2005/07/22 04:50:51 jaredy Exp $ |
2 | .\" | 2 | .\" |
3 | .\" Copyright (C) 2000, 2001 Internet Software Consortium. | 3 | .\" Copyright (C) 2000, 2001 Internet Software Consortium. |
4 | .\" | 4 | .\" |
@@ -19,6 +19,7 @@ | |||
19 | .Dt GETRRSETBYNAME 3 | 19 | .Dt GETRRSETBYNAME 3 |
20 | .Os | 20 | .Os |
21 | .Sh NAME | 21 | .Sh NAME |
22 | .Nm freerrset , | ||
22 | .Nm getrrsetbyname | 23 | .Nm getrrsetbyname |
23 | .Nd retrieve DNS records | 24 | .Nd retrieve DNS records |
24 | .Sh SYNOPSIS | 25 | .Sh SYNOPSIS |
@@ -32,7 +33,7 @@ | |||
32 | .Fn getrrsetbyname | 33 | .Fn getrrsetbyname |
33 | gets a set of resource records associated with a | 34 | gets a set of resource records associated with a |
34 | .Fa hostname , | 35 | .Fa hostname , |
35 | .Fa rdclass | 36 | .Fa rdclass , |
36 | and | 37 | and |
37 | .Fa rdtype . | 38 | .Fa rdtype . |
38 | .Fa hostname | 39 | .Fa hostname |
@@ -74,22 +75,22 @@ bit is set, the data has been DNSSEC | |||
74 | validated and the signatures verified. | 75 | validated and the signatures verified. |
75 | .Pp | 76 | .Pp |
76 | The following structures are used: | 77 | The following structures are used: |
77 | .Bd -literal -offset | 78 | .Bd -literal -offset indent |
78 | struct rdatainfo { | 79 | struct rdatainfo { |
79 | unsigned int rdi_length; /* length of data */ | 80 | unsigned int rdi_length; /* length of data */ |
80 | unsigned char *rdi_data; /* record data */ | 81 | unsigned char *rdi_data; /* record data */ |
81 | }; | 82 | }; |
82 | 83 | ||
83 | struct rrsetinfo { | 84 | struct rrsetinfo { |
84 | unsigned int rri_flags; /* RRSET_VALIDATED ... */ | 85 | unsigned int rri_flags; /* RRSET_VALIDATED ... */ |
85 | unsigned int rri_rdclass; /* class number */ | 86 | unsigned int rri_rdclass; /* class number */ |
86 | unsigned int rri_rdtype; /* RR type number */ | 87 | unsigned int rri_rdtype; /* RR type number */ |
87 | unsigned int rri_ttl; /* time to live */ | 88 | unsigned int rri_ttl; /* time to live */ |
88 | unsigned int rri_nrdatas; /* size of rdatas array */ | 89 | unsigned int rri_nrdatas; /* size of rdatas array */ |
89 | unsigned int rri_nsigs; /* size of sigs array */ | 90 | unsigned int rri_nsigs; /* size of sigs array */ |
90 | char *rri_name; /* canonical name */ | 91 | char *rri_name; /* canonical name */ |
91 | struct rdatainfo *rri_rdatas; /* individual records */ | 92 | struct rdatainfo *rri_rdatas; /* individual records */ |
92 | struct rdatainfo *rri_sigs; /* individual signatures */ | 93 | struct rdatainfo *rri_sigs; /* individual signatures */ |
93 | }; | 94 | }; |
94 | .Ed | 95 | .Ed |
95 | .Pp | 96 | .Pp |
@@ -110,7 +111,7 @@ is released by | |||
110 | .Fn freerrset . | 111 | .Fn freerrset . |
111 | .Li rrset | 112 | .Li rrset |
112 | is a pointer to a | 113 | is a pointer to a |
113 | .Li struct rrset | 114 | .Li struct rrsetinfo |
114 | created by a call to | 115 | created by a call to |
115 | .Fn getrrsetbyname . | 116 | .Fn getrrsetbyname . |
116 | .Pp | 117 | .Pp |
@@ -123,17 +124,17 @@ will request DNSSEC authentication using the EDNS0 DNSSEC OK (DO) bit. | |||
123 | returns zero on success, and one of the following error | 124 | returns zero on success, and one of the following error |
124 | codes if an error occurred: | 125 | codes if an error occurred: |
125 | .Pp | 126 | .Pp |
126 | .Bl -tag -width ERRSET_NOMEMORY -compact | 127 | .Bl -tag -width ERRSET_NOMEMORY |
127 | .It Dv ERRSET_NONAME | 128 | .It Bq Er ERRSET_NONAME |
128 | the name does not exist | 129 | The name does not exist. |
129 | .It Dv ERRSET_NODATA | 130 | .It Bq Er ERRSET_NODATA |
130 | the name exists, but does not have data of the desired type | 131 | The name exists, but does not have data of the desired type. |
131 | .It Dv ERRSET_NOMEMORY | 132 | .It Bq Er ERRSET_NOMEMORY |
132 | memory could not be allocated | 133 | Memory could not be allocated. |
133 | .It Dv ERRSET_INVAL | 134 | .It Bq Er ERRSET_INVAL |
134 | a parameter is invalid | 135 | A parameter is invalid. |
135 | .It Dv ERRSET_FAIL | 136 | .It Bq Er ERRSET_FAIL |
136 | other failure | 137 | Other failure. |
137 | .El | 138 | .El |
138 | .Sh SEE ALSO | 139 | .Sh SEE ALSO |
139 | .Xr resolver 3 , | 140 | .Xr resolver 3 , |