diff options
Diffstat (limited to 'docs/htmldocs/smbd.8.html')
| -rw-r--r-- | docs/htmldocs/smbd.8.html | 357 |
1 files changed, 170 insertions, 187 deletions
diff --git a/docs/htmldocs/smbd.8.html b/docs/htmldocs/smbd.8.html index 6f1cb8c057..65f5f95b8d 100644 --- a/docs/htmldocs/smbd.8.html +++ b/docs/htmldocs/smbd.8.html @@ -1,11 +1,12 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >smbd</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" @@ -15,9 +16,7 @@ VLINK="#840084" ALINK="#0000FF" ><H1 ><A -NAME="SMBD.8" -></A ->smbd</H1 +NAME="SMBD">smbd</H1 ><DIV CLASS="REFNAMEDIV" ><A @@ -29,15 +28,13 @@ NAME="AEN5" ><DIV CLASS="REFSYNOPSISDIV" ><A -NAME="AEN8" -></A -><H2 +NAME="AEN8"><H2 >Synopsis</H2 ><P ><B CLASS="COMMAND" >smbd</B -> [-D] [-F] [-S] [-i] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]</P +> [-D] [-F] [-S] [-i] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]</P ></DIV ><DIV CLASS="REFSECT1" @@ -47,13 +44,7 @@ NAME="AEN23" ><H2 >DESCRIPTION</H2 ><P ->This program is part of the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->Samba</SPAN ->(7)</SPAN -> suite.</P +>This program is part of the Samba suite.</P ><P ><B CLASS="COMMAND" @@ -70,24 +61,28 @@ CLASS="COMMAND" >An extensive description of the services that the server can provide is given in the man page for the configuration file controlling the attributes of those - services (see <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN + services (see <A +HREF="smb.conf.5.html" +TARGET="_top" +><TT +CLASS="FILENAME" +>smb.conf(5) + </TT +></A >. This man page will not describe the services, but will concentrate on the administrative aspects of running the server.</P ><P >Please note that there are significant security - implications to running this server, and the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN -> manual page should be regarded as mandatory reading before + implications to running this server, and the <A +HREF="smb.conf.5.html" +TARGET="_top" +><TT +CLASS="FILENAME" +>smb.conf(5)</TT +></A +> + manpage should be regarded as mandatory reading before proceeding with installation.</P ><P >A session is created whenever a client requests one. @@ -109,7 +104,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN42" +NAME="AEN37" ></A ><H2 >OPTIONS</H2 @@ -230,9 +225,11 @@ CLASS="COMMAND" >-d <debug level></DT ><DD ><P -><VAR +><TT CLASS="REPLACEABLE" ->debuglevel</VAR +><I +>debuglevel</I +></TT > is an integer from 0 to 10. The default value if this parameter is not specified is zero.</P @@ -254,17 +251,15 @@ CLASS="REPLACEABLE" override the <A HREF="smb.conf.5.html#loglevel" TARGET="_top" -><VAR -CLASS="PARAMETER" >log - level</VAR + level</A +> parameter in the <A +HREF="smb.conf.5.html" +TARGET="_top" +> <TT +CLASS="FILENAME" +>smb.conf(5)</TT ></A -> parameter in the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN > file.</P ></DD ><DT @@ -272,9 +267,11 @@ CLASS="REFENTRYTITLE" ><DD ><P >If specified, - <VAR + <TT CLASS="REPLACEABLE" ->log directory</VAR +><I +>log directory</I +></TT > specifies a log directory into which the "log.smbd" log file will be created for informational and debug @@ -283,23 +280,18 @@ CLASS="REPLACEABLE" its size may be controlled by the <A HREF="smb.conf.5.html#maxlogsize" TARGET="_top" -><VAR -CLASS="PARAMETER" ->max log size</VAR -></A +>max log size</A > - option in the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN -> file. <SPAN -CLASS="emphasis" -><I + option in the <A +HREF="smb.conf.5.html" +TARGET="_top" +><TT +CLASS="FILENAME" +> smb.conf(5)</TT +></A +> file. <I CLASS="EMPHASIS" >Beware:</I -></SPAN > If the directory specified does not exist, <B CLASS="COMMAND" @@ -318,26 +310,27 @@ CLASS="COMMAND" >See the <A HREF="smb.conf.5.html#socketoptions" TARGET="_top" -><VAR -CLASS="PARAMETER" ->socket options</VAR -></A +>socket options</A > - parameter in the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN + parameter in the <A +HREF="smb.conf.5.html" +TARGET="_top" +><TT +CLASS="FILENAME" +>smb.conf(5) + </TT +></A > file for details.</P ></DD ><DT >-p <port number></DT ><DD ><P -><VAR +><TT CLASS="REPLACEABLE" ->port number</VAR +><I +>port number</I +></TT > is a positive integer value. The default value if this parameter is not specified is 139.</P @@ -369,12 +362,13 @@ CLASS="REPLACEABLE" information in this file includes server-specific information such as what printcap file to use, as well as descriptions of all the services that the server is - to provide. See <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN + to provide. See <A +HREF="smb.conf.5.html" +TARGET="_top" +><TT +CLASS="FILENAME" +> smb.conf(5)</TT +></A > for more information. The default configuration file name is determined at compile time.</P @@ -385,7 +379,7 @@ CLASS="REFENTRYTITLE" ><DIV CLASS="REFSECT1" ><A -NAME="AEN135" +NAME="AEN123" ></A ><H2 >FILES</H2 @@ -408,9 +402,9 @@ CLASS="COMMAND" > meta-daemon, this file must contain suitable startup information for the meta-daemon. See the <A -HREF="install.html" +HREF="UNIX_INSTALL.html" TARGET="_top" ->"How to Install and Test SAMBA"</A +>UNIX_INSTALL.html</A > document for details. </P @@ -428,9 +422,9 @@ CLASS="FILENAME" >If running the server as a daemon at startup, this file will need to contain an appropriate startup sequence for the server. See the <A -HREF="install.html" +HREF="UNIX_INSTALL.html" TARGET="_top" ->"How to Install and Test SAMBA"</A +>UNIX_INSTALL.html</A > document for details.</P ></DD @@ -449,9 +443,9 @@ CLASS="COMMAND" must contain a mapping of service name (e.g., netbios-ssn) to service port (e.g., 139) and protocol type (e.g., tcp). See the <A -HREF="install.html" +HREF="UNIX_INSTALL.html" TARGET="_top" ->"How to Install and Test SAMBA"</A +>UNIX_INSTALL.html</A > document for details.</P ></DD @@ -462,30 +456,34 @@ CLASS="FILENAME" ></DT ><DD ><P ->This is the default location of the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN -> server configuration file. Other common places that systems +>This is the default location of the + <A +HREF="smb.conf.5.html" +TARGET="_top" +><TT +CLASS="FILENAME" +>smb.conf</TT +></A +> + server configuration file. Other common places that systems install this file are <TT CLASS="FILENAME" >/usr/samba/lib/smb.conf</TT > and <TT CLASS="FILENAME" ->/etc/samba/smb.conf</TT +>/etc/smb.conf</TT >.</P ><P >This file describes all the services the server - is to make available to clients. See <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN -> for more information.</P + is to make available to clients. See <A +HREF="smb.conf.5.html" +TARGET="_top" +> <TT +CLASS="FILENAME" +>smb.conf(5)</TT +></A +> for more information.</P ></DD ></DL ></DIV @@ -493,7 +491,7 @@ CLASS="REFENTRYTITLE" ><DIV CLASS="REFSECT1" ><A -NAME="AEN173" +NAME="AEN159" ></A ><H2 >LIMITATIONS</H2 @@ -512,7 +510,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN177" +NAME="AEN163" ></A ><H2 >ENVIRONMENT VARIABLES</H2 @@ -522,17 +520,17 @@ NAME="AEN177" CLASS="VARIABLELIST" ><DL ><DT -><VAR +><TT CLASS="ENVAR" ->PRINTER</VAR +>PRINTER</TT ></DT ><DD ><P >If no printer name is specified to printable services, most systems will use the value of - this variable (or <CODE + this variable (or <TT CLASS="CONSTANT" ->lp</CODE +>lp</TT > if this variable is not defined) as the name of the printer to use. This is not specific to the server, however.</P @@ -543,7 +541,7 @@ CLASS="CONSTANT" ><DIV CLASS="REFSECT1" ><A -NAME="AEN186" +NAME="AEN172" ></A ><H2 >PAM INTERACTION</H2 @@ -551,33 +549,22 @@ NAME="AEN186" >Samba uses PAM for authentication (when presented with a plaintext password), for account checking (is this account disabled?) and for session management. The degree too which samba supports PAM is restricted - by the limitations of the SMB protocol and the <A + by the limitations of the SMB protocol and the + <A HREF="smb.conf.5.html#OBEYPAMRESRICTIONS" TARGET="_top" -><VAR -CLASS="PARAMETER" ->obey - pam restricions</VAR -></A -> <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN -> paramater. When this is set, the following restrictions apply: +>obey pam restricions</A +> + smb.conf paramater. When this is set, the following restrictions apply: </P ><P ></P ><UL ><LI ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Account Validation</I -></SPAN >: All accesses to a samba server are checked against PAM to see if the account is vaild, not disabled and is permitted to @@ -586,12 +573,9 @@ CLASS="EMPHASIS" ></LI ><LI ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Session Management</I -></SPAN >: When not using share level secuirty, users must pass PAM's session checks before access is granted. Note however, that this is bypassed in share level secuirty. @@ -604,7 +588,7 @@ CLASS="EMPHASIS" ><DIV CLASS="REFSECT1" ><A -NAME="AEN201" +NAME="AEN183" ></A ><H2 >VERSION</H2 @@ -615,7 +599,7 @@ NAME="AEN201" ><DIV CLASS="REFSECT1" ><A -NAME="AEN204" +NAME="AEN186" ></A ><H2 >DIAGNOSTICS</H2 @@ -638,7 +622,7 @@ NAME="AEN204" ><DIV CLASS="REFSECT1" ><A -NAME="AEN209" +NAME="AEN191" ></A ><H2 >SIGNALS</H2 @@ -660,12 +644,9 @@ CLASS="COMMAND" that <B CLASS="COMMAND" >SIGKILL (-9)</B -> <SPAN -CLASS="emphasis" -><I +> <I CLASS="EMPHASIS" >NOT</I -></SPAN > be used, except as a last resort, as this may leave the shared memory area in an inconsistent state. The safe way to terminate @@ -679,14 +660,16 @@ CLASS="COMMAND" CLASS="COMMAND" >smbd</B > may be raised - or lowered using <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smbcontrol</SPAN ->(1)</SPAN -> program (SIGUSR[1|2] signals are no longer - used since Samba 2.2). This is to allow transient problems to be diagnosed, + or lowered using <A +HREF="smbcontrol.1.html" +TARGET="_top" +><B +CLASS="COMMAND" +>smbcontrol(1) + </B +></A +> program (SIGUSR[1|2] signals are no longer used in + Samba 2.2). This is to allow transient problems to be diagnosed, whilst still running at a normally low log level.</P ><P >Note that as the signal handlers send a debug write, @@ -705,55 +688,55 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN227" +NAME="AEN208" ></A ><H2 >SEE ALSO</H2 ><P -><SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->hosts_access</SPAN ->(5)</SPAN ->, <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->inetd</SPAN ->(8)</SPAN ->, <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->nmbd</SPAN ->(8)</SPAN ->, <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN ->, <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smbclient</SPAN ->(1)</SPAN ->, <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->testparm</SPAN ->(1)</SPAN ->, <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->testprns</SPAN ->(1)</SPAN ->, and the - Internet RFC's <TT +>hosts_access(5), <B +CLASS="COMMAND" +>inetd(8)</B +>, + <A +HREF="nmbd.8.html" +TARGET="_top" +><B +CLASS="COMMAND" +>nmbd(8)</B +></A +>, + <A +HREF="smb.conf.5.html" +TARGET="_top" +><TT +CLASS="FILENAME" +>smb.conf(5)</TT +> + </A +>, <A +HREF="smbclient.1.html" +TARGET="_top" +><B +CLASS="COMMAND" +>smbclient(1) + </B +></A +>, <A +HREF="testparm.1.html" +TARGET="_top" +><B +CLASS="COMMAND" +> testparm(1)</B +></A +>, <A +HREF="testprns.1.html" +TARGET="_top" +> <B +CLASS="COMMAND" +>testprns(1)</B +></A +>, and the Internet RFC's + <TT CLASS="FILENAME" >rfc1001.txt</TT >, <TT @@ -771,7 +754,7 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN254" +NAME="AEN225" ></A ><H2 >AUTHOR</H2 @@ -783,14 +766,14 @@ NAME="AEN254" ><P >The original Samba man pages were written by Karl Auer. The man page sources were converted to YODL format (another - excellent piece of Open Source software, available at <A + excellent piece of Open Source software, available at + <A HREF="ftp://ftp.icce.rug.nl/pub/unix/" TARGET="_top" > ftp://ftp.icce.rug.nl/pub/unix/</A >) and updated for the Samba 2.0 release by Jeremy Allison. The conversion to DocBook for - Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2 for - Samba 3.0 was done by Alexander Bokovoy.</P + Samba 2.2 was done by Gerald Carter</P ></DIV ></BODY ></HTML |