.\"
.\" Japanese Version Copyright (c) 2001-2004 Yuichi SATO
.\"         all rights reserved.
.\" Translated Mon Mar 12 22:32:08 JST 2001
.\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\" Updated & Modified Sat Sep  8 17:49:44 JST 2001
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\" Updated & Modified Sun Nov 10 03:42:07 JST 2002
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\" Updated & Modified Wed Feb 11 17:50:37 JST 2004 by Yuichi SATO
.\"
.TH AFPD 8 "23 Feb 1999" "netatalk 1.4b2/asun 2.1.3"

.SH 名前
afpd \- AppleTalk ファイリングプロトコルデーモン
.SH 書式
.B afpd
[
.B -duptDTvI
]
[
.B -f
.I defaultvolumes
]
[
.B -s
.I systemvolumes
]
[
.B -n
.I nbpname
]
[
.B -c
.I maxconnections
]
[
.B -g
.I guest
]
[
.B -P
.I pidfile
]
[
.B -S
.I port
]
[
.B -L
.I message
]
[
.B -F
.I config
]
[
.B -U
.I uams
]
[
.B -m
.I umask
]
.SH 説明
.B afpd
は AppleTalk ファイリングプロトコル (AppleTalk Filing Protocol, AFP) の
インターフェースを Unix ファイルシステムに提供する。
このデーモンは、通常、ブート時に
.BR /etc/rc
から起動される。
ユーザーに提供されるボリュームの一覧は、
.B /etc/netatalk/AppleVolumes.system
および
.BR /etc/netatalk/AppleVolumes.default ,
.BR ~/AppleVolumes ,
.BR ~/.AppleVolumes
のうちの 1 つから作成される。
.LP
.B AppleVolumes
ファイルは、マウントするボリュームや
ファイル名拡張子の対応付けを指定するために使われる。
以下のようなフォーマットで、1 行に 1 つを指定する:
.RS
.sp
.I pathname
[
.I volumename
]
.br
.RI . extension
[
.I type
[
.I creator
]
]
.sp
.RE
.I volumename
が指定されない場合、
.I pathname
の最後の '/' より後の部分が使われる。
ボリューム名として同じ名前を重複して使うことはできない。
.I type
が指定されない場合、
.RB ' ???? '
が使われる。
.I creator
が指定されない場合、
.RB ' UNIX '
が使われる。
拡張子
.RB ' . '
は、タイプが設定されていない Unix ファイルに対して、
デフォルトのクリエータとタイプを設定する。
空行と `#' で始まる行は無視される。
.SH オプション
.TP
.B \-d
デーモンを fork せず、全ての AFP コマンドを標準出力に書き出すように指定する。
.TP
.BI \-f " defaultvolumes"
デフォルトで提供するボリュームの一覧を、
.B /etc/netatalk/AppleVolumes.default
ではなく
.I defaultvolumes
から読み込む。
.TP
.BI \-s " systemvolumes"
全てのユーザーに提供するボリュームの一覧を、
.B /etc/netatalk/AppleVolumes.system
ではなく
.I systemvolumes
から読み込む。
.TP
.B \-u
ユーザーの
.B AppleVolumes
ファイルを最初に読み込む。
このオプションにより、ユーザーの
.B AppleVolumes
ファイルにあるボリューム名が、システムの
.B AppleVolumes
ファイルにあるボリューム名よりも優先される。
デフォルトではシステムの
.B AppleVolumes
が最初に読まれる。
このオプションがファイル名拡張子の対応付けの優先順位には
影響しない点に注意すること:
ユーザーの AppleVolumes ファイルが常に優先される。
.TP
.BI \-n " nbpname"
NBP の登録に、
ローカルゾーンのホスト名からドメイン部をとった最初の部分ではなく、
.I nbpname
を使うように指定する。
.TP
.BI \-c " maxconnections"
.BR afpd
に許可する最大接続数を指定する。
デフォルトは 5 である。
.TP
.BI \-g " guest"
ゲストアカウントの名前を指定する。デフォルトは ``nobody'' である。
.TP
.BI \-P " pidfile"
.B afpd
が自身のプロセス ID を格納するファイルを指定する。
.TP
.B \-p
クライアントがパスワードを保存しないようにさせる
.RB (  afpd.conf
における
.I \-nosavepasswd
と等価である)。
.TP
.B \-t
クライアントがパスワードを変更できるようにする
.RB (  afpd.conf
における
.I \-setpasswd
と等価である)。
.TP
.B \-D
トランスポートプロトコルとして DDP (AppleTalk) を使う
.RB (  afpd.conf
における
.I \-ddp
と等価である)。
.TP
.B \-T
トランスポートプロトコルとして TCP/IP を使う
.RB (  afpd.conf
における
.I \-tcp
と等価である)。
.TP
.BI \-S " port"
AFPoverTCP を実行するときに登録するポートを指定する。
デフォルトは
.I 548
である
.RB (  afpd.conf
における
.I -port
と等価である)。
.TP
.BI \-L " message"
クライアントに送られるログインメッセージを指定する
.RB (  afpd.conf
における
.I \-loginmsg
と等価である)。
.TP
.BI \-F " config"
使用する設定ファイルを指定する
(デフォルトは
.I /etc/netatalk/afpd.conf
である)。
.TP
.BI \-U " uams"
認証プロセスで使用する UAM
(訳註: User Authentication Method, ユーザ認証法) の
コンマで区切られたリスト
.RB (  afpd.conf
における
.I -uamlist
と等価である)。
.TP
.B \-I
プラットフォーム固有のアイコンを使う
.RB (  afpd.conf
における
.I \-icon
と等価である)。
.TP
.BR \-m " umask"
Netatalk でフォルダを作成する際に、この umask を使う。
.TP
.B \-v
バージョン情報を表示して、終了する。
.SH 認証
.B afpd
は、現在のところ、
.BR "NoUserAuthent " (ゲスト),
.BR "Cleartxt passwrd" ,
.B Kerberos IV
という 3 つのユーザー認証法 (UAM) を使うことができる。
ユーザーが
.B NoUserAuthent
を使った場合、デフォルトのボリュームのみをマウントできる。
また、ゲストユーザーに許可されたファイルについてのみ読み書きが可能である。
.B -G
オプションは
.B NoUserAuthent
を使用不可にする。
.B Cleartxt passwd
や
.B Kerberos IV
が使われた場合、
.B afpd
は
.B ~/AppleVolumes
にリストされている全てのボリュームをユーザーに提供する。
ユーザーは通常読み書きできる全てのファイルの読み書きができる。
AFS を使う際に
.B Cleartxt passwd
は推奨されず、
.B Kerberos IV
が推奨される。
アメリカ国外用に、簡略化した UAM,
.B AFS Kerberos
が配布の中に含まれている。
.SH 警告
.B afpd
のディレクトリ ID は、セッションの間を通して固定である。
これは Mac エイリアスが必ずしも常に正しく動作しないことを意味する。
.LP
アプリケーションが対応付けられているフォルダの名前が変更されると、
そのアプリケーションの
.B APPL
対応付けは使用不能になる。
これは、アプリケーションが作った文書をダブルクリックしても、
そのアプリケーションが起動しなくなることを意味する。
.B APPL
対応付けは、次に Finder がアプリケーションを参照したときに、
Mac によって再構築される。
.LP
.B afpd
が Macintosh ファイル名を小文字化するように設定されている場合、
大文字と小文字の混ざった Unix ファイル名は使うことができない。
.LP
キャリッジリターン / ラインフィードの変換が有効にされている場合、
Unix のバイナリファイルを Macintosh にコピーするのは安全でない。
.LP
デバイス間でディレクトリを移動することはできない。
.LP
既存のボリュームの親ボリュームをマウントした場合、
既存のボリュームのデスクトップデータベースは
親ボリュームからは使えない。
.B APPL
対応付けや
.B BNDL
ビットセットを使ったアプリケーションのアイコンは、
Finder がアプリケーションを参照したときに親ボリューム内に作成される。
.LP
ユーザーが自分の
.B ~/AppleVolumes
を編集して自分のディレクトリを提供しないようにした場合、
ユーザーは Macintosh から自分の
.B ~/AppleVolumes
を編集できなくなる。
.LP
`.' で始まる Unix ファイルは、Mac からアクセスできない。
.LP
.I pathname
が
.B ~/AppleVolumes
ファイルにない場合、そのボリュームはセレクタに現れない。
.LP
Microsoft Word の
.B TEXT
文書はキャリッジリターン / ラインフィードの変換が行われない。
なぜなら、MS Word は文書を書き込むときに
.B TEXT
ではないタイプを使い、その後でタイプを
.B TEXT
に変更するためである。
ユーザーが自分の
.B ~/AppleVolumes
を編集できるように、
.B afpd
はファイルの行末文字が (NL, LF の) どちらであっても理解する。
.LP
31 文字より長い Unix ファイル名は、Macintosh からアクセスできない。

