Subversion Repositories

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

Rev 3 | Details | Compare with Previous | 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
12 magnus 35 
<a href="oop_adns_query.html">queries</a>.<p>
3 magnus 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 
 
12 magnus 58 
<hr><a href="ref.html">liboop reference</a></body></html>