1
0
mirror of https://github.com/samba-team/samba.git synced 2025-01-12 09:18:10 +03:00

Next batch of conversions: File names.

Fixed some wrong context marks (most of "hide ..." parameters are per-share)
This commit is contained in:
Alexander Bokovoy 0001-01-01 00:00:00 +00:00
parent 49926d706f
commit 0f8d5b210a
17 changed files with 238 additions and 192 deletions

View File

@ -1,7 +1,9 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="CASESENSITIVE"/>case sensitive (S)</term>
<listitem><para>See the discussion in the section <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link>.</para>
<samba:parameter name="case sensitive"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>See the discussion in the section <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link>.</para>
<para>Default: <command moreinfo="none">case sensitive = no</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">case sensitive = no</command></para>
</listitem>
</samba:parameter>

View File

@ -1,5 +1,8 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="CASESIGNAMES"/>casesignames (S)</term>
<listitem><para>Synonym for <link linkend="CASESENSITIVE">case
sensitive</link>.</para></listitem>
</samba:parameter>
<samba:parameter name="casesignames"
context="S"
hide="1"
xmlns:samba="http://samba.org/common">
<listitem>
<para>Synonym for <link linkend="CASESENSITIVE">case sensitive</link>.</para>
</listitem>
</samba:parameter>

View File

@ -1,9 +1,11 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="DEFAULTCASE"/>default case (S)</term>
<listitem><para>See the section on <link linkend="NAMEMANGLINGSECT">
NAME MANGLING</link>. Also note the <link linkend="SHORTPRESERVECASE">
<parameter moreinfo="none">short preserve case</parameter></link> parameter.</para>
<samba:parameter name="default case"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>See the section on <link linkend="NAMEMANGLINGSECT">
NAME MANGLING</link>. Also note the <link linkend="SHORTPRESERVECASE">
<parameter moreinfo="none">short preserve case</parameter></link> parameter.</para>
<para>Default: <command moreinfo="none">default case = lower</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">default case = lower</command></para>
</listitem>
</samba:parameter>

View File

@ -1,25 +1,28 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="DELETEVETOFILES"/>delete veto files (S)</term>
<listitem><para>This option is used when Samba is attempting to
delete a directory that contains one or more vetoed directories
(see the <link linkend="VETOFILES"><parameter moreinfo="none">veto files</parameter></link>
option). If this option is set to <constant>no</constant> (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.</para>
<samba:parameter name="delete veto files"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>This option is used when Samba is attempting to
delete a directory that contains one or more vetoed directories
(see the <link linkend="VETOFILES"><parameter moreinfo="none">veto files</parameter></link>
option). If this option is set to <constant>no</constant> (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.</para>
<para>If this option is set to <constant>yes</constant>, 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. <filename moreinfo="none">.AppleDouble</filename>)</para>
<para>If this option is set to <constant>yes</constant>, 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. <filename moreinfo="none">.AppleDouble</filename>)</para>
<para>Setting <command moreinfo="none">delete veto files = yes</command> allows these
directories to be transparently deleted when the parent directory
is deleted (so long as the user has permissions to do so).</para>
<para>Setting <command moreinfo="none">delete veto files = yes</command> allows these
directories to be transparently deleted when the parent directory
is deleted (so long as the user has permissions to do so).</para>
<para>See also the <link linkend="VETOFILES"><parameter moreinfo="none">veto
files</parameter></link> parameter.</para>
<para>See also the <link linkend="VETOFILES"><parameter moreinfo="none">veto
files</parameter></link> parameter.</para>
<para>Default: <command moreinfo="none">delete veto files = no</command></para></listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">delete veto files = no</command></para>
</listitem>
</samba:parameter>

View File

@ -1,7 +1,10 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="HIDEDOTFILES"/>hide dot files (S)</term>
<listitem><para>This is a boolean parameter that controls whether
files starting with a dot appear as hidden files.</para>
<samba:parameter name="hide dot files"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>This is a boolean parameter that controls whether
files starting with a dot appear as hidden files.</para>
<para>Default: <command moreinfo="none">hide dot files = yes</command></para></listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">hide dot files = yes</command></para>
</listitem>
</samba:parameter>

View File

