diff options
Diffstat (limited to 'docs/htmldocs/smbd.8.html')
| -rw-r--r-- | docs/htmldocs/smbd.8.html | 433 |
1 files changed, 215 insertions, 218 deletions
diff --git a/docs/htmldocs/smbd.8.html b/docs/htmldocs/smbd.8.html index afd70cbe03..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 @@ -200,106 +195,83 @@ CLASS="COMMAND" </P ></DD ><DT +>-h</DT +><DD +><P +>Prints the help information (usage) + for <B +CLASS="COMMAND" +>smbd</B +>.</P +></DD +><DT >-V</DT ><DD ><P >Prints the version number for -<B + <B CLASS="COMMAND" >smbd</B >.</P ></DD ><DT ->-s <configuration file></DT +>-b</DT ><DD ><P ->The file specified contains the -configuration details required by the server. The -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 <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 +>Prints information about how + Samba was built.</P ></DD ><DT ->-d|--debug=debuglevel</DT +>-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 + from 0 to 10. The default value if this parameter is + not specified is zero.</P ><P >The higher this value, the more detail will be -logged to the log files about the activities of the -server. At level 0, only critical errors and serious -warnings will be logged. Level 1 is a reasonable level for -day to day running - it generates a small amount of -information about operations carried out.</P + logged to the log files about the activities of the + server. At level 0, only critical errors and serious + warnings will be logged. Level 1 is a reasonable level for + day to day running - it generates a small amount of + information about operations carried out.</P ><P >Levels above 1 will generate considerable -amounts of log data, and should only be used when -investigating a problem. Levels above 3 are designed for -use only by developers and generate HUGE amounts of log -data, most of which is extremely cryptic.</P + amounts of log data, and should only be used when + investigating a problem. Levels above 3 are designed for + use only by developers and generate HUGE amounts of log + data, most of which is extremely cryptic.</P ><P >Note that specifying this parameter here will -override the <A + override the <A HREF="smb.conf.5.html#loglevel" TARGET="_top" >log -level</A + level</A > parameter in the <A HREF="smb.conf.5.html" TARGET="_top" -><TT +> <TT CLASS="FILENAME" >smb.conf(5)</TT ></A > file.</P ></DD ><DT ->-l|--logfile=logbasename</DT -><DD -><P ->File name for log/debug files. The extension -<CODE -CLASS="CONSTANT" ->".client"</CODE -> will be appended. The log file is -never removed by the client.</P -></DD -><DT ->-h|--help</DT -><DD -><P ->Print a summary of command line options.</P -></DD -><DT ->-b</DT -><DD -><P ->Prints information about how - Samba was built.</P -></DD -><DT >-l <log directory></DT ><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 @@ -308,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" @@ -337,12 +304,33 @@ CLASS="COMMAND" compile time.</P ></DD ><DT +>-O <socket options></DT +><DD +><P +>See the <A +HREF="smb.conf.5.html#socketoptions" +TARGET="_top" +>socket options</A +> + 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 @@ -365,13 +353,33 @@ CLASS="REPLACEABLE" >This parameter is not normally specified except in the above situation.</P ></DD +><DT +>-s <configuration file></DT +><DD +><P +>The file specified contains the + configuration details required by the server. The + 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 <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 +></DD ></DL ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN127" +NAME="AEN123" ></A ><H2 >FILES</H2 @@ -394,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 @@ -414,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 @@ -435,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 @@ -448,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 @@ -479,7 +491,7 @@ CLASS="REFENTRYTITLE" ><DIV CLASS="REFSECT1" ><A -NAME="AEN165" +NAME="AEN159" ></A ><H2 >LIMITATIONS</H2 @@ -498,7 +510,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN169" +NAME="AEN163" ></A ><H2 >ENVIRONMENT VARIABLES</H2 @@ -508,17 +520,17 @@ NAME="AEN169" 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 @@ -529,7 +541,7 @@ CLASS="CONSTANT" ><DIV CLASS="REFSECT1" ><A -NAME="AEN178" +NAME="AEN172" ></A ><H2 >PAM INTERACTION</H2 @@ -537,33 +549,22 @@ NAME="AEN178" >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 @@ -572,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. @@ -590,7 +588,7 @@ CLASS="EMPHASIS" ><DIV CLASS="REFSECT1" ><A -NAME="AEN193" +NAME="AEN183" ></A ><H2 >VERSION</H2 @@ -601,7 +599,7 @@ NAME="AEN193" ><DIV CLASS="REFSECT1" ><A -NAME="AEN196" +NAME="AEN186" ></A ><H2 >DIAGNOSTICS</H2 @@ -624,7 +622,7 @@ NAME="AEN196" ><DIV CLASS="REFSECT1" ><A -NAME="AEN201" +NAME="AEN191" ></A ><H2 >SIGNALS</H2 @@ -646,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 @@ -665,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, @@ -691,55 +688,55 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN219" +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 @@ -757,7 +754,7 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN246" +NAME="AEN225" ></A ><H2 >AUTHOR</H2 @@ -769,14 +766,14 @@ NAME="AEN246" ><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 |