diff --git a/doc/ja/manpages/man5/afp.conf.5.xml b/doc/ja/manpages/man5/afp.conf.5.xml index 2bc2bd84008..33396eeb9f5 100644 --- a/doc/ja/manpages/man5/afp.conf.5.xml +++ b/doc/ja/manpages/man5/afp.conf.5.xml @@ -446,6 +446,10 @@ ボリュームのファイルシステムのエンコーディングを指定する。デフォルトではと同じである。 + + + デフォルトのUTF-8エンコーディングを使うことをを強く推奨する。 + @@ -908,9 +912,8 @@ (G) - Classic Mac OS の Finder に表示される共有ボリューム アイコンを設定する。 - 参考に、ある Classic Mac OS バージョンでは、このアイコン設定が無視される。 - 有効なアイコン名の例は以下になる。 + Classic Mac OS の Finder に表示される共有ボリューム アイコンを設定する。 参考に、ある + Classic Mac OS バージョンでは、このアイコン設定が無視される。 有効なアイコン名の例は以下になる。 @@ -1692,6 +1695,16 @@ そのボリュームに使う CNID バックエンドをセットする。デフォルトのバックエンドは [@DEFAULT_CNID_SCHEME@] で、有効なバックエンドは [@compiled_backends@] である。 + + + 「mysql」バックエンドでは、システム管理者が netatalk で使用するために MySQL データベース + インスタンスを構成する必要がある。 + + + + afpd が持続性のある ID + データベースに重く依存しているので、このバックエンドをボリュームに使用するのは推奨されていない。エイリアスはおそらく機能しないだろうし、ファイル名のマングリングもサポートされていない。 + @@ -2076,81 +2089,6 @@ directory perm = 0770 - - CNID バックエンド - - AFP プロトコルはたいていはファイルとディレクトリを名前ではなく ID で参照する。Netatalk はこの ID - を永続的な方法で保管する方法を必要とする。これを達成するためにいくつかの異なる CNID バックエンドが用意されている。CNID - データベースはデフォルトで localstatedir の下に置かれている。 - - - - cdb - - - "Concurrent database" バックエンドは Oracle Berkeley DB - を基礎としている。このバックエンドだと、いくつかの afpd デーモンが直接 CNID - データベースにアクセスする。もし一つのボリュームあたり、一つ以上の afpd - プロセスがアクティブならば、Berkeley DB ロッキングがアクセスを同期するために用いられる。欠点は単一の - afpd プロセスのクラッシュがデータベースを壊すかもしれないということである。 - - - - - dbd - - - CNID データベースへのアクセスは cnid_metad - デーモンプロセスによって制限されている。afpd - プロセスはこのデーモンとデータベースの読み込みと更新のために通信する。もし Berkeley DB - トランザクションとでビルドすれば、データベースの壊れる可能性は経験的にはゼロである。しかし、パフォーマンスは - とによるものより遅いかもしれない。 - - - - - last - - - このバックエンドは、ID の持続性の点では、例外である。ID はカレントセッションでしか有効ではない。これは基本的には - afpd がバージョン 1.5（と1.6）で行ったことである。このバックエンドは、例えば共有 - CD-ROM などで有用なので未だに有効である。Netatalk 3.0 - からは、これは自動的に読み込み専用モードになる。 - - 警告: 今や - afpd が持続性のある ID - データベースに重く依存しているので、このバックエンドをボリュームに使用するのはもはや推奨されていない。エイリアスはおそらく機能しないだろうし、ファイル名のマングリングもサポートされていない。 - - - - - ./configure --help - で他の有効なバックエンドがあると表示するかもしれない。にも関わらずそれらは壊れていることもありえるし、あるいは主にテストのために使われていることを注意すべきである。 - あなたが何をしているのかわかっている場合以外はそれらを使用してはならない。それらは将来のバージョンでそれ以上の通告なく除去されるかもしれない。 - - - - 文字セットオプション - - OS XでAppleはAFP3プロトコルを導入した。最も重要な変更の一つは、AFP3は分解済UTF-8 - としてエンコードされたUnicode名を用いることである。以前のAFP及びOSバージョンはMacRomanやMacCentralEuropeといったコードページを用いた。 - - afpdがunixファイルシステム上にファイルを保存するとき、拡張されたMacintosh文字やunixファイル名としては不正な文字を維持する方法が必要である。現在のバージョンは今、名前のためのデフォルトエンコーディングとしてUTF-8を用いる。「/」は「:」に変換される。 - - 初期のバージョンはいわゆるCAPエンコーディングを用いた。一つの拡張文字(>0x7F)は一つの :xx - シーケンスに変換された。例えば、Appleロゴ (MacRoman: - 0xF0)は:f0として保存された。幾つかの特殊な文字も - :xx表記として変換された。「/」は:2fにエンコードされ、先頭のドット「.」は:2eにエンコードされた。 - - オプションは他のボリュームエンコーディングを選べるようにする。afpdは - - iconv - - 1 - が提供する如何なる文字セットも受け入れる。デフォルトのUTF-8を使うことをを強く推奨する。 - - 参照 @@ -2180,6 +2118,7 @@ directory perm = 0770 著作者 - CONTRIBUTORS を参照 + CONTRIBUTORS + を参照 diff --git a/doc/ja/manual/configuration.xml b/doc/ja/manual/configuration.xml index 76ae45a1d4f..d5596396574 100644 --- a/doc/ja/manual/configuration.xml +++ b/doc/ja/manual/configuration.xml @@ -243,9 +243,13 @@ basedir regex = /usr/home "last" CNID バックエンド - last バックエンドはメモリーにデータを保持する tdb データベースである。それ故永続性がない。netatalk 3.0 - からは、それは自動的に読み込み専用モードになる。このバックエンドは例えば CD-ROM + last バックエンドはメモリーにデータを保持する tdb データベースである。故永続性がなく、ID + はカレントセッションでしか有効ではない。netatalk 3.0 + からは、それは読み込み専用モードになっている。このバックエンドは例えば CD-ROM や自動化テスト などに有用である。 + + これは基本的には afpd が netatalk バージョン 1.5以前で CNID + データの保存方法に一致している。 diff --git a/doc/manpages/man5/afp.conf.5.xml b/doc/manpages/man5/afp.conf.5.xml index fefc7d6ccff..b1fee19675c 100644 --- a/doc/manpages/man5/afp.conf.5.xml +++ b/doc/manpages/man5/afp.conf.5.xml @@ -528,6 +528,11 @@ Specifies the encoding of the volumes filesystem. By default, it is the same as . + + + It is highly recommended to stick to the default UTF-8 + encoding. + @@ -970,8 +975,8 @@ Sets the path to dbus-daemon binary used by the Spotlight - feature. Can be used when the compile-time default path - does not match the runtime environment. + feature. Can be used when the compile-time default path does not + match the runtime environment. @@ -1061,8 +1066,8 @@ Sets the shared volume icon displayed in the Finder in - Classic Mac OS. Note that some versions of Classic Mac OS - ignores this icon. Examples of valid icon styles: + Classic Mac OS. Note that some versions of Classic Mac OS ignores + this icon. Examples of valid icon styles: @@ -1919,6 +1924,19 @@ set the CNID backend to be used for the volume, default is [@DEFAULT_CNID_SCHEME@] available schemes: [@compiled_backends@] + + + The "mysql" backend requires the system administrator to + configure a MySQL database instance for use with + netatalk. + + + + Do NOT use the "last" backend for + volumes, because afpd relies heavily on a + persistent ID database. Aliases will likely not work and + filename mangling is not supported. + @@ -2333,88 +2351,6 @@ - - CNID backends - - The AFP protocol primarily refers to files and directories by ID and - not by name. Netatalk needs a way to store these IDs in a persistent way. - To achieve this, Netatalk provides multiple CNID backends with different - capabilities. The CNID databases are by default located under - localstatedir. - - - - dbd - - - Access to the CNID database is restricted to the - cnid_metad daemon process. - afpd processes communicate with the daemon for - database reads and updates. If built with Berkeley DB transactions - the probability for database corruption is practically zero, but - performance can be slower than with - - - - - last - - - This backend is an exception, in terms of ID persistency. ID's - are only valid for the current session. This is basically what - afpd did in the 1.5 (and 1.6) versions. This - backend is still available, as it is useful for e.g. sharing CD-ROMs. - Starting with Netatalk 3.0, it becomes the read only - mode automatically. - - Warning: It is - NOT recommended to use this backend for volumes - anymore, as afpd now relies heavily on a - persistent ID database. Aliases will likely not work and filename - mangling is not supported. - - - - - Even though ./configure --help might show that - there are other CNID backends available, be warned those are likely broken - or mainly used for testing. Don't use them unless you know what you're - doing, they may be removed without further notice from future - versions. - - - - Charset options - - With OS X Apple introduced the AFP3 protocol. One of the most - important changes was that AFP3 uses unicode names encoded as UTF-8 - decomposed. Previous AFP/OS versions used codepages, like MacRoman, - MacCentralEurope, etc. - - afpd needs a way to preserve extended Macintosh - characters, or characters illegal in unix filenames, when saving files on - a unix filesystem. This version now uses UTF-8 as the default encoding for - names. '/' will be converted to - ':'. - - Earlier versions used the the so called CAP encoding. An extended - character (>0x7F) would be converted to a :xx sequence, e.g. the Apple - Logo (MacRoman: 0xF0) was saved as :f0. Some special - characters would be converted as to :xx notation as well. - '/' would be encoded to :2f, a - leading dot '.' might be encoded as - :2e. - - The option will allow you to select - another volume encoding. afpd will accept any - - iconv - - 1 - provided charset. It is highly recommended to stick to - the default UTF-8. - - See Also @@ -2444,6 +2380,7 @@ Author - See CONTRIBUTORS + See CONTRIBUTORS diff --git a/doc/manual/configuration.xml b/doc/manual/configuration.xml index 069180d3f0b..79cf4023ccb 100644 --- a/doc/manual/configuration.xml +++ b/doc/manual/configuration.xml @@ -234,9 +234,13 @@ basedir regex = /usr/home The last backend is an in-memory tdb database. It is not - persistent. Starting with netatalk 3.0, it operates in read - only mode automatically. This is useful e.g. for mounting - CD-ROMs. + persistent, with IDs valid only for the current session. Starting with + netatalk 3.0, it operates in read only mode. This + backend is useful e.g. for mounting CD-ROMs, or for automated + testing. + + This is basically equivalent to how afpd stored + CNID data in netatalk 1.5 and earlier. @@ -696,8 +700,8 @@ basedir regex = /usr/home support exists since AppleShare client 3.8.x. On macOS, there exist some client-side techniques to make the - AFP-client more verbose, so one can have a look at what's happening while - negotiating the UAMs to use. Compare with this hint. @@ -1341,12 +1345,12 @@ aclmode = passthrough Mapping POSIX ACLs to macOS ACLs - When a client wants to read an object's ACL, afpd maps its - POSIX ACL onto an equivalent macOS ACL. Writing an object's ACL - requires afpd to map an macOS ACL onto a POSIX ACL. Due to - architectural restrictions of POSIX ACLs, it is usually impossible to - find an exact mapping so that the result of the mapping process will - be an approximation of the original ACL's semantic. + When a client wants to read an object's ACL, afpd maps its POSIX + ACL onto an equivalent macOS ACL. Writing an object's ACL requires + afpd to map an macOS ACL onto a POSIX ACL. Due to architectural + restrictions of POSIX ACLs, it is usually impossible to find an exact + mapping so that the result of the mapping process will be an + approximation of the original ACL's semantic.