diff options
Diffstat (limited to 'docs/manpages/smb.conf.5')
| -rw-r--r-- | docs/manpages/smb.conf.5 | 278 |
1 files changed, 139 insertions, 139 deletions
diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5 index 818b26814f5..0c7229ce202 100644 --- a/docs/manpages/smb.conf.5 +++ b/docs/manpages/smb.conf.5 @@ -1,4 +1,4 @@ -.TH "smb\&.conf" "5" "23 Oct 1998" "Samba" "SAMBA" +.TH "smb\&.conf " "5" "23 Oct 1998" "Samba" "SAMBA" .PP .SH "NAME" smb\&.conf \- The configuration file for the Samba suite @@ -74,7 +74,7 @@ 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 \fB"user="\fP option in the share definition\&. For modern clients such as Windows 95/98 and -Windows NT, this should not be neccessary\&. +Windows NT, this should not be necessary\&. .PP Note that the access rights granted by the server are masked by the access rights granted to the specified or guest UNIX user by the host @@ -92,7 +92,7 @@ the share name "foo": [foo] path = /home/bar - writable = true + writeable = true .DE @@ -179,7 +179,7 @@ following is a typical and suitable [homes] section: [homes] - writable = yes + writeable = yes .DE @@ -232,7 +232,7 @@ given, the username is set to the located printer name\&. Note that the [printers] service MUST be printable - if you specify otherwise, the server will refuse to load the configuration file\&. .IP -Typically the path specified would be that of a world-writable spool +Typically the path specified would be that of a world-writeable spool directory with the sticky bit set on it\&. A typical [printers] entry would look like this: .IP @@ -242,7 +242,7 @@ would look like this: [printers] path = /usr/spool/public - writable = no + writeable = no guest ok = yes printable = yes @@ -266,7 +266,7 @@ this: .IP Each alias should be an acceptable printer name for your printing subsystem\&. In the \fB[global]\fP section, specify the new -file as your printcap\&. The server will then only recognise names +file as your printcap\&. The server will then only recognize names found in your pseudo-printcap, which of course can contain whatever aliases you like\&. The same technique could be used simply to limit access to a subset of your local printers\&. @@ -280,7 +280,7 @@ NOTE: On SYSV systems which use lpstat to determine what printers are defined on the system you may be able to use \fB"printcap name = lpstat"\fP to automatically obtain a list of printers\&. See the \fB"printcap name"\fP option for -more detils\&. +more details\&. .IP .PP .SH "PARAMETERS" @@ -288,8 +288,8 @@ more detils\&. Parameters define the specific attributes of sections\&. .PP Some parameters are specific to the \fB[global]\fP section -(eg\&., \fBsecurity\fP)\&. Some parameters are usable in -all sections (eg\&., \fBcreate mode\fP)\&. All others are +(e\&.g\&., \fBsecurity\fP)\&. Some parameters are usable in +all sections (e\&.g\&., \fBcreate mode\fP)\&. All others are permissible only in normal sections\&. For the purposes of the following descriptions the \fB[homes]\fP and \fB[printers]\fP sections will be considered normal\&. @@ -298,7 +298,7 @@ specific to the \fB[global]\fP section\&. The letter \f(CW\'S\'\fP indicates that a parameter can be specified in a service specific section\&. Note that all \f(CW\'S\'\fP parameters can also be specified in the \fB[global]\fP section - in which case they will define -the default behaviour for all services\&. +the default behavior for all services\&. .PP Parameters are arranged here in alphabetical order - this may not create best bedfellows, but at least you can find them! Where there @@ -375,8 +375,8 @@ negotiation\&. It can be one of CORE, COREPLUS, LANMAN1, LANMAN2 or NT1\&. .IP .IP o \fB%a\fP = the architecture of the remote -machine\&. Only some are recognised, and those may not be 100% -reliable\&. It currently recognises Samba, WfWg, WinNT and +machine\&. Only some are recognized, and those may not be 100% +reliable\&. It currently recognizes Samba, WfWg, WinNT and Win95\&. Anything else will be known as "UNKNOWN"\&. If it gets it wrong then sending a level 3 log to \fIsamba-bugs@samba\&.anu\&.edu\&.au\fP should allow it to be fixed\&. @@ -1306,7 +1306,7 @@ regardless if the owner of the file is the currently logged on user or not\&. This specifies what type of server \fBnmbd\fP will announce itself as, to a network neighborhood browse list\&. By default this is set to Windows NT\&. The valid options are : "NT", "Win95" or -"WfW" meaining Windows NT, Windows 95 and Windows for Workgroups +"WfW" meaning Windows NT, Windows 95 and Windows for Workgroups respectively\&. Do not change this parameter unless you have a specific need to stop Samba appearing as an NT server as this may prevent Samba servers from participating as browser servers correctly\&. @@ -1388,7 +1388,7 @@ the interface list given in the \fB\'interfaces\'\fP parameter\&. This restricts the networks that \fBsmbd\fP will serve to packets coming in those interfaces\&. Note that you should not use this parameter for machines that are serving PPP or -other intermittant or non-broadcast network interfaces as it will not +other intermittent or non-broadcast network interfaces as it will not cope with non-permanent interfaces\&. .IP In addition, to change a users SMB password, the @@ -1433,16 +1433,9 @@ This parameter can be set per share\&. \fBExample:\fP \f(CW blocking locks = False\fP .IP -.IP "\fBbroweable (S)\fP" +.IP "\fBbrowseable (S)\fP" .IP -This controls whether this share is seen in the list of available -shares in a net view and in the browse list\&. -.IP -\fBDefault:\fP -\f(CW browsable = Yes\fP -.IP -\fBExample:\fP -\f(CW browsable = No\fP +Synonym for \fBbrowseable\fP\&. .IP .IP "\fBbrowse list(G)\fP" .IP @@ -1455,7 +1448,14 @@ should never need to change this\&. .IP .IP "\fBbrowseable\fP" .IP -Synonym for \fBbrowsable\fP\&. +This controls whether this share is seen in the list of available +shares in a net view and in the browse list\&. +.IP +\fBDefault:\fP +\f(CW browseable = Yes\fP +.IP +\fBExample:\fP +\f(CW browseable = No\fP .IP .IP "\fBcase sensitive (G)\fP" .IP @@ -1549,7 +1549,7 @@ described more fully in the manual page \fBmake_smbcodepage to map lower to upper case characters to provide the case insensitivity of filenames that Windows clients expect\&. .IP -Samba currenly ships with the following code page files : +Samba currently ships with the following code page files : .IP .IP .IP o @@ -1642,12 +1642,12 @@ Shift-JIS to JUNET code with different shift-in, shift out codes\&. .IP .IP o \fBHEX\fP Convert an incoming Shift-JIS character to a 3 byte hex -representation, ie\&. \f(CW:AB\fP\&. +representation, i\&.e\&. \f(CW:AB\fP\&. .IP .IP o \fBCAP\fP Convert an incoming Shift-JIS character to the 3 byte hex -representation used by the Columbia Appletalk Program (CAP), -ie\&. \f(CW:AB\fP\&. This is used for compatibility between Samba and CAP\&. +representation used by the Columbia AppleTalk Program (CAP), +i\&.e\&. \f(CW:AB\fP\&. This is used for compatibility between Samba and CAP\&. .IP .IP .IP "\fBcomment (S)\fP" @@ -1704,7 +1704,7 @@ in the configuration file than the service doing the copying\&. .IP A synonym for this parameter is \fB\'create mode\'\fP\&. .IP -When a file is created, the neccessary permissions are calculated +When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to UNIX permissions, and the resulting UNIX mode is then bit-wise \'AND\'ed with this parameter\&. This parameter may be thought of as a bit-wise MASK for the UNIX modes @@ -1859,7 +1859,7 @@ If this option is set to True, then Samba will attempt to recursively delete any files and directories within the vetoed directory\&. This can be useful for integration with file serving systems such as \fBNetAtalk\fP, which create meta-files within directories you might normally veto -DOS/Windows users from seeing (eg\&. \f(CW\&.AppleDouble\fP) +DOS/Windows users from seeing (e\&.g\&. \f(CW\&.AppleDouble\fP) .IP Setting \f(CW\'delete veto files = True\'\fP allows these directories to be transparently deleted when the parent directory is deleted (so long @@ -1908,7 +1908,7 @@ return value can give the block size in bytes\&. The default blocksize is 1024 bytes\&. .IP Note: Your script should \fINOT\fP be setuid or setgid and should be -owned by (and writable only by) root! +owned by (and writeable only by) root! .IP \fBDefault:\fP \f(CW By default internal routines for determining the disk capacity @@ -1955,7 +1955,7 @@ Synonym for \fBpath\fP\&. This parameter is the octal modes which are used when converting DOS modes to UNIX modes when creating UNIX directories\&. .IP -When a directory is created, the neccessary permissions are calculated +When a directory is created, the necessary permissions are calculated according to the mapping from DOS modes to UNIX permissions, and the resulting UNIX mode is then bit-wise \'AND\'ed with this parameter\&. This parameter may be thought of as a bit-wise MASK for the UNIX modes @@ -1968,7 +1968,7 @@ directory to modify it\&. .IP Following this Samba will bit-wise \'OR\' the UNIX mode created from this parameter with the value of the "force directory mode" -parameter\&. This parameter is set to 000 by default (ie\&. no extra mode +parameter\&. This parameter is set to 000 by default (i\&.e\&. no extra mode bits are added)\&. .IP See the \fB"force directory mode"\fP parameter @@ -2012,7 +2012,7 @@ See also the parameter \fBwins support\fP\&. This is an \fBEXPERIMENTAL\fP parameter that is part of the unfinished Samba NT Domain Controller Code\&. It may be removed in a later release\&. To work with the latest code builds that may have more support for -Samba NT Domain Controller functionality please subscibe to the +Samba NT Domain Controller functionality please subscribe to the mailing list \fBSamba-ntdom\fP available by sending email to \fIlistproc@samba\&.anu\&.edu\&.au\fP .IP @@ -2021,7 +2021,7 @@ mailing list \fBSamba-ntdom\fP available by sending email to This is an \fBEXPERIMENTAL\fP parameter that is part of the unfinished Samba NT Domain Controller Code\&. It may be removed in a later release\&. To work with the latest code builds that may have more support for -Samba NT Domain Controller functionality please subscibe to the +Samba NT Domain Controller functionality please subscribe to the mailing list \fBSamba-ntdom\fP available by sending email to \fIlistproc@samba\&.anu\&.edu\&.au\fP .IP @@ -2036,7 +2036,7 @@ files\&. It is left behind for compatibility reasons\&. This is an \fBEXPERIMENTAL\fP parameter that is part of the unfinished Samba NT Domain Controller Code\&. It may be removed in a later release\&. To work with the latest code builds that may have more support for -Samba NT Domain Controller functionality please subscibe to the +Samba NT Domain Controller functionality please subscribe to the mailing list \fBSamba-ntdom\fP available by sending email to \fIlistproc@samba\&.anu\&.edu\&.au\fP .IP @@ -2045,7 +2045,7 @@ mailing list \fBSamba-ntdom\fP available by sending email to This is an \fBEXPERIMENTAL\fP parameter that is part of the unfinished Samba NT Domain Controller Code\&. It may be removed in a later release\&. To work with the latest code builds that may have more support for -Samba NT Domain Controller functionality please subscibe to the +Samba NT Domain Controller functionality please subscribe to the mailing list \fBSamba-ntdom\fP available by sending email to \fIlistproc@samba\&.anu\&.edu\&.au\fP .IP @@ -2054,7 +2054,7 @@ mailing list \fBSamba-ntdom\fP available by sending email to This is an \fBEXPERIMENTAL\fP parameter that is part of the unfinished Samba NT Domain Controller Code\&. It may be removed in a later release\&. To work with the latest code builds that may have more support for -Samba NT Domain Controller functionality please subscibe to the +Samba NT Domain Controller functionality please subscribe to the mailing list \fBSamba-ntdom\fP available by sending email to \fIlistproc@samba\&.anu\&.edu\&.au\fP .IP @@ -2067,7 +2067,7 @@ Samba documentation directory \f(CWdocs/\fP shipped with the source code\&. .IP Note that Win95/98 Domain logons are \fINOT\fP the same as Windows NT Domain logons\&. NT Domain logons require a Primary Domain Controller -(PDC) for the Domain\&. It is inteded that in a future release Samba +(PDC) for the Domain\&. It is intended that in a future release Samba will be able to provide this functionality for Windows NT clients also\&. .IP @@ -2077,7 +2077,7 @@ also\&. .IP "\fBdomain master (G)\fP" .IP Tell \fBnmbd\fP to enable WAN-wide browse list -collation\&.Setting this option causes \fBnmbd\fP to +collation\&. Setting this option causes \fBnmbd\fP to claim a special domain specific NetBIOS name that identifies it as a domain master browser for its given \fBworkgroup\fP\&. Local master browsers in the same @@ -2091,7 +2091,7 @@ list, instead of just the list for their broadcast-isolated subnet\&. Note that Windows NT Primary Domain Controllers expect to be able to claim this \fBworkgroup\fP specific special NetBIOS name that identifies them as domain master browsers for that -\fBworkgroup\fP by default (ie\&. there is no way to +\fBworkgroup\fP by default (i\&.e\&. there is no way to prevent a Windows NT PDC from attempting to do this)\&. This means that if this parameter is set and \fBnmbd\fP claims the special name for a \fBworkgroup\fP before a Windows NT @@ -2103,7 +2103,7 @@ and may fail\&. .IP .IP "\fBdont descend (S)\fP" .IP -There are certain directories on some systems (eg\&., the \f(CW/proc\fP tree +There are certain directories on some systems (e\&.g\&., the \f(CW/proc\fP tree under Linux) that are either not of interest to clients or are infinitely deep (recursive)\&. This parameter allows you to specify a comma-delimited list of directories that the server should always show @@ -2121,7 +2121,7 @@ just \f(CW"/proc"\fP\&. Experimentation is the best policy :-) .IP .IP "\fBdos filetime resolution (S)\fP" .IP -Under the DOS and Windows FAT filesystem, the finest granulatity on +Under the DOS and Windows FAT filesystem, the finest granularity on time resolution is two seconds\&. Setting this parameter for a share causes Samba to round the reported time down to the nearest two second boundary when a query call that requires one second resolution is made @@ -2151,7 +2151,7 @@ the timestamp on it\&. Under POSIX semantics, only the owner of the file or root may change the timestamp\&. By default, Samba runs with POSIX semantics and refuses to change the timestamp on a file if the user smbd is acting on behalf of is not the file owner\&. Setting this option -to True allows DOS semantics and smbd will change the file timstamp as +to True allows DOS semantics and smbd will change the file timestamp as DOS requires\&. .IP \fBDefault:\fP @@ -2247,10 +2247,10 @@ This parameter allows the Samba administrator to stop particular share\&. Setting this parameter to \fI"No"\fP prevents any file or directory that is a symbolic link from being followed (the user will get an error)\&. This option is very useful to stop users from -adding a symbolic link to \f(CW/etc/pasword\fP in their home directory for +adding a symbolic link to \f(CW/etc/passwd\fP in their home directory for instance\&. However it will slow filename lookups down slightly\&. .IP -This option is enabled (ie\&. \fBsmbd\fP will follow +This option is enabled (i\&.e\&. \fBsmbd\fP will follow symbolic links) by default\&. .IP .IP "\fBforce create mode (S)\fP" @@ -2258,7 +2258,7 @@ symbolic links) by default\&. This parameter specifies a set of UNIX mode bit permissions that will \fI*always*\fP be set on a file created by Samba\&. This is done by bitwise \'OR\'ing these bits onto the mode bits of a file that is being -created\&. The default for this parameter is (in octel) 000\&. The modes +created\&. The default for this parameter is (in octal) 000\&. The modes in this parameter are bitwise \'OR\'ed onto the file mode after the mask set in the \fB"create mask"\fP parameter is applied\&. .IP @@ -2280,7 +2280,7 @@ the \'user\'\&. This parameter specifies a set of UNIX mode bit permissions that will \fI*always*\fP be set on a directory created by Samba\&. This is done by bitwise \'OR\'ing these bits onto the mode bits of a directory that is -being created\&. The default for this parameter is (in octel) 0000 which +being created\&. The default for this parameter is (in octal) 0000 which will not add any extra permission bits to a created directory\&. This operation is done after the mode mask in the parameter \fB"directory mask"\fP is applied\&. @@ -2351,7 +2351,7 @@ Windows NT but this can be changed to other strings such as "Samba" or .IP .IP "\fBgetwd cache (G)\fP" .IP -This is a tuning option\&. When this is enabled a cacheing algorithm +This is a tuning option\&. When this is enabled a caching algorithm will be used to reduce the time taken for getwd() calls\&. This can have a significant impact on performance, especially when the \fBwidelinks\fP parameter is set to False\&. @@ -2440,8 +2440,8 @@ Each entry in the list must be separated by a \f(CW\'/\'\fP, which allows spaces to be included in the entry\&. \f(CW\'*\'\fP and \f(CW\'?\'\fP can be used to specify multiple files or directories as in DOS wildcards\&. .IP -Each entry must be a unix path, not a DOS path and must not include the -unix directory separator \f(CW\'/\'\fP\&. +Each entry must be a Unix path, not a DOS path and must not include the +Unix directory separator \f(CW\'/\'\fP\&. .IP Note that the case sensitivity option is applicable in hiding files\&. .IP @@ -2623,7 +2623,7 @@ parameter allows the use of them to be turned on or off\&. Kernel oplocks support allows Samba \fBoplocks\fP to be broken whenever a local UNIX process or NFS operation accesses a file that \fBsmbd\fP has oplocked\&. This allows complete -data consistancy between SMB/CIFS, NFS and local file access (and is a +data consistency between SMB/CIFS, NFS and local file access (and is a \fIvery\fP cool feature :-)\&. .IP This parameter defaults to \fI"On"\fP on systems that have the support, @@ -2769,7 +2769,7 @@ will be loaded for browsing by default\&. See the \fBDefault:\fP \f(CW load printers = yes\fP .IP -bg(Example:) +\fBExample:\fP \f(CW load printers = no\fP .IP .IP "\fBlocal master (G)\fP" @@ -2895,15 +2895,15 @@ client\&. The share must be writeable when the logs in for the first time, in order that the Windows 95/98 client can create the user\&.dat and other directories\&. .IP -Thereafter, the directories and any of contents can, if required, be -made read-only\&. It is not adviseable that the USER\&.DAT file be made +Thereafter, the directories and any of the contents can, if required, be +made read-only\&. It is not advisable that the USER\&.DAT file be made read-only - rename it to USER\&.MAN to achieve the desired effect (a \fIMAN\fPdatory profile)\&. .IP Windows clients can sometimes maintain a connection to the [homes] share, even though there is no user logged in\&. Therefore, it is vital that the logon path does not include a reference to the homes share -(i\&.e setting this parameter to \f(CW\e\e%N\eHOMES\eprofile_path\fP will cause +(i\&.e\&. setting this parameter to \f(CW\e\e%N\eHOMES\eprofile_path\fP will cause problems)\&. .IP This option takes the standard substitutions, allowing you to have @@ -2934,7 +2934,7 @@ file that will be downloaded is: .IP The contents of the batch file is entirely your choice\&. A suggested command would be to add \f(CWNET TIME \e\eSERVER /SET /YES\fP, to force every -machine to synchronise clocks with the same time server\&. Another use +machine to synchronize clocks with the same time server\&. Another use would be to add \f(CWNET USE U: \e\eSERVER\eUTILS\fP for commonly used utilities, or \f(CWNET USE Q: \e\eSERVER\eISO9001_QA\fP for example\&. .IP @@ -3006,7 +3006,7 @@ previous identical \fBlpq\fP command will be used if the cached data is less than 10 seconds old\&. A large value may be advisable if your \fBlpq\fP command is very slow\&. .IP -A value of 0 will disable cacheing completely\&. +A value of 0 will disable caching completely\&. .IP See also the \fB"printing"\fP parameter\&. .IP @@ -3178,8 +3178,8 @@ See the section on \fB"NAME MANGLING"\fP\&. .IP .IP "\fBmangled map (S)\fP" .IP -This is for those who want to directly map UNIX file names which are -not representable on Windows/DOS\&. The mangling of names is not always +This is for those who want to directly map UNIX file names which can +not be represented on Windows/DOS\&. The mangling of names is not always what is needed\&. In particular you may have documents with file extensions that differ between DOS and UNIX\&. For example, under UNIX it is common to use \f(CW"\&.html"\fP for HTML files, whereas under @@ -3190,7 +3190,7 @@ So to map \f(CW"html"\fP to \f(CW"htm"\fP you would use: \f(CW mangled map = (*\&.html *\&.htm)\fP .IP One very useful case is to remove the annoying \f(CW";1"\fP off the ends -of filenames on some CDROMS (only visible under some UNIXes)\&. To do +of filenames on some CDROMS (only visible under some UNIXs)\&. To do this use a map of (*;1 *)\&. .IP \fBdefault:\fP @@ -3309,7 +3309,7 @@ source code, documents, etc\&.\&.\&. .IP Note that this requires the \fB"create mask"\fP parameter to be set such that owner execute bit is not masked out -(ie\&. it must include 100)\&. See the parameter \fB"create +(i\&.e\&. it must include 100)\&. See the parameter \fB"create mask"\fP for details\&. .IP \fBDefault:\fP @@ -3324,7 +3324,7 @@ This controls whether DOS style hidden files should be mapped to the UNIX world execute bit\&. .IP Note that this requires the \fB"create mask"\fP to be -set such that the world execute bit is not masked out (ie\&. it must +set such that the world execute bit is not masked out (i\&.e\&. it must include 001)\&. See the parameter \fB"create mask"\fP for details\&. .IP @@ -3340,7 +3340,7 @@ This controls whether DOS style system files should be mapped to the UNIX group execute bit\&. .IP Note that this requires the \fB"create mask"\fP to be -set such that the group execute bit is not masked out (ie\&. it must +set such that the group execute bit is not masked out (i\&.e\&. it must include 010)\&. See the parameter \fB"create mask"\fP for details\&. .IP @@ -3353,7 +3353,7 @@ for details\&. .IP "\fBmap to guest (G)\fP" .IP This parameter is only useful in \fBsecurity\fP modes -other than \fB"security=share"\fP - ie\&. user, +other than \fB"security=share"\fP - i\&.e\&. user, server, and domain\&. .IP This parameter can take three different values, which tell @@ -3377,7 +3377,7 @@ account"\fP\&. \fB"Bad Password"\fP - Means user logins with an invalid password are treated as a guest login and mapped into the \fB"guest account"\fP\&. Note that this can -cause problems as it means that any user mistyping their +cause problems as it means that any user incorrectly typing their password will be silently logged on a \fB"guest"\fP - and will not know the reason they cannot access files they think they should - there will have been no message given to them @@ -3473,7 +3473,7 @@ never need to set this parameter\&. This parameter limits the maximum number of open files that one \fBsmbd\fP file serving process may have open for a client at any one time\&. The default for this parameter is set -very high (10,000) as Samba uses only one bit per un-opened file\&. +very high (10,000) as Samba uses only one bit per unopened file\&. .IP The limit of the number of open files is usually set by the UNIX per-process file descriptor limit rather than this parameter @@ -3726,7 +3726,7 @@ system and the Samba server with this option must also be a .IP .IP "\fBnt pipe support (G)\fP" .IP -This boolean parameter controlls whether \fBsmbd\fP +This boolean parameter controls whether \fBsmbd\fP will allow Windows NT clients to connect to the NT SMB specific \f(CWIPC$\fP pipes\&. This is a developer debugging option and can be left alone\&. @@ -3736,7 +3736,7 @@ alone\&. .IP .IP "\fBnt smb support (G)\fP" .IP -This boolean parameter controlls whether \fBsmbd\fP +This boolean parameter controls whether \fBsmbd\fP will negotiate NT specific SMB support with Windows NT clients\&. Although this is a developer debugging option and should be left alone, benchmarking has discovered that Windows NT clients give @@ -3808,15 +3808,15 @@ See also the \fBuser\fP parameter\&. .IP This boolean option tells smbd whether to issue oplocks (opportunistic locks) to file open requests on this share\&. The oplock code can -dramatically (approx 30% or more) improve the speed of access to files -on Samba servers\&. It allows the clients to agressively cache files +dramatically (approx\&. 30% or more) improve the speed of access to files +on Samba servers\&. It allows the clients to aggressively cache files locally and you may want to disable this option for unreliable network environments (it is turned on by default in Windows NT Servers)\&. For more information see the file Speed\&.txt in the Samba docs/ directory\&. .IP Oplocks may be selectively turned off on certain files on a per share basis\&. -See the \'veto oplock files\' parameter\&. On some systems oplocks are recognised -by the underlying operating system\&. This allows data synchronisation between +See the \'veto oplock files\' parameter\&. On some systems oplocks are recognized +by the underlying operating system\&. This allows data synchronization between all access to oplocked files, whether it be via Samba or NFS or a local UNIX process\&. See the \fBkernel oplocks\fP parameter for details\&. @@ -3854,7 +3854,7 @@ old \fBsmb\&.conf\fP files\&. This is a Samba developer option that allows a system command to be called when either \fBsmbd\fP or \fBnmbd\fP crashes\&. This is usually used to draw -attention to the fact that a problem occured\&. +attention to the fact that a problem occurred\&. .IP \fBDefault:\fP \f(CW panic action = <empty string>\fP @@ -3941,7 +3941,7 @@ program"\fP\&. .IP The name of a program that can be used to set UNIX user passwords\&. Any occurrences of \fB%u\fP will be replaced with the -user name\&. The user name is checked for existance before calling the +user name\&. The user name is checked for existence before calling the password changing program\&. .IP Also note that many passwd programs insist in \fI"reasonable"\fP @@ -3952,7 +3952,7 @@ Windows for Workgroups) uppercase the password before sending it\&. \fINote\fP that if the \fB"unix password sync"\fP parameter is set to \f(CW"True"\fP then this program is called \fI*AS ROOT*\fP before the SMB password in the -\fBsmbpassswd\fP file is changed\&. If this UNIX +\fBsmbpasswd\fP file is changed\&. If this UNIX password change fails, then \fBsmbd\fP will fail to change the SMB password also (this is by design)\&. .IP @@ -4045,8 +4045,8 @@ better restrict them with hosts allow! If the \fB"security"\fP parameter is set to \fB"domain"\fP, then the list of machines in this option must be a list of Primary or Backup Domain controllers for the -\fBDomain\fP, as the Samba server is cryptographically -in that domain, and will use crpytographically authenticated RPC calls +\fBDomain\fP, as the Samba server is cryptographicly +in that domain, and will use cryptographicly authenticated RPC calls to authenticate the user logging on\&. The advantage of using \fB"security=domain"\fP is that if you list several hosts in the \fB"password server"\fP option then @@ -4093,7 +4093,7 @@ where print data will spool prior to being submitted to the host for printing\&. .IP For a printable service offering guest access, the service should be -readonly and the path should be world-writable and have the sticky bit +readonly and the path should be world-writeable and have the sticky bit set\&. This is not mandatory of course, but you probably won\'t get the results you expect if you do otherwise\&. .IP @@ -4255,12 +4255,12 @@ If there is neither a specified print command for a printable service nor a global print command, spool files will be created but not processed and (most importantly) not removed\&. .IP -Note that printing may fail on some UNIXes from the \f(CW"nobody"\fP +Note that printing may fail on some UNIXs from the \f(CW"nobody"\fP account\&. If this happens then create an alternative guest account that can print and set the \fB"guest account"\fP in the \fB"[global]"\fP section\&. .IP -You can form quite complex print commands by realising that they are +You can form quite complex print commands by realizing that they are just passed to a shell\&. For example the following will log a print job, print the file, then remove it\&. Note that \f(CW\';\'\fP is the usual separator for command in shell scripts\&. @@ -4525,7 +4525,7 @@ command as the PATH may not be available to the server\&. .IP This parameter specifies the command to be executed on the server host in order to resume the printerqueue\&. It is the command to undo the -behaviour that is caused by the previous parameter +behavior that is caused by the previous parameter (\fB"queuepause command\fP)\&. .IP This command should be a program or script which takes a printer name @@ -4576,9 +4576,9 @@ the \fB"invalid users"\fP parameter\&. .IP "\fBread only (S)\fP" .IP Note that this is an inverted synonym for -\fB"writable"\fP and \fB"write ok"\fP\&. +\fB"writeable"\fP and \fB"write ok"\fP\&. .IP -See also \fB"writable"\fP and \fB"write +See also \fB"writeable"\fP and \fB"write ok"\fP\&. .IP .IP "\fBread prediction (G)\fP" @@ -4674,7 +4674,7 @@ See the documentation file BROWSING\&.txt in the docs/ directory\&. .IP "\fBremote browse sync (G)\fP" .IP This option allows you to setup \fBnmbd\fP to -periodically request synchronisation of browse lists with the master +periodically request synchronization of browse lists with the master browser of a samba server that is on a remote segment\&. This option will allow you to gain browse lists for multiple workgroups across routed networks\&. This is done in a manner that does not work with any @@ -4690,7 +4690,7 @@ For example: \f(CW remote browse sync = 192\&.168\&.2\&.255 192\&.168\&.4\&.255\fP .IP the above line would cause \fBnmbd\fP to request the -master browser on the specified subnets or addresses to synchronise +master browser on the specified subnets or addresses to synchronize their browse lists with the local server\&. .IP The IP addresses you choose would normally be the broadcast addresses @@ -4737,7 +4737,7 @@ Synonym for \fB"root directory"\fP\&. .IP .IP "\fBroot directory (G)\fP" .IP -The server will \f(CW"chroot()"\fP (ie\&. Change it\'s root directory) to +The server will \f(CW"chroot()"\fP (i\&.e\&. Change it\'s root directory) to this directory on startup\&. This is not strictly necessary for secure operation\&. Even without it the server will deny access to files not in one of the service entries\&. It may also check for, and deny access to, @@ -4774,7 +4774,7 @@ See also \fB"postexec"\fP\&. .IP This is the same as the \fB"preexec"\fP parameter except that the command is run as root\&. This is useful for mounting -filesystems (such as cdroms) before a connection is finalised\&. +filesystems (such as cdroms) before a connection is finalized\&. .IP See also \fB"preexec"\fP\&. .IP @@ -4803,7 +4803,7 @@ In previous versions of Samba the default was \fB"security=share"\fP mainly because that was the only option at one stage\&. .IP -There is a bug in WfWg that has relevence to this setting\&. When in +There is a bug in WfWg that has relevance to this setting\&. When in user or server level security a WfWg client will totally ignore the password you type in the "connect drive" dialog box\&. This makes it very difficult (if not impossible) to connect to a Samba service as @@ -4821,7 +4821,7 @@ difficult to setup guest shares with \fBsecurity=user\fP, see the \fB"map to guest"\fPparameter for details\&. .IP -It is possible to use \fBsmbd\fP in a \fI"hybred +It is possible to use \fBsmbd\fP in a \fI"hybrid mode"\fP where it is offers both user and share level security under different \fBNetBIOS aliases\fP\&. See the \fBNetBIOS aliases\fP and the @@ -4909,7 +4909,7 @@ are then applied and may change the UNIX user to use on this connection, but only after the user has been successfully authenticated\&. .IP -\fINote\fP that the the name of the resource being requested is +\fINote\fP that the name of the resource being requested is \fI*not*\fP sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\'t work in user level security without allowing the server to automatically map unknown @@ -4935,7 +4935,7 @@ the same as \fB"security=user"\fP\&. It only affects how the server deals with the authentication, it does not in any way affect what the client sees\&. .IP -\fINote\fP that the the name of the resource being requested is +\fINote\fP that the name of the resource being requested is \fI*not*\fP sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\'t work in server level security without allowing the server to automatically map unknown @@ -4968,7 +4968,7 @@ the same as \fB"security=user"\fP\&. It only affects how the server deals with the authentication, it does not in any way affect what the client sees\&. .IP -\fINote\fP that the the name of the resource being requested is +\fINote\fP that the name of the resource being requested is \fI*not*\fP sent to the server until after the server has successfully authenticated the client\&. This is why guest shares don\'t work in domain level security without allowing the server to automatically map unknown @@ -4981,7 +4981,7 @@ e,(BUG:) There is currently a bug in the implementation of set usernames\&. The communication with a Domain Controller must be done in UNICODE and Samba currently does not widen multi-byte user names to UNICODE correctly, thus a multi-byte -username will not be recognised correctly at the Domain Controller\&. +username will not be recognized correctly at the Domain Controller\&. This issue will be addressed in a future release\&. .IP See also the section \fB"NOTE ABOUT USERNAME/PASSWORD @@ -5032,7 +5032,7 @@ client\&. See the Pathworks documentation for details\&. .IP .IP "\fBshare modes (S)\fP" .IP -This enables or disables the honouring of the \f(CW"share modes"\fP during a +This enables or disables the honoring of the \f(CW"share modes"\fP during a file open\&. These modes are used by clients to gain exclusive read or write access to a file\&. .IP @@ -5136,9 +5136,9 @@ appropriate documentation for your operating system first (perhaps \fB"man setsockopt"\fP will help)\&. .IP You may find that on some systems Samba will say "Unknown socket -option" when you supply an option\&. This means you either mis-typed it -or you need to add an include file to includes\&.h for your OS\&. If the -latter is the case please send the patch to +option" when you supply an option\&. This means you either incorrectly +typed it or you need to add an include file to includes\&.h for your OS\&. +If the latter is the case please send the patch to \fIsamba-bugs@samba\&.anu\&.edu\&.au\fP\&. .IP Any of the supported socket options may be combined in any way you @@ -5237,7 +5237,7 @@ option \f(CW"--with-ssl"\fP was given at configure time\&. enabled by default in any current binary version of Samba\&. .IP This variable defines where to look up the Certification -Autorities\&. The given directory should contain one file for each CA +Authorities\&. The given directory should contain one file for each CA that samba will trust\&. The file name must be the hash value over the "Distinguished Name" of the CA\&. How this directory is set up is explained later in this document\&. All files within the directory that @@ -5260,7 +5260,7 @@ This variable is a second way to define the trusted CAs\&. The certificates of the trusted CAs are collected in one big file and this variable points to the file\&. You will probably only use one of the two ways to define your CAs\&. The first choice is preferable if you have -many CAs or want to be flexible, the second is perferable if you only +many CAs or want to be flexible, the second is preferable if you only have one CA and want to keep things simple (you won\'t need to create the hashed file names)\&. You don\'t need this variable if you don\'t verify client certificates\&. @@ -5485,7 +5485,7 @@ change this parameter\&. \fBDefault:\fP status = yes .IP -dir(\fBstrict locking (S)\fP) +.IP "\fBstrict locking (S)\fP" .IP This is a boolean that controls the handling of file locking in the server\&. When this is set to \f(CW"yes"\fP the server will check every read and @@ -5511,7 +5511,7 @@ Many Windows applications (including the Windows 98 explorer shell) seem to confuse flushing buffer contents to disk with doing a sync to disk\&. Under UNIX, a sync call forces the process to be suspended until the kernel has ensured that all outstanding data in kernel disk -buffers has been safely stored onto stable storate\&. This is very slow +buffers has been safely stored onto stable storage\&. This is very slow and should only be done rarely\&. Setting this parameter to "no" (the default) means that smbd ignores the Windows applications requests for a sync call\&. There is only a possibility of losing data if the @@ -5556,7 +5556,7 @@ See also the \fB"strict sync"\fP parameter\&. \fBDefault:\fP \f(CW sync always = no\fP .IP -\fBxample:\fP +\fBExample:\fP \f(CW sync always = yes\fP .IP .IP "\fBsyslog (G)\fP" @@ -5564,9 +5564,9 @@ See also the \fB"strict sync"\fP parameter\&. This parameter maps how Samba debug messages are logged onto the system syslog logging levels\&. Samba debug level zero maps onto syslog LOG_ERR, debug level one maps onto LOG_WARNING, debug level two maps -to LOG_NOTICE, debug level three maps onto LOG_INFO\&. The paramter +to LOG_NOTICE, debug level three maps onto LOG_INFO\&. The parameter sets the threshold for doing the mapping, all Samba debug messages -above this threashold are mapped to syslog LOG_DEBUG messages\&. +above this threshold are mapped to syslog LOG_DEBUG messages\&. .IP \fBDefault:\fP \f(CW syslog = 1\fP @@ -5617,7 +5617,7 @@ parameter allows the timestamping to be turned off\&. .IP .IP "\fBunix password sync (G)\fP" .IP -This boolean parameter controlls whether Samba attempts to synchronise +This boolean parameter controls whether Samba attempts to synchronize the UNIX password with the SMB password when the encrypted SMB password in the smbpasswd file is changed\&. If this is set to true the program specified in the \fB"passwd program"\fP @@ -5777,7 +5777,7 @@ tries all lowercase, followed by the username with the first letter capitalized, and fails if the username is not found on the UNIX machine\&. .IP -If this parameter is set to non-zero the behaviour changes\&. This +If this parameter is set to non-zero the behavior changes\&. This parameter is a number that specifies the number of uppercase combinations to try whilst trying to determine the UNIX user name\&. The higher the number the more combinations will be tried, but the slower @@ -5792,7 +5792,7 @@ strange usernames on your UNIX machine, such as \f(CW"AstrangeUser"\fP\&. .IP .IP "\fBusername map (G)\fP" .IP -This option allows you to to specify a file containing a mapping of +This option allows you to specify a file containing a mapping of usernames from the clients to the server\&. This can be used for several purposes\&. The most common is to map usernames that users use on DOS or Windows machines to those that the UNIX box uses\&. The other is to map @@ -5927,7 +5927,7 @@ See also the \fB"client code page"\fP parameter\&. Samba defaults to using a reasonable set of valid characters - for english systems + for English systems .DE @@ -5936,7 +5936,7 @@ See also the \fB"client code page"\fP parameter\&. \fBExample\fP \f(CW valid chars = 0345:0305 0366:0326 0344:0304\fP .IP -The above example allows filenames to have the swedish characters in +The above example allows filenames to have the Swedish characters in them\&. .IP NOTE: It is actually quite difficult to correctly produce a \fB"valid @@ -6124,42 +6124,19 @@ network\&. .IP "\fBworkgroup (G)\fP" .IP This controls what workgroup your server will appear to be in when -queried by clients\&. Note that this parameter also controlls the Domain +queried by clients\&. Note that this parameter also controls the Domain name used with the \fB"security=domain"\fP setting\&. .IP \fBDefault:\fP \f(CW set at compile time to WORKGROUP\fP .IP -\&.B Example: +\fBExample:\fP workgroup = MYGROUP .IP .IP "\fBwritable (S)\fP" .IP -An inverted synonym is \fB"read only"\fP\&. -.IP -If this parameter is \f(CW"no"\fP, then users of a service may not create -or modify files in the service\'s directory\&. -.IP -Note that a printable service \fB("printable = yes")\fP -will \fI*ALWAYS*\fP allow writing to the directory (user privileges -permitting), but only via spooling operations\&. -.IP -\fBDefault:\fP -\f(CW writable = no\fP -.IP -\fBExamples:\fP - -.DS - - - read only = no - writable = yes - write ok = yes - -.DE - - +Synonym for \fB"writeable"\fP for people who can\'t spell :-)\&. .IP .IP "\fBwrite list (S)\fP" .IP @@ -6182,7 +6159,7 @@ See also the \fB"read list"\fP option\&. .IP .IP "\fBwrite ok (S)\fP" .IP -Synonym for \fBwritable\fP\&. +Synonym for \fBwriteable\fP\&. .IP .IP "\fBwrite raw (G)\fP" .IP @@ -6195,7 +6172,30 @@ need to change this parameter\&. .IP .IP "\fBwriteable\fP" .IP -Synonym for \fB"writable"\fP for people who can\'t spell :-)\&. +An inverted synonym is \fB"read only"\fP\&. +.IP +If this parameter is \f(CW"no"\fP, then users of a service may not create +or modify files in the service\'s directory\&. +.IP +Note that a printable service \fB("printable = yes")\fP +will \fI*ALWAYS*\fP allow writing to the directory (user privileges +permitting), but only via spooling operations\&. +.IP +\fBDefault:\fP +\f(CW writeable = no\fP +.IP +\fBExamples:\fP + +.DS + + + read only = no + writeable = yes + write ok = yes + +.DE + + .IP .SH "WARNINGS" .IP |