Support.txt: Modified a consultant's entry (Italy)
[nivanova/samba-autobuild/.git] / docs / manpages / smb.conf.5
index dcef2bb2f0e05d615b3a3c43887a5e9436d86b47..8bab487086e253cbc836c2fbf5d13a306bcc0847 100644 (file)
@@ -341,6 +341,8 @@ default service
 
 dfree command
 
+dns proxy
+
 domain controller
 
 domain master
@@ -349,6 +351,10 @@ encrypt passwords
 
 getwd cache
 
+hide files
+
+hide dot files
+
 homedir map
 
 hosts equiv
@@ -459,6 +465,8 @@ syslog only
 
 time offset
 
+time server
+
 unix realname
 
 username map
@@ -518,6 +526,12 @@ exec
 
 fake oplocks
 
+follow symlinks
+
+force create mode
+
+force directory mode
+
 force group
 
 force user
@@ -862,8 +876,30 @@ A synonym for this parameter is 'create mode'.
 This parameter is the octal modes which are used when converting DOS modes 
 to UNIX modes.
 
-Note that Samba will or this value with 0700 as you must have at least
-user read, write and execute for Samba to work properly.
+When a file is created, the neccessary 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 of a file. Any bit *not* set here will be removed from the
+modes set on a file when it is created.
+
+The default value of this parameter removes the 'user' execute
+bit and the 'group' and 'other' write and execute bits from the
+UNIX modes.
+
+Following this Samba will bit-wise 'OR' the UNIX mode created from
+this parameter with the value of the "force create mode" parameter 
+which is set to 0700 by default. This causes the 'user' read, write
+and execute bits to be set for every file created. You must have at 
+least 'user' read, write and execute bits set for Samba to work properly.
+
+For Samba 1.9.17 and above this parameter no longer affects directory
+modes. See the parameter 'directory mode' for details.
+
+See also the "force create mode" parameter for forcing particular
+mode bits to be set on created files.
+See also the "directory mode" paramter for masking mode bits on created
+directories.
 
 .B Default:
        create mask = 0644
@@ -873,6 +909,7 @@ user read, write and execute for Samba to work properly.
 .SS create mode (S)
 See
 .B create mask.
+
 .SS dead time (G)
 The value of the parameter (a decimal integer) represents the number of
 minutes of inactivity before a connection is considered dead, and it
@@ -1022,8 +1059,25 @@ A synonym for this parameter is 'directory mode'.
 This parameter is the octal modes which are used when converting DOS modes 
 to UNIX modes when creating UNIX directories.
 
-Note that Samba will bit-wise 'OR' this value with 0700 as you must have at
-least user read, write and execute for Samba to work properly.
+When a directory is created, the neccessary 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 of a directory. Any bit *not* set here will be removed from the
+modes set on a directory when it is created.
+
+The default value of this parameter removes the 'group' and 'other'
+write bits from the UNIX mode.
+
+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 bits are added).
+
+See the "force directory mode" parameter to cause particular mode
+bits to always be set on created directories.
+
+See also the "create mode" parameter for masking mode bits on created
+files.
 
 .B Default:
        directory mask = 0755
@@ -1033,13 +1087,32 @@ least user read, write and execute for Samba to work properly.
 .SS directory mode (S)
 See
 .B directory mask.
+
+.SS dns proxy (G)
+
+Specifies that nmbd should (as a WINS server), on finding that a NetBIOS
+name has not been registered, treat the NetBIOS name word-for-word as
+a DNS name.
+
+Note that the maximum length for a NetBIOS name is 15
+characters, so the DNS name (or DNS alias) can likewise only be 15
+characters, maximum.
+
+Note also that nmbd will block completely until the DNS name is resolved.
+This will result in temporary loss of browsing and WINS services.
+Enable this option only if you are certain that DNS resolution is fast,
+or you can live with the consequences of periodic pauses in nmbd service.
+
+.B Default:
+        dns proxy = yes
+
 .SS domain controller (G)
 
 Specifies the DNS name or IP address of the machine to refer domain 
 logons from Win95 machines to. You should never need to set this parameter.
 
 .B Default:
-       domain controller =
+        domain controller = no
 
 .SS domain master (G)
 
@@ -1105,6 +1178,62 @@ carefully!
 
 This option is disabled by default.
 
