source/smbd/smbd.8.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
   3 <refentry id="smbd.8">
   4
   5 <refmeta>
   6         <refentrytitle>smbd</refentrytitle>
   7         <manvolnum>8</manvolnum>
   8 </refmeta>
   9
  10
  11 <refnamediv>
  12         <refname>smbd</refname>
  13         <refpurpose>server to provide filesharing- and directory services to clients</refpurpose>
  14 </refnamediv>
  15
  16 <refsynopsisdiv>
  17         <cmdsynopsis>
  18                 <command>smbd</command>
  19                 <arg choice="opt">-i</arg>
  20                 <arg choice="opt">-M model</arg>
  21         </cmdsynopsis>
  22 </refsynopsisdiv>
  23
  24 <refsect1>
  25         <title>DESCRIPTION</title>
  26         <para>This program is part of the <citerefentry><refentrytitle>samba</refentrytitle>
  27         <manvolnum>7</manvolnum></citerefentry> suite.</para>
  28
  29         <para><command>smbd</command> is the server daemon that
  30         provides filesharing and directory services to Windows clients.
  31         The server provides filespace and directory services to
  32         clients using the SMB (or CIFS) protocol and other
  33         related protocols such as DCE/RPC, LDAP and Kerberos.
  34         </para>
  35
  36         <para>
  37         Clients supported include MSCLIENT 3.0 for DOS, Windows for
  38         Workgroups, Windows 95/98/ME, Windows NT, Windows 2000/XP/2003,
  39         OS/2, DAVE for Macintosh, and cifsfs for Linux.</para>
  40
  41         <para>An extensive description of the services that the
  42         server can provide is given in the man page for the
  43         configuration file controlling the attributes of those
  44         services (see <citerefentry><refentrytitle>smb.conf</refentrytitle>
  45         <manvolnum>5</manvolnum></citerefentry>.  This man page will not describe the
  46         services, but will concentrate on the administrative aspects
  47         of running the server.</para>
  48
  49         <para>Please note that there are significant security
  50         implications to running this server, and the <citerefentry><refentrytitle>smb.conf</refentrytitle>
  51         <manvolnum>5</manvolnum></citerefentry> manual page should be regarded as mandatory reading before
  52         proceeding with installation.</para>
  53
  54         <para>As of Samba 4, smbd also incorporates all the functionality of
  55         nmbd.</para>
  56
  57 </refsect1>
  58
  59 <refsect1>
  60         <title>OPTIONS</title>
  61
  62         <variablelist>
  63                 <varlistentry>
  64                 <term>-i</term>
  65                 <listitem><para>If this parameter is specified it causes the
  66                 server to run "interactively", not as a daemon, even if the
  67                 server is executed on the command line of a shell. Setting this
  68                 parameter negates the implicit deamon mode when run from the
  69                 command line. <command>smbd</command> also logs to standard
  70                 output, as if the <command>-S</command> parameter had been
  71                 given.
  72                 </para></listitem>
  73                 </varlistentry>
  74
  75                 <varlistentry>
  76                 <term>-M model</term>
  77                 <listitem><para>This parameter can be used to specify the
  78                 &quot;process model&quot; smbd should use. This determines
  79                 how concurrent clients are handled. Available process
  80                 models include <emphasis>single</emphasis> (everything in
  81                 a single process), <emphasis>standard</emphasis> (similar
  82                 behaviour to that of Samba 3), <emphasis>thread</emphasis>
  83                 (single process, different threads.
  84                 </para></listitem>
  85                 </varlistentry>
  86         </variablelist>
  87 </refsect1>
  88
  89 <refsect1>
  90         <title>FILES</title>
  91
  92         <variablelist>
  93                 <varlistentry>
  94                 <term><filename>/etc/rc</filename></term>
  95                 <listitem><para>or whatever initialization script your
  96                 system uses).</para>
  97
  98                 <para>If running the server as a daemon at startup,
  99                 this file will need to contain an appropriate startup
 100                 sequence for the server. </para></listitem>
 101                 </varlistentry>
 102
 103                 <varlistentry>
 104                 <term><filename>/etc/services</filename></term>
 105                 <listitem><para>If running the server via the
 106                 meta-daemon <command>inetd</command>, this file
 107                 must contain a mapping of service name (e.g., netbios-ssn)
 108                 to service port (e.g., 139) and protocol type (e.g., tcp).
 109                 </para></listitem>
 110                 </varlistentry>
 111
 112                 <varlistentry>
 113                 <term><filename>/usr/local/samba/lib/smb.conf</filename></term>
 114                 <listitem><para>This is the default location of the <citerefentry><refentrytitle>smb.conf</refentrytitle>
 115                 <manvolnum>5</manvolnum></citerefentry> server configuration file. Other common places that systems
 116                 install this file are <filename>/usr/samba/lib/smb.conf</filename>
 117                 and <filename>/etc/samba/smb.conf</filename>.</para>
 118
 119                 <para>This file describes all the services the server
 120                 is to make available to clients. See <citerefentry><refentrytitle>smb.conf</refentrytitle>
 121                 <manvolnum>5</manvolnum></citerefentry> for more information.</para>
 122                 </listitem>
 123                 </varlistentry>
 124         </variablelist>
 125 </refsect1>
 126
 127 <refsect1>
 128         <title>VERSION</title>
 129
 130         <para>This man page is correct for version 4 of
 131         the Samba suite.</para>
 132 </refsect1>
 133
 134 <refsect1>
 135         <title>DIAGNOSTICS</title>
 136
 137         <para>Most diagnostics issued by the server are logged
 138         in a specified log file. The log file name is specified
 139         at compile time, but may be overridden on the command line.</para>
 140
 141         <para>The number and nature of diagnostics available depends
 142         on the debug level used by the server. If you have problems, set
 143         the debug level to 3 and peruse the log files.</para>
 144
 145         <para>Most messages are reasonably self-explanatory. Unfortunately,
 146         at the time this man page was created, there are too many diagnostics
 147         available in the source code to warrant describing each and every
 148         diagnostic. At this stage your best bet is still to grep the
 149         source code and inspect the conditions that gave rise to the
 150         diagnostics you are seeing.</para>
 151 </refsect1>
 152
 153 <refsect1>
 154         <title>SEE ALSO</title>
 155         <para><citerefentry><refentrytitle>hosts_access</refentrytitle>
 156         <manvolnum>5</manvolnum></citerefentry>
 157         <citerefentry><refentrytitle>smb.conf</refentrytitle>
 158         <manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>smbclient</refentrytitle>
 159         <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>testparm</refentrytitle>
 160         <manvolnum>1</manvolnum></citerefentry>, and the
 161         Internet RFC's  <filename>rfc1001.txt</filename>, <filename>rfc1002.txt</filename>.
 162         In addition the CIFS (formerly SMB) specification is available
 163         as a link from the Web page <ulink noescape="1" url="http://samba.org/cifs/">
 164         http://samba.org/cifs/</ulink>.</para>
 165 </refsect1>
 166
 167 <refsect1>
 168         <title>AUTHOR</title>
 169
 170         <para>The original Samba software and related utilities
 171         were created by Andrew Tridgell. Samba is now developed
 172         by the Samba Team as an Open Source project similar
 173         to the way the Linux kernel is developed.</para>
 174
 175 </refsect1>
 176
 177 </refentry>