Subversion Repositories

?revision_form?Rev ?revision_input??revision_submit??revision_endform?

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
3 magnus 1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
<html><head>
3
<title>liboop: oop_adns_new(), oop_adns_delete()</title>
4
<link rel="stylesheet" type="text/css" href="style.css">
5
</head><body>
6
 
7
<h2>oop_adns_new(), oop_adns_delete()</h2>
8
 
9
<pre>
10
#include &lt;oop.h&gt;
11
#include &lt;adns.h&gt;
12
#include &lt;oop-adns.h&gt;
13
 
14
oop_adapter_adns *oop_adns_new(oop_source *source,adns_initflags flags,FILE *diag);
15
void oop_adns_delete(oop_adapter_adns *adapter);
16
</pre>
17
 
18
<h3>Arguments.</h3>
19
 
20
<dl>
21
<dt><b>oop_source *source</b>
22
<dd>The event source to use.  The adapter will use this event source to wait
23
asynchronously for network communication.<p>
24
 
25
<dt><b>adns_initflags flags</b>
26
<dd>Any initialization flags used to create the instance of adns.  Refer to the
27
adns documentation for details.<p>
28
 
29
<dt><b>FILE *diag</b>
30
<dd>The file to send adns diagnostics to.  Refer to the adns documentation for
31
details.<p>
32
 
33
<dt><b>oop_adapter_adns *adapter</b>
34
<dd>An adns adapter to delete, with no outstanding
35
<a href="oop_adns_query">queries</a>.<p>
36
</dl>
37
 
38
<h3>Description.</h3>
39
 
40
<dl>
41
<dt><b>oop_adns_new</b>
42
<dd>Create a new liboop adns adapter.  This adapter manages an instance of
43
<a href="http://www.chiark.greenend.org.uk/~ian/adns/">Ian Jackson's
44
asychronous DNS resolver</a> and supplies it with events from <em>source</em>.
45
The adns instance is initialized with the supplied <em>flags</em> and
46
<em>diag</em> file; refer to the adns documentation for details.<p>
47
 
48
If a malloc failure or other catastrophic system error occurs creating the
49
adapter, NULL is returned.  The caller must handle this failure.<p>
50
 
51
<dt><b>oop_adns_delete</b>
52
<dd>Destroy the liboop adns adapter <em>adns</em>.  This frees all resources
53
associated with the adapter, including the underlying adns instance.  Any
54
callbacks registered with the event source are cancelled.  The adapter can have
55
no active queries when it is deleted.<p>
56
</dl>
57
 
58
<hr><a href="ref">liboop reference</a></body></html>