sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-08-29 13:49:30 +03:00
Code Activity

Standardised on 'var = value' when referencing smb.conf parameters, rather

Browse Source 
than 'var=value'.

Fixed up some dodgy quoting on the way.
This commit is contained in:
Tim Potter
-
parent d3758404d4
commit 0606c194d6
1 changed files with 39 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
docs/docbook/manpages/smb.conf.5.sgml
View File

@ -92,7 +92,7 @@
<para>Sections other than guest services will require a password
to access them. The client provides the username. As older clients
only provide passwords and not usernames, you may specify a list
of usernames to check against the password using the "user="
of usernames to check against the password using the "user ="
option in the share definition. For modern clients such as
Windows 95/98/ME/NT/2000, this should not be necessary.</para>
@ -168,11 +168,11 @@
the user's home directory.</para></listitem>
</itemizedlist>
<para>If you decide to use a <emphasis>path=</emphasis> line
<para>If you decide to use a <emphasis>path =</emphasis> line
in your [homes] section then you may find it useful
to use the %S macro. For example :</para>
<para><userinput>path=/data/pchome/%S</userinput></para>
<para><userinput>path = /data/pchome/%S</userinput></para>
<para>would be useful if you have different home directories
for your PCs than for UNIX access.</para>
@ -209,9 +209,9 @@
<para>Note that the <emphasis>browseable</emphasis> flag for
auto home directories will be inherited from the global browseable
flag, not the [homes] browseable flag. This is useful as
it means setting browseable=no in the [homes] section
will hide the [homes] share but make any auto home
directories visible.</para>
it means setting <emphasis>browseable = no</emphasis> in
the [homes] section will hide the [homes] share but make
any auto home directories visible.</para>
</refsect2>
<refsect2>
@ -484,7 +484,7 @@
<variablelist>
<varlistentry>
<term>mangle case= yes/no</term>
<term>mangle case = yes/no</term>
<listitem><para> controls if names that have characters that
aren't of the "default" case are mangled. For example,
if this is yes then a name like "Mail" would be mangled.
@ -565,9 +565,9 @@
<filename>smb.conf</filename> file for the service and the client
has supplied a password, and that password matches (according to
the UNIX system's password checking) with one of the usernames
from the "user=" field then the connection is made as
the username in the "user=" line. If one
of the username in the "user=" list begins with a
from the "user =" field then the connection is made as
the username in the "user =" line. If one
of the username in the "user =" list begins with a
'@' then that name expands to a list of names in
the group of the same name.</para></listitem>
@ -1011,8 +1011,8 @@
<emphasis>ON DEMAND</emphasis> when a user accesses the Samba server.</para>
<para>In order to use this option, <ulink url="smbd.8.html">smbd</ulink>
must be set to <parameter>security=server</parameter> or <parameter>
security=domain</parameter> and <parameter>add user script</parameter>
must be set to <parameter>security = server</parameter> or <parameter>
security = domain</parameter> and <parameter>add user script</parameter>
must be set to a full pathname for a script that will create a UNIX
user given one argument of <parameter>%u</parameter>, which expands into
the UNIX user name to create.</para>
@ -1652,7 +1652,7 @@
<para>See also the <link linkend="FORCECREATEMODE"><parameter>force
create mode</parameter></link> parameter for forcing particular mode
bits to be set on created files. See also the <link linkend="DIRECTORYMODE">
<parameter>directory mode"</parameter></link> parameter for masking
<parameter>directory mode</parameter></link> parameter for masking
mode bits on created directories. See also the <link linkend="INHERITPERMISSIONS">
<parameter>inherit permissions</parameter></link> parameter.</para>
@ -1783,7 +1783,7 @@
<term><anchor id="DEFAULTCASE">default case (S)</term>
<listitem><para>See the section on <link linkend="NAMEMANGLINGSECT">
NAME MANGLING</link>. Also note the <link linkend="SHORTPRESERVECASE">
<parameter>short preserve case"</parameter></link> parameter.</para>
<parameter>short preserve case</parameter></link> parameter.</para>
<para>Default: <command>default case = lower</command></para>
</listitem>
@ -1951,17 +1951,17 @@
Windows NT user no longer exists.</para>
<para>In order to use this option, <command>smbd</command> must be
set to <parameter>security=domain</parameter> and <parameter>delete
set to <parameter>security = domain</parameter> and <parameter>delete
user script</parameter> must be set to a full pathname for a script
that will delete a UNIX user given one argument of <parameter>%u
</parameter>, which expands into the UNIX user name to delete.
<emphasis>NOTE</emphasis> that this is different to the <link
linkend="ADDUSERSCRIPT"><parameter>add user script</parameter></link>
which will work with the <parameter>security=server</parameter> option
as well as <parameter>security=domain</parameter>. The reason for this
which will work with the <parameter>security = server</parameter> option
as well as <parameter>security = domain</parameter>. The reason for this
is only when Samba is a domain member does it get the information
on an attempted user logon that a user no longer exists. In the
<parameter>security=server</parameter> mode a missing user
<parameter>security = server</parameter> mode a missing user
is treated the same as an invalid password logon attempt. Deleting
the user in this circumstance would not be a good idea.</para>
@ -1982,7 +1982,7 @@
UNIX users are dynamically deleted to match existing Windows NT
accounts.</para>
<para>See also <link linkend="SECURITYEQUALSDOMAIN">security=domain</link>,
<para>See also <link linkend="SECURITYEQUALSDOMAIN">security = domain</link>,
<link linkend="PASSWORDSERVER"><parameter>password server</parameter>
</link>, <link linkend="ADDUSERSCRIPT"><parameter>add user script</parameter>
</link>.</para>
@ -2409,7 +2409,7 @@
</filename></ulink> file (see the <ulink url="smbpasswd.8.html"><command>
smbpasswd(8)</command></ulink> program for information on how to set up
and maintain this file), or set the <link
linkend="SECURITY">security=[serve|domain]</link> parameter which
linkend="SECURITY">security = [server|domain]</link> parameter which
causes <command>smbd</command> to authenticate against another
server.</para>
@ -3662,7 +3662,7 @@
<para>If a <parameter>%p</parameter> is given then the printername
is put in its place. A <parameter>%j</parameter> is replaced with
the job number (an integer). On HPUX (see <parameter>printing=hpux
the job number (an integer). On HPUX (see <parameter>printing = hpux
</parameter>), if the <parameter>-p%p</parameter> option is added
to the lpq command, the job will show up with the correct status, i.e.
if the job priority is lower than the set fence priority it will
@ -3836,7 +3836,7 @@
<varlistentry>
<term><anchor id="MACHINEPASSWORDTIMEOUT">machine password timeout (G)</term>
<listitem><para>If a Samba server is a member of an Windows
NT Domain (see the <link linkend="SECURITYEQUALSDOMAIN">security=domain</link>)
NT Domain (see the <link linkend="SECURITYEQUALSDOMAIN">security = domain</link>)
parameter) then periodically a running <ulink url="smbd.8.html">
smbd(8)</ulink> process will try and change the MACHINE ACCOUNT
PASSWORD stored in the TDB called <filename>private/secrets.tdb
@ -3846,7 +3846,7 @@
<para>See also <ulink url="smbpasswd.8.html"><command>smbpasswd(8)
</command></ulink>, and the <link linkend="SECURITYEQUALSDOMAIN">
security=domain</link>) parameter.</para>
security = domain</link>) parameter.</para>
<para>Default: <command>machine password timeout = 604800</command></para>
</listitem>
@ -4097,7 +4097,7 @@
<varlistentry>
<term><anchor id="MAPTOGUEST">map to guest (G)</term>
<listitem><para>This parameter is only useful in <link linkend="SECURITY">
security</link> modes other than <parameter>security=share</parameter>
security</link> modes other than <parameter>security = share</parameter>
- i.e. <constant>user</constant>, <constant>server</constant>,
and <constant>domain</constant>.</para>
@ -4334,13 +4334,13 @@
<term><anchor id="MAXWINSTTL">max wins ttl (G)</term>
<listitem><para>This option tells <ulink url="nmbd.8.html">nmbd(8)
</ulink> when acting as a WINS server (<link linkend="WINSSUPPORT">
<parameter>wins support=yes</parameter></link>) what the maximum
<parameter>wins support = yes</parameter></link>) what the maximum
'time to live' of NetBIOS names that <command>nmbd</command>
will grant will be (in seconds). You should never need to change this
parameter. The default is 6 days (518400 seconds).</para>
<para>See also the <link linkend="MINWINSTTL"><parameter>min
wins ttl"</parameter></link> parameter.</para>
wins ttl</parameter></link> parameter.</para>
<para>Default: <command>max wins ttl = 518400</command></para>
</listitem>
@ -5179,13 +5179,13 @@
<command>smbd</command> makes a connection to a password server,
and then the password server fails, no more users will be able
to be authenticated from this <command>smbd</command>. This is a
restriction of the SMB/CIFS protocol when in <command>security=server
restriction of the SMB/CIFS protocol when in <command>security = server
</command> mode and cannot be fixed in Samba.</para></listitem>
<listitem><para>If you are using a Windows NT server as your
password server then you will have to ensure that your users
are able to login from the Samba server, as when in <command>
security=server</command> mode the network logon will appear to
security = server</command> mode the network logon will appear to
come from there rather than from the users workstation.</para></listitem>
</itemizedlist>
@ -5452,14 +5452,14 @@
the parameter varies depending on the setting of the <link linkend="PRINTING">
<parameter>printing</parameter></link> parameter.</para>
<para>Default: For <command>printing= BSD, AIX, QNX, LPRNG
<para>Default: For <command>printing = BSD, AIX, QNX, LPRNG
or PLP :</command></para>
<para><command>print command = lpr -r -P%p %s</command></para>
<para>For <command>printing= SYS or HPUX :</command></para>
<para>For <command>printing = SYS or HPUX :</command></para>
<para><command>print command = lp -c -d%p %s; rm %s</command></para>
<para>For <command>printing=SOFTQ :</command></para>
<para>For <command>printing = SOFTQ :</command></para>
<para><command>print command = lp -d%p -s %s; rm %s</command></para>
<para>Example: <command>print command = /usr/local/samba/bin/myprintscript
@ -6155,7 +6155,7 @@
Windows NT.</para>
<para>The alternatives are <command>security = share</command>,
<command>security = server</command> or <command>security=domain
<command>security = server</command> or <command>security = domain
</command>.</para>
<para>In versions of Samba prior to 2..0, the default was
@ -6263,7 +6263,7 @@
</emphasis></para>
<para>This is the default security setting in Samba 2.2.
With user-level security a client must first "log=on" with a
With user-level security a client must first "log-on" with a
valid username and password (which can be mapped using the <link
linkend="USERNAMEMAP"><parameter>username map</parameter></link>
parameter). Encrypted passwords (see the <link linkend="ENCRYPTPASSWORDS">
@ -6414,7 +6414,7 @@
<term><anchor id="SERVERSTRING">server string (G)</term>
<listitem><para>This controls what string will show up in the
printer comment box in print manager and next to the IPC connection
in <command>net view"</command>. It can be any string that you wish
in <command>net view</command>. It can be any string that you wish
to show to your users.</para>
<para>It also sets what will appear in browse lists next
@ -6620,8 +6620,8 @@
or disable the option, by default they will be enabled if you
don't specify 1 or 0.</para>
<para>To specify an argument use the syntax SOME_OPTION=VALUE
for example <command>SO_SNDBUF=8192</command>. Note that you must
<para>To specify an argument use the syntax SOME_OPTION = VALUE
for example <command>SO_SNDBUF = 8192</command>. Note that you must
not have any spaces before or after the = sign.</para>
<para>If you are on a local network then a sensible option
@ -6658,7 +6658,7 @@
be formatted as the output of the standard Unix <command>env(1)
</command> command. This is of the form :</para>
<para>Example environment entry:</para>
<para><command>SAMBA_NETBIOS_NAME=myhostname</command></para>
<para><command>SAMBA_NETBIOS_NAME = myhostname</command></para>
<para>Default: <emphasis>No default value</emphasis></para>
<para>Examples: <command>source environment = |/etc/smb.conf.sh
@ -6690,7 +6690,7 @@
<parameter>ssl hosts resign</parameter></link> whether an SSL
connection will be required.</para>
<para>Default: <command>ssl=no</command></para>
<para>Default: <command>ssl = no</command></para>
</listitem>
</varlistentry>
@ -7957,7 +7957,7 @@
<listitem><para>This controls what workgroup your server will
appear to be in when queried by clients. Note that this parameter
also controls the Domain name used with the <link
linkend="SECURITYEQUALSDOMAIN"><command>security=domain</command></link>
linkend="SECURITYEQUALSDOMAIN"><command>security = domain</command></link>
setting.</para>
<para>Default: <emphasis>set at compile time to WORKGROUP</emphasis></para>