Update smbdotconf/filename/manglednames.xml.
| @@ -1,26 +1,89 @@ | ||
| 1 | 1 | <samba:parameter name="mangled names" |
| 2 | - type="boolean" | |
| 2 | + type="enum" | |
| 3 | + enumlist="enum_mangled_names" | |
| 3 | 4 | context="S" |
| 4 | 5 | parm="1" |
| 5 | - xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> | |
| 6 | + xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> | |
| 6 | 7 | <description> |
| 8 | +<!-- 原文 samba-4.7.0 | |
| 9 | + <para>This controls whether non-DOS names under UNIX | |
| 10 | + should be mapped to DOS-compatible names ("mangled") and made visible, | |
| 11 | + or whether non-DOS names should simply be ignored.</para> | |
| 12 | +--> | |
| 7 | 13 | <para> このパラメーターは、 |
| 8 | - UNIX 上の DOS非互換のファイル名をDOS互換の名前(「短縮名」)に短縮してアクセス可能にするか、 | |
| 14 | + UNIX 上の DOS 非互換のファイル名を DOS 互換の名前（「短縮名」）に短縮してアクセス可能にするか、 | |
| 9 | 15 | 単純に無視するかどうかを制御する。</para> |
| 10 | 16 | |
| 17 | +<!-- 原文 samba-4.7.0 | |
| 18 | + <para>See the section on <smbconfoption name="name mangling"/> for | |
| 19 | + details on how to control the mangling process.</para> | |
| 20 | +--> | |
| 11 | 21 | <para>短縮処理がどのように行なわれているかについての詳細は、 |
| 12 | 22 | <smbconfoption name="name mangling"/> セクションを参照のこと。</para> |
| 13 | 23 | |
| 14 | - <para>短縮が行なわれる場合の手法は以下の通りである(訳注:以下は hash アルゴリズムの場合):</para> | |
| 24 | +<!-- 原文 samba-4.7.0 | |
| 25 | + <para>Possible option settings are</para> | |
| 26 | +--> | |
| 27 | + <para>Possible option settings are</para> | |
| 15 | 28 | |
| 16 | 29 | <itemizedlist> |
| 30 | +<!-- 原文 samba-4.7.0 | |
| 31 | + <listitem><para><emphasis>yes (default)</emphasis> - | |
| 32 | + enables name mangling for all not DOS 8.3 conforming | |
| 33 | + names.</para></listitem> | |
| 34 | +--> | |
| 35 | + <listitem><para><emphasis>yes (default)</emphasis> - | |
| 36 | + enables name mangling for all not DOS 8.3 conforming | |
| 37 | + names.</para></listitem> | |
| 38 | + | |
| 39 | +<!-- 原文 samba-4.7.0 | |
| 40 | + <listitem><para><emphasis>no</emphasis> - disables any | |
| 41 | + name mangling.</para></listitem> | |
| 42 | +--> | |
| 43 | + <listitem><para><emphasis>no</emphasis> - disables any | |
| 44 | + name mangling.</para></listitem> | |
| 45 | + | |
| 46 | +<!-- 原文 samba-4.7.0 | |
| 47 | + <listitem><para><emphasis>illegal</emphasis> - does | |
| 48 | + mangling for names with illegal NTFS characters. This | |
| 49 | + is the most sensible setting for modern clients that | |
| 50 | + don't use the shortname anymore.</para></listitem> | |
| 51 | +--> | |
| 52 | + <listitem><para><emphasis>illegal</emphasis> - does | |
| 53 | + mangling for names with illegal NTFS characters. This | |
| 54 | + is the most sensible setting for modern clients that | |
| 55 | + don't use the shortname anymore.</para></listitem> | |
| 56 | + </itemizedlist> | |
| 57 | + | |
| 58 | +<!-- 原文 samba-4.7.0 | |
| 59 | + <para>If mangling is used then the mangling method is as follows:</para> | |
| 60 | +--> | |
| 61 | + <para>短縮が行なわれる場合の手法は以下の通りである。（訳注: 以下は hash アルゴリズムの場合）</para> | |
| 62 | + | |
| 63 | + <itemizedlist> | |
| 17 | 64 | <listitem> |
| 18 | - <para> ファイル名の先頭から一番右にあるドットの前までの英数5文字は、 | |
| 19 | - 大文字に変換された上で、 | |
| 20 | - 短縮名の先頭5文字となる。</para> | |
| 65 | +<!-- 原文 samba-4.7.0 | |
| 66 | + <para>The first (up to) five alphanumeric characters | |
| 67 | + before the rightmost dot of the filename are preserved, forced | |
| 68 | + to upper case, and appear as the first (up to) five characters | |
| 69 | + of the mangled name.</para> | |
| 70 | +--> | |
| 71 | + <para> | |
| 72 | + ファイル名の先頭から一番右にあるドットの前までの英数 5 文字は、 | |
| 73 | + 大文字に変換された上で、短縮名の先頭 5 文字となる。 | |
| 74 | + </para> | |
| 75 | + | |
| 21 | 76 | </listitem> |
| 22 | - | |
| 77 | + | |
| 23 | 78 | <listitem> |
| 79 | +<!-- 原文 samba-4.7.0 | |
| 80 | + <para>A tilde "~" is appended to the first part of the mangled | |
| 81 | + name, followed by a two-character unique sequence, based on the | |
| 82 | + original root name (i.e., the original filename minus its final | |
| 83 | + extension). The final extension is included in the hash calculation | |
| 84 | + only if it contains any upper case characters or is longer than three | |
| 85 | + characters.</para> | |
| 86 | +--> | |
| 24 | 87 | <para>チルダ「~」が短縮名に付加される。 |
| 25 | 88 | 更に元々のファイル名のベース部分(ファイル名から拡張子部分を除いたもの)から生成された一意な2文字が付加される。 |
| 26 | 89 | 拡張子にあたる部分は、大文字を含んでいるか、 |
| @@ -27,6 +90,11 @@ | ||
| 27 | 90 | 3文字以上の場合のみ、ハッシュの計算に含まれる。 |
| 28 | 91 | </para> |
| 29 | 92 | |
| 93 | +<!-- 原文 samba-4.7.0 | |
| 94 | + <para>Note that the character to use may be specified using | |
| 95 | + the <smbconfoption name="mangling char"/> | |
| 96 | + option, if you don't like '~'.</para> | |
| 97 | +--> | |
| 30 | 98 | <para> 「~」の利用を避けたい場合は、 |
| 31 | 99 | <smbconfoption name="mangling char"/> |
| 32 | 100 | オプションにより、別の文字を指定することも可能である。</para> |
| @@ -33,6 +101,13 @@ | ||
| 33 | 101 | </listitem> |
| 34 | 102 | |
| 35 | 103 | <listitem> |
| 104 | +<!-- 原文 samba-4.7.0 | |
| 105 | + <para>Files whose UNIX name begins with a dot will be | |
| 106 | + presented as DOS hidden files. The mangled name will be created as | |
| 107 | + for other filenames, but with the leading dot removed and "___" as | |
| 108 | + its extension regardless of actual original extension (that's three | |
| 109 | + underscores).</para> | |
| 110 | +--> | |
| 36 | 111 | <para>UNIX 上のファイル名がドットから始まる場合、 |
| 37 | 112 | そのファイルは DOS の隠しファイルとして扱われる。 |
| 38 | 113 | この場合の短縮名は、ファイル名の先頭のドットを取り除き、 |
| @@ -41,17 +116,33 @@ | ||
| 41 | 116 | </listitem> |
| 42 | 117 | </itemizedlist> |
| 43 | 118 | |
| 44 | - <para>2桁のハッシュ値は、大文字の英数文字になる。</para> | |
| 119 | +<!-- 原文 samba-4.7.0 | |
| 120 | + <para>The two-digit hash value consists of upper case alphanumeric characters.</para> | |
| 121 | +--> | |
| 122 | + <para>2 桁のハッシュ値は、大文字の英数文字になる。</para> | |
| 45 | 123 | |
| 124 | +<!-- 原文 samba-4.7.0 | |
| 125 | + <para>This algorithm can cause name collisions only if files | |
| 126 | + in a directory share the same first five alphanumeric characters. | |
| 127 | + The probability of such a clash is 1/1300.</para> | |
| 128 | +--> | |
| 46 | 129 | <para>このアルゴリズムは、 |
| 47 | 130 | ディレクトリ内のファイルに先頭の英数 5 文字が同一のファイル名が存在する時のみ名前の衝突が発生するが、 |
| 48 | 131 | 実際に衝突する確率は、1/1300 である。</para> |
| 49 | 132 | |
| 133 | +<!-- 原文 samba-4.7.0 | |
| 134 | + <para>The name mangling (if enabled) allows a file to be | |
| 135 | + copied between UNIX directories from Windows/DOS while retaining | |
| 136 | + the long UNIX filename. UNIX files can be renamed to a new extension | |
| 137 | + from Windows/DOS and will retain the same basename. Mangled names | |
| 138 | + do not change between sessions.</para> | |
| 139 | +--> | |
| 50 | 140 | <para> |
| 51 | - 名前の短縮処理により、(この処理が有効な限り) Windows や DOS から、UNIX 側の長いファイル名を保持したまま UNIX ディレクトリ間のファイルのコピーができる。 | |
| 141 | + 名前の短縮処理により、（この処理が有効な限り）Windows や DOS から、UNIX 側の長いファイル名を保持したまま UNIX ディレクトリ間のファイルのコピーができる。 | |
| 52 | 142 | Windows や DOS 側から UNIX 側のファイル名の拡張子を変更しても、ベース名は保持される。 |
| 53 | 143 | なお、セッションが異なっても短縮名は変化しない。 |
| 54 | 144 | </para> |
| 55 | 145 | </description> |
| 56 | 146 | <value type="default">yes</value> |
| 147 | +<value type="example">illegal</value> | |
| 57 | 148 | </samba:parameter> |
trunk/docs-xml/smbdotconf/filename/manglednames.xml