From 510064b14e8fddafe615f8c707023fcc3f84f094 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Fri, 10 Oct 2003 16:21:39 +0000 Subject: removing docs from HEAD (This used to be commit 820903ef5a062b4b9824c33ee035c68a39c8eeb0) --- docs/docbook/smbdotconf/filename/casesensitive.xml | 9 --- docs/docbook/smbdotconf/filename/casesignames.xml | 8 --- docs/docbook/smbdotconf/filename/defaultcase.xml | 11 ---- .../smbdotconf/filename/deletevetofiles.xml | 28 --------- docs/docbook/smbdotconf/filename/hidedotfiles.xml | 10 ---- docs/docbook/smbdotconf/filename/hidefiles.xml | 39 ------------- .../smbdotconf/filename/hidespecialfiles.xml | 12 ---- .../docbook/smbdotconf/filename/hideunreadable.xml | 10 ---- .../smbdotconf/filename/hideunwriteablefiles.xml | 12 ---- docs/docbook/smbdotconf/filename/manglecase.xml | 9 --- docs/docbook/smbdotconf/filename/mangledmap.xml | 26 --------- docs/docbook/smbdotconf/filename/manglednames.xml | 67 ---------------------- docs/docbook/smbdotconf/filename/mangledstack.xml | 27 --------- docs/docbook/smbdotconf/filename/mangleprefix.xml | 20 ------- docs/docbook/smbdotconf/filename/manglingchar.xml | 14 ----- .../docbook/smbdotconf/filename/manglingmethod.xml | 19 ------ docs/docbook/smbdotconf/filename/maparchive.xml | 19 ------ docs/docbook/smbdotconf/filename/maphidden.xml | 15 ----- docs/docbook/smbdotconf/filename/mapsystem.xml | 15 ----- docs/docbook/smbdotconf/filename/preservecase.xml | 14 ----- .../smbdotconf/filename/shortpreservecase.xml | 17 ------ docs/docbook/smbdotconf/filename/statcache.xml | 13 ----- docs/docbook/smbdotconf/filename/vetofiles.xml | 49 ---------------- .../smbdotconf/filename/vetooplockfiles.xml | 25 -------- 24 files changed, 488 deletions(-) delete mode 100644 docs/docbook/smbdotconf/filename/casesensitive.xml delete mode 100644 docs/docbook/smbdotconf/filename/casesignames.xml delete mode 100644 docs/docbook/smbdotconf/filename/defaultcase.xml delete mode 100644 docs/docbook/smbdotconf/filename/deletevetofiles.xml delete mode 100644 docs/docbook/smbdotconf/filename/hidedotfiles.xml delete mode 100644 docs/docbook/smbdotconf/filename/hidefiles.xml delete mode 100644 docs/docbook/smbdotconf/filename/hidespecialfiles.xml delete mode 100644 docs/docbook/smbdotconf/filename/hideunreadable.xml delete mode 100644 docs/docbook/smbdotconf/filename/hideunwriteablefiles.xml delete mode 100644 docs/docbook/smbdotconf/filename/manglecase.xml delete mode 100644 docs/docbook/smbdotconf/filename/mangledmap.xml delete mode 100644 docs/docbook/smbdotconf/filename/manglednames.xml delete mode 100644 docs/docbook/smbdotconf/filename/mangledstack.xml delete mode 100644 docs/docbook/smbdotconf/filename/mangleprefix.xml delete mode 100644 docs/docbook/smbdotconf/filename/manglingchar.xml delete mode 100644 docs/docbook/smbdotconf/filename/manglingmethod.xml delete mode 100644 docs/docbook/smbdotconf/filename/maparchive.xml delete mode 100644 docs/docbook/smbdotconf/filename/maphidden.xml delete mode 100644 docs/docbook/smbdotconf/filename/mapsystem.xml delete mode 100644 docs/docbook/smbdotconf/filename/preservecase.xml delete mode 100644 docs/docbook/smbdotconf/filename/shortpreservecase.xml delete mode 100644 docs/docbook/smbdotconf/filename/statcache.xml delete mode 100644 docs/docbook/smbdotconf/filename/vetofiles.xml delete mode 100644 docs/docbook/smbdotconf/filename/vetooplockfiles.xml (limited to 'docs/docbook/smbdotconf/filename') diff --git a/docs/docbook/smbdotconf/filename/casesensitive.xml b/docs/docbook/smbdotconf/filename/casesensitive.xml deleted file mode 100644 index 94b20d6c0c..0000000000 --- a/docs/docbook/smbdotconf/filename/casesensitive.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - See the discussion in the section NAME MANGLING. - - Default: case sensitive = no - - diff --git a/docs/docbook/smbdotconf/filename/casesignames.xml b/docs/docbook/smbdotconf/filename/casesignames.xml deleted file mode 100644 index 3254b545c5..0000000000 --- a/docs/docbook/smbdotconf/filename/casesignames.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - Synonym for case sensitive. - - diff --git a/docs/docbook/smbdotconf/filename/defaultcase.xml b/docs/docbook/smbdotconf/filename/defaultcase.xml deleted file mode 100644 index de3ad35c0c..0000000000 --- a/docs/docbook/smbdotconf/filename/defaultcase.xml +++ /dev/null @@ -1,11 +0,0 @@ - - - See the section on - NAME MANGLING. Also note the - short preserve case parameter. - - Default: default case = lower - - diff --git a/docs/docbook/smbdotconf/filename/deletevetofiles.xml b/docs/docbook/smbdotconf/filename/deletevetofiles.xml deleted file mode 100644 index c851824b7e..0000000000 --- a/docs/docbook/smbdotconf/filename/deletevetofiles.xml +++ /dev/null @@ -1,28 +0,0 @@ - - - This option is used when Samba is attempting to - delete a directory that contains one or more vetoed directories - (see the veto files - option). If this option is set to no (the default) then if a vetoed - directory contains any non-vetoed files or directories then the - directory delete will fail. This is usually what you want. - - If this option is set to yes, 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 NetAtalk which create meta-files within - directories you might normally veto DOS/Windows users from seeing - (e.g. .AppleDouble) - - Setting delete veto files = yes allows these - directories to be transparently deleted when the parent directory - is deleted (so long as the user has permissions to do so). - - See also the veto - files parameter. - - Default: delete veto files = no - - diff --git a/docs/docbook/smbdotconf/filename/hidedotfiles.xml b/docs/docbook/smbdotconf/filename/hidedotfiles.xml deleted file mode 100644 index 1728f01f8f..0000000000 --- a/docs/docbook/smbdotconf/filename/hidedotfiles.xml +++ /dev/null @@ -1,10 +0,0 @@ - - - This is a boolean parameter that controls whether - files starting with a dot appear as hidden files. - - Default: hide dot files = yes - - diff --git a/docs/docbook/smbdotconf/filename/hidefiles.xml b/docs/docbook/smbdotconf/filename/hidefiles.xml deleted file mode 100644 index b687fc5a1f..0000000000 --- a/docs/docbook/smbdotconf/filename/hidefiles.xml +++ /dev/null @@ -1,39 +0,0 @@ - - - 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. - - 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. - - Setting this parameter will affect the performance of Samba, - as it will be forced to check all files and directories for a match - as they are scanned. - - See also hide - dot files, - veto files and - case sensitive. - - Default: no file are hidden - - Example: hide files = - /.*/DesktopFolderDB/TrashFor%m/resource.frk/ - - The above example is based on files that the Macintosh - SMB client (DAVE) available from - Thursby creates for internal use, and also still hides - all files beginning with a dot. - - diff --git a/docs/docbook/smbdotconf/filename/hidespecialfiles.xml b/docs/docbook/smbdotconf/filename/hidespecialfiles.xml deleted file mode 100644 index 815e8ea63c..0000000000 --- a/docs/docbook/smbdotconf/filename/hidespecialfiles.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - This parameter prevents clients from seeing - special files such as sockets, devices and fifo's in directory - listings. - - - Default: hide special files = no - - diff --git a/docs/docbook/smbdotconf/filename/hideunreadable.xml b/docs/docbook/smbdotconf/filename/hideunreadable.xml deleted file mode 100644 index f34a3a597d..0000000000 --- a/docs/docbook/smbdotconf/filename/hideunreadable.xml +++ /dev/null @@ -1,10 +0,0 @@ - - - This parameter prevents clients from seeing the - existance of files that cannot be read. Defaults to off. - - Default: hide unreadable = no - - diff --git a/docs/docbook/smbdotconf/filename/hideunwriteablefiles.xml b/docs/docbook/smbdotconf/filename/hideunwriteablefiles.xml deleted file mode 100644 index 7d20296ff2..0000000000 --- a/docs/docbook/smbdotconf/filename/hideunwriteablefiles.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - This parameter prevents clients from seeing - the existance of files that cannot be written to. Defaults to off. - Note that unwriteable directories are shown as usual. - - - Default: hide unwriteable = no - - diff --git a/docs/docbook/smbdotconf/filename/manglecase.xml b/docs/docbook/smbdotconf/filename/manglecase.xml deleted file mode 100644 index d514375c3b..0000000000 --- a/docs/docbook/smbdotconf/filename/manglecase.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - See the section on NAME MANGLING - - Default: mangle case = no - - diff --git a/docs/docbook/smbdotconf/filename/mangledmap.xml b/docs/docbook/smbdotconf/filename/mangledmap.xml deleted file mode 100644 index e790fa877d..0000000000 --- a/docs/docbook/smbdotconf/filename/mangledmap.xml +++ /dev/null @@ -1,26 +0,0 @@ - - - This is for those who want to directly map UNIX - file names which cannot 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 .html - for HTML files, whereas under Windows/DOS .htm - is more commonly used. - - So to map html to htm - you would use: - - mangled map = (*.html *.htm) - - One very useful case is to remove the annoying ;1 - off the ends of filenames on some CDROMs (only visible - under some UNIXes). To do this use a map of (*;1 *;). - - Default: no mangled map - - Example: mangled map = (*;1 *;) - - diff --git a/docs/docbook/smbdotconf/filename/manglednames.xml b/docs/docbook/smbdotconf/filename/manglednames.xml deleted file mode 100644 index 4ec088d16f..0000000000 --- a/docs/docbook/smbdotconf/filename/manglednames.xml +++ /dev/null @@ -1,67 +0,0 @@ - - - This controls whether non-DOS names under UNIX - should be mapped to DOS-compatible names ("mangled") and made visible, - or whether non-DOS names should simply be ignored. - - See the section on NAME MANGLING for - details on how to control the mangling process. - - If mangling is used then the mangling algorithm is as follows: - - - - The first (up to) five alphanumeric characters - before the rightmost dot of the filename are preserved, forced - to upper case, and appear as the first (up to) five characters - of the mangled name. - - - - A tilde "~" is appended to the first part of the mangled - name, followed by a two-character unique sequence, based on the - original root name (i.e., the original filename minus its final - extension). The final extension is included in the hash calculation - only if it contains any upper case characters or is longer than three - characters. - - Note that the character to use may be specified using - the mangling char - option, if you don't like '~'. - - - - The first three alphanumeric characters of the final - extension are preserved, forced to upper case and appear as the - extension of the mangled name. The final extension is defined as that - part of the original filename after the rightmost dot. If there are no - dots in the filename, the mangled name will have no extension (except - in the case of "hidden files" - see below). - - - - Files whose UNIX name begins with a dot will be - presented as DOS hidden files. The mangled name will be created as - for other filenames, but with the leading dot removed and "___" as - its extension regardless of actual original extension (that's three - underscores). - - - - The two-digit hash value consists of upper case alphanumeric characters. - - This algorithm can cause name collisions only if files - in a directory share the same first five alphanumeric characters. - The probability of such a clash is 1/1300. - - The name mangling (if enabled) allows a file to be - copied between UNIX directories from Windows/DOS while retaining - the long UNIX filename. UNIX files can be renamed to a new extension - from Windows/DOS and will retain the same basename. Mangled names - do not change between sessions. - - Default: mangled names = yes - - diff --git a/docs/docbook/smbdotconf/filename/mangledstack.xml b/docs/docbook/smbdotconf/filename/mangledstack.xml deleted file mode 100644 index 5f28e76dd9..0000000000 --- a/docs/docbook/smbdotconf/filename/mangledstack.xml +++ /dev/null @@ -1,27 +0,0 @@ - - - This parameter controls the number of mangled names - that should be cached in the Samba server smbd - 8. - - This stack is a list of recently mangled base names - (extensions are only maintained if they are longer than 3 characters - or contains upper case characters). - - The larger this value, the more likely it is that mangled - names can be successfully converted to correct long UNIX names. - However, large stack sizes will slow most directory accesses. Smaller - stacks save memory in the server (each stack element costs 256 bytes). - - - It is not possible to absolutely guarantee correct long - filenames, so be prepared for some surprises! - - Default: mangled stack = 50 - - Example: mangled stack = 100 - - diff --git a/docs/docbook/smbdotconf/filename/mangleprefix.xml b/docs/docbook/smbdotconf/filename/mangleprefix.xml deleted file mode 100644 index eff1f2b8fe..0000000000 --- a/docs/docbook/smbdotconf/filename/mangleprefix.xml +++ /dev/null @@ -1,20 +0,0 @@ - - - controls the number of prefix - characters from the original name used when generating - the mangled names. A larger value will give a weaker - hash and therefore more name collisions. The minimum - value is 1 and the maximum value is 6. - - - mangle prefix is effective only when mangling method is hash2. - - - Default: mangle prefix = 1 - - Example: mangle prefix = 4 - - diff --git a/docs/docbook/smbdotconf/filename/manglingchar.xml b/docs/docbook/smbdotconf/filename/manglingchar.xml deleted file mode 100644 index de5f620fd9..0000000000 --- a/docs/docbook/smbdotconf/filename/manglingchar.xml +++ /dev/null @@ -1,14 +0,0 @@ - - - This controls what character is used as - the magic character in name mangling. The - default is a '~' but this may interfere with some software. Use this option to set - it to whatever you prefer. This is effective only when mangling method is hash. - - Default: mangling char = ~ - - Example: mangling char = ^ - - diff --git a/docs/docbook/smbdotconf/filename/manglingmethod.xml b/docs/docbook/smbdotconf/filename/manglingmethod.xml deleted file mode 100644 index 74366483bd..0000000000 --- a/docs/docbook/smbdotconf/filename/manglingmethod.xml +++ /dev/null @@ -1,19 +0,0 @@ - - - controls the algorithm used for the generating - the mangled names. Can take two different values, "hash" and - "hash2". "hash" is the default and is the algorithm that has been - used in Samba for many years. "hash2" is a newer and considered - a better algorithm (generates less collisions) in the names. - However, many Win32 applications store the mangled names and so - changing to the new algorithm must not be done - lightly as these applications may break unless reinstalled. - - Default: mangling method = hash2 - - Example: mangling method = hash - - diff --git a/docs/docbook/smbdotconf/filename/maparchive.xml b/docs/docbook/smbdotconf/filename/maparchive.xml deleted file mode 100644 index b44088efe3..0000000000 --- a/docs/docbook/smbdotconf/filename/maparchive.xml +++ /dev/null @@ -1,19 +0,0 @@ - - - This controls whether the DOS archive attribute - should be mapped to the UNIX owner execute bit. The DOS archive bit - is set when a file has been modified since its last backup. One - motivation for this option it to keep Samba/your PC from making - any file it touches from becoming executable under UNIX. This can - be quite annoying for shared source code, documents, etc... - - Note that this requires the create mask - parameter to be set such that owner execute bit is not masked out - (i.e. it must include 100). See the parameter - create mask for details. - - Default: map archive = yes - - diff --git a/docs/docbook/smbdotconf/filename/maphidden.xml b/docs/docbook/smbdotconf/filename/maphidden.xml deleted file mode 100644 index 4c1a932788..0000000000 --- a/docs/docbook/smbdotconf/filename/maphidden.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - This controls whether DOS style hidden files - should be mapped to the UNIX world execute bit. - - Note that this requires the create mask - to be set such that the world execute bit is not masked out (i.e. - it must include 001). See the parameter - create mask for details. - - Default: map hidden = no - - diff --git a/docs/docbook/smbdotconf/filename/mapsystem.xml b/docs/docbook/smbdotconf/filename/mapsystem.xml deleted file mode 100644 index 7fe50bb19f..0000000000 --- a/docs/docbook/smbdotconf/filename/mapsystem.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - This controls whether DOS style system files - should be mapped to the UNIX group execute bit. - - Note that this requires the create mask - to be set such that the group execute bit is not masked out (i.e. - it must include 010). See the parameter - create mask for details. - - Default: map system = no - - diff --git a/docs/docbook/smbdotconf/filename/preservecase.xml b/docs/docbook/smbdotconf/filename/preservecase.xml deleted file mode 100644 index d8a4e2342d..0000000000 --- a/docs/docbook/smbdotconf/filename/preservecase.xml +++ /dev/null @@ -1,14 +0,0 @@ - - - This controls if new filenames are created - with the case that the client passes, or if they are forced to - be the default case - . - - Default: preserve case = yes - - See the section on NAME MANGLING for a fuller discussion. - - diff --git a/docs/docbook/smbdotconf/filename/shortpreservecase.xml b/docs/docbook/smbdotconf/filename/shortpreservecase.xml deleted file mode 100644 index 52c93e1370..0000000000 --- a/docs/docbook/smbdotconf/filename/shortpreservecase.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - This boolean parameter controls if new files - which conform to 8.3 syntax, that is all in upper case and of - suitable length, are created upper case, or if they are forced - to be the default case - . This option can be use with preserve case = yes - to permit long filenames to retain their case, while short - names are lowered. - - See the section on NAME MANGLING. - - Default: short preserve case = yes - - diff --git a/docs/docbook/smbdotconf/filename/statcache.xml b/docs/docbook/smbdotconf/filename/statcache.xml deleted file mode 100644 index ee2a48732e..0000000000 --- a/docs/docbook/smbdotconf/filename/statcache.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - This parameter determines if smbd - 8 will use a cache in order to - speed up case insensitive name mappings. You should never need - to change this parameter. - - Default: stat cache = yes - - diff --git a/docs/docbook/smbdotconf/filename/vetofiles.xml b/docs/docbook/smbdotconf/filename/vetofiles.xml deleted file mode 100644 index 567286580d..0000000000 --- a/docs/docbook/smbdotconf/filename/vetofiles.xml +++ /dev/null @@ -1,49 +0,0 @@ - - - This is a list of files and directories that - are neither visible nor 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 sensitive option - is applicable in vetoing files. - - One feature of the veto files parameter that it - is important to be aware of is Samba's behaviour when - trying to delete a directory. If a directory that is - to be deleted contains nothing but veto files this - deletion will fail unless you also set - the delete veto files parameter to - yes. - - Setting this parameter will affect the performance - of Samba, as it will be forced to check all files and directories - for a match as they are scanned. - - See also hide files - and - case sensitive. - - Default: No files or directories are vetoed. - - - Examples: - -; Veto any files containing the word Security, -; any ending in .tmp, and any directory containing the -; word root. -veto files = /*Security*/*.tmp/*root*/ - -; Veto the Apple specific files that a NetAtalk server -; creates. -veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/ - - - diff --git a/docs/docbook/smbdotconf/filename/vetooplockfiles.xml b/docs/docbook/smbdotconf/filename/vetooplockfiles.xml deleted file mode 100644 index e7c683a518..0000000000 --- a/docs/docbook/smbdotconf/filename/vetooplockfiles.xml +++ /dev/null @@ -1,25 +0,0 @@ - - - This parameter is only valid when the - oplocks - parameter is turned on for a share. It allows the Samba administrator - to selectively turn off the granting of oplocks on selected files that - match a wildcarded list, similar to the wildcarded list used in the - veto files - parameter. - - Default: No files are vetoed for oplock grants - - You might want to do this on files that you know will - be heavily contended for by clients. A good example of this - is in the NetBench SMB benchmark program, which causes heavy - client contention for files ending in .SEM. - To cause Samba not to grant oplocks on these files you would use - the line (either in the [global] section or in the section for - the particular NetBench share : - - Example: veto oplock files = /*.SEM/ - - -- cgit