From 1ca175186281673e5d52d5a1a8ed41bf2d85c4ae Mon Sep 17 00:00:00 2001 From: Tim Potter Date: Tue, 11 Sep 2001 05:19:10 +0000 Subject: Standardised on 'var = value' when referencing smb.conf parameters, rather than 'var=value'. Fixed up some dodgy quoting on the way. (This used to be commit 0606c194d6e3aba0c1aac883fe04e0c6e9e9a578) --- docs/docbook/manpages/smb.conf.5.sgml | 78 +++++++++++++++++------------------ 1 file changed, 39 insertions(+), 39 deletions(-) diff --git a/docs/docbook/manpages/smb.conf.5.sgml b/docs/docbook/manpages/smb.conf.5.sgml index 08938fa153..ea32a05c67 100644 --- a/docs/docbook/manpages/smb.conf.5.sgml +++ b/docs/docbook/manpages/smb.conf.5.sgml @@ -92,7 +92,7 @@ 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. @@ -168,11 +168,11 @@ the user's home directory. - If you decide to use a path= line + If you decide to use a path = line in your [homes] section then you may find it useful to use the %S macro. For example : - path=/data/pchome/%S + path = /data/pchome/%S would be useful if you have different home directories for your PCs than for UNIX access. @@ -209,9 +209,9 @@ Note that the browseable 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. + it means setting browseable = no in + the [homes] section will hide the [homes] share but make + any auto home directories visible. @@ -484,7 +484,7 @@ - mangle case= yes/no + mangle case = yes/no 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 @@ smb.conf 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. @@ -1011,8 +1011,8 @@ ON DEMAND when a user accesses the Samba server. In order to use this option, smbd - must be set to security=server or - security=domain and add user script + must be set to security = server or + security = domain and add user script must be set to a full pathname for a script that will create a UNIX user given one argument of %u, which expands into the UNIX user name to create. @@ -1652,7 +1652,7 @@ See also the force create mode parameter for forcing particular mode bits to be set on created files. See also the - directory mode" parameter for masking + directory mode parameter for masking mode bits on created directories. See also the inherit permissions parameter. @@ -1783,7 +1783,7 @@ default case (S) See the section on NAME MANGLING. Also note the - short preserve case" parameter. + short preserve case parameter. Default: default case = lower @@ -1951,17 +1951,17 @@ Windows NT user no longer exists. In order to use this option, smbd must be - set to security=domain and delete + set to security = domain and delete user script must be set to a full pathname for a script that will delete a UNIX user given one argument of %u , which expands into the UNIX user name to delete. NOTE that this is different to the add user script - which will work with the security=server option - as well as security=domain. The reason for this + which will work with the security = server option + as well as security = domain. 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 - security=server mode a missing user + security = server 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. @@ -1982,7 +1982,7 @@ UNIX users are dynamically deleted to match existing Windows NT accounts. - See also security=domain, + See also security = domain, password server , add user script . @@ -2409,7 +2409,7 @@ file (see the smbpasswd(8) program for information on how to set up and maintain this file), or set the security=[serve|domain] parameter which + linkend="SECURITY">security = [server|domain] parameter which causes smbd to authenticate against another server. @@ -3662,7 +3662,7 @@ If a %p is given then the printername is put in its place. A %j is replaced with - the job number (an integer). On HPUX (see printing=hpux + the job number (an integer). On HPUX (see printing = hpux ), if the -p%p 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 @@ machine password timeout (G) If a Samba server is a member of an Windows - NT Domain (see the security=domain) + NT Domain (see the security = domain) parameter) then periodically a running smbd(8) process will try and change the MACHINE ACCOUNT PASSWORD stored in the TDB called private/secrets.tdb @@ -3846,7 +3846,7 @@ See also smbpasswd(8) , and the - security=domain) parameter. + security = domain) parameter. Default: machine password timeout = 604800 @@ -4097,7 +4097,7 @@ map to guest (G) This parameter is only useful in - security modes other than security=share + security modes other than security = share - i.e. user, server, and domain. @@ -4334,13 +4334,13 @@ max wins ttl (G) This option tells nmbd(8) when acting as a WINS server ( - wins support=yes) what the maximum + wins support = yes) what the maximum 'time to live' of NetBIOS names that nmbd will grant will be (in seconds). You should never need to change this parameter. The default is 6 days (518400 seconds). See also the min - wins ttl" parameter. + wins ttl parameter. Default: max wins ttl = 518400 @@ -5179,13 +5179,13 @@ smbd makes a connection to a password server, and then the password server fails, no more users will be able to be authenticated from this smbd. This is a - restriction of the SMB/CIFS protocol when in security=server + restriction of the SMB/CIFS protocol when in security = server mode and cannot be fixed in Samba. 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 - security=server mode the network logon will appear to + security = server mode the network logon will appear to come from there rather than from the users workstation. @@ -5452,14 +5452,14 @@ the parameter varies depending on the setting of the printing parameter. - Default: For printing= BSD, AIX, QNX, LPRNG + Default: For printing = BSD, AIX, QNX, LPRNG or PLP : print command = lpr -r -P%p %s - For printing= SYS or HPUX : + For printing = SYS or HPUX : print command = lp -c -d%p %s; rm %s - For printing=SOFTQ : + For printing = SOFTQ : print command = lp -d%p -s %s; rm %s Example: print command = /usr/local/samba/bin/myprintscript @@ -6155,7 +6155,7 @@ Windows NT. The alternatives are security = share, - security = server or security=domain + security = server or security = domain . In versions of Samba prior to 2..0, the default was @@ -6263,7 +6263,7 @@ 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 username map parameter). Encrypted passwords (see the @@ -6414,7 +6414,7 @@ server string (G) This controls what string will show up in the printer comment box in print manager and next to the IPC connection - in net view". It can be any string that you wish + in net view. It can be any string that you wish to show to your users. 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. - To specify an argument use the syntax SOME_OPTION=VALUE - for example SO_SNDBUF=8192. Note that you must + To specify an argument use the syntax SOME_OPTION = VALUE + for example SO_SNDBUF = 8192. Note that you must not have any spaces before or after the = sign. If you are on a local network then a sensible option @@ -6658,7 +6658,7 @@ be formatted as the output of the standard Unix env(1) command. This is of the form : Example environment entry: - SAMBA_NETBIOS_NAME=myhostname + SAMBA_NETBIOS_NAME = myhostname Default: No default value Examples: source environment = |/etc/smb.conf.sh @@ -6690,7 +6690,7 @@ ssl hosts resign whether an SSL connection will be required. - Default: ssl=no + Default: ssl = no @@ -7957,7 +7957,7 @@ 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 security=domain + linkend="SECURITYEQUALSDOMAIN">security = domain setting. Default: set at compile time to WORKGROUP -- cgit