<!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: daemon/unbound.c 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_25e37f0a75013b615a5ba63405adf018.html">daemon</a> </div> </div> <div class="contents"> <h1>unbound.c File Reference</h1>Main program to start the DNS resolver <a class="el" href="structdaemon.html" title="Structure holding worker list.">daemon</a>. <a href="#_details">More...</a> <p> <code>#include "config.h"</code><br> <code>#include "<a class="el" href="log_8h.html">util/log.h</a>"</code><br> <code>#include "<a class="el" href="daemon_8h.html">daemon/daemon.h</a>"</code><br> <code>#include "<a class="el" href="remote_8h.html">daemon/remote.h</a>"</code><br> <code>#include "<a class="el" href="config__file_8h.html">util/config_file.h</a>"</code><br> <code>#include "<a class="el" href="slabhash_8h.html">util/storage/slabhash.h</a>"</code><br> <code>#include "<a class="el" href="listen__dnsport_8h.html">services/listen_dnsport.h</a>"</code><br> <code>#include "<a class="el" href="rrset_8h.html">services/cache/rrset.h</a>"</code><br> <code>#include "<a class="el" href="infra_8h.html">services/cache/infra.h</a>"</code><br> <code>#include "<a class="el" href="msgreply_8h.html">util/data/msgreply.h</a>"</code><br> <code>#include "<a class="el" href="module_8h.html">util/module.h</a>"</code><br> <code>#include <signal.h></code><br> <code>#include <fcntl.h></code><br> <code>#include <openssl/crypto.h></code><br> <code>#include <pwd.h></code><br> <code>#include <grp.h></code><br> <code>#include <sys/resource.h></code><br> <code>#include <event.h></code><br> <table border="0" cellpadding="0" cellspacing="0"> <tr><td></td></tr> <tr><td colspan="2"><br><h2>Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#64a6014565bb3e03294ec4a952d5add0">usage</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">print usage. <a href="#64a6014565bb3e03294ec4a952d5add0"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="0c71b78b0043e2efaed5ed186daafdf8"></a><!-- doxytag: member="unbound.c::checkrlimits" ref="0c71b78b0043e2efaed5ed186daafdf8" args="(struct config_file *cfg)" --> static void </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#0c71b78b0043e2efaed5ed186daafdf8">checkrlimits</a> (struct <a class="el" href="structconfig__file.html">config_file</a> *cfg)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">check file descriptor count <br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d155b92c4c4774fc115174b868b96adf"></a><!-- doxytag: member="unbound.c::apply_settings" ref="d155b92c4c4774fc115174b868b96adf" args="(struct daemon *daemon, struct config_file *cfg, int cmdline_verbose)" --> static void </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#d155b92c4c4774fc115174b868b96adf">apply_settings</a> (struct <a class="el" href="structdaemon.html">daemon</a> *<a class="el" href="structdaemon.html">daemon</a>, struct <a class="el" href="structconfig__file.html">config_file</a> *cfg, int cmdline_verbose)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">set verbosity, check rlimits, cache settings <br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">static pid_t </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#84609c02c719a7bd0ef6d06d611bc0cf">readpid</a> (const char *file)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Read existing pid from pidfile. <a href="#84609c02c719a7bd0ef6d06d611bc0cf"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#bf1bf30cf8c78b7dacff638fc1bce02e">writepid</a> (const char *pidfile, pid_t pid)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">write pid to file. <a href="#bf1bf30cf8c78b7dacff638fc1bce02e"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#42422301b8737f4f9dc1ac3ad2c82eb5">checkoldpid</a> (char *pidfile, int inchroot)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">check old pid file. <a href="#42422301b8737f4f9dc1ac3ad2c82eb5"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3488c7a154449c112199ce008e295602"></a><!-- doxytag: member="unbound.c::detach" ref="3488c7a154449c112199ce008e295602" args="(void)" --> static void </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#3488c7a154449c112199ce008e295602">detach</a> (void)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">detach from command line <br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="44a7d3ab66491b99d708b9511812a273"></a><!-- doxytag: member="unbound.c::perform_setup" ref="44a7d3ab66491b99d708b9511812a273" args="(struct daemon *daemon, struct config_file *cfg, int debug_mode, const char **cfgfile)" --> static void </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#44a7d3ab66491b99d708b9511812a273">perform_setup</a> (struct <a class="el" href="structdaemon.html">daemon</a> *<a class="el" href="structdaemon.html">daemon</a>, struct <a class="el" href="structconfig__file.html">config_file</a> *cfg, int debug_mode, const char **<a class="el" href="testbound_8c.html#90e3838491a7b92fdb154c9026326af5">cfgfile</a>)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">daemonize, drop user priviliges and chroot if needed <br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#986c023a68841f82998137ad3baced21">run_daemon</a> (const char *<a class="el" href="testbound_8c.html#90e3838491a7b92fdb154c9026326af5">cfgfile</a>, int cmdline_verbose, int debug_mode)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Run the <a class="el" href="structdaemon.html" title="Structure holding worker list.">daemon</a>. <a href="#986c023a68841f82998137ad3baced21"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#0ddf1224851353fc92bfbff6f499fa97">main</a> (int argc, char *argv[])</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">main program. <a href="#0ddf1224851353fc92bfbff6f499fa97"></a><br></td></tr> <tr><td colspan="2"><br><h2>Variables</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f90d73f93cb88ef8ae5eb14a5ec5064a"></a><!-- doxytag: member="unbound.c::unbound_start_brk" ref="f90d73f93cb88ef8ae5eb14a5ec5064a" args="" --> void * </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#f90d73f93cb88ef8ae5eb14a5ec5064a">unbound_start_brk</a> = 0</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">global debug value to keep track of heap memory allocation <br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#d5e1c16213bbee2d5e8cc363309f418c">optind</a></td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">getopt global, in case header files fail to declare it. <a href="#d5e1c16213bbee2d5e8cc363309f418c"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="unbound_8c.html#db50a0eab9fed92fc3bfc7dfa4f2c410">optarg</a></td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">getopt global, in case header files fail to declare it. <a href="#db50a0eab9fed92fc3bfc7dfa4f2c410"></a><br></td></tr> </table> <hr><h2>Detailed Description</h2> Main program to start the DNS resolver <a class="el" href="structdaemon.html" title="Structure holding worker list.">daemon</a>. <p> <hr><h2>Function Documentation</h2> <a class="anchor" name="64a6014565bb3e03294ec4a952d5add0"></a><!-- doxytag: member="unbound.c::usage" ref="64a6014565bb3e03294ec4a952d5add0" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">static void usage </td> <td>(</td> <td class="paramtype">void </td> <td class="paramname"> </td> <td> ) </td> <td><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p> print usage. <p> <p>References <a class="el" href="modstack_8c_source.html#l00114">module_list_avail()</a>.</p> <p>Referenced by <a class="el" href="unbound_8c_source.html#l00595">main()</a>.</p> </div> </div><p> <a class="anchor" name="84609c02c719a7bd0ef6d06d611bc0cf"></a><!-- doxytag: member="unbound.c::readpid" ref="84609c02c719a7bd0ef6d06d611bc0cf" args="(const char *file)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">static pid_t readpid </td> <td>(</td> <td class="paramtype">const char * </td> <td class="paramname"> <em>file</em> </td> <td> ) </td> <td><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Read existing pid from pidfile. <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>file,:</em> </td><td>file name of pid file. </td></tr> </table> </dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd>: the pid from the file or -1 if none. </dd></dl> <p>References <a class="el" href="log_8c_source.html#l00241">log_err()</a>.</p> <p>Referenced by <a class="el" href="unbound_8c_source.html#l00284">checkoldpid()</a>.</p> </div> </div><p> <a class="anchor" name="bf1bf30cf8c78b7dacff638fc1bce02e"></a><!-- doxytag: member="unbound.c::writepid" ref="bf1bf30cf8c78b7dacff638fc1bce02e" args="(const char *pidfile, pid_t pid)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">static void writepid </td> <td>(</td> <td class="paramtype">const char * </td> <td class="paramname"> <em>pidfile</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">pid_t </td> <td class="paramname"> <em>pid</em></td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p> write pid to file. <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>pidfile,:</em> </td><td>file name of pid file. </td></tr> <tr><td valign="top"></td><td valign="top"><em>pid,:</em> </td><td>pid to write to file. </td></tr> </table> </dl> <p>References <a class="el" href="log_8c_source.html#l00241">log_err()</a>.</p> <p>Referenced by <a class="el" href="unbound_8c_source.html#l00338">perform_setup()</a>.</p> </div> </div><p> <a class="anchor" name="42422301b8737f4f9dc1ac3ad2c82eb5"></a><!-- doxytag: member="unbound.c::checkoldpid" ref="42422301b8737f4f9dc1ac3ad2c82eb5" args="(char *pidfile, int inchroot)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">static void checkoldpid </td> <td>(</td> <td class="paramtype">char * </td> <td class="paramname"> <em>pidfile</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"> <em>inchroot</em></td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p> check old pid file. <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>pidfile,:</em> </td><td>the file name of the pid file. </td></tr> <tr><td valign="top"></td><td valign="top"><em>inchroot,:</em> </td><td>if pidfile is inchroot and we can thus expect to be able to delete it. </td></tr> </table> </dl> <p>References <a class="el" href="log_8c_source.html#l00254">log_warn()</a>, and <a class="el" href="unbound_8c_source.html#l00217">readpid()</a>.</p> <p>Referenced by <a class="el" href="unbound_8c_source.html#l00338">perform_setup()</a>.</p> </div> </div><p> <a class="anchor" name="986c023a68841f82998137ad3baced21"></a><!-- doxytag: member="unbound.c::run_daemon" ref="986c023a68841f82998137ad3baced21" args="(const char *cfgfile, int cmdline_verbose, int debug_mode)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">static void run_daemon </td> <td>(</td> <td class="paramtype">const char * </td> <td class="paramname"> <em>cfgfile</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"> <em>cmdline_verbose</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"> <em>debug_mode</em></td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Run the <a class="el" href="structdaemon.html" title="Structure holding worker list.">daemon</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>cfgfile,:</em> </td><td>the config file name. </td></tr> <tr><td valign="top"></td><td valign="top"><em>cmdline_verbose,:</em> </td><td>verbosity resulting from commandline -v. These increase verbosity as specified in the config file. </td></tr> <tr><td valign="top"></td><td valign="top"><em>debug_mode,:</em> </td><td>if set, do not daemonize. </td></tr> </table> </dl> <p>References <a class="el" href="unbound_8c_source.html#l00202">apply_settings()</a>, <a class="el" href="daemon_8h_source.html#l00070">daemon::chroot</a>, <a class="el" href="config__file_8h_source.html#l00162">config_file::chrootdir</a>, <a class="el" href="config__file_8c_source.html#l00069">config_create()</a>, <a class="el" href="config__file_8c_source.html#l00511">config_delete()</a>, <a class="el" href="config__file_8c_source.html#l00446">config_read()</a>, <a class="el" href="daemon_8c_source.html#l00448">daemon_cleanup()</a>, <a class="el" href="daemon_8c_source.html#l00475">daemon_delete()</a>, <a class="el" href="daemon_8c_source.html#l00397">daemon_fork()</a>, <a class="el" href="daemon_8c_source.html#l00147">daemon_init()</a>, <a class="el" href="daemon_8c_source.html#l00197">daemon_open_shared_ports()</a>, <a class="el" href="log_8c_source.html#l00267">fatal_exit()</a>, <a class="el" href="log_8c_source.html#l00081">log_init()</a>, <a class="el" href="log_8c_source.html#l00254">log_warn()</a>, <a class="el" href="config__file_8h_source.html#l00168">config_file::logfile</a>, <a class="el" href="daemon_8h_source.html#l00088">daemon::need_to_exit</a>, <a class="el" href="unbound_8c_source.html#l00338">perform_setup()</a>, <a class="el" href="daemon_8h_source.html#l00072">daemon::pidfile</a>, <a class="el" href="config__file_8h_source.html#l00173">config_file::use_syslog</a>, <a class="el" href="log_8h_source.html#l00058">VERB_ALGO</a>, <a class="el" href="log_8h_source.html#l00052">VERB_OPS</a>, and <a class="el" href="ldns-testpkts_8c.html#a557e5b23b2833d7c1ec0415a1bdd2b1">verbose()</a>.</p> <p>Referenced by <a class="el" href="unbound_8c_source.html#l00595">main()</a>.</p> </div> </div><p> <a class="anchor" name="0ddf1224851353fc92bfbff6f499fa97"></a><!-- doxytag: member="unbound.c::main" ref="0ddf1224851353fc92bfbff6f499fa97" args="(int argc, char *argv[])" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int main </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"> <em>argc</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">char * </td> <td class="paramname"> <em>argv</em>[]</td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td></td> </tr> </table> </div> <div class="memdoc"> <p> main program. <p> Set options given commandline arguments. <dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>argc,:</em> </td><td>number of commandline arguments. </td></tr> <tr><td valign="top"></td><td valign="top"><em>argv,:</em> </td><td>array of commandline arguments. </td></tr> </table> </dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd>: exit status of the program. </dd></dl> <p>References <a class="el" href="testbound_8c_source.html#l00058">cfgfile</a>, <a class="el" href="log_8c_source.html#l00267">fatal_exit()</a>, <a class="el" href="log_8c_source.html#l00081">log_init()</a>, <a class="el" href="unbound_8c.html#db50a0eab9fed92fc3bfc7dfa4f2c410">optarg</a>, <a class="el" href="unbound_8c.html#d5e1c16213bbee2d5e8cc363309f418c">optind</a>, <a class="el" href="unbound_8c_source.html#l00525">run_daemon()</a>, <a class="el" href="unbound_8c_source.html#l00086">unbound_start_brk</a>, <a class="el" href="unbound_8c_source.html#l00089">usage()</a>, <a class="el" href="log_8c_source.html#l00062">verbosity</a>, and <a class="el" href="testbound_8c_source.html#l00328">wsvc_command_option()</a>.</p> </div> </div><p> <hr><h2>Variable Documentation</h2> <a class="anchor" name="d5e1c16213bbee2d5e8cc363309f418c"></a><!-- doxytag: member="unbound.c::optind" ref="d5e1c16213bbee2d5e8cc363309f418c" args="" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int <a class="el" href="streamtcp_8c.html#d5e1c16213bbee2d5e8cc363309f418c">optind</a> </td> </tr> </table> </div> <div class="memdoc"> <p> getopt global, in case header files fail to declare it. <p> <p>Referenced by <a class="el" href="unbound_8c_source.html#l00595">main()</a>.</p> </div> </div><p> <a class="anchor" name="db50a0eab9fed92fc3bfc7dfa4f2c410"></a><!-- doxytag: member="unbound.c::optarg" ref="db50a0eab9fed92fc3bfc7dfa4f2c410" args="" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">char* <a class="el" href="streamtcp_8c.html#db50a0eab9fed92fc3bfc7dfa4f2c410">optarg</a> </td> </tr> </table> </div> <div class="memdoc"> <p> getopt global, in case header files fail to declare it. <p> <p>Referenced by <a class="el" href="unbound_8c_source.html#l00595">main()</a>.</p> </div> </div><p> </div> <hr size="1"><address style="text-align: right;"><small>Generated on Tue Oct 13 06:46:30 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>