From 058f6c0459263a4ec5b4e030ccba1bcb05c8f8a6 Mon Sep 17 00:00:00 2001 From: Alexander Bokovoy Date: Tue, 15 Apr 2003 11:46:16 +0000 Subject: Final bits of smb.conf(5) are converted! (This used to be commit fac3d67f71057d880e51cf8e103edf0c9b71cae9) --- docs/docbook/smbdotconf/misc/deletereadonly.xml | 21 ++++---- docs/docbook/smbdotconf/misc/dosfilemode.xml | 32 ++++++------ .../smbdotconf/misc/dosfiletimeresolution.xml | 44 ++++++++-------- docs/docbook/smbdotconf/misc/dosfiletimes.xml | 29 ++++++----- .../smbdotconf/misc/fakedirectorycreatetimes.xml | 58 +++++++++++----------- docs/docbook/smbdotconf/misc/hidelocalusers.xml | 16 +++--- docs/docbook/smbdotconf/misc/magicoutput.xml | 29 +++++------ docs/docbook/smbdotconf/misc/magicscript.xml | 49 +++++++++--------- docs/docbook/smbdotconf/misc/panicaction.xml | 26 ++++++---- 9 files changed, 164 insertions(+), 140 deletions(-) diff --git a/docs/docbook/smbdotconf/misc/deletereadonly.xml b/docs/docbook/smbdotconf/misc/deletereadonly.xml index 8e86b5b00b..cfffceedcb 100644 --- a/docs/docbook/smbdotconf/misc/deletereadonly.xml +++ b/docs/docbook/smbdotconf/misc/deletereadonly.xml @@ -1,11 +1,14 @@ - - delete readonly (S) - This parameter allows readonly files to be deleted. - This is not normal DOS semantics, but is allowed by UNIX. + + + This parameter allows readonly files to be deleted. + This is not normal DOS semantics, but is allowed by UNIX. - This option may be useful for running applications such - as rcs, where UNIX file ownership prevents changing file - permissions, and DOS semantics prevent deletion of a read only file. + This option may be useful for running applications such + as rcs, where UNIX file ownership prevents changing file + permissions, and DOS semantics prevent deletion of a read only file. - Default: delete readonly = no - + Default: delete readonly = no + + diff --git a/docs/docbook/smbdotconf/misc/dosfilemode.xml b/docs/docbook/smbdotconf/misc/dosfilemode.xml index e8aec3b78d..2628dc45b0 100644 --- a/docs/docbook/smbdotconf/misc/dosfilemode.xml +++ b/docs/docbook/smbdotconf/misc/dosfilemode.xml @@ -1,16 +1,18 @@ - - dos filemode (S) - The default behavior in Samba is to provide - UNIX-like behavior where only the owner of a file/directory is - able to change the permissions on it. However, this behavior - is often confusing to DOS/Windows users. Enabling this parameter - allows a user who has write access to the file (by whatever - means) to modify the permissions on it. Note that a user - belonging to the group owning the file will not be allowed to - change permissions if the group is only granted read access. - Ownership of the file/directory is not changed, only the permissions - are modified. + + + The default behavior in Samba is to provide + UNIX-like behavior where only the owner of a file/directory is + able to change the permissions on it. However, this behavior + is often confusing to DOS/Windows users. Enabling this parameter + allows a user who has write access to the file (by whatever + means) to modify the permissions on it. Note that a user + belonging to the group owning the file will not be allowed to + change permissions if the group is only granted read access. + Ownership of the file/directory is not changed, only the permissions + are modified. - Default: dos filemode = no - - + Default: dos filemode = no + + diff --git a/docs/docbook/smbdotconf/misc/dosfiletimeresolution.xml b/docs/docbook/smbdotconf/misc/dosfiletimeresolution.xml index bc82582c87..600294d442 100644 --- a/docs/docbook/smbdotconf/misc/dosfiletimeresolution.xml +++ b/docs/docbook/smbdotconf/misc/dosfiletimeresolution.xml @@ -1,23 +1,25 @@ - - dos filetime resolution (S) - 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 to smbd - 8. + + + 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 to smbd + 8. - This option is mainly used as a compatibility option for Visual - C++ when used against Samba shares. If oplocks are enabled on a - share, Visual C++ uses two different time reading calls to check if a - file has changed since it was last read. One of these calls uses a - one-second granularity, the other uses a two second granularity. As - the two second call rounds any odd second down, then if the file has a - timestamp of an odd number of seconds then the two timestamps will not - match and Visual C++ will keep reporting the file has changed. Setting - this option causes the two timestamps to match, and Visual C++ is - happy. + This option is mainly used as a compatibility option for Visual + C++ when used against Samba shares. If oplocks are enabled on a + share, Visual C++ uses two different time reading calls to check if a + file has changed since it was last read. One of these calls uses a + one-second granularity, the other uses a two second granularity. As + the two second call rounds any odd second down, then if the file has a + timestamp of an odd number of seconds then the two timestamps will not + match and Visual C++ will keep reporting the file has changed. Setting + this option causes the two timestamps to match, and Visual C++ is + happy. - Default: dos filetime resolution = no - - + Default: dos filetime resolution = no + + diff --git a/docs/docbook/smbdotconf/misc/dosfiletimes.xml b/docs/docbook/smbdotconf/misc/dosfiletimes.xml index d9b9f3b08b..a201d2d832 100644 --- a/docs/docbook/smbdotconf/misc/dosfiletimes.xml +++ b/docs/docbook/smbdotconf/misc/dosfiletimes.xml @@ -1,14 +1,17 @@ - - dos filetimes (S) - Under DOS and Windows, if a user can write to a - file they can change 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 - yes allows DOS semantics and smbd - 8 will change the file - timestamp as DOS requires. + + + Under DOS and Windows, if a user can write to a + file they can change 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 + yes allows DOS semantics and smbd + 8 will change the file + timestamp as DOS requires. - Default: dos filetimes = no - + Default: dos filetimes = no + + diff --git a/docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml b/docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml index 81773606ee..f0a0d39230 100644 --- a/docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml +++ b/docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml @@ -1,31 +1,33 @@ - - fake directory create times (S) - NTFS and Windows VFAT file systems keep a create - time for all files and directories. This is not the same as the - ctime - status change time - that Unix keeps, so Samba by default - reports the earliest of the various times Unix does keep. Setting - this parameter for a share causes Samba to always report midnight - 1-1-1980 as the create time for directories. + + + NTFS and Windows VFAT file systems keep a create + time for all files and directories. This is not the same as the + ctime - status change time - that Unix keeps, so Samba by default + reports the earliest of the various times Unix does keep. Setting + this parameter for a share causes Samba to always report midnight + 1-1-1980 as the create time for directories. - This option is mainly used as a compatibility option for - Visual C++ when used against Samba shares. Visual C++ generated - makefiles have the object directory as a dependency for each object - file, and a make rule to create the directory. Also, when NMAKE - compares timestamps it uses the creation time when examining a - directory. Thus the object directory will be created if it does not - exist, but once it does exist it will always have an earlier - timestamp than the object files it contains. + This option is mainly used as a compatibility option for + Visual C++ when used against Samba shares. Visual C++ generated + makefiles have the object directory as a dependency for each object + file, and a make rule to create the directory. Also, when NMAKE + compares timestamps it uses the creation time when examining a + directory. Thus the object directory will be created if it does not + exist, but once it does exist it will always have an earlier + timestamp than the object files it contains. - However, Unix time semantics mean that the create time - reported by Samba will be updated whenever a file is created or - or deleted in the directory. NMAKE finds all object files in - the object directory. The timestamp of the last one built is then - compared to the timestamp of the object directory. If the - directory's timestamp if newer, then all object files - will be rebuilt. Enabling this option - ensures directories always predate their contents and an NMAKE build - will proceed as expected. + However, Unix time semantics mean that the create time + reported by Samba will be updated whenever a file is created or + or deleted in the directory. NMAKE finds all object files in + the object directory. The timestamp of the last one built is then + compared to the timestamp of the object directory. If the + directory's timestamp if newer, then all object files + will be rebuilt. Enabling this option + ensures directories always predate their contents and an NMAKE build + will proceed as expected. - Default: fake directory create times = no - - + Default: fake directory create times = no + + diff --git a/docs/docbook/smbdotconf/misc/hidelocalusers.xml b/docs/docbook/smbdotconf/misc/hidelocalusers.xml index d0468ead6b..18a1c817c1 100644 --- a/docs/docbook/smbdotconf/misc/hidelocalusers.xml +++ b/docs/docbook/smbdotconf/misc/hidelocalusers.xml @@ -1,7 +1,11 @@ - - hide local users(G) - This parameter toggles the hiding of local UNIX - users (root, wheel, floppy, etc) from remote clients. + + + This parameter toggles the hiding of local UNIX + users (root, wheel, floppy, etc) from remote clients. - Default: hide local users = no - + Default: hide local users = no + + diff --git a/docs/docbook/smbdotconf/misc/magicoutput.xml b/docs/docbook/smbdotconf/misc/magicoutput.xml index 8208d5bd4c..c321f12b99 100644 --- a/docs/docbook/smbdotconf/misc/magicoutput.xml +++ b/docs/docbook/smbdotconf/misc/magicoutput.xml @@ -1,17 +1,18 @@ - - magic output (S) - This parameter specifies the name of a file - which will contain output created by a magic script (see the - magic script - parameter below). + + + This parameter specifies the name of a file + which will contain output created by a magic script (see the + magic script + parameter below). - Warning: If two clients use the same magic script - in the same directory the output file content - is undefined. + Warning: If two clients use the same magic script + in the same directory the output file content + is undefined. - Default: magic output = <magic script name>.out - + Default: magic output = <magic script name>.out - Example: magic output = myfile.txt - - + Example: magic output = myfile.txt + + diff --git a/docs/docbook/smbdotconf/misc/magicscript.xml b/docs/docbook/smbdotconf/misc/magicscript.xml index 73abb50fc5..67f39d918e 100644 --- a/docs/docbook/smbdotconf/misc/magicscript.xml +++ b/docs/docbook/smbdotconf/misc/magicscript.xml @@ -1,28 +1,31 @@ - - magic script (S) - This parameter specifies the name of a file which, - if opened, will be executed by the server when the file is closed. - This allows a UNIX script to be sent to the Samba host and - executed on behalf of the connected user. + + + This parameter specifies the name of a file which, + if opened, will be executed by the server when the file is closed. + This allows a UNIX script to be sent to the Samba host and + executed on behalf of the connected user. - Scripts executed in this way will be deleted upon - completion assuming that the user has the appropriate level - of privilege and the file permissions allow the deletion. + Scripts executed in this way will be deleted upon + completion assuming that the user has the appropriate level + of privilege and the file permissions allow the deletion. - If the script generates output, output will be sent to - the file specified by the - magic output parameter (see above). + If the script generates output, output will be sent to + the file specified by the + magic output parameter (see above). - Note that some shells are unable to interpret scripts - containing CR/LF instead of CR as - the end-of-line marker. Magic scripts must be executable - as is on the host, which for some hosts and - some shells will require filtering at the DOS end. + Note that some shells are unable to interpret scripts + containing CR/LF instead of CR as + the end-of-line marker. Magic scripts must be executable + as is on the host, which for some hosts and + some shells will require filtering at the DOS end. - Magic scripts are EXPERIMENTAL and - should NOT be relied upon. + Magic scripts are EXPERIMENTAL and + should NOT be relied upon. - Default: None. Magic scripts disabled. - Example: magic script = user.csh - - + Default: None. Magic scripts disabled. + + Example: magic script = user.csh + + diff --git a/docs/docbook/smbdotconf/misc/panicaction.xml b/docs/docbook/smbdotconf/misc/panicaction.xml index 6de37c2c17..04b7aab8c8 100644 --- a/docs/docbook/smbdotconf/misc/panicaction.xml +++ b/docs/docbook/smbdotconf/misc/panicaction.xml @@ -1,12 +1,16 @@ - - panic action (G) - This is a Samba developer option that allows a - system command to be called when either smbd - 8 or smbd - 8 crashes. This is usually used to - draw attention to the fact that a problem occurred. + + + This is a Samba developer option that allows a + system command to be called when either smbd + 8 or smbd + 8 crashes. This is usually used to + draw attention to the fact that a problem occurred. - Default: panic action = <empty string> - Example: panic action = "/bin/sleep 90000" - - + Default: panic action = <empty string> + + Example: panic action = "/bin/sleep 90000" + + -- cgit