@ -1,35 +1,39 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="HIDEFILES"/>hide files(S)</term>
<listitem><para>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.</para>
<samba:parameter name="hide files"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>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.</para>
<para>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.</para>
<para>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.</para>
<para>Each entry must be a Unix path, not a DOS path and must
not include the Unix directory separator '/'.</para>
<para>Each entry must be a Unix path, not a DOS path and must
not include the Unix directory separator '/'.</para>
<para>Note that the case sensitivity option is applicable
in hiding files.</para>
<para>Note that the case sensitivity option is applicable
in hiding files.</para>
<para>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.</para>
<para>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.</para>
<para>See also <link linkend="HIDEDOTFILES"><parameter moreinfo="none">hide
dot files</parameter></link>, <link linkend="VETOFILES"><parameter moreinfo="none">
veto files</parameter></link> and <link linkend="CASESENSITIVE">
<parameter moreinfo="none">case sensitive</parameter></link>.</para>
<para>See also <link linkend="HIDEDOTFILES"><parameter moreinfo="none">hide
dot files</parameter></link>, <link linkend="VETOFILES"><parameter moreinfo="none">
veto files</parameter></link> and <link linkend="CASESENSITIVE">
<parameter moreinfo="none">case sensitive</parameter></link>.</para>
<para>Default: <emphasis>no file are hidden</emphasis></para>
<para>Example: <command moreinfo="none">hide files =
<para>Default: <emphasis>no file are hidden</emphasis></para>
<para>Example: <command moreinfo="none">hide files =
/.*/DesktopFolderDB/TrashFor%m/resource.frk/</command></para>
<para>The above example is based on files that the Macintosh
SMB client (DAVE) available from <ulink url="http://www.thursby.com">
Thursby</ulink> creates for internal use, and also still hides
all files beginning with a dot.</para></listitem>
</samba:parameter>
<para>The above example is based on files that the Macintosh
SMB client (DAVE) available from <ulink url="http://www.thursby.com">
Thursby</ulink> creates for internal use, and also still hides
all files beginning with a dot.</para>
</listitem>
</samba:parameter>

View File

@ -1,10 +1,12 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="HIDESPECIALFILES"/>hide special files (G)</term>
<listitem><para>This parameter prevents clients from seeing
special files such as sockets, devices and fifo's in directory
listings.
</para>
<samba:parameter name="hide special files"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>This parameter prevents clients from seeing
special files such as sockets, devices and fifo's in directory
listings.
</para>
<para>Default: <command moreinfo="none">hide special files = no</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">hide special files = no</command></para>
</listitem>
</samba:parameter>

View File

@ -1,8 +1,10 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="HIDEUNREADABLE"/>hide unreadable (G)</term>
<listitem><para>This parameter prevents clients from seeing the
existance of files that cannot be read. Defaults to off.</para>
<samba:parameter name="hide unreadable"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>This parameter prevents clients from seeing the
existance of files that cannot be read. Defaults to off.</para>
<para>Default: <command moreinfo="none">hide unreadable = no</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">hide unreadable = no</command></para>
</listitem>
</samba:parameter>

View File

@ -1,10 +1,12 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="HIDEUNWRITEABLEFILES"/>hide unwriteable files (G)</term>
<listitem><para>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.
</para>
<samba:parameter name="hide unwriteable files"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>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.
</para>
<para>Default: <command moreinfo="none">hide unwriteable = no</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">hide unwriteable = no</command></para>
</listitem>
</samba:parameter>

View File

@ -1,8 +1,9 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="MANGLECASE"/>mangle case (S)</term>
<listitem><para>See the section on <link linkend="NAMEMANGLINGSECT">
NAME MANGLING</link></para>
<samba:parameter name="mangle case"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>See the section on <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link></para>
<para>Default: <command moreinfo="none">mangle case = no</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">mangle case = no</command></para>
</listitem>
</samba:parameter>

View File

@ -1,23 +1,27 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="MANGLEDSTACK"/>mangled stack (G)</term>
<listitem><para>This parameter controls the number of mangled names
that should be cached in the Samba server <citerefentry><refentrytitle>smbd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry>.</para>
<samba:parameter name="mangling stack"
context="G"
advanced="1" developer="1"
xmlns:samba="http://samba.org/common">
<listitem>
<para>This parameter controls the number of mangled names
that should be cached in the Samba server <citerefentry><refentrytitle>smbd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry>.</para>
<para>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).</para>
<para>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).</para>
<para>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).
</para>
<para>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).
</para>
<para>It is not possible to absolutely guarantee correct long
filenames, so be prepared for some surprises!</para>
<para>It is not possible to absolutely guarantee correct long
filenames, so be prepared for some surprises!</para>
<para>Default: <command moreinfo="none">mangled stack = 50</command></para>
<para>Example: <command moreinfo="none">mangled stack = 100</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">mangled stack = 50</command></para>
<para>Example: <command moreinfo="none">mangled stack = 100</command></para>
</listitem>
</samba:parameter>

View File

@ -1,11 +1,16 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="MANGLEPREFIX"/>mangle prefix (G)</term>
<listitem><para> 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.</para>
<para>Default: <command moreinfo="none">mangle prefix = 1</command></para>
<para>Example: <command moreinfo="none">mangle prefix = 4</command></para>
</listitem>
</samba:parameter>
<samba:parameter name="mangling prefix"
context="G"
advanced="1" developer="1"
xmlns:samba="http://samba.org/common">
<listitem>
<para> 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.</para>
<para>Default: <command moreinfo="none">mangle prefix = 1</command></para>
<para>Example: <command moreinfo="none">mangle prefix = 4</command></para>
</listitem>
</samba:parameter>

View File

