summaryrefslogtreecommitdiff
path: root/src/lib/libc/net/getrrsetbyname.3
diff options
context:
space:
mode:
authorjaredy <>2005-07-22 04:50:51 +0000
committerjaredy <>2005-07-22 04:50:51 +0000
commit3553ae132550867ea92f1c819130713a94c9aa57 (patch)
tree0fcccaffb7fe67c8d9c1f46e9831c994ceadc81a /src/lib/libc/net/getrrsetbyname.3
parentfca3e187a867f51bfd0b46cc4d3f49175ffddef6 (diff)
downloadopenbsd-3553ae132550867ea92f1c819130713a94c9aa57.tar.gz
openbsd-3553ae132550867ea92f1c819130713a94c9aa57.tar.bz2
openbsd-3553ae132550867ea92f1c819130713a94c9aa57.zip
- sync prototypes and header file excerpts
- typos/spelling, punctuation, rewording, macro, and layout fixes. help & ok jmc
Diffstat (limited to 'src/lib/libc/net/getrrsetbyname.3')
-rw-r--r--src/lib/libc/net/getrrsetbyname.353
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
33gets a set of resource records associated with a 34gets a set of resource records associated with a
34.Fa hostname , 35.Fa hostname ,
35.Fa rdclass 36.Fa rdclass ,
36and 37and
37.Fa rdtype . 38.Fa rdtype .
38.Fa hostname 39.Fa hostname
@@ -74,22 +75,22 @@ bit is set, the data has been DNSSEC
74validated and the signatures verified. 75validated and the signatures verified.
75.Pp 76.Pp
76The following structures are used: 77The following structures are used:
77.Bd -literal -offset 78.Bd -literal -offset indent
78struct rdatainfo { 79struct 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
83struct rrsetinfo { 84struct 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
112is a pointer to a 113is a pointer to a
113.Li struct rrset 114.Li struct rrsetinfo
114created by a call to 115created 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.
123returns zero on success, and one of the following error 124returns zero on success, and one of the following error
124codes if an error occurred: 125codes 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
128the name does not exist 129The name does not exist.
129.It Dv ERRSET_NODATA 130.It Bq Er ERRSET_NODATA
130the name exists, but does not have data of the desired type 131The name exists, but does not have data of the desired type.
131.It Dv ERRSET_NOMEMORY 132.It Bq Er ERRSET_NOMEMORY
132memory could not be allocated 133Memory could not be allocated.
133.It Dv ERRSET_INVAL 134.It Bq Er ERRSET_INVAL
134a parameter is invalid 135A parameter is invalid.
135.It Dv ERRSET_FAIL 136.It Bq Er ERRSET_FAIL
136other failure 137Other failure.
137.El 138.El
138.Sh SEE ALSO 139.Sh SEE ALSO
139.Xr resolver 3 , 140.Xr resolver 3 ,