diff options
author | aaron <> | 2000-12-24 00:31:00 +0000 |
---|---|---|
committer | aaron <> | 2000-12-24 00:31:00 +0000 |
commit | b11608439e707f8c7601b090028e530ea5a1e067 (patch) | |
tree | 966934b4f9368fd14deca5be22b83ff9fb439cbd /src/lib/libc/net/resolver.3 | |
parent | 71213d0b131a3545184a31aa671f269eceacad1e (diff) | |
download | openbsd-b11608439e707f8c7601b090028e530ea5a1e067.tar.gz openbsd-b11608439e707f8c7601b090028e530ea5a1e067.tar.bz2 openbsd-b11608439e707f8c7601b090028e530ea5a1e067.zip |
Various repairs, mostly to get rid of short lines.
Diffstat (limited to 'src/lib/libc/net/resolver.3')
-rw-r--r-- | src/lib/libc/net/resolver.3 | 43 |
1 files changed, 15 insertions, 28 deletions
diff --git a/src/lib/libc/net/resolver.3 b/src/lib/libc/net/resolver.3 index 9b2471d823..a5f956f90d 100644 --- a/src/lib/libc/net/resolver.3 +++ b/src/lib/libc/net/resolver.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: resolver.3,v 1.13 2000/01/03 11:51:08 itojun Exp $ | 1 | .\" $OpenBSD: resolver.3,v 1.14 2000/12/24 00:30:57 aaron Exp $ |
2 | .\" | 2 | .\" |
3 | .\" Copyright (c) 1985, 1991, 1993 | 3 | .\" Copyright (c) 1985, 1991, 1993 |
4 | .\" The Regents of the University of California. All rights reserved. | 4 | .\" The Regents of the University of California. All rights reserved. |
@@ -108,8 +108,7 @@ Global configuration and state information that is used by the | |||
108 | resolver routines is kept in the structure | 108 | resolver routines is kept in the structure |
109 | .Li _res . | 109 | .Li _res . |
110 | Most of the values have reasonable defaults and can be ignored. | 110 | Most of the values have reasonable defaults and can be ignored. |
111 | Options | 111 | Options stored in |
112 | stored in | ||
113 | .Li _res.options | 112 | .Li _res.options |
114 | are defined in | 113 | are defined in |
115 | .Aq Pa resolv.h | 114 | .Aq Pa resolv.h |
@@ -142,8 +141,7 @@ Used with | |||
142 | .Dv RES_USEVC | 141 | .Dv RES_USEVC |
143 | to keep the | 142 | to keep the |
144 | .Tn TCP | 143 | .Tn TCP |
145 | connection open between | 144 | connection open between queries. |
146 | queries. | ||
147 | This is useful only in programs that regularly do many queries. | 145 | This is useful only in programs that regularly do many queries. |
148 | .Tn UDP | 146 | .Tn UDP |
149 | should be the normal mode used. | 147 | should be the normal mode used. |
@@ -180,12 +178,10 @@ The option is not meaningful on | |||
180 | .Pp | 178 | .Pp |
181 | The | 179 | The |
182 | .Fn res_init | 180 | .Fn res_init |
183 | routine | 181 | routine reads the configuration file (if any; see |
184 | reads the configuration file (if any; see | ||
185 | .Xr resolv.conf 5 ) | 182 | .Xr resolv.conf 5 ) |
186 | to get the default domain name, | 183 | to get the default domain name, search list, and the Internet address |
187 | search list and | 184 | of the local name server(s). |
188 | the Internet address of the local name server(s). | ||
189 | If no server is configured, the host running | 185 | If no server is configured, the host running |
190 | the resolver is tried. | 186 | the resolver is tried. |
191 | The current domain name is defined by the hostname | 187 | The current domain name is defined by the hostname |
@@ -235,8 +231,7 @@ The | |||
235 | .Fn res_search | 231 | .Fn res_search |
236 | routine makes a query and awaits a response like | 232 | routine makes a query and awaits a response like |
237 | .Fn res_query , | 233 | .Fn res_query , |
238 | but in addition, it implements the default and search rules | 234 | but in addition, it implements the default and search rules controlled by the |
239 | controlled by the | ||
240 | .Dv RES_DEFNAMES | 235 | .Dv RES_DEFNAMES |
241 | and | 236 | and |
242 | .Dv RES_DNSRCH | 237 | .Dv RES_DNSRCH |
@@ -247,11 +242,9 @@ The remaining routines are lower-level routines used by | |||
247 | .Fn res_query . | 242 | .Fn res_query . |
248 | The | 243 | The |
249 | .Fn res_mkquery | 244 | .Fn res_mkquery |
250 | function | 245 | function constructs a standard query message and places it in |
251 | constructs a standard query message and places it in | ||
252 | .Fa buf . | 246 | .Fa buf . |
253 | It returns the size of the query, or \-1 if the query is | 247 | It returns the size of the query, or \-1 if the query is larger than |
254 | larger than | ||
255 | .Fa buflen . | 248 | .Fa buflen . |
256 | The query type | 249 | The query type |
257 | .Fa op | 250 | .Fa op |
@@ -266,21 +259,18 @@ is currently unused but is intended for making update messages. | |||
266 | .Pp | 259 | .Pp |
267 | The | 260 | The |
268 | .Fn res_send | 261 | .Fn res_send |
269 | routine | 262 | routine sends a pre-formatted query and returns an answer. |
270 | sends a pre-formatted query and returns an answer. | ||
271 | It will call | 263 | It will call |
272 | .Fn res_init | 264 | .Fn res_init |
273 | if | 265 | if |
274 | .Dv RES_INIT | 266 | .Dv RES_INIT |
275 | is not set, send the query to the local name server, and | 267 | is not set, send the query to the local name server, and |
276 | handle timeouts and retries. | 268 | handle timeouts and retries. |
277 | The length of the reply message is returned, or | 269 | The length of the reply message is returned, or \-1 if there were errors. |
278 | \-1 if there were errors. | ||
279 | .Pp | 270 | .Pp |
280 | The | 271 | The |
281 | .Fn dn_comp | 272 | .Fn dn_comp |
282 | function | 273 | function compresses the domain name |
283 | compresses the domain name | ||
284 | .Fa exp_dn | 274 | .Fa exp_dn |
285 | and stores it in | 275 | and stores it in |
286 | .Fa comp_dn . | 276 | .Fa comp_dn . |
@@ -289,8 +279,7 @@ The size of the array pointed to by | |||
289 | .Fa comp_dn | 279 | .Fa comp_dn |
290 | is given by | 280 | is given by |
291 | .Fa length . | 281 | .Fa length . |
292 | The compression uses | 282 | The compression uses an array of pointers |
293 | an array of pointers | ||
294 | .Fa dnptrs | 283 | .Fa dnptrs |
295 | to previously compressed names in the current message. | 284 | to previously compressed names in the current message. |
296 | The first pointer points | 285 | The first pointer points |
@@ -300,8 +289,7 @@ The limit to the array is specified by | |||
300 | .Fa lastdnptr . | 289 | .Fa lastdnptr . |
301 | A side effect of | 290 | A side effect of |
302 | .Fn dn_comp | 291 | .Fn dn_comp |
303 | is to update the list of pointers for | 292 | is to update the list of pointers for labels inserted into the message |
304 | labels inserted into the message | ||
305 | as the name is compressed. | 293 | as the name is compressed. |
306 | If | 294 | If |
307 | .Em dnptr | 295 | .Em dnptr |
@@ -316,8 +304,7 @@ the list of labels is not updated. | |||
316 | .Pp | 304 | .Pp |
317 | The | 305 | The |
318 | .Fn dn_expand | 306 | .Fn dn_expand |
319 | entry | 307 | entry expands the compressed domain name |
320 | expands the compressed domain name | ||
321 | .Fa comp_dn | 308 | .Fa comp_dn |
322 | to a full domain name | 309 | to a full domain name |
323 | The compressed name is contained in a query or reply message; | 310 | The compressed name is contained in a query or reply message; |