@ -1,11 +1,14 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="MANGLINGCHAR"/>mangling char (S)</term>
<listitem><para>This controls what character is used as
the <emphasis>magic</emphasis> character in <link linkend="NAMEMANGLINGSECT">name mangling</link>. The default is a '~'
but this may interfere with some software. Use this option to set
it to whatever you prefer.</para>
<samba:parameter name="mangling char"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>This controls what character is used as
the <emphasis>magic</emphasis> character in <link linkend="NAMEMANGLINGSECT">name mangling</link>. The
default is a '~' but this may interfere with some software. Use this option to set
it to whatever you prefer.</para>
<para>Default: <command moreinfo="none">mangling char = ~</command></para>
<para>Example: <command moreinfo="none">mangling char = ^</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">mangling char = ~</command></para>
<para>Example: <command moreinfo="none">mangling char = ^</command></para>
</listitem>
</samba:parameter>

View File

@ -1,14 +1,19 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="MANGLINGMETHOD"/>mangling method (G)</term>
<listitem><para> controls the algorithm used for the generating
the mangled names. Can take two different values, &quot;hash&quot; and
&quot;hash2&quot;. &quot;hash&quot; is the default and is the algorithm that has been
used in Samba for many years. &quot;hash2&quot; 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.</para>
<para>Default: <command moreinfo="none">mangling method = hash2</command></para>
<para>Example: <command moreinfo="none">mangling method = hash</command></para>
</listitem>
</samba:parameter>
<samba:parameter name="mangling method"
context="G"
advanced="1" developer="1"
xmlns:samba="http://samba.org/common">
<listitem>
<para> controls the algorithm used for the generating
the mangled names. Can take two different values, &quot;hash&quot; and
&quot;hash2&quot;. &quot;hash&quot; is the default and is the algorithm that has been
used in Samba for many years. &quot;hash2&quot; 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.</para>
<para>Default: <command moreinfo="none">mangling method = hash2</command></para>
<para>Example: <command moreinfo="none">mangling method = hash</command></para>
</listitem>
</samba:parameter>

View File

@ -1,13 +1,14 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="PRESERVECASE"/>preserve case (S)</term>
<listitem><para> This controls if new filenames are created
with the case that the client passes, or if they are forced to
be the <link linkend="DEFAULTCASE"><parameter moreinfo="none">default case
</parameter></link>.</para>
<samba:parameter name="preserve case"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para> This controls if new filenames are created
with the case that the client passes, or if they are forced to
be the <link linkend="DEFAULTCASE"><parameter moreinfo="none">default case
</parameter></link>.</para>
<para>Default: <command moreinfo="none">preserve case = yes</command></para>
<para>Default: <command moreinfo="none">preserve case = yes</command></para>
<para>See the section on <link linkend="NAMEMANGLINGSECT">NAME
MANGLING</link> for a fuller discussion.</para>
</listitem>
</samba:parameter>
<para>See the section on <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link> for a fuller discussion.</para>
</listitem>
</samba:parameter>

View File

@ -1,16 +1,17 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="SHORTPRESERVECASE"/>short preserve case (S)</term>
<listitem><para>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 <link linkend="DEFAULTCASE"><parameter moreinfo="none">default case
</parameter></link>. This option can be use with <link linkend="PRESERVECASE"><command moreinfo="none">preserve case = yes</command>
</link> to permit long filenames to retain their case, while short
names are lowered. </para>
<samba:parameter name="short preserve case"
context="S"
xmlns:samba="http://samba.org/common">
<listitem>
<para>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 <link linkend="DEFAULTCASE"><parameter moreinfo="none">default case
</parameter></link>. This option can be use with <link linkend="PRESERVECASE"><command moreinfo="none">preserve case = yes</command>
</link> to permit long filenames to retain their case, while short
names are lowered. </para>
<para>See the section on <link linkend="NAMEMANGLINGSECT">
NAME MANGLING</link>.</para>
<para>See the section on <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link>.</para>
<para>Default: <command moreinfo="none">short preserve case = yes</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">short preserve case = yes</command></para>
</listitem>
</samba:parameter>

View File

@ -1,9 +1,12 @@
<samba:parameter xmlns:samba="http://samba.org/common">
<term><anchor id="STRIPDOT"/>strip dot (G)</term>
<listitem><para>This is a boolean that controls whether to
strip trailing dots off UNIX filenames. This helps with some
CDROMs that have filenames ending in a single dot.</para>
<samba:parameter name="strip dot"
context="G"
advanced="1" developer="1"
xmlns:samba="http://samba.org/common">
<listitem>
<para>This is a boolean that controls whether to
strip trailing dots off UNIX filenames. This helps with some
CDROMs that have filenames ending in a single dot.</para>
<para>Default: <command moreinfo="none">strip dot = no</command></para>
</listitem>
</samba:parameter>
<para>Default: <command moreinfo="none">strip dot = no</command></para>
</listitem>
</samba:parameter>