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 <oop.h> |
||
| 11 | #include <adns.h> |
||
| 12 | #include <oop-adns.h> |
||
| 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> |