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">
6 <refentrytitle>smbd</refentrytitle>
7 <manvolnum>8</manvolnum>
12 <refname>smbd</refname>
13 <refpurpose>server to provide filesharing- and directory services to clients</refpurpose>
18 <command>smbd</command>
19 <arg choice="opt">-i</arg>
20 <arg choice="opt">-M model</arg>
25 <title>DESCRIPTION</title>
26 <para>This program is part of the <citerefentry><refentrytitle>samba</refentrytitle>
27 <manvolnum>7</manvolnum></citerefentry> suite.</para>
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.
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>
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>
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>
54 <para>As of Samba 4, smbd also incorporates all the functionality of
60 <title>OPTIONS</title>
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
77 <listitem><para>This parameter can be used to specify the
78 "process model" 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.
94 <term><filename>/etc/rc</filename></term>
95 <listitem><para>or whatever initialization script your
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>
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).
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>
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>
128 <title>VERSION</title>
130 <para>This man page is correct for version 4 of
131 the Samba suite.</para>
135 <title>DIAGNOSTICS</title>
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>
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>
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>
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>
168 <title>AUTHOR</title>
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>