summaryrefslogtreecommitdiff
path: root/docs/manpages/smb.conf.5
diff options
context:
space:
mode:
authorSamba Release Account <samba-bugs@samba.org>1997-06-19 00:42:29 +0000
committerSamba Release Account <samba-bugs@samba.org>1997-06-19 00:42:29 +0000
commit2654fd14726fac28e3ef94b2a9031e27d8f33ab6 (patch)
tree99107169b7d44413b7b1735149cef697e1b001b8 /docs/manpages/smb.conf.5
parent434d26acfe3bea62217b5ceaafc8b7b9cbe6e914 (diff)
downloadsamba-2654fd14726fac28e3ef94b2a9031e27d8f33ab6.tar.gz
samba-2654fd14726fac28e3ef94b2a9031e27d8f33ab6.tar.bz2
samba-2654fd14726fac28e3ef94b2a9031e27d8f33ab6.zip
smb.conf.5: Updated definitions of mode setting options. Added force
mode options. Support.txt: More consultants.... Jeremy (jallison@whistle.com) (This used to be commit 5c17bc2581b50da8e0a072bcfd528d95eab93161)
Diffstat (limited to 'docs/manpages/smb.conf.5')
-rw-r--r--docs/manpages/smb.conf.5107
1 files changed, 103 insertions, 4 deletions
diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5
index dcef2bb2f0..cbae60cc8b 100644
--- a/docs/manpages/smb.conf.5
+++ b/docs/manpages/smb.conf.5
@@ -459,6 +459,8 @@ syslog only
time offset
+time server
+
unix realname
username map
@@ -518,6 +520,10 @@ exec
fake oplocks
+force create mode
+
+force directory mode
+
force group
force user
@@ -862,8 +868,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 +901,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 +1051,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
@@ -1105,6 +1151,49 @@ carefully!
This option is disabled 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
@@ -2856,6 +2945,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