diff options
Diffstat (limited to 'docs/htmldocs/smb.conf.5.html')
-rw-r--r-- | docs/htmldocs/smb.conf.5.html | 345 |
1 files changed, 109 insertions, 236 deletions
diff --git a/docs/htmldocs/smb.conf.5.html b/docs/htmldocs/smb.conf.5.html index d409469e7c..14820cb623 100644 --- a/docs/htmldocs/smb.conf.5.html +++ b/docs/htmldocs/smb.conf.5.html @@ -531,6 +531,31 @@ NAME="AEN112" CLASS="VARIABLELIST" ><DL ><DT +>%S</DT +><DD +><P +>the name of the current service, if any.</P +></DD +><DT +>%P</DT +><DD +><P +>the root directory of the current service, + if any.</P +></DD +><DT +>%u</DT +><DD +><P +>user name of the current service, if any.</P +></DD +><DT +>%g</DT +><DD +><P +>primary group name of %u.</P +></DD +><DT >%U</DT ><DD ><P @@ -544,6 +569,19 @@ CLASS="VARIABLELIST" >primary group name of %U.</P ></DD ><DT +>%H</DT +><DD +><P +>the home directory of the user given + by %u.</P +></DD +><DT +>%v</DT +><DD +><P +>the Samba version.</P +></DD +><DT >%h</DT ><DD ><P @@ -576,6 +614,29 @@ CLASS="VARIABLELIST" </P ></DD ><DT +>%N</DT +><DD +><P +>the name of your NIS home directory server. + This is obtained from your NIS auto.map entry. If you have + not compiled Samba with the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--with-automount</I +></SPAN +> + option then this value will be the same as %L.</P +></DD +><DT +>%p</DT +><DD +><P +>the path of the service's home directory, + obtained from your NIS auto.map entry. The NIS auto.map entry + is split up as "%N:%p".</P +></DD +><DT >%R</DT ><DD ><P @@ -619,12 +680,6 @@ TARGET="_top" >the current date and time.</P ></DD ><DT ->%D</DT -><DD -><P ->Name of the domain or workgroup of the current user.</P -></DD -><DT >%$(<TT CLASS="REPLACEABLE" ><I @@ -644,78 +699,13 @@ CLASS="REPLACEABLE" ></DL ></DIV ><P ->The following substitutes apply only to some configuration options(only those - that are used when a connection has been established):</P -><P -></P -><DIV -CLASS="VARIABLELIST" -><DL -><DT ->%S</DT -><DD -><P ->the name of the current service, if any.</P -></DD -><DT ->%P</DT -><DD -><P ->the root directory of the current service, - if any.</P -></DD -><DT ->%u</DT -><DD -><P ->user name of the current service, if any.</P -></DD -><DT ->%g</DT -><DD -><P ->primary group name of %u.</P -></DD -><DT ->%H</DT -><DD -><P ->the home directory of the user given - by %u.</P -></DD -><DT ->%N</DT -><DD -><P ->the name of your NIS home directory server. - This is obtained from your NIS auto.map entry. If you have - not compiled Samba with the <SPAN -CLASS="emphasis" -><I -CLASS="EMPHASIS" ->--with-automount</I -></SPAN -> - option then this value will be the same as %L.</P -></DD -><DT ->%p</DT -><DD -><P ->the path of the service's home directory, - obtained from your NIS auto.map entry. The NIS auto.map entry - is split up as "%N:%p".</P -></DD -></DL -></DIV -><P >There are some quite creative things that can be done with these substitutions and other smb.conf options.</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN205" +NAME="AEN203" ></A ><H2 >NAME MANGLING</H2 @@ -814,13 +804,13 @@ CLASS="EMPHASIS" ></DL ></DIV ><P ->By default, Samba 3.0 has the same semantics as a Windows +>By default, Samba 2.2 has the same semantics as a Windows NT server, in that it is case insensitive but case preserving.</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN238" +NAME="AEN236" ></A ><H2 >NOTE ABOUT USERNAME/PASSWORD VALIDATION</H2 @@ -898,7 +888,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN257" +NAME="AEN255" ></A ><H2 >COMPLETE LIST OF GLOBAL PARAMETERS</H2 @@ -1679,18 +1669,6 @@ CLASS="PARAMETER" ><LI ><P ><A -HREF="#LDAPTRUSTIDS" -><TT -CLASS="PARAMETER" -><I ->ldap trust ids</I -></TT -></A -></P -></LI -><LI -><P -><A HREF="#LMANNOUNCE" ><TT CLASS="PARAMETER" @@ -3169,7 +3147,7 @@ CLASS="PARAMETER" ><DIV CLASS="REFSECT1" ><A -NAME="AEN1013" +NAME="AEN1007" ></A ><H2 >COMPLETE LIST OF SERVICE PARAMETERS</H2 @@ -4672,7 +4650,7 @@ CLASS="PARAMETER" ><DIV CLASS="REFSECT1" ><A -NAME="AEN1513" +NAME="AEN1507" ></A ><H2 >EXPLANATION OF EACH PARAMETER</H2 @@ -5504,12 +5482,12 @@ NAME="ANNOUNCEVERSION" ><P >This specifies the major and minor version numbers that nmbd will use when announcing itself as a server. The default - is 4.9. Do not change this parameter unless you have a specific + is 4.2. Do not change this parameter unless you have a specific need to set a Samba server to be a downlevel server.</P ><P >Default: <B CLASS="COMMAND" ->announce version = 4.9</B +>announce version = 4.5</B ></P ><P >Example: <B @@ -5851,7 +5829,7 @@ TARGET="_top" request has a time limit associated with it.</P ><P >If this parameter is set and the lock range requested - cannot be immediately satisfied, samba will internally + cannot be immediately satisfied, Samba 2.2 will internally queue the lock request, and periodically attempt to obtain the lock until the timeout period expires.</P ><P @@ -5859,7 +5837,7 @@ TARGET="_top" CLASS="CONSTANT" >no</TT >, then - samba will behave as previous versions of Samba would and + Samba 2.2 will behave as previous versions of Samba would and will fail the lock request immediately if the lock range cannot be obtained.</P ><P @@ -5975,7 +5953,7 @@ NAME="CASESENSITIVE" ><DD ><P >See the discussion in the section <A -HREF="#AEN205" +HREF="#AEN203" >NAME MANGLING</A >.</P ><P @@ -6538,7 +6516,7 @@ NAME="DEBUGTIMESTAMP" >debug timestamp (G)</DT ><DD ><P ->Samba debug log messages are timestamped +>Samba 2.2 debug log messages are timestamped by default. If you are running at a high <A HREF="#DEBUGLEVEL" > <TT @@ -6626,7 +6604,7 @@ NAME="DEFAULTCASE" ><DD ><P >See the section on <A -HREF="#AEN205" +HREF="#AEN203" > NAME MANGLING</A >. Also note the <A HREF="#SHORTPRESERVECASE" @@ -8725,7 +8703,7 @@ CLASS="COMMAND" > lp(1)</B >.</P ><P ->This parameter does not accept % macros, because +>This paramater does not accept % macros, because many parts of the system require this value to be constant for correct operation.</P ><P @@ -9994,54 +9972,40 @@ CLASS="PARAMETER" ><TT CLASS="PARAMETER" ><I ->Off</I +>On</I ></TT -> = Never use SSL when querying the directory.</P -></LI -><LI -><P -><TT +> = Always use SSL when contacting the + <TT CLASS="PARAMETER" ><I ->Start_tls</I +>ldap server</I ></TT -> = Use the LDAPv3 StartTLS extended operation - (RFC2830) for communicating with the directory server.</P +>.</P ></LI ><LI ><P ><TT CLASS="PARAMETER" ><I ->On</I -></TT -> = - Use SSL on the ldaps port when contacting the - <TT -CLASS="PARAMETER" -><I ->ldap server</I +>Off</I ></TT ->. Only - available when the backwards-compatiblity <B -CLASS="COMMAND" -> --with-ldapsam</B -> option is specified - to configure. See <A -HREF="#PASSDBBACKEND" +> = Never use SSL when querying the directory.</P +></LI +><LI +><P ><TT CLASS="PARAMETER" ><I ->passdb backend</I +>Start_tls</I ></TT -></A -></P +> = Use the LDAPv3 StartTLS extended operation + (RFC2830) for communicating with the directory server.</P ></LI ></UL ><P >Default : <B CLASS="COMMAND" ->ldap ssl = start_tls</B +>ldap ssl = on</B ></P ></DD ><DT @@ -10051,14 +10015,6 @@ NAME="LDAPSUFFIX" >ldap suffix (G)</DT ><DD ><P ->Specifies where user and machine accounts are added to the tree. Can be overriden by <B -CLASS="COMMAND" ->ldap user suffix</B -> and <B -CLASS="COMMAND" ->ldap machine suffix</B ->. It also used as the base dn for all ldap searches. </P -><P >Default : <SPAN CLASS="emphasis" ><I @@ -10164,35 +10120,6 @@ CLASS="COMMAND" ></DD ><DT ><A -NAME="LDAPTRUSTIDS" -></A ->ldap trust ids (G)</DT -><DD -><P ->Normally, Samba validates each entry - in the LDAP server against getpwnam(). This allows - LDAP to be used for Samba with the unix system using - NIS (for example) and also ensures that Samba does not - present accounts that do not otherwise exist. </P -><P ->This option is used to disable this functionality, and - instead to rely on the presence of the appropriate - attributes in LDAP directly, which can result in a - significant performance boost in some situations. - Setting this option to yes effectivly assumes - that the local machine is running <B -CLASS="COMMAND" ->nss_ldap</B -> against the - same LDAP server.</P -><P ->Default: <B -CLASS="COMMAND" ->ldap trust ids = No</B -></P -></DD -><DT -><A NAME="LEVEL2OPLOCKS" ></A >level2 oplocks (S)</DT @@ -11541,7 +11468,7 @@ NAME="MANGLECASE" ><DD ><P >See the section on <A -HREF="#AEN205" +HREF="#AEN203" > NAME MANGLING</A ></P ><P @@ -11617,7 +11544,7 @@ NAME="MANGLEDNAMES" or whether non-DOS names should simply be ignored.</P ><P >See the section on <A -HREF="#AEN205" +HREF="#AEN203" > NAME MANGLING</A > for details on how to control the mangling process.</P ><P @@ -11704,39 +11631,17 @@ NAME="MANGLINGMETHOD" a better algorithm (generates less collisions) in the names. However, many Win32 applications store the mangled names and so changing to the new algorithm must not be done - lightly as these applications may break unless reinstalled.</P + lightly as these applications may break unless reinstalled. + New installations of Samba may set the default to hash2.</P ><P >Default: <B CLASS="COMMAND" ->mangling method = hash2</B -></P -><P ->Example: <B -CLASS="COMMAND" >mangling method = hash</B ></P -></DD -><DT -><A -NAME="MANGLEPREFIX" -></A ->mangle prefix (G)</DT -><DD -><P -> controls the number of prefix - characters from the original name used when generating - the mangled names. A larger value will give a weaker - hash and therefore more name collisions. The minimum - value is 1 and the maximum value is 6.</P -><P ->Default: <B -CLASS="COMMAND" ->mangle prefix = 1</B -></P ><P >Example: <B CLASS="COMMAND" ->mangle prefix = 4</B +>mangling method = hash2</B ></P ></DD ><DT @@ -11791,7 +11696,7 @@ CLASS="EMPHASIS" >magic</I ></SPAN > character in <A -HREF="#AEN205" +HREF="#AEN203" >name mangling</A >. The default is a '~' but this may interfere with some software. Use this option to set @@ -13772,41 +13677,15 @@ CLASS="COMMAND" >ldap://localhost</B >)</P ><P ->Note: In this module, any account - without a matching POSIX account is regarded - as 'non unix'. - </P -><P >See also <A HREF="#NONUNIXACCOUNTRANGE" > <TT CLASS="PARAMETER" ><I ->non unix account - range</I +>non unix account range</I ></TT ></A ></P -><P ->LDAP connections should be secured where - possible. This may be done using either - Start-TLS (see <A -HREF="#LDAPSSL" -> <TT -CLASS="PARAMETER" -><I ->ldap ssl</I -></TT -></A ->) or by - specifying <TT -CLASS="PARAMETER" -><I ->ldaps://</I -></TT -> in - the URL argument. - </P ></LI ><LI ><P @@ -14902,7 +14781,7 @@ CLASS="COMMAND" ></P ><P >See the section on <A -HREF="#AEN205" +HREF="#AEN203" >NAME MANGLING</A > for a fuller discussion.</P @@ -16668,7 +16547,7 @@ CLASS="EMPHASIS" be used in granting access.</P ><P >See also the section <A -HREF="#AEN238" +HREF="#AEN236" > NOTE ABOUT USERNAME/PASSWORD VALIDATION</A >.</P ><P @@ -16761,7 +16640,7 @@ CLASS="PARAMETER" > parameter for details on doing this.</P ><P >See also the section <A -HREF="#AEN238" +HREF="#AEN236" > NOTE ABOUT USERNAME/PASSWORD VALIDATION</A >.</P ><P @@ -16853,7 +16732,7 @@ CLASS="PARAMETER" > parameter for details on doing this.</P ><P >See also the section <A -HREF="#AEN238" +HREF="#AEN236" > NOTE ABOUT USERNAME/PASSWORD VALIDATION</A >.</P ><P @@ -16992,7 +16871,7 @@ CLASS="COMMAND" Domain Controller. This issue will be addressed in a future release.</P ><P >See also the section <A -HREF="#AEN238" +HREF="#AEN236" > NOTE ABOUT USERNAME/PASSWORD VALIDATION</A >.</P ><P @@ -17264,7 +17143,7 @@ CLASS="COMMAND" names are lowered. </P ><P >See the section on <A -HREF="#AEN205" +HREF="#AEN203" > NAME MANGLING</A >.</P ><P @@ -18158,8 +18037,7 @@ NAME="UNICODE" ><DD ><P >Specifies whether Samba should try - to use unicode on the wire by default. Note: This does NOT - mean that samba will assume that the unix machine uses unicode! + to use unicode on the wire by default. </P ><P >Default: <B @@ -18183,11 +18061,6 @@ NAME="UNIXCHARSET" CLASS="COMMAND" >unix charset = ASCII</B ></P -><P ->Example: <B -CLASS="COMMAND" ->unix charset = UTF8</B -></P ></DD ><DT ><A @@ -18554,7 +18427,7 @@ CLASS="PARAMETER" search.</P ><P >See the section <A -HREF="#AEN238" +HREF="#AEN236" >NOTE ABOUT USERNAME/PASSWORD VALIDATION</A > for more information on how @@ -19890,7 +19763,7 @@ CLASS="PARAMETER" ><DIV CLASS="REFSECT1" ><A -NAME="AEN6150" +NAME="AEN6113" ></A ><H2 >WARNINGS</H2 @@ -19920,18 +19793,18 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN6156" +NAME="AEN6119" ></A ><H2 >VERSION</H2 ><P ->This man page is correct for version 3.0 of +>This man page is correct for version 2.2 of the Samba suite.</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN6159" +NAME="AEN6122" ></A ><H2 >SEE ALSO</H2 @@ -20010,7 +19883,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN6179" +NAME="AEN6142" ></A ><H2 >AUTHOR</H2 |