Debian Codegraph @

html/oop_adns.html

raw
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.html">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.html">liboop reference</a></body></html>