<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>unbound: libunbound/libworker.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css">
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.9 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="dir_fc3ea7a5a61a7a52c4b5d946cda53628.html">libunbound</a>
</div>
</div>
<div class="contents">
<h1>libworker.h File Reference</h1>This file contains the <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a> process or thread that performs the DNS resolving and validation.
<a href="#_details">More...</a>
<p>
<code>#include "<a class="el" href="packed__rrset_8h.html">util/data/packed_rrset.h</a>"</code><br>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Data Structures</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structlibworker.html">libworker</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The library-worker status structure Internal to the <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a>. <a href="structlibworker.html#_details">More...</a><br></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#043cb9cb1943b252294adea13f95dfdd">libworker_bg</a> (struct <a class="el" href="structub__ctx.html">ub_ctx</a> *ctx)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a background <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a>. <a href="#043cb9cb1943b252294adea13f95dfdd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#05441bdab608422642eceec49c92ea1f">libworker_fg</a> (struct <a class="el" href="structub__ctx.html">ub_ctx</a> *ctx, struct <a class="el" href="structctx__query.html">ctx_query</a> *q)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a foreground <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a>. <a href="#05441bdab608422642eceec49c92ea1f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5d6d524647ca7044d24917586fbb6bb1"></a><!-- doxytag: member="libworker.h::libworker_alloc_cleanup" ref="5d6d524647ca7044d24917586fbb6bb1" args="(void *arg)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#5d6d524647ca7044d24917586fbb6bb1">libworker_alloc_cleanup</a> (void *arg)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">cleanup the cache to remove all rrset IDs from it, arg is <a class="el" href="structlibworker.html" title="The library-worker status structure Internal to the worker.">libworker</a> <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#89bbf813f6ca06398f65f38c39cf4d0e">libworker_send_packet</a> (ldns_buffer *pkt, struct sockaddr_storage *addr, socklen_t addrlen, int timeout, struct <a class="el" href="structmodule__qstate.html">module_qstate</a> *q, int use_tcp)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Worker service routine to send udp messages for modules. <a href="#89bbf813f6ca06398f65f38c39cf4d0e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">struct <a class="el" href="structoutbound__entry.html">outbound_entry</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#b24e8e1d8bd73e2450110d278a274383">libworker_send_query</a> (uint8_t *qname, size_t qnamelen, uint16_t qtype, uint16_t qclass, uint16_t flags, int dnssec, struct sockaddr_storage *addr, socklen_t addrlen, struct <a class="el" href="structmodule__qstate.html">module_qstate</a> *q)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Worker service routine to send serviced queries to authoritative servers. <a href="#b24e8e1d8bd73e2450110d278a274383"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="deeeb1bfacd3fb0769af71c6789ed01c"></a><!-- doxytag: member="libworker.h::libworker_handle_reply" ref="deeeb1bfacd3fb0769af71c6789ed01c" args="(struct comm_point *c, void *arg, int error, struct comm_reply *reply_info)" -->
int </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#deeeb1bfacd3fb0769af71c6789ed01c">libworker_handle_reply</a> (struct <a class="el" href="structcomm__point.html">comm_point</a> *c, void *arg, int error, struct <a class="el" href="structcomm__reply.html">comm_reply</a> *<a class="el" href="structreply__info.html">reply_info</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">process incoming replies from the network <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6359e59371e5a36aa61bdceaa758b39b"></a><!-- doxytag: member="libworker.h::libworker_handle_service_reply" ref="6359e59371e5a36aa61bdceaa758b39b" args="(struct comm_point *c, void *arg, int error, struct comm_reply *reply_info)" -->
int </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#6359e59371e5a36aa61bdceaa758b39b">libworker_handle_service_reply</a> (struct <a class="el" href="structcomm__point.html">comm_point</a> *c, void *arg, int error, struct <a class="el" href="structcomm__reply.html">comm_reply</a> *<a class="el" href="structreply__info.html">reply_info</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">process incoming serviced query replies from the network <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="06f43db817a42f6530a6d770d911d22b"></a><!-- doxytag: member="libworker.h::libworker_handle_control_cmd" ref="06f43db817a42f6530a6d770d911d22b" args="(struct tube *tube, uint8_t *msg, size_t len, int err, void *arg)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#06f43db817a42f6530a6d770d911d22b">libworker_handle_control_cmd</a> (struct <a class="el" href="structtube.html">tube</a> *<a class="el" href="structtube.html">tube</a>, uint8_t *msg, size_t len, int err, void *arg)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">handle control command coming into server <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2e3623e89434f9cafac0ca4b7b66559e"></a><!-- doxytag: member="libworker.h::libworker_handle_result_write" ref="2e3623e89434f9cafac0ca4b7b66559e" args="(struct tube *tube, uint8_t *msg, size_t len, int err, void *arg)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#2e3623e89434f9cafac0ca4b7b66559e">libworker_handle_result_write</a> (struct <a class="el" href="structtube.html">tube</a> *<a class="el" href="structtube.html">tube</a>, uint8_t *msg, size_t len, int err, void *arg)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">handle opportunity to write result back <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="93c5911c6d2fee65de98783486087607"></a><!-- doxytag: member="libworker.h::libworker_fg_done_cb" ref="93c5911c6d2fee65de98783486087607" args="(void *arg, int rcode, ldns_buffer *buf, enum sec_status s)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#93c5911c6d2fee65de98783486087607">libworker_fg_done_cb</a> (void *arg, int rcode, ldns_buffer *buf, enum <a class="el" href="packed__rrset_8h.html#ecbbb9607758922722abc9a49d1097bb">sec_status</a> s)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">mesh callback with fg results <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="054233c7ba5bd6406025b89c6049fc50"></a><!-- doxytag: member="libworker.h::libworker_bg_done_cb" ref="054233c7ba5bd6406025b89c6049fc50" args="(void *arg, int rcode, ldns_buffer *buf, enum sec_status s)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#054233c7ba5bd6406025b89c6049fc50">libworker_bg_done_cb</a> (void *arg, int rcode, ldns_buffer *buf, enum <a class="el" href="packed__rrset_8h.html#ecbbb9607758922722abc9a49d1097bb">sec_status</a> s)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">mesh callback with bg results <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="libworker_8h.html#c911a724c35844e64d0e823476087bff">libworker_enter_result</a> (struct <a class="el" href="structub__result.html">ub_result</a> *res, ldns_buffer *buf, struct <a class="el" href="structregional.html">regional</a> *temp, enum <a class="el" href="packed__rrset_8h.html#ecbbb9607758922722abc9a49d1097bb">sec_status</a> msg_security)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">fill result from parsed message, on error fills servfail <a href="#c911a724c35844e64d0e823476087bff"></a><br></td></tr>
</table>
<hr><h2>Detailed Description</h2>
This file contains the <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a> process or thread that performs the DNS resolving and validation.
<p>
The <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a> is called by a procedure and if in the background continues until exit, if in the foreground returns from the procedure when done. <hr><h2>Function Documentation</h2>
<a class="anchor" name="043cb9cb1943b252294adea13f95dfdd"></a><!-- doxytag: member="libworker.h::libworker_bg" ref="043cb9cb1943b252294adea13f95dfdd" args="(struct ub_ctx *ctx)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int libworker_bg </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structub__ctx.html">ub_ctx</a> * </td>
<td class="paramname"> <em>ctx</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a background <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a>.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>ctx,:</em> </td><td>is updated with pid/tid of the background <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a>. a new allocation cache is obtained from ctx. It contains the threadnumber and unique id for further (shared) cache insertions. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 if OK, else error. Further communication is done via the pipes in ctx. </dd></dl>
<p>References <a class="el" href="context_8h_source.html#l00083">ub_ctx::bg_pid</a>, <a class="el" href="context_8h_source.html#l00085">ub_ctx::bg_tid</a>, <a class="el" href="context_8h_source.html#l00072">ub_ctx::cfglock</a>, <a class="el" href="context_8h_source.html#l00088">ub_ctx::dothread</a>, <a class="el" href="log_8c_source.html#l00267">fatal_exit()</a>, <a class="el" href="libworker_8h_source.html#l00074">libworker::is_bg_thread</a>, <a class="el" href="libworker_8c_source.html#l00257">libworker_dobg()</a>, <a class="el" href="libworker_8c_source.html#l00092">libworker_setup()</a>, <a class="el" href="context_8h_source.html#l00064">ub_ctx::qq_pipe</a>, <a class="el" href="context_8h_source.html#l00068">ub_ctx::rr_pipe</a>, <a class="el" href="libworker_8h_source.html#l00067">libworker::thread_num</a>, <a class="el" href="tube_8c_source.html#l00094">tube_close_read()</a>, <a class="el" href="tube_8c_source.html#l00102">tube_close_write()</a>, <a class="el" href="context_8h_source.html#l00179">UB_FORKFAIL</a>, <a class="el" href="context_8h_source.html#l00168">UB_NOERROR</a>, and <a class="el" href="context_8h_source.html#l00173">UB_NOMEM</a>.</p>
<p>Referenced by <a class="el" href="libunbound_8c_source.html#l00572">ub_resolve_async()</a>.</p>
</div>
</div><p>
<a class="anchor" name="05441bdab608422642eceec49c92ea1f"></a><!-- doxytag: member="libworker.h::libworker_fg" ref="05441bdab608422642eceec49c92ea1f" args="(struct ub_ctx *ctx, struct ctx_query *q)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int libworker_fg </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structub__ctx.html">ub_ctx</a> * </td>
<td class="paramname"> <em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct <a class="el" href="structctx__query.html">ctx_query</a> * </td>
<td class="paramname"> <em>q</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a foreground <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a>.
<p>
This <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a> will join the threadpool of resolver threads. It exits when the query answer has been obtained (or error). This routine blocks until the <a class="el" href="structworker.html" title="Structure holding working information for unbound.">worker</a> is finished. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>ctx,:</em> </td><td>new allocation cache obtained and returned to it. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>q,:</em> </td><td>query (result is stored in here). </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 if finished OK, else error. </dd></dl>
<p>References <a class="el" href="libworker_8h_source.html#l00081">libworker::back</a>, <a class="el" href="libworker_8h_source.html#l00079">libworker::base</a>, <a class="el" href="net__help_8h_source.html#l00062">BIT_RD</a>, <a class="el" href="fake__event_8c_source.html#l00641">comm_base_dispatch()</a>, <a class="el" href="libworker_8h_source.html#l00077">libworker::env</a>, <a class="el" href="libworker_8c_source.html#l00071">libworker_delete()</a>, <a class="el" href="worker_8c_source.html#l01251">libworker_fg_done_cb()</a>, <a class="el" href="libworker_8c_source.html#l00439">libworker_fillup_fg()</a>, <a class="el" href="libworker_8c_source.html#l00092">libworker_setup()</a>, <a class="el" href="context_8h_source.html#l00110">ub_ctx::local_zones</a>, <a class="el" href="localzone_8c_source.html#l01115">local_zones_answer()</a>, <a class="el" href="module_8h_source.html#l00192">module_env::mesh</a>, <a class="el" href="mesh_8c_source.html#l00344">mesh_new_callback()</a>, <a class="el" href="msgreply_8h_source.html#l00064">query_info::qname</a>, <a class="el" href="module_8h_source.html#l00186">module_env::scratch</a>, <a class="el" href="packed__rrset_8h_source.html#l00170">sec_status_insecure</a>, <a class="el" href="libworker_8c_source.html#l00473">setup_qinfo_edns()</a>, <a class="el" href="context_8h_source.html#l00183">UB_INITFAIL</a>, <a class="el" href="context_8h_source.html#l00168">UB_NOERROR</a>, <a class="el" href="context_8h_source.html#l00173">UB_NOMEM</a>, <a class="el" href="context_8h_source.html#l00175">UB_SYNTAX</a>, <a class="el" href="outside__network_8h_source.html#l00072">outside_network::udp_buff</a>, and <a class="el" href="context_8h_source.html#l00156">ctx_query::w</a>.</p>
<p>Referenced by <a class="el" href="libunbound_8c_source.html#l00528">ub_resolve()</a>.</p>
</div>
</div><p>
<a class="anchor" name="89bbf813f6ca06398f65f38c39cf4d0e"></a><!-- doxytag: member="libworker.h::libworker_send_packet" ref="89bbf813f6ca06398f65f38c39cf4d0e" args="(ldns_buffer *pkt, struct sockaddr_storage *addr, socklen_t addrlen, int timeout, struct module_qstate *q, int use_tcp)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int libworker_send_packet </td>
<td>(</td>
<td class="paramtype">ldns_buffer * </td>
<td class="paramname"> <em>pkt</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct sockaddr_storage * </td>
<td class="paramname"> <em>addr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">socklen_t </td>
<td class="paramname"> <em>addrlen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>timeout</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct <a class="el" href="structmodule__qstate.html">module_qstate</a> * </td>
<td class="paramname"> <em>q</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>use_tcp</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Worker service routine to send udp messages for modules.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pkt,:</em> </td><td>packet to send. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>addr,:</em> </td><td>where to. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>addrlen,:</em> </td><td>length of addr. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>timeout,:</em> </td><td>seconds to wait until timeout. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>q,:</em> </td><td>wich query state to reactivate upon return. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>use_tcp,:</em> </td><td>true to use TCP, false for UDP. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>: false on failure (memory or socket related). no query was sent. </dd></dl>
<p>References <a class="el" href="libworker_8h_source.html#l00081">libworker::back</a>, <a class="el" href="module_8h_source.html#l00286">module_qstate::env</a>, <a class="el" href="worker_8c_source.html#l01228">libworker_handle_reply()</a>, <a class="el" href="log_8h_source.html#l00185">log_assert</a>, <a class="el" href="outside__network_8c_source.html#l00985">pending_tcp_query()</a>, <a class="el" href="outside__network_8c_source.html#l00902">pending_udp_query()</a>, and <a class="el" href="module_8h_source.html#l00190">module_env::worker</a>.</p>
<p>Referenced by <a class="el" href="fptr__wlist_8c_source.html#l00244">fptr_whitelist_modenv_send_packet()</a>, and <a class="el" href="libworker_8c_source.html#l00092">libworker_setup()</a>.</p>
</div>
</div><p>
<a class="anchor" name="b24e8e1d8bd73e2450110d278a274383"></a><!-- doxytag: member="libworker.h::libworker_send_query" ref="b24e8e1d8bd73e2450110d278a274383" args="(uint8_t *qname, size_t qnamelen, uint16_t qtype, uint16_t qclass, uint16_t flags, int dnssec, struct sockaddr_storage *addr, socklen_t addrlen, struct module_qstate *q)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">struct <a class="el" href="structoutbound__entry.html">outbound_entry</a>* libworker_send_query </td>
<td>(</td>
<td class="paramtype">uint8_t * </td>
<td class="paramname"> <em>qname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>qnamelen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t </td>
<td class="paramname"> <em>qtype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t </td>
<td class="paramname"> <em>qclass</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t </td>
<td class="paramname"> <em>flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>dnssec</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct sockaddr_storage * </td>
<td class="paramname"> <em>addr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">socklen_t </td>
<td class="paramname"> <em>addrlen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct <a class="el" href="structmodule__qstate.html">module_qstate</a> * </td>
<td class="paramname"> <em>q</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [read]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Worker service routine to send serviced queries to authoritative servers.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>qname,:</em> </td><td>query name. (host order) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>qnamelen,:</em> </td><td>length in bytes of qname, including trailing 0. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>qtype,:</em> </td><td>query type. (host order) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>qclass,:</em> </td><td>query class. (host order) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>flags,:</em> </td><td>host order flags word, with opcode and CD bit. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dnssec,:</em> </td><td>if set, EDNS record will have DO bit set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>addr,:</em> </td><td>where to. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>addrlen,:</em> </td><td>length of addr. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>q,:</em> </td><td>wich query state to reactivate upon return. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>: false on failure (memory or socket related). no query was sent. </dd></dl>
<p>References <a class="el" href="libworker_8h_source.html#l00081">libworker::back</a>, <a class="el" href="module_8h_source.html#l00286">module_qstate::env</a>, <a class="el" href="worker_8c_source.html#l01236">libworker_handle_service_reply()</a>, <a class="el" href="log_8h_source.html#l00185">log_assert</a>, <a class="el" href="libworker_8c_source.html#l00668">outbound_entry_compare()</a>, <a class="el" href="outside__network_8c_source.html#l01556">outnet_serviced_query()</a>, <a class="el" href="module_8h_source.html#l00277">module_qstate::region</a>, <a class="el" href="regional_8c_source.html#l00116">regional_alloc()</a>, <a class="el" href="outside__network_8h_source.html#l00072">outside_network::udp_buff</a>, and <a class="el" href="module_8h_source.html#l00190">module_env::worker</a>.</p>
<p>Referenced by <a class="el" href="fptr__wlist_8c_source.html#l00254">fptr_whitelist_modenv_send_query()</a>, and <a class="el" href="libworker_8c_source.html#l00092">libworker_setup()</a>.</p>
</div>
</div><p>
<a class="anchor" name="c911a724c35844e64d0e823476087bff"></a><!-- doxytag: member="libworker.h::libworker_enter_result" ref="c911a724c35844e64d0e823476087bff" args="(struct ub_result *res, ldns_buffer *buf, struct regional *temp, enum sec_status msg_security)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void libworker_enter_result </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structub__result.html">ub_result</a> * </td>
<td class="paramname"> <em>res</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">ldns_buffer * </td>
<td class="paramname"> <em>buf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct <a class="el" href="structregional.html">regional</a> * </td>
<td class="paramname"> <em>temp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">enum <a class="el" href="packed__rrset_8h.html#ecbbb9607758922722abc9a49d1097bb">sec_status</a> </td>
<td class="paramname"> <em>msg_security</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
fill result from parsed message, on error fills servfail
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>res,:</em> </td><td>is clear at start, filled in at end. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>buf,:</em> </td><td>contains DNS message. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>temp,:</em> </td><td>temporary buffer for parse. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>msg_security,:</em> </td><td>security status of the DNS message. On error, the res may contain a different status (out of memory is not secure, not bogus). </td></tr>
</table>
</dl>
<p>References <a class="el" href="unbound_8h_source.html#l00183">ub_result::bogus</a>, <a class="el" href="unbound_8h_source.html#l00124">ub_result::data</a>, <a class="el" href="libworker_8c_source.html#l00374">fill_res()</a>, <a class="el" href="msgreply_8h_source.html#l00099">reply_info::flags</a>, <a class="el" href="net__help_8h_source.html#l00070">FLAGS_GET_RCODE</a>, <a class="el" href="unbound_8h_source.html#l00153">ub_result::havedata</a>, <a class="el" href="log_8c_source.html#l00241">log_err()</a>, <a class="el" href="unbound_8h_source.html#l00160">ub_result::nxdomain</a>, <a class="el" href="libworker_8c_source.html#l00345">parse_reply()</a>, <a class="el" href="unbound_8h_source.html#l00140">ub_result::rcode</a>, <a class="el" href="msgreply_8c_source.html#l00697">reply_find_answer_rrset()</a>, <a class="el" href="msgreply_8c_source.html#l00676">reply_find_final_cname_target()</a>, <a class="el" href="packed__rrset_8h_source.html#l00162">sec_status_bogus</a>, <a class="el" href="packed__rrset_8h_source.html#l00173">sec_status_secure</a>, and <a class="el" href="unbound_8h_source.html#l00170">ub_result::secure</a>.</p>
<p>Referenced by <a class="el" href="libworker_8c_source.html#l00439">libworker_fillup_fg()</a>, and <a class="el" href="libunbound_8c_source.html#l00366">process_answer_detail()</a>.</p>
</div>
</div><p>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Tue Oct 13 06:46:31 2009 for unbound by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.9 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
550bbe86d83a7870fdddc73c68e5d2b2
>
files
>
188