+.SS follow symlinks (S)
+
+This parameter allows the Samba administrator to stop smbd from
+following symbolic links in a particular share. Setting this
+parameter to "No" 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 /etc/pasword in their home directory for instance.
+However it will slow filename lookups down slightly.
+
+This option is enabled (ie. smbd will follow symbolic links)
+by default.
+
+.SS force create mode (S)
+This parameter specifies a set of UNIX mode bit permissions that
+will *always* 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)
+0700 as files must have at least 'user' read/write/execute bits
+set for Samba to work correctly. This operation is done after
+the mode mask in the parameter "create mask" is applied.
+
+See also the parameter "create mask" for details on masking mode
+bits on created files.
+
+.B Default:
+       force create mode = 0700
+
+.B Example:
+       force create mode = 0755
+
+would force all created files to have read and execute permissions
+set for 'group' and 'other' as well as the read/write/execute bits 
+set for the 'user'.
+
+.SS force directory mode (S)
+This parameter specifies a set of UNIX mode bit permissions that
+will *always* 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 will not add any extra permission bits to a created
+directory. This operation is done after the mode mask in the parameter 
+"directory mask" is applied.
+
+See also the parameter "directory mask" for details on masking mode
+bits on created directories.
+
+.B Default:
+       force directory mode = 000
+
+.B Example:
+       force directory mode = 0755
+
+would force all created directories to have read and execute permissions
+set for 'group' and 'other' as well as the read/write/execute bits 
+set for the 'user'.
 
 .SS force group (S)
 This specifies a group name that all connections to this service
@@ -1195,6 +1324,35 @@ a dot appear as hidden files.
 
 .B Example:
        hide dot files = no
+
+
+.SS hide files(S)
+This is a list of files or directories that are not visible but are
+accessible.  The DOS 'hidden' attribute is applied to any files or
+directories that match.
+
+Each entry in the list must be separated by a "/", which allows spaces
+to be included in the entry.  '*' and '?' can be used to specify multiple 
+files or directories as in DOS wildcards.  The default, for example, is 
+used to hide all files beginning with a dot.
+
+Each entry must be a unix path, not a DOS path and must not include the 
+unix directory separator "/".
+
+Note that the case sensitivity option is applicable in hiding files.
+
+See also "veto files" and "case sensitive"
+
+.B Default
+       hide files = .*
+
+.B Example
+       hide files = /.*/DesktopFolderDB/TrashFor%m/resource.frk/
+
+The above example is based on files that the Macintosh client (DAVE)
+creates for internal use, and also still hides all files beginning with
+a dot.
+
 .SS homedir map (G)
 If "nis homedir" is true, this parameter specifies the NIS (or YP) map
 from which the server for the user's home directory should be extracted.
@@ -1800,12 +1958,12 @@ A size of 0 means no limit.
 
 .SS max mux (G)
 
-This option controls the maximum number of simultaneous reads that
-samba tells the client it will allow. You should never need to set this
-parameter.
+This option controls the maximum number of outstanding simultaneous SMB 
+operations that samba tells the client it will allow. You should never need 
+to set this parameter.
 
 .B Default:
-       max mux = 2
+       max mux = 50
 
 .SS max packet (G)
 
@@ -2856,6 +3014,16 @@ that have incorrect daylight saving time handling.
 .B Example:
        time offset = 60
 
+.SS time server (G)
+This parameter determines if nmbd advertises itself as a time server
+to Windows clients. The default is False.
+
+.B Default:
+       time server = False
+
+.B Example:
+       time server = True
+
 .SS unix realname (G)
 This boolean parameter when set causes samba to supply the real name field
 from the unix password file to the client. This is useful for setting up
@@ -3042,18 +3210,40 @@ See also "invalid users"
 
 .SS veto files(S)
 This is a list of files and directories that are neither visible nor
-accessible.  Each entry in the list must be separate by a "/", which
-allows spaces to be included in the entry.  Note that '*' and '?' at
-present cannot be used to specify multiple files or directories.
+accessible.  Each entry in the list must be separated by a "/", which
+allows spaces to be included in the entry.  '*' and '?' can be used to
+specify multiple files or directories as in DOS wildcards.
+
+Each entry must be a unix path, not a DOS path and must not include the 
+unix directory separator "/".
+
+Note that the case sensitivity option is applicable in vetoing files.
+
+One feature of the veto files parameter that it is important to be
+aware of, is that if a directory contains nothing but files that
+match the veto files parameter (which means that Windows/DOS clients
+cannot ever see them) is deleted, the veto files within that directory
+*are automatically deleted* along with it, if the user has UNIX permissions
+to do so.
+See also "hide files" and "case sensitive"
 
 .B Default
        No files or directories are vetoed.
 
-.B Example
-       veto files = DesktopFolderDB/TrashFor%m/resource.frk
+.B Examples
+    Example 1.
+    Veto any files containing the word Security, 
+    any ending in .tmp, and any directory containing the
+    word root.
 
-The above example is based on files that the Macintosh client (DAVE)
-creates for internal use.
+       veto files = /*Security*/*.tmp/*root*/
+
+    Example 2.
+    Veto the Apple specific files that a NetAtalk server
+    creates.
+
+    veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/
 
 .SS volume (S)
 This allows you to override the volume label returned for a