<appendix label="D" id="SAMBA-AP-D">
<title>Summary of Samba Daemons and Commands</title>
<para>This appendix is a reference listing of command-line options and other information to help you use the executables that come with Samba distribution.</para>
<sect1 role="" label="D.1" id="appd-SECT-1">
<title>Samba Distribution Programs</title>
<para>The following sections provide information about the command-line parameters for Samba programs.</para>
<sect2 role="" label="D.1.1" id="appd-SECT-1.1">
<title>smbd</title>
<para>
<indexterm id="appd-idx-993627-0" class="startofrange"><primary>smbd daemon</primary></indexterm>
<indexterm id="appd-idx-993627-1" class="startofrange"><primary>daemons</primary></indexterm>The <emphasis>smbd</emphasis> program provides Samba's file and printer services, using one TCP/IP stream and one daemon per client. It is controlled from the default configuration file, <replaceable>samba_dir</replaceable><emphasis>/lib/smb.conf</emphasis>, and can be overridden by command-line options.</para>
<para>The configuration file is automatically re-evaluated every minute. If it has changed, most new options are immediately effective. You can force Samba to immediately reload the configuration file if you send a SIGHUP to <emphasis>smbd</emphasis>. Reloading the configuration file, however, will not affect any clients that are already connected. To escape this "grandfather" configuration, a client would need to disconnect and reconnect, or the server itself would have to be restarted, forcing all clients to reconnect.</para>
<sect3 role="" label="D.1.1.1" id="appd-SECT-1.1.1">
<title>Other signals</title>
<para>To shut down a <emphasis>smbd</emphasis> process, send it the termination signal SIGTERM (-15) which allows it to die gracefully instead of a SIGKILL (-9). To increment the debug logging level of <emphasis>smbd</emphasis> at runtime, send the program a SIGUSR1 signal. To decrement it at runtime, send the program a SIGUSR2 signal.</para>
</sect3>
<sect3 role="" label="D.1.1.2" id="appd-SECT-1.1.2">
<title>Command-line options</title>
<variablelist>
<varlistentry><term><literal>-D</literal></term>
<listitem><para>The <emphasis>smbd</emphasis> program is run as a daemon. This is the recommended way to use <emphasis>smbd</emphasis> (it is also the default action). In addition, <emphasis>smbd</emphasis> can also be run from <emphasis>inetd</emphasis>.</para></listitem>
</varlistentry>
<varlistentry><term><literal>-d</literal> <replaceable>debuglevel</replaceable></term>
<listitem><para>Sets the debug (sometimes called logging) level. The level can range from 0 all the way to 10. Specifying the value on the command line overrides the value specified in the <filename>smb.conf</filename> file. Debug level 0 logs only the most important messages; level 1 is normal; levels 3 and above are primarily for debugging and slow <emphasis>smbd</emphasis> considerably.</para></listitem>
</varlistentry>
<varlistentry><term><literal>-h</literal> </term>
<listitem><para>Prints command-line usage information for the <filename>smbd</filename> program.</para></listitem>
</varlistentry>
</variablelist>
</sect3>
<sect3 role="" label="D.1.1.3" id="appd-SECT-1.1.3">
<title>Testing/debugging options</title>
<variablelist>
<varlistentry><term><literal>-a</literal></term>
<listitem><para>If this is specified, e
| 