.SH シグナル
メインの
.B afpd
プロセスに送られたシグナルは、子プロセスにも伝えられて、
全てに影響を与える。
.TP 13
.B SIGHUP
.B afpd
プロセスは "The server is going down for maintenance." という
メッセージをクライアントに送り、5 分以内にシャットダウンする。
新規の接続は許可されない。
子の
.B afpd
にシグナルが送られても、他の子プロセスには影響しない。
だだしメインプロセスは終了し、新規の接続はできない。
.TP 13
.B SIGUSR1
configure オプション
.B --with-message-dir
が指定された場合、
.B afpd
プロセスは
.B debug
オプションを設定し、メッセージを
.RI /var/tmp/afpd-debug- pid
にリダイレクトする。
このシグナルは子の
.B afpd
にのみ送るべきである。
.B 警告:
.B --with-message-dir
オプションが指定されていない場合、
このシグナルは
.B afpd
プロセスを kill する。
.TP 13
.B SIGUSR2
.B afpd
プロセスは
.I msg
ディレクトリで
.RI message. pid
という名前のファイルを探す。
ファイルが見つかると、それに対応する AFP クライアントに
ファイルの内容をメッセージとして送る。
メッセージが送られた後、ファイルは削除される。

.SH ファイル
.TP 20
.B /etc/netatalk/AppleVolumes.default
マウントするデフォルトのボリュームの一覧
.TP 20
.B /etc/netatalk/AppleVolumes.system
全てのユーザーに提供するボリュームの一覧
.TP 20
.B ~/AppleVolumes
各ユーザーがマウントするボリュームの一覧
.TP 20
.BI /etc/netatalk/msg/message. pid
ユーザーに送られるメッセージ
.TP 20
.BI /var/tmp/afpd-debug- pid
(SIGUSR1 で呼び出された場合の) デバッグ出力
.SH バグ
いくつかの AFP の仕様は、Macintosh で使用されていないので、実装されていない。