summaryrefslogtreecommitdiff
path: root/docs/htmldocs/smb.conf.5.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/htmldocs/smb.conf.5.html')
-rw-r--r--docs/htmldocs/smb.conf.5.html345
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
generated by cgit (git 2.34.1) at 2024-09-02 01:08:35 +0000