日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
PPP(8) FreeBSD システム管理者マニュアル PPP(8)
名称
ppp -- ポイントからポイントプロトコル (Point to Point Protocol) (別名、
ユーザ ppp)
書式
ppp [-mode] [-nat] [-quiet] [-unitN] [system ...]
解説
これは、ユーザプロセスの PPP ソフトウェアパッケージです。PPP は、時々、
(pppd でそうなっているように) カーネルの一部として実装されますが、そのた
め、デバッグや動作の変更が少々難しい場合があります。それに対し、この実装
では、トンネルデバイスドライバ (tun) を利用して、ユーザプロセスで PPP を
実現しています。
-nat フラグは、``nat enable yes'' と等価であり、ppp のネットワークアドレ
ス変換機能を有効にします。これにより ppp は、内部 LAN 上の全マシンに対す
る NAT、すなわちマスカレーディングエンジンとして動作します。NAT エンジン
の技術的な詳細は、libalias(3) を参照してください。ppp での NAT の構成の仕
方については、本マニュアルページのネットワークアドレス変換 (パケットエイ
リアシング) を参照してください。
-quiet フラグを指定すると、ppp は、起動時に静かになり、モードとインタ
フェースを標準出力へ表示しなくなります。
-unit フラグは、ppp が /dev/tunN のみのオープンを試みるように指定します。
通常、ppp は、N に対して値 0 から開始し、成功するまで N を値 1 ずつ増加さ
せて、トンネルデバイスのオープンを試みます。デバイスファイルが存在しない
ために、3 回連続して失敗すると、諦めます。
ppp は、次の mode を理解します:
-auto
ppp は、tun インタフェースをオープンし、これを設定した後バックグ
ラウンドになります。出力データが tun インタフェース上で検出される
までリンクはアップせず、出力データが tun インタフェース上で検出さ
れると ppp は、リンクをアップしようとします。ppp がリンクをアップ
しようとしている間に受信したパケット (最初のものを含みます) は、
デフォルトで 2 分間キューにとどまります。後述の ``set choked'' コ
マンドを参照してください。
-auto モードでは、コマンドラインには少なくとも 1 つの ``system''
を指定する必要があり (後述)、インタフェース設定時に使用する相手の
IP アドレスを指定する ``set ifaddr'' を、システムプロファイルで実
行する必要があります。通常、``10.0.0.1/0'' のようなものが適切で
す。例としては、/usr/share/examples/ppp/ppp.conf.sample の
``pmdemand'' システムを参照してください。
-background
この場合、ppp は、相手との接続をすぐに確立しようとします。成功す
ると、ppp は、バックグラウンドになり、親プロセスは、終了コード 0
を返します。失敗すると、ppp は、非 0 の結果で終了します。
-foreground
フォアグラウンドモードでは、ppp は、相手との接続をすぐに確立しよ
うとしますが、デーモンにはなりません。リンクは、バックグラウンド
モードで作成されます。ppp の起動を別のプロセスから制御したい場合
に有用です。
-direct
これは、既に確立された接続を介して通信するために使用します。通常
は、入力接続を getty(8) が受け取ったときに使用されます ppp は、
``set device'' 行を無視し、リンクに記述子 0 を使用します。ppp
は、また設定されたチャットスクリプトをすべて無視しますが、
``force-scripts'' オプションが有効な場合は、例外です。
コールバックの設定を行うと、ダイヤルバック時に ppp は、``set
device'' 情報を使用します。
-direct モードで実行するとき、ppp は、記述子 0 が pipe(2) によっ
て作成されたなら、わずかに異なって振る舞います。パイプが双方向で
ないときに、ppp は、記述子 0 での読み込み動作のみ、そのままにし
て、すべての書き込みを記述子 1 (標準出力) に向け直します。記述子
0 が socketpair(2) によって作成されたなら、特別な動作を行いませ
ん。
-dedicated
このオプションは、専用線で接続されたマシンのためにデザインされて
います。ppp は、デバイスを常にオープンに保ちます。また、設定され
たチャットスクリプトは、一切使用しませんが、``force-scripts'' オ
プションが有効な場合は、例外です。
-ddial
-auto モードと等価ですが、なんらかの理由でリンクが落ちた場合に
ppp が再度リンクをアップすることが違います。
-interactive
これは、no-op であり、前述のフラグがどれも指定されなかった場合の
動作を行います。ppp は、コマンドラインで指定されたセクションを
ロードし、対話プロンプトを提供します。
(/etc/ppp/ppp.conf に指定される) 設定エントリ、すなわち system を、コマン
ドラインで 1 つ以上指定可能です。起動時に ppp は、/etc/ppp/ppp.conf から
``default'' システムを読み込み、その後コマンドラインで指定した各 system
を読み込みます。
主な機能
対話的なユーザインタフェースを提供 コマンドモードで利用する場合、ユーザ
がコマンドを入力することで、簡単にリモートコンピュータとの接続の確立、接
続状態の確認、接続の切断を行うことができます。オプションとして、セキュリ
ティ確保のためにすべての機能をパスワードで保護することができます。
手動と自動でのダイヤルをサポート 対話モードでは、直接デバイスと通信でき
るように ``term'' コマンドが用意されています。リモートホストと接続され
て、PPP での通信が始まったら、ppp は、それを検出して自動的にパケットモー
ドに移行します。ひとたびリモートホストとの接続に必要なコマンドシーケンス
がわかったら、後々の接続を簡単にするため、必要なダイヤル手順やログイン手
順を {定義する} チャットスクリプトを書くことができます。
オンデマンドでのダイヤルアップをサポート -auto モード (自動モード) で
は、ppp は、デーモンとして動作し、PPP リンクを通して送られるパケットを待
ちうけます。パケットを検出すると、デーモンが自動的にダイヤルを行って接続
を確立します。-ddial モード (直接ダイヤルモード) でもほぼ同様に、自動ダイ
ヤルと接続の確立を行います。しかしながらこのモードは、送るべきパケットが
存在しない場合にも、リンクが切れていることを検出するといつでもリモートへ
ダイヤルするという点が auto モードと異なります。このモードは、電話料金よ
りも常時接続されていることが重視される場合に有用です。3 番目の -dedicated
モード (専用線モード) も利用可能です。このモードは、2 つのマシン間の専用
線を対象にしています。専用線モードでは、ppp は、自発的に動作を終了するこ
とはありません - 終了するには、``quit all'' コマンドを診断ソケットを介し
て送る必要があります。SIGHUP は、LCP の再ネゴシエーションを強要し、
SIGTERM は、終了を強要します。
クライアントコールバックのサポート ppp は、標準 LCP コールバックプロト
コルまたは Microsoft コールバック制御プロトコル (CallBack Control Proto
col) (https://winprotocoldoc.blob.core.windows.net/productionwin
dowsarchives/MS-CBCP/[MS-CBCP].pdf). のいずれかを使用することができま
す。
NAT またはパケットエイリアシングのサポート パケットエイリアシング (別名:
IP マスカレード) により、未登録でプライベートなネットワーク上のコンピュー
タからもインターネットにアクセスすることが可能です。PPP ホストは、マスカ
レードゲートウェイとして動作します。送信パケットの IP アドレスと TCP や
UDP のポート番号は、どちらも NAT され、返信パケットではエイリアスが元に戻
されます。
バックグラウンド PPP 接続のサポート バックグラウンドモードでは、接続を確
立するのに成功した場合に ppp は、デーモンになります。それ以外の場合は、エ
ラーで終了します。これにより、接続が成功裏に確立した場合のみコマンドを実
行するようなスクリプトをセットアップすることが出来ます。
サーバ側の PPP 接続のサポート ダイレクトモードでは、ppp は、標準入力/標
準出力からの PPP 接続を受け入れるサーバとして動作させることができます。
PAP と CHAP (rfc 1994, 2433 と 2759) の認証のサポート PAP または CHAP を
用いることにより、Unix スタイルの login(1) 手続きをスキップし、PPP プロト
コルを代りに認証に使用することが可能です。相手が Microsoft CHAP 認証を要
求し、かつ ppp が DES をサポートするようにコンパイルされている場合、適当
な MD4/DES 応答がなされます。
RADIUS (rfc 2138 & 2548) 認証のサポート PAP と CHAP の拡張である Remote
Access Dial In User Service は、集中データベースまたは分散データベース
に、ユーザごとに異なる接続特性を含んだ認証情報を、格納できます。コンパイ
ル時に libradius(3) が利用可能な場合、利用するように設定すると、ppp は、
これを使用して RADIUS 要求を作成します。
代理 arp (Proxy Arp) のサポート ppp が相手のために 1 個以上の代理 arp
エントリを作成するように、設定可能です。LAN 上の各マシンでの設定を行わず
に、相手側から LAN へのルーティングを可能とします。
パケットのフィルタリングのサポート ユーザは、4 種類のフィルタを {定義}
することができます。in は、受信パケットに対するフィルタです。out は、送信
パケットに対するフィルタです。dial は、ダイヤルを行うきっかけとなるパケッ
トを {定義} するフィルタで、alive は、接続を保持するためのパケットを定義
するフィルタです。
トンネルドライバは、bpf (Berkeley Packet Filter) をサポート PPP リンクを
流れるパケットを調べるために、tcpdump(1) を使うことができます。
PPP オーバ TCP と PPP オーバ UDP のサポート デバイス名が
host:port[/tcp|udp], 形式で指定された場合、ppp は、通常のシリアルデバイス
を使うのではなく、データ転送のための TCP または UDP の接続を開きます。UDP
接続は、ppp を強制的に同期モードにします。
PPP オーバイーサネットのサポート (rfc 2516) ppp が
PPPoE:iface[:provider] の書式のデバイス指定を与えられ、netgraph(4) が利用
可能な場合、ppp は、iface ネットワークインタフェースを使用し、provider に
対して PPP オーバイーサネットを話そうとします。
netgraph(4) をサポートしないシステム上では、pppoed(8) のような外部プログ
ラムを使用可能です。
IETF ドラフトの Predictor-1 (rfc 1978) と DEFLATE (rfc 1979) 圧縮のサポー
ト ppp は、VJ 圧縮だけでなく、Predictor-1 と DEFLATE 圧縮もサポートして
います。通常、モデムは、組み込みの圧縮機能があり (例えば、v42.bis)、シス
テムは、そのような圧縮の結果として、そこからより高いデータ速度で受信でき
ます。これは、一般には、良いことですが、より高速のデータによってシリアル
回線からの割り込みが増加します。システムは、この割り込みをモデムと通信し
て処理しなくてはならないため、システムの負荷と遅延時間が増加することにな
ります。VJ 圧縮とは異なり、Predictor-1 と DEFLATE 圧縮は、リンクを通るす
べてのネットワークトラフィックをあらかじめ圧縮しておくことで、オーバヘッ
ドを最小にします。
Microsoft の IPCP 拡張のサポート (rfc 1877) Microsoft の PPP スタックを
使用するクライアント (つまり Win95, WinNT) との間でネームサーバのアドレス
と NetBIOS ネームサーバのアドレスをネゴシエーションできます。
マルチリンク PPP のサポート (rfc 1990) ppp は、接続先への複数の物理的な
回線をオープンし、すべてのリンクの帯域幅を合わせてより高いスループットを
得ることができます。
MPPE (draft-ietf-pppext-mppe) のサポート MPPE は、Microsoft 社の Point
to Point 暗号化機構です。ppp を設定して、Microsoft Windows の仮想プライ
ベートネットワーク (VPN) に参加できるようになります。現在のところ、ppp
は、CHAP 81 認証機構からしか暗号鍵を取得することができません。MPPE を動作
させるためには、DES つきで ppp をコンパイルしなくてはなりません。
IPV6CP (rfc 2023) のサポート 通常の IPv4 接続に追加するか、または代わり
に IPv6 接続を行うことができます。
パーミッション
ppp は、ユーザ root、グループ network、パーミッション 04554 でインストー
ルされます。デフォルトで、ppp は、呼び出しているユーザ ID が 0 でないな
ら、実行しません。これは、``allow users'' コマンドを /etc/ppp/ppp.conf に
記載することにより変更することが可能です。通常ユーザとして実行する場合に
は、ppp は、ユーザ ID 0 に変わり、システムの経路表の変更と、システムロッ
クファイルの作成と、ppp の設定ファイルの読み込みを行います。("shell" また
は "!bg" コマンドによって実行される) すべての外部コマンドは、ppp を呼び出
したユーザ ID として実行されます。ユーザ ID 0 にて正確になにが行われてい
るのかに興味がある場合には、ログ機能の `ID0' を参照してください。
始める前に
最初に ppp を実行する時には、いくつかの初期設定を整える必要があります。
• 利用者のシステムの /etc/group ファイルに ``network'' グループがあり、
そのグループが ppp を使うと想定されるすべてのユーザ名を含んでいること
を確かめてください。詳細は、group(5) マニュアルページを参照してくださ
い。また、これらのユーザは、/etc/ppp/ppp.conf ファイルで ``allow
users'' コマンドを使用してアクセス権が与えられなければなりません。
• ログファイルを作成します。ppp は、syslog(3) を使用して情報を記録しま
す。通常のログファイル名は、/var/log/ppp.log です。このファイルに出力
を行うためには、次の行を /etc/syslog.conf ファイルに記述してください:
!ppp
*.*<TAB>/var/log/ppp.log
ppp の実行形式にリンクを作成することにより、複数の PPP ログファイルを
持つことが可能です:
# cd /usr/sbin
# ln ppp ppp0
として /etc/syslog.conf で
!ppp0
*.*<TAB>/var/log/ppp0.log
とします。/etc/syslog.conf を更新した後に、syslogd(8) に HUP シグナル
を送ることをお忘れなく。
• 厳密には、ppp の操作とは関係ありませんが、リゾルバが正しく働くように
設定した方が良いでしょう。これは、(named(8) を用いて) ローカルな DNS
サーバを設定するか、もしくは /etc/resolv.conf ファイルに適切な
`nameserver' 行を加えることで行われます。詳細は、resolv.conf(5) のマ
ニュアルを参照してください。
他の方法として、もし接続先がサポートしている場合には、ppp が接続先に
ネームサーバのアドレスを尋ねて、自動的に /etc/resolv.conf を更新する
ことができます。詳細は、後述の ``enable dns'' コマンドと ``resolv''
コマンドとを参照してください。
手動ダイヤル
次の例では、利用者のマシン名が awfulhak であるとして説明します。ppp を引
数なしで起動すると (前述のパーミッション参照) 次のプロンプトが表示されま
す:
ppp ON awfulhak>
プロンプトの `ON' の部分は、常に大文字であるべきです。ここが小文字の場
合、``passwd'' コマンドを使用してパスワードを入力しなければならないことを
意味します。実行中の ppp に接続し、まだ正しいパスワードを入力していない場
合にのみこのような状態になります。
デバイス名と速度を指定して開始できます。
ppp ON awfulhak> set device /dev/cuau0
ppp ON awfulhak> set speed 38400
通常ハードウェアフロー制御 (CTS/RTS) を使用します。しかし、特定の場合 (特
定の PPP 可能な端末サービスに直接接続している場合に起り得ます)、ppp が通
信リンクにデータを書き込もうとしたときに、永遠に来ない CTS (送信時にクリ
ア) シグナルを待つことにより ppp がハングします。直通線で接続できない場合
は、``set ctsrts off'' で CTS/RTS をオフにしてみてください。これが必要な
場合、後述の ``set accmap'' の記述も参照してください - ``set accmap
000a0000'' も必要かもしれません。
通常、パリティは、``none'' に設定します。これが ppp のデフォルトです。パ
リティは、どちらかというと古風なエラーチェック機構であり、今となっては使
用しません。最近のモデムは、各自のエラーチェック機構を持っており、ほとん
どのリンク層プロトコル (ppp は、これです) は、より信頼できるチェック機構
を使用します。パリティは、相対的に大きなオーバヘッドを持ちますので (トラ
フィックが 12.5% 増加します)、PPP がオープンされると常に無効化 (``none''
に設定) されます。しかし、ISP (インターネットサービスプロバイダ) によって
は、特定のパリティ設定を接続時 (PPP がオープンする前) に使用するものがあ
ります。特に、Compuserve は、ログイン時に偶数パリティに固執しています:
ppp ON awfulhak> set parity even
ここで、現在のデバイス設定がどのようになっているか見られます:
ppp ON awfulhak> show physical
Name: deflink
State: closed
Device: N/A
Link Type: interactive
Connect Count: 0
Queued Packets: 0
Phone Number: N/A
Defaults:
Device List: /dev/cuau0
Characteristics: 38400bps, cs8, even parity, CTS/RTS on
Connect time: 0 secs
0 octets in, 0 octets out
Overall 0 bytes/sec
ppp ON awfulhak>
今、直接デバイスと通信するために、term コマンドを使用することができます:
ppp ON awfulhak> term
at
OK
atdt123456
CONNECT
login: myispusername
Password: myisppassword
Protocol: ppp
相手が PPP で話しはじめると、ppp は、それを自動的に検出してコマンドモード
に戻ります。
ppp ON awfulhak> # リンクは確立していません
Ppp ON awfulhak> # 接続完了、LCP 完了
PPp ON awfulhak> # 認証完了
PPP ON awfulhak> # IP アドレス合意完了
このようにならない場合、接続先がこちらのネゴシエーション開始を待っている
可能性があります。強制的に ppp に接続先への PPP 設定パケットの送出を開始
させるためには、``~p'' コマンドを使い、端末モードを抜けてパケットモードに
移行してください。
それでもログインプロンプトが得られない場合、Unix 的なログイン/パスワード
認証ではなく、PAP または CHAP の認証を、相手は、要求している可能性が非常
に高いです。正しく設定するためには、プロンプトに戻り、認証用の名前とキー
を設定し、再度接続します:
~.
ppp ON awfulhak> set authname myispusername
ppp ON awfulhak> set authkey myisppassword
ppp ON awfulhak> term
at
OK
atdt123456
CONNECT
ここで再度、ネゴシエーションを開始するように ppp に指定できます:
~p
ppp ON awfulhak> # リンクは確立していません
Ppp ON awfulhak> # 接続完了、LCP 完了
PPp ON awfulhak> # 認証完了
PPP ON awfulhak> # IP アドレス合意完了
これで接続されました! プロンプトの `PPP' が大文字に変化して、接続された
ことを知らせます。もし 3 つの P の内いくつかだけが大文字になっている場合
には、すべての文字が大文字もしくは小文字になるまで待ってください。もし小
文字に戻った場合には、それは、ppp が接続先とのにネゴシエーションに成功し
なかったことを意味します。この時点での問題解決の第一歩としては、次のよう
にし、再挑戦します。
ppp ON awfulhak> set log local phase lcp ipcp
詳細は、下記の ``set log'' コマンドの説明を参照してください。この時点でも
失敗する場合、ログを有効にして再挑戦することが非常に重要です。プロンプト
の変化に注意し、利用者を助けてくれる人に報告することもまた重要です。
リンクが確立したら、show コマンドを使用することで、どのように事態が進行し
ているのかが分ります:
PPP ON awfulhak> show physical
* モデム関連の情報がここに表示されます *
PPP ON awfulhak> show ccp
* CCP (圧縮) 関連の情報がここに表示されます *
PPP ON awfulhak> show lcp
* LCP (回線制御) 関連の情報がここに表示されます *
PPP ON awfulhak> show ipcp
* IPCP (IP) 関連の情報がここに表示されます *
PPP ON awfulhak> show ipv6cp
* IPV6CP (IPv6) 関連の情報がここに表示されます *
PPP ON awfulhak> show link
* (高レベル) リンク関係の情報がここに表示されます *
PPP ON awfulhak> show bundle
* (高レベル) 論理接続関係の情報がここに表示されます *
この時点で、マシンは、接続先に対するホスト単位の経路 (host route) を持っ
ています。これは、リンクの相手のホストとのみ接続可能であるという意味で
す。デフォルト経路のエントリ (他の経路エントリを持たずに、全パケットを
PPP リンクの相手に送るように、利用者のマシンに指示します)を追加したけれ
ば、次のコマンドを入力してください。
PPP ON awfulhak> add default HISADDR
`HISADDR' という文字列は、相手側の IP アドレスを表します。既存の経路のた
めに ``add'' コマンドが失敗する場合には、
PPP ON awfulhak> add! default HISADDR
を用いることで既存の経路を上書きできます。このコマンドは、実際に接続を作
成する前に実行可能です。新しい IP アドレスを接続時にネゴシエートする場
合、これに従って ppp がデフォルト経路を更新します。
ここで、(ping, telnet, ftp のような) ネットワークアプリケーションを、利用
者のマシンの別のウィンドウまたは端末で使用可能です。現在の端末を再利用し
たい場合、ppp をバックグラウンドモードにするために、標準のシェルのサスペ
ンドとバックグラウンドコマンド (通常 ``^Z'' の後に ``bg'') を使用可能で
す。
使用可能コマンドの詳細は、PPP コマンドリストのセクションを参照してくださ
い。
自動ダイヤル
自動ダイヤルを行うためには、ダイヤルとログインのチャットスクリプトを用意
しなければなりません。定義の例は、/usr/share/examples/ppp/ppp.conf.sample
を見てください (/etc/ppp/ppp.conf の書式は、非常に簡単です)。各行は、単一
のコメント、インクルード、ラベル、コマンドのいずれかを含みます。
• (``#'') 文字で始まる行は、コメントとして扱われます。コメント行と認識
した場合、先行する空白は、無視されます。
• インクルードは、語 `{!include}' から始まる行です。1 つの引数 - {イン
クルード} するファイル - を持つ必要があります。古いバージョンの ppp
との互換性のために、``{!include} ~/.ppp.conf'' を使用したいかもしれま
せん。
• ラベルは、行頭から始まり、最後にコロン (``:'') が続かなければなりませ
ん。
• コマンド行は、最初の桁に空白かタブを含む必要があります。
• ``$'' 文字で始まる文字列は、同じ名前の環境変数の値で置き換えられま
す。同様に、``~'' 文字で始まる文字列は、同じ名前のユーザアカウントの
ホームディレクトリへのフルパスで置き換えられ、``~'' 文字自体は、現在
のユーザのホームディレクトリへのフルパスで置き換えられます。コマンド
や引数に ``$'' や ``~'' の文字を含めたい場合には、
set password "pa$ss~word"
のようにダブルクォートで囲んでください。
/etc/ppp/ppp.conf ファイルには、少なくとも ``default'' セクションが存在す
る必要があります。このセクションは、常に実行されます。このファイルには、1
つ以上のセクションが含まれます。セクション名は、用途に応じて付けます。例
えば、``MyISP'' は、利用者の ISP を表したり、``ppp-in'' は、入力の ppp 構
成を表したります。ppp を立ち上げる際に、接続先のラベル名を指定可能です。
``default'' ラベルに関係づけられたコマンドが実行されてから、接続先ラベル
に関連づけられたコマンドが実行されます。ppp を引数なしで起動した場合、
``default'' だけは実行されます。load コマンドを使用して、
/etc/ppp/ppp.conf のセクションを手動でロード可能です:
ppp ON awfulhak> load MyISP
セクションロード後には、ppp は、いかなる動作も行わないことに注意してくだ
さい。これは、コマンドラインでラベルを指定した結果でも、``load'' コマンド
を使用した結果でも同様です。設定ファイル中で、そのラベルに対して指定され
たコマンドのみが、実行されます。一方、ppp を -background, -ddial,
-dedicated のいずれかのスイッチ付きで起動したときには、ppp が接続を確立す
るように、リンクモードが指示します。更なる詳細については、後述の ``set
mode'' コマンドを参照してください。
ひとたび接続が確立したなら、プロンプトの `ppp' は、`PPP' に変わります:
# ppp MyISP
...
ppp ON awfulhak> dial
Ppp ON awfulhak>
PPp ON awfulhak>
PPP ON awfulhak>
Ppp プロンプトは、ppp が認証フェーズに入ったことを示します。PPp プロンプ
トは、ppp がネットワークフェーズに入ったことを示します。PPP プロンプト
は、ppp がネットワーク層プロトコルのネゴシエーションに成功し、使用可能状
態にあることを示します。
もし /etc/ppp/ppp.linkup が利用可能ならば、PPP 接続が確立された時に、その
内容が実行されます。接続が確立された後のバックグラウンドでのスクリプト実
行については、提供されている /usr/share/examples/ppp/ppp.conf.sample (使
用可能な置換文字列については、後述の ``shell'' と ``bg'' を参照してくださ
い) の ``pmdemand'' の例を参照してください。同様に、接続が閉じられると、
/etc/ppp/ppp.linkdown ファイルの内容が実行されます。これらのファイルの形
式は、/etc/ppp/ppp.conf と同じです。
以前のバージョンの ppp では、デフォルト経路のような経路は、ppp.linkup
ファイルで追加し直す必要がありました。現在では、ppp は、HISADDR, MYADDR,
HISADDR6, MYADDR6 が変化したときに、自動的にこれらの文字列を含むすべての
経路を更新する `スティッキ経路' をサポートします。
バックグラウンドダイヤル
ppp を使って非対話的に接続を確立したい場合 (例えば crontab(5) エントリや
at(1) ジョブから使うような場合) には、-background オプションを使います。
-background が指定された場合、ppp は、すぐに接続を確立しようとします。複
数の電話番号が指定された場合には、各電話番号が 1 回ずつ試されます。これら
に失敗すると、ppp は、即座に終了し、0 でない終了コードを返します。接続に
成功すると ppp は、デーモンになり、呼び出し側に終了コード 0 を返します。
デーモンは、リモートシステムが接続を終了した場合、もしくは TERM シグナル
を受け取った場合に、自動的に終了します。
ダイヤルオンデマンド
デマンドダイヤル機能は、-auto または -ddial オプションにて有効にされま
す。この場合にも /etc/ppp/ppp.conf で定義された接続先のラベルを指定しなけ
ればなりません。これには、リモート接続先の IP アドレスを {定義} するため
の ``set ifaddr'' コマンドも書かれていなければなりません
(/usr/share/examples/ppp/ppp.conf.sample を参照してください)。
# ppp -auto pmdemand
-auto または -ddial が指定された時に ppp は、デーモンとして動作しますが、
/etc/ppp/ppp.conf 中で ``set server'' コマンドを使うことで、設定を確認し
たり変更したりすることができます。(たとえば、``set server +3000
mypasswd'' とすると) 次のように診断ポートを通じて接続することができます。
# pppctl 3000 (tun0 を仮定)
Password:
PPP ON awfulhak> show who
tcp (127.0.0.1:1028) *
``show who'' コマンドは、現在 ppp 自身に接続しているユーザの一覧を表示し
ます。診断ソケットが閉じられる、もしくは異なるソケットに変更された場合、
すべての接続は、即座に終了します。
-auto モードにて送信パケットが検出された時、ppp は、(チャットスクリプトに
基づいて) ダイヤルを行い、通信相手に接続しようとします。-ddial モードで
は、回線がダウンしていることが確認された場合にはいつでもダイヤルが行われ
ます。接続に失敗したら、デフォルトの動作では、30 秒間待ってから、別の送信
パケットが検出された時に接続しようとします。``set redial'' コマンドを使用
してこの振る舞いを変更することができます:
set redial secs[+inc[-max]][.next] [attempts]
secs は、再び接続しようとするまでの秒数です。引数がリテラル文字列
`random' の場合には、待ち時間を 1 秒以上から 30 秒以下の間でラ
ンダムに選びます。
inc は、秒数であり、新規にダイヤルするときに secs に加えられます。
このタイムアウト値が secs に戻るのは、接続が成功裏に確立した後
だけです。inc のデフォルト値は、0 です。
max は、ppp が secs を増加させる最大回数です。max のデフォルト値
は、10 です。
next は、電話番号リストの中の次の番号をダイヤルする前に待つ秒数で
す。(``set phone'' コマンドを参照してください)。これのデフォル
トは、3 秒です。繰り返しますが、引数がリテラル文字列 `random'
の場合には、待ち時間を 1 秒以上 30 秒以下の間でランダムに選びま
す。
attempts は、受け取った個々の送信パケットに対して、最大何回接続を試みる
のかを示す数字です。パラメータを省略すると、以前の値は、変更さ
れません。attempts に 0 を指定すると、ppp は、接続されるまで試
みを続けます。
例えば、
set redial 10.3 4
は、個々の送信パケットに対して 4 回接続を試み、番号間の待ち時間が 3 秒
で、すべての番号を試した後に 10 秒待つことを表します。複数の電話番号が指
定されている場合でも、トータルのダイヤル回数は、4 回のままです。(それぞれ
の番号を 4 回ダイヤルするのではありません)。
代りに、
set redial 10+10-5.3 20
は、ppp に接続を 20 回試みさせます。最初の試みの後は、ppp は、10 秒待ちま
す。次の試みの後は、20 秒待ちということを、6 番目の試みの後では、1 分待つ
ところまで行います。次の 14 回の停止は、同じ 1 分間となります。ppp が接続
し、切断した後、再度接続に失敗した場合、タイムアウト値は、再度 10 秒から
開始します。
リンクの両端が ppp の -auto ダイヤルモードを利用している場合は、ダイヤル
間隔を変更しておくのが良いでしょう。もし、リンクの両端が同じタイムアウト
時間に設定されていて、リンクが切れて両方に送信待ちのパケットがあった場
合、両方が同時に相手を呼び出しあうことになってしまいます。場所によって
は、シリアルリンクに信頼性がなく、切れるべきでない時にキャリアが失われる
かもしれません。セッションの途中で予期せずキャリアが失われた場合、ppp に
リダイヤルさせることができます。
set reconnect timeout ntries
このコマンドは、キャリアが失われた時に timeout 秒の間隔を置いて ntries 回
まで接続を再確立するよう ppp に指示します。例えば、
set reconnect 3 5
は、予期せぬキャリア喪失の際に 3 秒待ってから再接続を試みるように ppp に
指示します。これは、ppp があきらめる前に 5 回まで行われます。ntries のデ
フォルト値は、0 (再接続しない) です。このオプションを使用する際には、注意
が必要です。もしローカル側のタイムアウトがリモート側よりもわずかに長い
と、リモート側がタイムアウトにより回線を切断した場合に、再接続機能が (指
定した回数まで) 起動されてしまいます。注: この文脈においては、多くの LQR
を喪失するとキャリア喪失を引き起こし、ひいては再接続を引き起こします。
-background フラグが指定された場合、接続が行えるまですべての電話番号が最
大 1 回ダイヤルされます。``set redial'' コマンドにて、リダイヤル期間の後
に、再接続回数を指定します。リダイヤル値が指定した電話番号数より少ない場
合、指定した電話番号で使用されないものが出来ます。プログラムを終了させる
には、次のように入力してください。
PPP ON awfulhak> close
ppp ON awfulhak> quit all
``quit'' コマンドは、pppctl(8) もしくは telnet(1) による接続を終了します
が、ppp プログラム自身は、終了させません。ppp も終了させたい場合には、
``quit all'' を使用しなければなりません。
PPP 接続の受け入れ (方法その 1)
PPP 接続要求を受け入れるには、次の手順にしたがってください。
1. モデムと、(必要であれば) /etc/rc.serial が正しく設定されていることを
確認します。
• フロー制御には、ハードウェアハンドシェイク (CTS/RTS) を使いま
す。
• モデムは、エコーバックを行わず (ATE0)、コマンドの結果も報告しな
い (ATQ1) ように設定されていなければなりません。
2. モデムが接続されているポートで getty(8) が起動されるように /etc/ttys
を編集します。例えば、次のように設定すれば良いでしょう:
ttyd1 "/usr/libexec/getty std.38400" dialup on secure
getty(8) を起動するために init(8) プロセスに HUP シグナルを送るのを
忘れないでください:
# kill -HUP 1
通常、利用者のモデムの DTR 速度を getty と同じに設定する必要がありま
す:
# ppp
ppp ON awfulhak> set device /dev/cuau1
ppp ON awfulhak> set speed 38400
ppp ON awfulhak> term
deflink: Entering terminal mode on /dev/cuau1
Type `~?' for help
at
OK
at
OK
atz
OK
at
OK
~.
ppp ON awfulhak> quit
3. /usr/local/bin/ppplogin ファイルを次のような内容で作成します:
#!/bin/sh
exec /usr/sbin/ppp -direct incoming
ダイレクトモード (-direct) では、ppp は、標準入力と標準出力を使って
動作します。クライアント動作の ppp と同様に、pppctl(8) を使用するこ
とで、構成された診断ポートに接続可能です。
ここで /etc/ppp/ppp.conf 中の incoming セクションが設定されていなけ
ればなりません。
incoming セクションに適当な ``allow users'' コマンドがあることを確か
めておいてください。
4. 受け入れるユーザのアカウントを用意してください。
ppp:xxxx:66:66:PPP Login User:/home/ppp:/usr/local/bin/ppplogin
詳細は、adduser(8) と vipw(8) のマニュアル項目を参照してください。
5. ``accept dns'' および ``set nbns'' コマンドを使うことで IPCP による
ドメインネームサーバと NetBIOS ネームサーバのネゴシエーションを有効
にすることが可能です。下記の記述を参照してください。
PPP 接続の受け入れ (方法その 2)
この方法は、login(1) ではなく ppp で接続の認証を行うという点が異なりま
す。
1. /etc/gettytab の default セクションに ``pp'' ケーパビリティを指定す
ることで ppp を自動的に認識するように設定してください。
default:\
:pp=/usr/local/bin/ppplogin:\
.....
2. 上記の方法その 1 の最初の 3 手順と同じように、シリアルデバイスを設定
し、getty(8) を有効にして、/usr/local/bin/ppplogin を作成してくださ
い。
3. /etc/ppp/ppp.conf の `incoming' ラベル (もしくは ppplogin が用いるラ
ベルならなんでも構いません) 下に ``enable chap'' か ``enable pap''
(もしくはその両方) を加えてください。
4. /etc/ppp/ppp.secret に、受け入れるユーザそれぞれについて、エントリを
作成してください。
Pfred<TAB>xxxx
Pgeorge<TAB>yyyy
これで、getty(8) は、(HDLC フレームヘッダを認識することで) ppp 接続を検出
すると、すぐに ``/usr/local/bin/ppplogin'' を実行します。
上記のように PAP もしくは CHAP を有効にすることは、必須です。そうしなけれ
ば、あらゆる人が利用者のマシンにパスワードなしに ppp セッションを確立する
ことを許可し、あらゆる種類の潜在的な攻撃に対して門戸を開いていることにな
ります。
内向き接続の認証
通常、接続の受信側は、相手が相手自身を認証することを要求します。これは、
通常 login(1) にて行われますが、代りに PAP か CHAP を使用可能です。2 つの
うちで CHAP の方がより安全ですが、クライアントによってはサポートしていな
いものがあります。どちらを使いたいか決めたら、`enable chap' または
`enable pap' を ppp.conf の適切なセクションに追加してください。
その後、/etc/ppp/ppp.secret ファイルの設定を行う必要があります。このファ
イルは、クライアントになりうるマシンごとに 1 行を含みます。各行は、5 つま
でのフィールドからなります:
name key [hisaddr [label [callback-number]]]
name と key は、期待されるクライアントのユーザ名とパスワードを指定しま
す。key が ``*'' で PAP が使用される場合、ppp は、認証時にパスワードデー
タベース (passwd(5)) を検索します。ppp.secret の如何なる name/key の組み
合わせにおいても適切でない返答をクライアントが与える場合、認証は、失敗し
ます。
認証に成功したならば、(指定時には) hisaddr を IP 番号ネゴシエーション時に
使用します。詳細は、``set ifaddr'' コマンドを参照してください。
認証に成功し label が指定された場合、現在のシステムラベルは、label にマッ
チするように修正されます。このことはファイル ppp.linkup と ppp.linkdown
の後続のパーズに影響があります。
認証に成功し callback-number が指定され ``set callback'' が ppp.conf で指
定された場合、クライアントは、指定された番号でコールバックされます。CBCP
が使用される場合、``set cbcp'' コマンドに渡すのと同様の形式で、callback-
number にもまた番号のリストまたは ``*'' を含むことが可能です。この値は、
ppp で後続する CBCP フェーズで使用します。
PPP オーバ TCP と PPP オーバ UDP (別名: トンネリング)
シリアルリンク上以外の ppp の使用方法として、device にホストとポートを指
定することにより、TCP 接続を使用することが可能です:
set device ui-gate:6669/tcp
シリアルデバイスをオープンする代りに、ppp は、指定されたマシンの指定され
たソケットへの TCP 接続をオープンします。ppp は、telnet プロトコルを使用
しないこと、telnet サーバとネゴシエーションできないことに注意を払うべきで
す。受信マシン (ui-gate) 上に、この PPP 接続を受信するポートを設定する必
要があります。まず /etc/services を更新して、サービスを定義します:
ppp-in 6669/tcp # Incoming PPP connections over TCP
そして /etc/inetd.conf を更新して、このポートへの受信接続をどのように扱う
かを inetd(8) に指示します:
ppp-in stream tcp nowait root /usr/sbin/ppp ppp -direct ppp-in
/etc/inetd.conf を更新した後には、inetd(8) に HUP シグナルを送るのをお忘
れなく。ここでは、ラベル名 ``ppp-in'' を使用します。ui-gate (受信側) の
/etc/ppp/ppp.conf エントリは、次の内容を含みます:
ppp-in:
set timeout 0
set ifaddr 10.0.4.1 10.0.4.2
また、/etc/ppp/ppp.linkup 中のエントリには、次のようなものを含まなくては
なりません。
ppp-in:
add 10.0.1.0/24 HISADDR
ppp がネゴシエーションを行い、インタフェースにアドレスを割り当ててからだ
けしか経路を追加しないように、ppp.linkup ファイル中には、``add'' コマンド
を置く必要があります。
セキュリティのために PAP もしくは CHAP の設定をしたいかもしれません。PAP
を有効にするには、次の行を追加します:
enable PAP
また、次のエントリを /etc/ppp/ppp.secret に作成する必要があります:
MyAuthName MyAuthPasswd
MyAuthPasswd が ``*'' の場合には、パスワードは、passwd(5) データベースか
ら検索されます。
awfulhak (起動側) の /etc/ppp/ppp.conf エントリは、次の内容を含む必要があ
ります:
ui-gate:
set escape 0xff
set device ui-gate:ppp-in/tcp
set dial
set timeout 30
set log Phase Chat Connect hdlc LCP IPCP IPV6CP CCP tun
set ifaddr 10.0.4.2 10.0.4.1
そして、/etc/ppp/ppp.linkup ファイル中に経路の設定もつけます。
ui-gate:
add 10.0.2.0/24 HISADDR
PAP を有効にするのなら、/etc/ppp/ppp.conf プロファイル中に、次のような設
定も必要です。
set authname MyAuthName
set authkey MyAuthKey
我々は、ui-gate に 10.0.4.1 のアドレスを割り当て、awfulhak に 10.0.4.2 の
アドレスを割り当てようとしています。接続をオープンするためには、次の内容
をタイプするだけで良いです。
awfulhak # ppp -background ui-gate
結果として、awfulhak には、ネットワーク 10.0.2.0/24 への新たな「経路」
が、ui-gate には、ネットワーク 10.0.1.0/24 への新たな「経路」が、TCP 接続
経由でそれぞれ作成されます。ネットワークは、実質的にブリッジされます - 下
位レベルの TCP 接続は、パブリックなネットワーク (例えばインターネット) を
またがっても良いです。また 2 つのゲートウェイ間では、PPP トラフィックは、
概念的に TCP ストリーム中でカプセル化されます (パケットがパケットに対応す
るわけではありません)。
この機構の大きな欠点は、同時に 2 つの「配送保証」機構が存在することです -
この 2 つとは、下位レベルの TCP ストリームと PPP リンク上で使用されるプロ
トコルであり、おそらくまた TCP でしょう。パケット喪失が起ると、両者は、そ
れぞれの方法で喪失したパケットを再送しようとするでしょう。
このオーバヘッドを避けるために、トランスポートとして TCP の代りに UDP を
使用できます。これは、単にプロトコルを "tcp" から "udp" に変えるだけで可
能です。トランスポートとして UDP を使用するとき、ppp は、同期モードで動作
します。入力データがパケットに再構成されないという、別の利点もあります。
このように、トンネルされた設定を通してデフォルトの経路を追加するときには
注意してください。デフォルトの経路 (/etc/ppp/ppp.linkup に追加されます)
が、最終的にはリンクのトンネル経由の TCP 接続をルーティングすることになる
のは、良く起こることであり、結果的に接続を狭めてしまうことになります。こ
れを避けるため、トンネル経由の接続の助けになるように、静的経路を追加する
ことを忘れないでください。
ui-gate:
set escape 0xff
set device ui-gate:ppp-in/tcp
add ui-gate x.x.x.x
.....
ここで、``x.x.x.x'' は、``ui-gate'' への経路が通常使用する IP アドレスで
す。
インターネットのような、公共のネットワークを通して接続をルーティングさせ
る場合、データを暗号化する方が望ましいです。MPPE プロトコルの助けを借りれ
ば、それが可能になります。しかし、現在のところ、MPPE が圧縮層として実装し
ている (この点に関しては、Microsoft 社に感謝します) ように、トラフィック
を圧縮することもできるというわけではありません。MPPE 暗号化を有効にするに
は、次のような行をサーバ側の /etc/ppp/ppp.conf に追加してください。
enable MSCHAPv2
disable deflate pred1
deny deflate pred1
その際、/etc/ppp/ppp.secret に必要なエントリを置いたことを確認してくださ
い (MSCHAPv2 は、チャレンジコードベースです。そのため、passwd(5) は、使用
しません)。
MSCHAPv2 および MPPE は、デフォルトで受け取ることができます。ですので、ク
ライアント側では、何も変更を加えなくても動くはずです (ですが、プロファイ
ル中に ``set authname'' と ``set authkey'' があることは、確認してくださ
い)。
ネットワークアドレス変換 (パケットエイリアシング)
-nat コマンドラインオプションにより、ネットワークアドレス変換 (別名、パ
ケットエイリアシング) が有効になります。これにより、ppp ホストがローカル
エリアネットワークの他のコンピュータに対してマスカレードゲートウェイとし
て動作するようになります。送信される IP パケットは、まるで ppp ホストから
来たかのように NAT され、受信パケットは、それがローカルエリアネットワーク
の正しいマシンに送られるように NAT が戻されます。NAT により、未登録でプラ
イベートなサブネット上のコンピュータを外部から見えないようにしつつ、イン
ターネットへアクセス可能とします。一般に、ppp が正しく動作していることの
確認は、まず最初にネットワークアドレス変換を禁止して行います。次に -nat
オプションを有効にして、ppp ホストの上で (ウェブブラウザや telnet(1),
ftp(1), ping(8), traceroute(8) などの) ネットワークアプリケーションの動作
を確認します。最後に、LAN 上の別のコンピュータの上で同様なアプリケーショ
ンの動作を確認することになります。ppp ホストでは、ネットワークアプリケー
ションが正しく動作するのに、LAN 上の別のコンピュータでは、動かないのであ
れば、マスカレードソフトウェアは、正しく動いているけれども、ホストが IP
パケットをフォワーディングしないか、ひょっとするとパケットが送られて来て
いないかのどちらかです。/etc/rc.conf で IP フォワーディングが有効にされて
いることと、他のコンピュータで ppp ホストがその LAN のゲートウェイとして
指定されていることを確認してください。
パケットのフィルタリング
この実装では、パケットのフィルタリングがサポートされています。in フィル
タ、out フィルタ、dial フィルタ、そして alive フィルタの 4 種類のフィルタ
があります。ここでは、基本的なことについて書くことにします。
• フィルタ定義は、次のような構文になっています。
set filter name rule-no action [!] [[host] src_addr[/width]
[dst_addr[/width]]] [proto [src cmp port] [dst cmp port] [estab]
[syn] [finrst] [timeout secs]]
1. name は、`in', `out', `dial', `alive' のいずれかです。
2. rule-no は、`0' から `39' までの数値で、ルール番号を指定します。
ルールは、rule-no の番号順に指定されます。ただしルール `0' が指
定されている場合のみです。
3. action は、`permit', `deny' を指定可能であり、あるパケットがこれ
らのルールに一致した場合、結びつけられた action が直ちに実行され
ます。また action には、`clear' も指定可能です。この場合、この
ルールに結びつけられた action をクリアします。また action には、
現在のルール番号よりも大きなルール番号を指定可能です。この場合に
は、あるパケットが現在のルールに一致した場合、(次のルール番号の
代りに) この新しいルールに対して次にパケットが一致するかを確認し
ます。
action には、エクスクラメーションマーク (``!'') を続けることが可
能です。この場合、ppp は、後続する一致の意味を反転させます。
4. [src_addr[/width]] と [dst_addr[/width]] は、始点と終点の IP ア
ドレスです。[/width] が指定された場合には、それによって適切な
ネットマスクのビット値を与え、アドレスの範囲を指定することができ
ます。
src_addr と dst_addr には、MYADDR, HISADDR, MYADDR6 または
HISADDR6 という値を使用可能です (これらの値の解説は、``bg'' を参
照してください)。これらの値を使用した場合、これらの値が変化する
たびにフィルタが更新されます。これは、後述の ``add'' コマンドの
動作と似ています。
5. proto は、protocols(5) 中の任意のプロトコルです。
6. cmp は、`lt', `eq', `gt' のうちいずれか 1 つです。それぞれ、より
小さい、等しい、より大きいを意味します。port は、ポート番号で指
定するか、/etc/services のサービス名で指定することができます。
7. `estab', `syn', `finrst' フラグは、proto が `tcp' に設定されてい
るときにのみ許可され、それぞれ TH_ACK、TH_SYN、および TH_FIN も
しくは TH_RST という TCP フラグを表わします。
8. タイムアウト値は、現在のアイドルタイムアウトを最低でも secs 秒へ
と修正します。タイムアウトを、alive フィルタと in/out フィルタの
両方で指定すると、in/out での値が使用されます。タイムアウトを指
定しないと、デフォルトタイムアウト (set timeout を使用して設定す
るもので、デフォルトでは、180 秒になります) が使用されます。
• 各フィルタは、ルール 0 から始まり、40 個までのルールをもつことができ
ます。規則のルールは、ルール 0 が定義されていなければ、有効にはなりま
せん。すなわち、デフォルトでは、すべてが通されます。
• 定義されたルール集合中にマッチするものが無い場合、パケットは、破棄
(ブロック) されます。フィルタにルールが存在しない場合、パケットは、通
過を許されます。
• PROTO_IP PPP フレームヘッダを持つ UDP フレームに対しては、ペイロード
に基づいたフィルタリングを行なうことが可能です。詳細については、後述
の filter-decapsulation を参照してください。
• すべての規則を消去するには、``set filter name -1'' を使ってください。
/usr/share/examples/ppp/ppp.conf.sample を参照してください。
アイドルタイマの設定
アイドルタイマを調べたり/設定するためには、それぞれ ``show bundle'' と
``set timeout'' コマンドを使ってください:
ppp ON awfulhak> set timeout 600
タイムアウト時間は、秒数で指定します。デフォルト値は、timeout が 180 秒
(3 分) です。アイドルタイマ機能を使わないようにするためには、次のコマンド
を利用してください。
ppp ON awfulhak> set timeout 0
-ddial と -dedicated モードでは、アイドルタイムアウトは、無視されます。
-auto モードでは、アイドルタイムアウトが発生すると ppp プログラムは、実行
したままで PPP セッションを終了します。別の引金となるパケットがきた時にリ
ンクを再び確立しようとします。
Predictor-1 および DEFLATE 圧縮
ppp は、Predictor type 1 圧縮および deflate 圧縮をサポートしています。デ
フォルトでは、ppp は、接続相手が同意 (あるいは要求) した場合に、この機能
を使おうと (もしくは受け入れようと) します。ppp は、deflate プロトコルを
優先します。これらの機能を使用したくない時には、``disable'' と ``deny''
のコマンドを参照してください。
``disable deflate'' か ``deny deflate'' の一方を使用することにより、方向
ごとに異ったアルゴリズムを使用することができます (接続相手が両方のプロト
コルをサポートしていると仮定しています)。
デフォルトでは、DEFLATE についてネゴシエートするときには、ppp は、ウィン
ドウサイズとして 15 を使います。この動作を変更したい場合には、``set
deflate'' コマンドを参照してください。
デフォルトでは、無効にされ受け付けませんが、DEFLATE24 と呼ばれる特殊なア
ルゴリズムを使用することもできます。これは、CCP ID 24 をネゴシエーション
に使う点を除いては、DEFLATE と完全に同じものです。これを使用することで
ppp は、pppd バージョン 2.3.* と DEFLATE ネゴシエーションを成功させること
ができます。
IP アドレスの制御
IPv4 では、ppp は、IP アドレスのネゴシエーションのために IPCP を使いま
す。接続の両側は、自分が使おうとするアドレスを提示し、要求された IP アド
レスが受け入れ可能なものであれば、相手に ACK (肯定応答) を返します。受け
入れることができなければ、別の IP アドレスの使用を促すために ppp は、相手
に NAK (否定応答) を返します。接続の両側が受け取った要求に同意し (ACK を
送っ) た時、IPCP は、オープン状態にセットされ、ネットワーク層での接続が確
立されます。IPCP の動作を制御するために、この実装は、ローカルとリモートの
IP アドレスを定義するための ``set ifaddr'' コマンドを持っています。
set ifaddr [src_addr[/nn] [dst_addr[/nn] [netmask [trigger_addr]]]]
ここで、`src_addr' は、ローカル側で使おうと思っている IP アドレスで、
`dst_addr' は、リモート側が使用すべき IP アドレスです。`netmask' は、使用
すべきネットマスクです。`src_addr' のデフォルトは、現在の hostname(1) の
もの、`dst_addr' のデフォルトは、0.0.0.0 であり、`netmask' のデフォルト
は、`src_addr' に適したマスク値です。`netmask' は、デフォルトより小さくす
ることのみ可能です。ほとんどのカーネルが POINTOPOINT インタフェースのネッ
トマスクを無視するので、便利な値は、255.255.255.255 でしょう。
誤った PPP の実装には、接続ネゴシエーションのために、`src_addr' ではなく
特別な IP アドレスを使用しなければならないものがあります。この場合、
`trigger_addr' で指定した IP アドレスが使用されます。相手がこの提案された
番号に同意しない限り、経路表には影響しません。
set ifaddr 192.244.177.38 192.244.177.2 255.255.255.255 0.0.0.0
上の例の意味は、次の通りです:
• 自分の IP アドレスとしてまず 0.0.0.0 を提案しますが、アドレス
192.244.177.38 のみは受け付けます。
• 相手側のアドレスとして 192.244.177.2 を使うように要求し、
192.244.177.2 以外のどんなアドレスを使うことも許可しません。相手側が
別の IP アドレスを要求してきた時は、いつでも 192.244.177.2 を提案しま
す。
• 経路表のネットマスク値は、0xffffffff に設定されます。
これは、両側が既に決まった IP アドレスを持っている場合には、うまくいきま
すが、多くの場合、一方がすべての IP アドレスを制御するサーバとして動作し
ており、もう一方は、その方針に従います。より柔軟な動作をさせるために、
``set ifaddr'' コマンドで IP アドレス指定をもっと緩やかにすることが可能で
す:
set ifaddr 192.244.177.38/24 192.244.177.2/20
スラッシュ (``/'') に続く数字は、この IP アドレスで意味のあるビットの数を
表現しています。上の例は、次のことを示しています。
• 可能なら自分のアドレスとして 192.244.177.38 を使おうとしますが、
192.244.177.0 から 192.244.177.255 の間の任意の IP アドレスも受け入れ
ます。
• 相手のアドレスとして 192.244.177.2 を使うことを希望しますが、
192.244.176.0 から 192.244.191.255 の間の任意の IP アドレスも許可しま
す。
• すでにお気づきと思いますが、192.244.177.2 は、192.244.177.2/32 と書く
ことと等価です。
• 例外として、0 は、0.0.0.0/0 と等価であり、希望する IP アドレスは、特
に無く、リモート接続先の選択に従うことを意味します。0 を使用した場合
は、接続が確立するまで、経路表のエントリは、まったく設定されません。
• 192.244.177.2/0 は、どんな IP アドレスでも受け入れる/許可することを意
味しますが、最初に 192.244.177.2 を使うように提案します。
IPv6 アドレスのネゴシエーション時には、ユーザは、なにも制御できません。
IPV6CP ネゴシエーションは、完全自動です。
インターネットサービスプロバイダと接続する
プロバイダに接続する際には、次のステップを踏む必要があるでしょう:
1. ``set phone'' コマンドを使って、ダイヤルスクリプトにプロバイダの電話
番号を記述します。このコマンドによって、利用者は、パイプ (``|'') ま
たはコロン (``:'') のいずれかによって区切られたダイヤルとリダイヤル
に対して複数の電話番号を設定することができます:
set phone telno[|backupnumber]...[:nextnumber]...
最初のパイプで区切られたリストの番号は、直前の番号でダイヤルもしくは
ログインスクリプトが失敗した場合のみ使用されます。コロンで区切られた
番号は、直前の番号の使用によりなにが起ったのかにかかわらず、この順番
で使用されます。例えば:
set phone "1234567|2345678:3456789|4567890"
この場合、まず 1234567 にダイヤルしてみます。ダイヤルもしくはログイ
ンスクリプトに失敗したら、次は、2345678 を使用します。しかしこれは、
ダイヤルもしくはログインスクリプトに失敗したとき *のみ* です。このダ
イヤルの後、3456789 が使用されます。4567890 は、345689 でダイヤルも
しくはログインスクリプトに失敗したときのみ使用されます。2345678 のロ
グインスクリプトが失敗したとしても、次の番号は、3456789 です。必要な
数だけ、パイプとコロンを使用可能です (しかし、通常は、パイプのみかコ
ロンのみであり両方の使用はないでしょう)。次の番号へのリダイヤルまで
のタイムアウトは、すべての番号にて使用されます。リストが終了すると、
通常のリダイヤル期間だけ待ち、最初から再開します。``set dial'' コマ
ンドの \\T 文字列は、選択された番号で置きかえられます。(以降を参照し
てください)。
2. リダイヤルに関する設定は、``set redial'' で行います。例えば回線の調
子が悪かったり、(最近では、それほど多くないでしょうが) プロバイダが
いつも話中だったりすると、次のように設定したくなるかもしれません:
set redial 10 4
これは、最初の番号にリダイヤルを行う前に 10 秒待って、4 回までダイヤ
ルしてみるという意味になります。
3. ``set dial'' と ``set login'' コマンドを使ってログイン手続きを記述し
ます。``set dial'' コマンドは、モデムと通信してプロバイダへのリンク
を確立するのに使われます。例えば、次のようになります:
set dial "ABORT BUSY ABORT NO\\sCARRIER TIMEOUT 4 \"\" \
ATZ OK-ATZ-OK ATDT\\T TIMEOUT 60 CONNECT"
このモデム「チャット」文字列の意味は、次の通りです。
• "BUSY" または "NO CARRIER" を受信した場合には、処理を中止しま
す。
• タイムアウトを 4 秒にセットします。
• 文字列の受信待ちは行いません。
• ATZ を送信します。
• OK の受信待ちを行います。もし 4 秒以内に受信できなければ、もう 1
度 ATZ を送信し、OK の受信待ちを行います。
• ATDTxxxxxxx を送信します。xxxxxxx は、上記の電話番号リストの中
の、次にダイヤルする番号です。
• タイムアウトを 60 にセットします。
• 文字列 CONNECT の受信待ちを行います。
一旦接続が確立されると、ログインスクリプトが実行されます。このスクリ
プトは、ダイヤルスクリプトと同じスタイルで書かれますが、パスワードが
記録されないように注意してください:
set authkey MySecret
set login "TIMEOUT 15 login:-\\r-login: awfulhak \
word: \\P ocol: PPP HELLO"
このログイン「チャット」文字列の意味は、次の通りです。
• タイムアウトを 15 秒にセットします。
• "login:" の受信待ちを行います。もし受信できなければ復改文字を送
信して、再び "login:" の受信待ちを行います。
• "awfulhak" を送信します。
• "word:" ("Password:" プロンプトの末尾) の受信待ちを行います。
• authkey に現在設定されている値を送信します。
• "ocol:" ("Protocol:" プロンプトの末尾) の受信待ちを行います。
• "PPP" を送信します。
• "HELLO" の受信待ちを行います。
``set authkey'' コマンドのログは、特別な方法でとられます。command ま
たは chat のログが有効な時は、実際のパスワードは、記録されません。代
りに `********' が記録されます。
ログインスクリプトは、プロバイダによって大きく違うものになるでしょ
う。初めてそれを設定するときにはチャットログを有効化することで、利用
者のスクリプトが予定通りに動いているかを調べることができます。
4. シリアル回線と通信速度を指定するためには、``set device'' と ``set
speed'' を使います。例えば次のようになります。
set device /dev/cuau0
set speed 115200
FreeBSD では、cuau0 が 1 つめのシリアルポートになります。OpenBSD で
ppp を実行している場合には、cua00 が 1 つめです。利用者のモデムが
28800 かそれ以上のビットレートで通信することができるなら、シリアル
ポートの速度には、115200 を指定しておくべきでしょう。一般に、シリア
ルポートの速度は、モデムの速度の約 4 倍にしておきます。
5. ``set ifaddr'' コマンドで IP アドレスを {定義} します。
• プロバイダがどの IP アドレスを使っているのか知っている場合には、
それをリモートアドレス (dst_addr) として使ってください。知らない
場合には、10.0.0.2/0 か何かを使ってください (以降を参照してくだ
さい)。
• 特定の IP アドレスをプロバイダから割り当てられている場合は、それ
をローカルアドレス (src_addr) として使ってください。
• プロバイダが IP アドレスを動的に割り当てる場合は、適当に控えめで
緩やかに記述した IP アドレスをローカルアドレスに選んでください。
10.0.0.1/0 が適切でしょう。/ に続く数値は、このアドレスのうち何
ビットを重視しているかを示します。もしもクラス C のネットワーク
1.2.3.0 上のアドレスを使うことを主張したいのなら、1.2.3.1/24 と
指定することができます。
• プロバイダが利用者が提示した最初の IP 番号を受け付ける場合、第
3, 4 の引数に ``0.0.0.0'' を指定してください。これによりプロバイ
ダが番号を割り当てます (3 つめの引数は、`src_addr' に対してデ
フォルトのマスクよりも制約が緩いため、無視されます)。
自分の IP アドレスもプロバイダの IP アドレスも知らない場合には、次の
例のようにするとよいでしょう。
set ifaddr 10.0.0.1/0 10.0.0.2/0 0.0.0.0 0.0.0.0
6. ほとんどの場合、プロバイダは、デフォルトルータでもあるでしょう。この
場合、次の行
add default HISADDR
を /etc/ppp/ppp.conf (-auto モードを使用しない設定の場合には、
/etc/ppp/ppp.linkup) に追加します。
これは、ppp 接続先のアドレスが何であっても (この例では、10.0.0.2) デ
フォルト経路として追加するように指示します。この経路は、`スティッキ'
です。これは、HISADDR の値が変わると、経路もそれに従って自動的に更新
されるという意味です。
7. プロバイダが PAP/CHAP による認証を要求している場合は、
/etc/ppp/ppp.conf ファイルに次の行を追加してください:
set authname MyName
set authkey MyPassword
デフォルトでは、どちらも受け付けられますので、ppp は、利用者の ISP
が必要とするものなら何でも提供します。
PAP もしくは CHAP を使用する場合、ログインスクリプトは、ほとんどの場
合、必要とされないことを記述しておくべきでしょう。
8. 次のような行を加え、ISP にネームサーバアドレスを確認してください。
enable dns
ローカル DNS を走らせている場合には、``resolv readonly'' を使わず、
かつ、``resolv restore'' を /etc/ppp/ppp.linkdown に含めていないなら
ば、これをやらないでください。ppp は、単純に /etc/resolv.conf に
nameserver 行を入れることで、ローカル DNS の使用を出し抜いてしまうか
らです。
現実の例を見たい場合には、/usr/share/examples/ppp/ppp.conf.sample と
/usr/share/examples/ppp/ppp.linkup.sample を参照してください。ラベル
pmdemand は、ほとんどのプロバイダで使用できるでしょう。
ログ機能
ppp は、次のログ情報を、syslog(3) 経由で、もしくはスクリーンに出力するこ
とができます:
All ロギング用ファシリティをすべて有効にします。この場合、ログ
がたくさんできます。`all' の最も一般的な使い方は、共通部分
として使うことです。この場合、すべてのファシリティを有効に
したあとで一部のファシリティを削ったりします (`debug' や
`timer' が通常は、無効にするのに最適なファシリティです)。
Async 非同期レベルパケットの 16 進ダンプ。
CBCP CBCP (CallBack Control Protocol) ログの生成。
CCP CCP パケットトレースの生成。
Chat `dial', `login', `logout', `hangup' のチャットスクリプトの
トレースログの生成。
Command コマンド実行のログ。
Connect 文字列 "CONNECT" を含むチャット行のログ。
Debug デバッグ情報のログ。
DNS DNS QUERY パケットのログ。
Filter ダイヤルフィルタに許可され、他のフィルタに拒否されたパケッ
トのログ。
HDLC HDLC パケットの 16 進ダンプ。
ID0 ユーザ ID 0 で実行された全関数呼び出しを詳細に記録。
IPCP IPCP パケットトレースの生成。
LCP LCP パケットトレースの生成。
LQM LQR レポートの生成。
Phase フェーズ遷移ログの出力。
Physical 物理レベルパケットの 16 進ダンプ。
Radius RADIUS 情報のダンプ。``Radius'' のログが有効になっていない
場合、リンクのアップ・ダウンから来る RADIUS 情報のログを
``Phase'' レベルで採ります。このログレベルは、RADIUS の動作
中の情報を監視するのに最も有用です。
Sync 同期レベルパケットの 16 進ダンプ。
TCP/IP 全 TCP/IP パケットのダンプ。
Timer タイマ操作のログ。
TUN ログの各行に tun デバイスを含めます
Warning 端末デバイスへの出力。端末が存在しない場合は、LOG_WARNING
を使用してログファイルに送ります。
Error 端末デバイスとログファイルへの出力で、LOG_ERROR を使用しま
す。
Alert ログファイルへの出力で、LOG_ALERT を使用します。
``set log'' コマンドで、ログの出力レベルを設定することができます。また、
複数のレベルを単一コマンドラインにて指定することも可能です。デフォルト
は、``set log Phase'' です。
スクリーンに直接ログを表示することも可能です。文法は、同じで、語
``local'' が ``set log'' の直後に付くことだけが違います。デフォルトは、
``set log local'' (つまり、マスクされない警告、エラーと注意のみ出力) で
す。
``set log [local]'' への最初の引数が `+' か `-' の文字で始まる場合、現在
のログレベルを消去せずに修正します。例えば:
PPP ON awfulhak> set log phase
PPP ON awfulhak> show log
Log: Phase Warning Error Alert
Local: Warning Error Alert
PPP ON awfulhak> set log +tcp/ip -warning
PPP ON awfulhak> set log local +command
PPP ON awfulhak> show log
Log: Phase TCP/IP Warning Error Alert
Local: Command Warning Error Alert
レベル Warning, Error, Alert のメッセージログは、``set log [local]'' では
制御できません。
Warning レベルは、特別で、ローカルに表示可能な場合には記録されません。
シグナルハンドリング
ppp は、次のシグナルを扱います:
INT このシグナルを受信すると、現在の接続がもしあればそれを終了します。
-auto もしくは -ddial のモードではない場合、ppp は、終了します。
HUP, TERM, QUIT
ppp を終了させます。
USR1 ppp に既存のサーバソケットを再度オープンさせ、すべての既存の診断
ポートへの接続を取り下げます。以前にオープン出来なかったソケット
は、再度試されます。
USR2 ppp に全サーバソケットを閉じさせ、すべての既存の診断ポートへの接続
を取り下げます。再度オープンするためには、SIGUSR1 が使用できます。
マルチリンク PPP
PPP 相手に接続するのに複数の物理的なリンクを利用したいなら、接続相手もマ
ルチリンク PPP プロトコルを理解する必要があります。仕様の詳細は、RFC 1990
を参照してください。
接続先は、``終点の選択'' とその ``認証 ID'' の組み合わせによって識別され
ます。これらの一方、もしくは両方を指定することができます。最低でも片方
は、指定しておくことが推奨されます。そうでないと、すべてのリンクが実際に
同一のプログラムに接続されていることを確認する方法がなくなり、混乱して
ロックアップを引き起こすことがあります。ローカルには、これらの識別変数
は、``set enddisc'' と ``set authname'' コマンドを用いることで指定されま
す。先立って接続相手と `authname' (と `authkey') について合意しておく必要
があります。
マルチリンクの能力は、``set mrru'' コマンド (set maximum reconstructed
receive unit) を用いることで有効になります。一度マルチリンクが有効になれ
ば、ppp は、接続相手とマルチリンク接続のネゴシエーションを行います。
デフォルトでは、(`deflink' と呼ばれる) ただ 1 つの `リンク' のみが有効で
す。さらにリンクを作成するには、``clone'' コマンドが使われます。このコマ
ンドは、既存のリンクを複製します。それは、次の点を除いてすべての性質が同
じものです:
1. 新しいリンクは、``clone'' コマンドラインで指定された独自の名前を持ち
ます。
2. 新しいリンクは、`interactive' リンクです。そのモードは、次の ``set
mode'' コマンドで変更することができます。
3. 新しいリンクは、`closed' の状態にあります。
すべての有効なリンクのまとめは、``show links'' コマンドを用いて見ることが
できます。
一度リンクが作成されると、コマンドの使用方法が変わります。すべてのリンク
固有のコマンドの前には、``link name'' 接頭辞をつけて、コマンドを適用する
リンクを指定する必要があります。ppp は、十分賢いので、利用可能なリンクが
1 つだけの場合には、``link name'' 接頭辞は、不要です。
コマンドの中には、依然としてリンクの指定なしに使用できるものがあり、それ
は、`バンドル' レベルの操作を行います。たとえば、2 つ以上のリンクが存在す
るとき ``show ccp'' は、マルチリンクレベルの CPP 設定と統計を表示し
``link deflink show ccp'' は、``deflink'' のリンクレベルの同じ情報を表示
します。
これらの情報を用いて、次の設定を用いることができます:
mp:
set timeout 0
set log phase chat
set device /dev/cuau0 /dev/cuau1 /dev/cuau2
set phone "123456789"
set dial "ABORT BUSY ABORT NO\sCARRIER TIMEOUT 5 \"\" ATZ \
OK-AT-OK \\dATDT\\T TIMEOUT 45 CONNECT"
set login
set ifaddr 10.0.0.1/0 10.0.0.2/0 0.0.0.0 0.0.0.0
set authname ppp
set authkey ppppassword
set mrru 1500
clone 1,2,3 # 3 つの新しいリンクを作成する - デフォルトの複製
link deflink remove # デフォルトリンクを削除する (``deflink'' と呼ばれる)
すべての複製が設定の最後で行われていることに注意してください。一般には、
リンクは、最初に設定され、そして複製されます。利用者が常にすべてのリンク
がアップ状態であることを望む場合には、設定の最後に次の行を追加することが
できます。
link 1,2,3 set mode ddial
リンクが必要に応じてダイヤルされることを望む場合には、次のコマンドを使う
ことができます。
link * set mode auto
上記の ``set device'' 行を取り除き、``clone'' コマンドに続けて次の内容を
指定することで、リンクを特定の名前に結びつけることもできます:
link 1 set device /dev/cuau0
link 2 set device /dev/cuau1
link 3 set device /dev/cuau2
どのコマンドが (``link'' コマンドを使用した) コンテキスト (文脈) を要求
し、どのコマンドがコンテキストをオプションとし、そしてどのコマンドがコン
テキストを一切とらないかを調べるには、``help'' コマンドを使用します。
ppp が接続相手とマルチリンクモードでネゴシエートすると、ppp は、ローカル
ドメインソケットを /var/run ディレクトリに作成します。このソケットは、リ
ンク情報 (実際のリンクファイル記述子も含む) を、異なる ppp の間で受け渡し
するために使われます。この機能によって、ppp は、シリアル回線の初期制御を
行う必要なしに getty(8) から、もしくは直接 /etc/gettydefs から (`pp='
ケーパビリティを用いて) 実行することが可能となっています。ひとたび ppp が
マルチリンクモードのネゴシエーションを行うと、ppp は、自分がオープンした
リンクをすでに実行されている任意の他のプロセスに渡すことができます。すで
に実行されているプロセスがない場合、ppp は、マスタとして振る舞い、ソケッ
トを作成し、新たな接続を待ちます。
PPP コマンドリスト
このセクションでは、利用可能コマンドとその効果をリストします。ppp セッ
ションで対話的に使用することも、設定ファイルで指定することも、pppctl(8)
もしくは telnet(1) セッションで指定することも可能です。
accept|deny|enable|disable option....
これらのディレクティブは、最初の接続においてどのように相手とネゴシ
エートするかを ppp に指示します。各 ``option'' は、accept/deny および
enable/disable のデフォルトを持ちます。``accept'' は、相手がこのオプ
ションを要求したら、ACK を送ることを意味します。``deny'' は、相手がこ
のオプションを要求したら、NAK を送ることを意味します。``enable'' は、
このオプションを当方が要求することを意味します。``disable'' は、この
オプションを当方が要求しないことを意味します。
``option'' は、次の 1 つを指定できます:
acfcomp
デフォルト: enable と accept。ACFComp は、アドレスおよびコント
ロールフィールド圧縮 (Address and Control Field Compression) を意
味します。LCP パケット以外は、通常、アドレスフィールド 0xff (全ス
テーションアドレス) と制御フィールド 0x03 (番号付けされていない情
報コマンド) を持ちます。このオプションがネゴシエートされると、こ
れらの 2 バイトは、単に送信されなくなり、流量が少なくなります。
詳細は、rfc1662 を参照してください。
chap[05]
デフォルト: disable と accept。CHAP は、チャレンジ交換認証プロト
コル (Challenge Handshake Authentication Protocol) を意味します。
CHAP もしくは PAP (後述) のどちらか一方のみネゴシエーション可能で
す。CHAP では、認証者は、「チャレンジ」メッセージを相手に送りま
す。相手は、一方向ハッシュ関数を使用して「チャレンジ」を暗号化
し、結果を送り返します。認証者は、同じことを行い結果を比較しま
す。この機構の利点は、接続を介してパスワードを送らないことです。
接続が最初に確立する時にチャレンジが行われます。更なるチャレンジ
が行われるかもしれません。相手の認証を行いたい場合は、``enable
chap'' を /etc/ppp/ppp.conf に書き、相手のエントリを
/etc/ppp/ppp.secret に書く必要があります。
クライアントとして CHAP を使用する場合、``AuthName'' と
``AuthKey'' を /etc/ppp/ppp.conf に指定するだけで良いです。CHAP
は、デフォルトで accept されます。PPP の実装によっては、チャレン
ジの暗号化に MD5 ではなく "MS-CHAP" を使用するものがあります。MS
CHAP は、MD4 と DES の組み合わせです。もし ppp が DES ライブラリ
の存在するマシン上で構築された場合 MS-CHAP 認証要求に応答します
が、要求はしません。
deflate
デフォルト: enable と accept。このオプションは、デフレート
(deflate) 圧縮が圧縮制御プロトコル (Compression Control Protocol;
CCP) によって使用されるかどうかを決定します。これは、gzip(1) プロ
グラムによって使用されるものと同じアルゴリズムです。注: 多くのオ
ペレーティングシステムの下で利用可能な PPP の実装である、pppd に
ある deflate 機能をネゴシエートしている問題があります。pppd (バー
ジョン 2.3.1) は、rfc1979 で明記されるような、タイプ 26 ではな
く、CCP 設定タイプとしてタイプ 24 を使用している deflate 圧縮をネ
ゴシエートすることを間違って試みます。タイプ 24 は、実際に、
rfc1975 の ``PPP Magna-link Variable Resource Compression'' (PPP
マグナリンク変数リソース圧縮) として明記されています! ppp は、
pppd でネゴシエートする能力がありますが、``deflate24'' が enabled
と accepted である場合のみです。
deflate24
デフォルト: disable と deny。これは、deflate のバリエーションで、
pppd プログラムとのネゴシエーションを許可します。詳細は、上記の
deflate セクションを参照してください。これは、rfc1975 に反するた
め、デフォルトでは、disable となっています。
dns
デフォルト: disable と deny。このオプションは、DNS ネゴシエーショ
ンを許可します。
``enable'' にすることにより、ppp は、接続相手が /etc/resolv.conf
ファイルのエントリを確認することを要求します。もし接続相手が当方
の要求に否定応答をした場合 (新しい IP アドレスを提案したら)、
/etc/resolv.conf ファイルは、更新され、新しいエントリを確認するよ
うに要求を送ります。
``accept'' にすることにより、ppp は、接続相手からの DNS 検索要求
を拒否せずに、返答します。``set dns'' コマンドの使用によって上書
きされていない場合には、応答は、/etc/resolv.conf から採られます。
enddisc
デフォルト: enable と accept。このオプションは、終点選択値をネゴ
シエートするか否かを制御します。``set enddisc'' が使用され
enddisc が enable の場合のみ、当方の選択値を送ります。enddisc が
disable の場合、相手の選択値を拒否します。
LANMan|chap80lm
デフォルト: disable と accept。この認証プロトコルの使用は勧められ
ません。単一の CHAP タイプ (0x80) を装って、2 つの異った機構
(LANMan と NT) を実装することにより、部分的に認証プロトコルを侵害
しているからです。``LANMan'' は、単純な DES 暗号化機構を使用する
ものであり、CHAP 代替としては、最低の安全性のものです (それでも
PAP よりは安全です)。
更なる詳細は、後述の ``MSChap'' の記述を参照してください。
lqr
デフォルト: disable と accept。このオプションは、リンク品質要求
(Link Quality Request) を送信する、もしくは受け入れるかどうかを決
定します。LQR は、モデムのキャリア検出を使用せずに、リンクダウン
を ppp に決定させるプロトコルです。LQR が enable になっていると、
ppp は、LCP 要求の一部として QUALPROTO オプション (後述の ``set
lqrperiod'' を参照) を送ります。接続相手が同意した場合、両端は、
同意した間隔で LQR パケットを交換し、LQM ロギングを有効にすること
で、詳細なリンク品質を監視することが可能になります。接続相手が同
意せず、``echo'' オプションが有効だった場合、ppp は、代りに LCP
ECHO 要求を送ります。これらのパケットは、興味ある情報を何も渡しま
せんが、必ず接続相手に応答しなければなりません。
LQR か LCP ECHO のいずれを用いるにせよ、ppp は、5 つのパケットを
送ったが確認応答が無い場合、6 つ目のパケットを送らずに回線を切断
します。メッセージを PHASE レベルで記録し、回線切断の原因が接続相
手にあるものとして、適当な ``reconnect'' 値を使用します。
ppp バージョン 3.4.2 以前のものとの振る舞いの違いについては、
``enable echo'' コマンドの解説を参照してください。
mppe
デフォルト: enable と accept。これは、Microsoft 社の Point to
Point 暗号化機構です。MPPE の鍵のサイズは、40, 56, 128 ビットで
す。``set mppe'' コマンドを参照してください。
MSChapV2|chap81
デフォルト: disable と accept。標準 CHAP (タイプ 0x05) と非常に似
ていますが、長さ 16 バイト固定のチャレンジコードを送ることと、
チャレンジコードを暗号化するのに、標準の MD5 機構ではなく MD4,
SHA-1 そして DES を混合して使用する点が異なります。
MSChap|chap80nt
デフォルト: disable と accept。この認証プロトコルの使用は、勧めら
れません。単一の CHAP タイプ (0x80) を装って、2 つの異った機構
(LANMan と NT) を実装することにより、部分的に認証プロトコルを侵害
しているからです。標準の CHAP (タイプ 0x05) に非常に良く似ていま
すが、チャレンジを固定 8 バイト長で発行し、標準の MD5 機構ではな
く MD4 と DES を組み合わせてチャレンジを暗号化するところが違いま
す。LANman 用の CHAP タイプ 0x80 もまたサポートされています - 詳
細は、``enable LANMan'' を参照してください。
``LANMan'' と ``NT'' の両方が CHAP タイプ 0x80 を使用しますので、
両方を ``enable'' にして認証者として動作するときには、相手が誤っ
た方のプロトコルを使用して応答した場合には、ppp は、最大 3 回相手
に再チャレンジします。これにより、相手が両方のプロトコルを使用す
る機会を与えます。
逆に、両プロトコルを ``accept'' にして ppp が被認証者となる場合、
チャレンジに答えるたびに使用プロトコルを交換します。
注: LANMan のみが enable にされた場合、pppd (バージョン 2.3.5)
は、被認証者としては誤った動作を行います。NT と LANMan の両方の応
答を行いますが、NT の応答のみ使用すべきことも指示してしまうので
す。
pap
デフォルト: disable と accept。PAP は、パスワード認証プロトコル
(Password Authentication Protocol) を意味します。CHAP (前述) もし
くは PAP のどちらか一方のみネゴシエーション可能です。PAP では、ID
とパスワードが相手に送られ続け、認証されるか接続が終了されるまで
これが続きます。これは、比較的良くないセキュリティ機構です。接続
が最初に確立した時のみ実行可能です。相手の認証を行いたい場合は、
``enable pap'' を /etc/ppp/ppp.conf に書き、相手のエントリを
/etc/ppp/ppp.secret に書く必要があります (ただし、後述の
``passwdauth'' と ``set radius'' オプションを参照)。
クライアントとして PAP を使用する場合、``AuthName'' と
``AuthKey'' を /etc/ppp/ppp.conf に指定するだけで良いです。PAP
は、デフォルトで accept されます。
pred1
デフォルト: enable と accept。このオプションは、圧縮制御プロトコ
ル (Compression Control Protocol; CCP) に Predictor 1 圧縮を使用
するかどうかを決定します。
protocomp
デフォルト: enable と accept。このオプションは、PFC (プロトコル
フィールド圧縮) のネゴシエートするために使用されます。この機構に
より、プロトコルフィールド数が 2 オクテットから 1 オクテットに減
ります。
shortseq
デフォルト: enable と accept。このオプションは、ppp がマルチリン
クモードのネゴシエーション時に (12 ビットの) 短いシーケンス番号を
要求し、そして受け入れるかどうかを決定します。これは、当方の MMRU
が設定されたときのみ (マルチリンクが有効になっているときのみ) 適
用されます。
vjcomp
デフォルト: enable と accept。このオプションは、Van Jacobson ヘッ
ダ圧縮を使用するかどうかを決定します。
次に示すオプションは、実際には、相手とネゴシエートしません。それゆえ
accept および deny は、意味を持ちません。
echo
デフォルト: disable。このオプションを enable にすると、ppp は、
``echoperiod'' で定義された頻度で相手に LCP ECHO 要求を送信しま
す。LQR 要求が enable でありネゴシエートされていれば、LCP ECHO 要
求に取って代わることに注意してください。詳細は、下記の ``set
lqrperiod'' を参照してください。
ppp バージョン 3.4.2 以前は、``echo'' は、lqr が enable でありネ
ゴシエートされていれば enable と見なされ、そうでなければ disable
と見なされていました。同様の動作をさせるには、``enable lqr'' では
なく、今では、``enable lqr echo'' とする必要があります。
filter-decapsulation
デフォルト: disable。このオプションを enable にすると、ppp は、
UDP フレームを検査し、PPP フレームをペイロードとして持っているか
否かを見ます。これが真である場合、パケット自身に対してではなく、
ペイロードに対して、すべてのフィルタを適用します。
PPP リンク上で PPPoUDP トラフィックを送りたい場合で、UDP ラッパで
はなく、実際のデータに基いて賢いことをリンクにやらせたい場合に有
用です。
UDP フレームのペイロードは、如何なる方法であっても圧縮してはなり
ません。圧縮した場合には、ppp は、ペイロードを解釈できません。で
すから、UDP リンクに対する ppp の起動の際には、設定中で disable
vj pred1 deflate と deny vj pred1 deflate を行なうことを推奨しま
す。
force-scripts
設定済みのチャットスクリプトを、direct および dedicated のモード
でも実行することを強制します。
idcheck
デフォルト: enable。低レベルな LCP, CCP, IPCP 設定トラフィックを
交換するときに、すべての応答の識別子フィールドは、その要求の識別
子フィールドと同一であることが予定されています。デフォルトでは、
ppp は、予定された識別子フィールドを持たないすべての応答パケット
を捨て、それぞれのログレベルで報告します。もし idcheck が disable
になっている場合、ppp は、識別子フィールドを無視します。
iface-alias
デフォルト: -nat が指定されるなら、enable。このオプションは、イン
タフェースのアドレスを交換するのではなく、インタフェースに新規ア
ドレスを追加するように、ppp に指示します。ネットワークアドレス変
換が有効な場合のみ (``nat enable yes'')、このオプションを enable
にできます。
このオプションを enable にすると、ppp は、古いインタフェースアド
レスのトラフィックを NAT エンジン (libalias(3) 参照) を通すように
なり、(-auto モードでは) 最初に PPP リンクを立ち上げたプロセスが
正しく接続できるようにします。
``nat enable no'' として NAT を disable すると、`iface-alias' も
disable します。
ipcp
デフォルト: enable。このオプションは、ppp が IP 制御プロトコル
ケーパビリティを試み、これが成功したときには、IP データグラムを相
手と交換することを許可します。
ipv6cp
デフォルト: enable。このオプションは、ppp が IPv6 制御プロトコル
ケーパビリティを試み、これが成功したときには、IPv6 データグラムを
相手と交換することを許可します。
keep-session
デフォルト: disable。ppp がマルチリンクサーバとして動作するとき、
別の ppp インスタンスが最初に各接続を受け付けます。リンクが (別の
ppp によって制御されている) 既存のバンドルに属すと判定すると、ppp
は、このリンクを当該別プロセスへ移管します。
リンクが tty デバイスである場合かこのオプションが enable されてい
る場合、ppp は、終了せず、自己のプロセス名を ``session owner'' に
変え、リンクを制御する方の ppp が処理を完了してアイドルプロセスの
方へシグナルを返すまで待ちます。リンク資源が再利用可能であると
ppp の親がみなす結果により生じる混乱を、これにより防ぎます。
/etc/ttys にエントリがある tty デバイスの場合、別の getty(8) の開
始を防ぐために、これが必要です。sshd(8) のようなプログラムリンク
の場合、子供の死による sshd(8) の終了を防ぐために、これが必要で
す。ppp は、親の要件を判断できませんので (tty の場合を除く)、状況
に応じて手動でこのオプションを設定する必要があります。
loopback
デフォルト: enable。loopback が enable の場合、ppp は、自動的に
PPP インタフェースと同じ終点アドレス宛に送出されたパケットをルー
プバックします。disable の場合、ppp がパケットを送ると、おそらく
他の終点からの ICMP リダイレクトとなります。インタフェースがデ
フォルト経路であるため、ループバック経路を必要とすることを避けた
い場合、このオプションを enable にすると便利です。
NAS-IP-Address
デフォルト: enable。このオプションは、RADIUS が使われている場合、
ppp が RADIUS サーバへ ``NAS-IP-Address'' 属性を送信するかどうか
制御します。(``set radius'' を参照してください)
少なくとも ``NAS-IP-Address'' と ``NAS-Identifier'' の 1 つが
enable になっていなければならないことに注意してください。
ppp の 3.4.1 以前のバージョンでは、Radiator RADIUS サーバを壊して
しまうことが報告されたように、``NAS-IP-Address'' 属性を送信しませ
んでした。最新の rfc (2865) では、(rfc 2138 にはあったのですが)
``NAS-IP-Address'' と ``NAS-Identifier'' の一方だけを送信すべきこ
とに関して一切触れられていません。ppp は、今では両方を送信し、
``disable NAS-IP-Address'' として間違った RADIUS 実装を使うことを
選択するかどうかは管理者に任せています。
NAS-Identifier
デフォルト: enable。このオプションは、RADIUS が使われている場合、
ppp が RADIUS サーバへ ``NAS-Identifier'' 属性を送信するかどうか
制御します。(``set radius'' を参照してください)
少なくとも ``NAS-IP-Address'' と ``NAS-Identifier'' の 1 つが
enable になっていなければならないことに注意してください。
passwdauth
デフォルト: disable。このオプションを enable にすることにより、
PAP 認証コードが呼び出し側を認証する時に、/etc/ppp/ppp.secret
ファイル中でみつからない場合、パスワードデータベース (passwd(5)
参照) を使用します。/etc/ppp/ppp.secret は、常に、最初に調べられ
ます。passwd(5) からパスワードを調べ、かつそのクライアントに対し
て IP アドレスもしくはラベルを指定したい場合には、
/etc/ppp/ppp.secret ファイル中のクライアントのパスワードとして
``*'' を用いてください。
proxy
デフォルト: disable。このオプションを enable にすることにより、
ppp に相手のために代理 ARP をさせます。HISADDR と HISADDR がいる
ローカルネットワークの MAC アドレスを使用して、ppp が ARP 表に単
一エントリを作成することを意味します。これにより、相手自身がその
LAN に接続されたかのような状態で、LAN に接続された他のマシンと相
手とが通信できるようになります。HISADDR が LAN からのアドレスでは
ない場合、代理エントリは、作成できません。
proxyall
デフォルト: disable。このオプションを enable にすることにより、
ppp に代理 ARP エントリを追加させます。追加されるエントリは、tun
インタフェースによってルーティングされるすべてのクラス C もしくは
それ以下のサブネットの中の、全 IP アドレスです。
代理 arp エントリは、``add'' コマンドによって追加されたスティッキ
経路に対してのみ作成されます。(``set ifaddr'' コマンドによって作
成された) インタフェースアドレス自身に対しては、代理 arp エントリ
は、作成されません。
sroutes
デフォルト: enable。``add'' コマンドが HISADDR, MYADDR, HISADDR6
MYADDR6 のいずれかの値とともに用いられると、エントリは、`スティッ
キ経路' リストに格納されます。これらの値が変更される度に、このリ
ストが経路表に適用されます。
このオプションを disable にすると、スティッキ経路が適用されなくな
ります。`スティック経路' リストは、依然として保守されます。
[tcp]mssfixup
デフォルト: enable。このオプションは、ppp に、TCP SYN パケットを
調整するように指示し、インタフェース MTU が許可しているサイズを受
信セグメントサイズの最大値が超えないようにします。
throughput
デフォルト: enable。このオプションを有効にすると、ppp は、スルー
プット統計を収集します。ずれ動く 5 秒間のウィンドウにおいて入出力
が検査され、現在、最良時、総計の数値が保持されます。このデータ
は、関連する PPP 層が終了するときに出力され、また ``show'' コマン
ドで表示することで得られます。スループット統計は、``IPCP'' と
``physical'' のレベルで利用可能です。
utmp
デフォルト: enable。通常ユーザが PAP もしくは CHAP で認証された時
で、ppp が -direct モードで実行されている時は、このユーザのエント
リが utmp ファイルおよび wtmp ファイルに作成されます。このオプ
ションを disable にすると、ppp は、utmp および wtmp のエントリを
作成しません。通常、ユーザがログインしかつ認証することを要求する
場合のみ必要です。
add[!] dest[/nn] [mask] [gateway]
dest は、宛先 IP アドレスです。ネットマスクは、/nn によってビット数で
指定するか、もしくは mask を用いて IP 番号で指定します。0 0 ならびに
マスクなしの 0 は、デフォルト経路を意味します。0 の代りにシンボル名
`default' を使うことが可能です。gateway は、dest マシン/ネットワーク
に至る、次のホップのゲートウェイです。詳細は、route(8) コマンドを参照
してください。
宛先にシンボル名 `MYADDR', `HISADDR', `MYADDR6', `HISADDR6' のいずれ
かを使用可能であり、gateway には、`HISADDR', `HISADDR6' のいずれかを
使用可能です。`MYADDR' は、インタフェース IP アドレスに置き換えられ、
`HISADDR' は、インタフェースの宛先 (相手の) IP アドレスに置き換えら
れ、`MYADDR6' は、インタフェース IPv6 アドレスに置き換えられ、
`HISADDR6' は、インタフェースの宛先 IPv6 アドレスに置き換えられます。
add! コマンド (``!'' に注意) 使用時には、経路が存在する場合には、
`route change' コマンド (詳細は、route(8) 参照) にて経路を更新しま
す。
``HISADDR'', ``MYADDR'', ``HISADDR6'', ``MYADDR6'', ``DNS0'',
``DNS1'' のいずれかを含む経路は、`スティッキ' と見なされます。これら
は、リスト (リストを見るには、``show ncp'' コマンドを使用します) に格
納され、これらのいずれかの値が変更される度に、経路表の関連するエント
リが更新されます。この機能は、``disable sroutes'' を使用することで無
効にできます。
allow command [args]
このコマンドは、ppp と設定ファイルへのアクセスを制御します。設定ファ
イルのラベルと ppp 実行モードにより、ユーザレベルでのアクセスも可能で
す。例えば、-background モードでは、ユーザ `fred' のみがラベル
`fredlabel' にアクセスできるように、ppp を構成したいかもしれません。
ユーザ ID 0 は、これらのコマンドの対象外です。
allow user[s] logname...
デフォルトでは、ユーザ ID 0 のみが ppp へのアクセスを許されていま
す。このコマンドを指定することで、``allow users'' が記載されてい
るセクションに列挙されているユーザは、そのセクションへのアクセス
が可能となります。`default' セクションは、常に最初にチェックされ
ます (スタートアップ時に常にロードされる唯一のセクションです)。あ
るセクションの中では、複数の ``allow users'' コマンドは、加算的で
す。しかしながら、あるセクション中で許可されたユーザ群は、
`default' セクションで許可されたユーザ群を上書きします。ですか
ら、デフォルトユーザを `default' セクションで指定し、新しいユーザ
リストをあるラベルに指定することで、あるラベル以外のすべてにアク
セスを許すといったことが可能です。
ユーザ `*' が指定されると、全ユーザにアクセスが許されます。
allow mode[s] mode...
デフォルトでは、全 ppp モードが使用可能です。このコマンドが使用さ
れると、このコマンドが指定されたラベルのロードに許されるアクセス
mode が制限されます。``allow users'' コマンドと同様、各 ``allow
modes'' コマンドは、先行するコマンドに優先し、`default' セクショ
ンは、常に最初にチェックされます。
使用可能なモードは、次の通りです: `interactive', `auto',
`direct', `dedicated', `ddial', `background', `*'。
マルチリンクモードで動作するときには、現在存在する回線モードを許
可するセクションをロード可能です。
nat command [args]
このコマンドは、ppp 組込みのネットワークアドレス変換機能 (マスカレー
ディングや IP エイリアシングとしても知られています) を制御するために
使用します。NAT は、外部インタフェースでのみ動作し、-direct フラグと
共に使用してもおそらく意味がありません。
利用者のシステムで nat を有効にすると (コンパイル時に削除できます)、
次のコマンドが使用可能となります:
nat enable yes|no
このコマンドは、ネットワークアドレス変換を有効もしくは無効にしま
す。-nat コマンドラインフラグは、``nat enable yes'' と同じ意味で
す。
nat addr [addr_local addr_alias]
このコマンドには、addr_alias のデータを addr_local へリダイレクト
します。少数の実 IP アドレスを持ち、それらをゲートウェイの後の特
定のマシンにマップしたい場合に有用です。
nat deny_incoming yes|no
yes に設定すると、エイリアシングリンクがまだ存在しないところで
は、このコマンドは、全パケットを拒否します。``エイリアシングリン
ク'' が何であるかについては、libalias(3) の概念の背景セクションを
参照してください。
どのような状況において libalias(3) がエイリアシングリンクを作成し
たか、気をつける必要があります。``set filter'' または ``nat
target'' のコマンドを使用して、更にネットワークを保護する必要があ
るかもしれません。
nat help|?
このコマンドは、使用可能な nat コマンドのまとめを表示します。
nat log yes|no
このオプションは、NAT の様々な統計と情報がファイル
/var/log/alias.log に記録されるようにします。
nat port proto targetIP:targetPort[-targetPort] aliasPort[-aliasPort]
[remoteIP:remotePort[-remotePort]]
このコマンドは、aliasPort への入力の proto 接続を、targetIP の
targetPort へリダイレクトします。proto は、``tcp'' または ``udp''
です。
ポート番号の範囲は、前述のように指定可能です。範囲は、同じ大きさ
であることが必要です。
remoteIP が指定された場合、この IP 番号から来たデータのみがリダイ
レクトされます。remotePort は、``0'' (すべての送信元ポート) か、
もう一方の範囲と同じ大きさのポート範囲です。
利用者のゲートウェイの後のマシンでインターネット電話等を実行した
い場合に、このオプションは、有用です。しかし、送信元ホストと宛先
ポートにつき内部マシン 1 台のみに接続可能という制限があります。
nat proto proto localIP [publicIP [remoteIP]]
このコマンドは、プロトコルタイプ proto (protocols(5) 参照) のパ
ケットを内部アドレス localIP にリダイレクトするよう ppp に指示し
ます。
publicIP が指定された場合、そのアドレスが宛先のパケットのみが適合
し、そうでない場合、デフォルトのエイリアスアドレスが使用されま
す。
remoteIP が指定された場合、その始点アドレスに適合するパケットのみ
が適合します。
このコマンドは、トンネルのエンドポイントを内部マシンにリダイレク
トするために有用です。例えば次のようにします:
nat proto ipencap 10.0.0.1
nat proxy cmd arg...
このコマンドは、ppp に特定の接続に対する代理をさせ、これらの接続
を指定したサーバにリダイレクトします。使用可能なコマンドについて
の詳細は、libalias(3) の PacketAliasProxyRule() の記述を参照して
ください。
nat punch_fw [base count]
このコマンドは、ppp に対し、FTP または IRC DCC 接続用にファイア
ウォールに穴を開けるよう指示します。これは、特定の接続 (その接続
のみ) を許可する一時的なファイアウォールルールを動的にインストー
ルすることで実現されます。これらのルールは、対応する接続が終了す
ると、削除されます。
ルール番号 base から開始する最大 count 個のルールが、ファイア
ウォールに穴を開けます。``nat punch_fw'' コマンドを実行すると、こ
の範囲は、削除されます。
引数を指定しないと、ファイアウォールの穴開けは、無効になります。
nat skinny_port [port]
このコマンドは、ppp に対し、どの TCP ポートが Skinny Station プロ
トコルによって使用されるかを通知します。Cisco Call Managers と通
信してボイスオーバ IP コールを設定するために、Cisco IP 電話が
Skinny を使用します。デフォルトでは、Skinny エイリアスは、実行さ
れません。Skinny 用の典型的なポート番号は、2000 です。
引数を指定しないと、Skinny エイリアスは、無効化されます。
nat same_ports yes|no
有効になると、ネットワークアドレス変換エンジンに対して、出力パ
ケットのポート番号をできるだけ変更しないように指示します。RPC や
LPD といった、ウェルノウンポート (well known port) からの接続を要
求するプロトコルをサポートするのに有用です。
nat target [address]
アドレスを指定したときは、そのアドレスをターゲットアドレスとして
設定し、指定しないときは、ターゲットアドレスの設定をクリアしま
す。ターゲットアドレスは、デフォルトでどのように着信パケットを
NAT するかを指定するために libaliases によって使用されます。ター
ゲットアドレスが設定されていないか、または ``default'' が与えられ
ている場合、パケットは、変更されないまま内部ネットワークにルー
ティングされるようになります。
ターゲットアドレスは、``MYADDR'' に設定され、その場合に、libalias
は、すべてのパケットをインタフェースアドレスにリダイレクトしま
す。
nat use_sockets yes|no
有効になると、ネットワークアドレス変換エンジンにソケットを作成さ
せ、正しい ftp データ入力や IRC 接続を保証できるようになります。
nat unregistered_only yes|no
登録されていない送信元アドレスの出力パケットのみを、変更します。
RFC1918 によると、登録されていない送信元アドレスは、10.0.0.0/8,
172.16.0.0/12, 192.168.0.0/16 です。
これらのコマンドは、ソース配布物の README.nat ファイル中でも議論され
ています。
[!]bg command
指定した command を、次の語を置換した後に、バックグラウンドで実行しま
す:
AUTHNAME これは、ローカルの authname の値と置き換えられます。
後述の ``set authname'' コマンドを参照してください。
COMPILATIONDATE 以前のソフトウェアリビジョンでは、これは、ppp がコン
パイルされた日付と置き換えられます。以前のコンパイル
の正確な複製を製作するために同じコードを再コンパイル
する能力が失われるとき、これは、もうサポートされませ
ん。
DNS0 & DNS1 これは、それぞれプライマリ DNS サーバ、セカンダリ
DNS サーバの IP アドレスに置き換えられます。IPCP に
よりネームサーバがネゴシエーションされた場合、このマ
クロの値は、変わります。
ENDDISC これは、ローカルの終点選択値と置き換えられます。後述
の ``set enddisc'' コマンドを参照してください。
HISADDR これは、相手の IP 番号と置き換えられます。
HISADDR6 これは、相手の IPv6 番号と置き換えられます。
INTERFACE これは、使用中のインタフェース名と置き換えられます。
IPOCTETSIN これは、接続確立後に受信された IP バイト数と置き換え
られます。
IPOCTETSOUT これは、接続確立後に送信された IP バイト数と置き換え
られます。
IPPACKETSIN これは、接続確立後に受信された IP パケット数と置き換
えられます。
IPPACKETSOUT これは、接続確立後に送信された IP パケット数と置き換
えられます。
IPV6OCTETSIN これは、接続確立後に受信された IPv6 バイト数と置き換
えられます。
IPV6OCTETSOUT これは、接続確立後に送信された IPv6 バイト数と置き換
えられます。
IPV6PACKETSIN これは、接続確立後に受信された IPv6 パケット数と置き
換えられます。
IPV6PACKETSOUT これは、接続確立後に送信された IPv6 パケット数と置き
換えられます。
LABEL これは、最後に使用したラベル名と置き換えられます。ラ
ベルは、ppp のコマンドラインから ``load'' または
``dial'' のコマンドから指定するか、ppp.secret ファイ
ルから指定可能です。
MYADDR これは、ローカルインタフェースに割り当てられた IP 番
号と置き換えられます。
MYADDR6 これは、ローカルインタフェースに割り当てられた IPv6
番号と置き換えられます。
OCTETSIN これは、接続確立後に受信されたバイト数と置き換えられ
ます。
OCTETSOUT これは、接続確立後に送信されたバイト数と置き換えられ
ます。
PACKETSIN これは、接続確立後に受信されたパケット数と置き換えら
れます。
PACKETSOUT これは、接続確立後に送信されたパケット数と置き換えら
れます。
PEER_ENDDISC これは、相手の終点選択番号と置き換えられます。
PROCESSID これは、現在のプロセス ID と置き換えられます。
SOCKNAME これは、診断ソケット名と置き換えられます。
UPTIME これは、HH:MM:SS という書式の、バンドルの上がってい
る時間で置き換えられます。
USER これは、PAP もしくは CHAP で認証されたユーザ名と置き
換えられます。通常、この変数は、-direct モードでのみ
割り当てられます。この値は、utmp ロギングが有効に
なっているかどうかに関わらず、利用可能です。
VERSION これは、ppp の現在のバージョン番号と置き換えられま
す。
これらの置換は、``set proctitle'', ``ident'', ``log'' コマンドによっ
ても実行されます。
コマンド実行中に ppp を停止させたい場合は、``shell'' コマンドを使用し
てください。
clear physical|ipcp|ipv6 [current|overall|peak...]
``physical'', ``ipcp'', ``ipv6cp'' のいずれかの階層で、指定されたス
ループット値をクリアします。``physical'' を指定する場合には、コンテキ
ストが与えられなければなりません (後述の ``link'' コマンドを参照)。第
2 引数が与えられない場合、すべての値がクリアされます。
clone name[,name]...
指定されたリンクを複製し、引数の name に関連づけた新しいリンクを作成
します。このコマンドは、リンクが 1 つしかない場合 (この場合には、その
リンクがデフォルトになります) を除いて後述の ``link'' コマンドから使
用する必要があります。リンクは、下記の ``remove'' コマンドで削除でき
ます。
デフォルトのリンク名は、``deflink'' です。
close [lcp|ccp[!]]
引数が与えられないと、適切なプロトコル層がダウンし、リンクが閉じられ
ます。``lcp'' が指定されると LCP 層がダウンしますが、ppp をオフライン
にはしません。例えば ``slirp'' のようなものを使用すれば、``term'' (後
述) を使用して相手のマシンと会話できます。``ccp'' が指定されると適切
な圧縮層が閉じられます。``!'' が使用されると、圧縮層は、クローズ状態
のままとなります。使用されない場合には、STOPPED 状態へ再度入り、相手
が更なる CCP ネゴシエーションを開始するのを待ちます。なにが起きようと
も、ユーザを ppp から切り離すことはありませんし、ppp を終了させること
もありません。後述の ``quit'' を参照してください。
delete[!] dest
このコマンドは、指定した dest IP アドレスの経路を削除します。dest に
`ALL' が指定された場合、現在のインタフェースの経路表の非直接エントリ
と `スティッキ経路' がすべて削除されます。dest に `default' が指定さ
れた場合、デフォルト経路が削除されます。
delete! コマンドが使用された場合 (最後の ``!'' に注意)、存在しない経
路について ppp は、文句を言わなくなります。
dial|call [label]...
このコマンドは、``load label'' の次に ``open'' を指定することと同等で
す。後方互換性のために提供されています。
down [lcp|ccp]
適切な階層をダウンさせますが、綺麗な方法ではなく、下位層が使用不能に
なったように見えます。オープン状態にある有限状態機械でこのコマンドを
使用することは、丁寧ではないとされています。引数が与えられない場合、
すべてのリンクが閉じられます (コンテキストが与えられない場合には、す
べてのリンクが終了されます)。`lcp' が指定された場合、LCP 層は、終了さ
れますが、デバイスは、オフラインに移行せず、リンクも閉じられません。
`ccp' が指定された場合、関連する圧縮層のみが終了されます。
help|? [command]
利用可能なコマンドをリストします。command を指定した場合、このコマン
ドの使用方法を表示します。
ident [text...]
text を使用して、相手に対してリンクを自己証明 (identify) します。text
が空の場合、リンクの自己証明は、無効化されます。前述の bg コマンドに
使用できる語は、すべて使用可能です。ppp が相手に対して自己証明する場
合についての詳細は、sendident コマンドを参照してください。
iface command [args]
このコマンドは、ppp が使用するインタフェースを制御します。command
は、次のいずれかです:
iface add[!] addr[/bits] [peer]
iface add[!] addr mask peer
指定された addr mask peer の組み合わせをインタフェースに追加しま
す。mask を指定する代りに、/bits を使用可能です (addr との間に空
白を入れてはなりません)。指定したアドレスが既に存在する場合、
``!'' を使用していない限りコマンドは、失敗します - この場合、以前
のインタフェースアドレスエントリは、新しいもので置き換えられ、
ネットマスクと相手のアドレスの変更を許します。
addr のみが指定されると、bits は、デフォルト値 ``32'' になり、
peer は、デフォルト値 ``255.255.255.255'' になります。このアドレ
ス (ブロードキャストアドレス) は、相手のアドレスとして複数存在す
ることを ppp が唯一許すものです。
iface clear [INET | INET6]
ppp が OPENED 状態または -auto モードの場合にこのコマンドを使用す
ると、NCP ネゴシエートされたアドレス以外の全アドレスがインタ
フェースから削除されます。ppp が OPENED 状態でも -auto モードでも
ない場合、全インタフェースアドレスが削除されます。
INET または INET6 の引数が使用された場合、そのアドレスファミリの
アドレスのみが削除されます。
iface delete[!]|rm[!] addr
このコマンドは、指定した addr をインタフェースから削除します。
``!'' が指定されると、現在そのアドレスがインタフェースに割り当て
られていなくても、エラーは、報告されません (削除も行われません)。
iface name name
name へのインタフェースを改名します。
iface description description
インタフェース記述を description に設定します。利用者のシステムに
多くのインタフェースがあるなら、役に立ちます。
iface show
インタフェースの現在の状態と現在のアドレスを表示します。
``ifconfig INTERFACE'' を実行することと、ほとんど同じです。
iface help [sub-command]
このコマンドを sub-command なしで起動すると、利用可能な ``iface''
サブコマンドと、おのおのの短い書式を表示します。sub-command 付き
で起動すると、指定した sub-command の書式のみを表示します。
[data]link name[,name]... command [args]
コマンドが影響を与えるリンクを特定したい場合に、このコマンドを任意の
他のコマンドの接頭辞として使うことができます。これは、マルチリンク
モードで ``clone'' コマンドを使って複数のリンクを作成した後でのみ適用
されます。
name は、存在するリンク名を指定します。name がコンマ区切りのリストの
場合には、command は、それぞれのリンクに対して実行されます。name が
``*'' の場合には、command は、すべてのリンクに対して実行されます。
load [label]...
ppp.conf ファイルから指定された label (複数指定可) をロードします。
label が指定されない場合、default ラベルが仮定されます。
label セクションが ``set mode'', ``open'', ``dial'' のいずれのコマン
ドも使用しない場合、ppp は、すぐに接続を確立しようとはしません。
log word...
指定した単語 (複数可) をその前に ``LOG:'' を付けてログファイルに送信
します。前述の ``!bg'' コマンドで説明した単語置換が実行されます。
open [lcp|ccp|ipcp]
これは、``close'' の反対のコマンドです。閉じられているリンクのうち、2
番目以降の demand-dial リンク以外、全リンクがすぐに立ち上がります - 2
番目以降の demand-dial リンクは、どのような ``set autoload'' コマンド
が使用されたかに依存して立ち上ります。
LCP 層がすでにオープンされているときに ``lcp'' 引数を指定すると、LCP
は、再度ネゴシエートされます。したがって、種々の LCP オプションを変更
したあとで ``open lcp'' コマンドを用いることで、変更を有効にすること
ができます。LCP が再度ネゴシエートされた後、同意したあらゆる認証が実
行されます。
``ccp'' 引数が用いられると、関連する圧縮層がオープンされます。すでに
オープンされている場合には、再度ネゴシエートされます。
``ipcp'' 引数が用いられると、リンクが通常通り起動されます。すでに
IPCP がオープンされている場合には、IPCP は、再度ネゴシエートされ、
ネットワークインタフェースが再設定されます。
このようにして PPP の状態機械を再オープンするのは、おそらく良い手段で
はありません。接続相手が正しく振る舞わない可能性があるためです。しか
しながら、強制的に CCP もしくは VJ 辞書をリセットする手段としては便利
です。
passwd pass
すべての ppp コマンドセットにアクセスするために要求されるパスワードを
指定します。このパスワードは、診断ポート (``set server'' コマンド参
照) に接続するときに必要です。pass は、``set server'' コマンドライン
で指定します。command ログが有効でも、値 pass は、記録されず、文字列
`********' が記録されます。
quit|bye [all]
``quit'' が制御接続もしくはコマンドファイルから実行されると、ppp は、
すべての接続を閉じた後に終了します。その他の場合、つまりユーザが診断
ソケットから接続している場合には、単にその接続が失われます。
all 引数が与えられた場合、ppp は、コマンドがどこから発行されたかに関
わらず、すべての存在する接続を閉じて終了します。
remove|rm
このコマンドは、与えられたリンクを消去します。これは、マルチリンク
モードでのみ有用です。リンクは、消去する前に CLOSED 状態になっていな
ければなりません。
rename|mv name
このコマンドは、与えられたリンクの名前を name に変更します。name がす
でに他のリンクで使用されている場合には、失敗します。
デフォルトリンクの名前は、`deflink' です。これを `modem', `cuau0' ま
たは `USR' のいずれかに変更すると、ログファイルの可読性が向上するかも
知れません。
resolv command
このコマンドは、resolv.conf(5) ファイルの ppp の操作を制御します。ppp
が起動するとき、それは、このファイルの内容をメモリにロードし、将来の
使用のために、このイメージを保持します。command は、次の 1 つです:
readonly 読み込み専用として、/etc/resolv.conf を扱います。``dns'' が
有効であるなら、ppp は、DNS0 と DNS1 マクロを通して結果を利
用可能とし、まだ、接続相手とネームサーバをネゴシエートする
ことを試みます。これは、``resolv writable'' コマンドの反対
です。
reload /etc/resolv.conf をメモリに再ロードします。例えば、DHCP ク
ライアントが /etc/resolv.conf を上書きするなら、これは、必
要とされます。
restore 起動時に読み込まれたオリジナルのバージョンか、または最後の
``resolv reload'' コマンドで /etc/resolv.conf を置き換えま
す。これは、ときどき、/etc/ppp/ppp.linkdown ファイルを置く
ために役に立つコマンドです。
rewrite /etc/resolv.conf ファイルを書き換えます。このコマンドは、た
とえ、``resolv readonly'' コマンドが使用されても、動作しま
す。他のコマンドが終了される後まで、利用者が、
/etc/resolv.conf を更新することを延期したいなら、それは、
/etc/ppp/ppp.linkup ファイルのコマンドとして役に立ちます。
writable ppp は、``dns'' が有効にされ、ppp が DNS のネゴシエートが成
功するなら、/etc/resolv.conf を更新することができます。これ
は、``resolv readonly'' コマンドの反対です。
save
このオプションは、(まだ) 実装されていません。
sendident
このコマンドは、ppp に対し、相手に対して自己証明するように指示しま
す。リンクは、LCP 状態以上であることが必要です。(ident コマンドによっ
て) 自己証明の設定がなされていない場合、sendident は、失敗します。
自己証明の設定がなされている場合、設定拒否を送信または受信するとき
か、ネゴシエーションが失敗したときか、LCP が OPENED 状態になるときの
いずれかのときに、ppp は、自動的に自己証明します。
受信した自己証明パケットは、LCP ログに記録し (詳細は、set log を参照
してください)、これに対する応答は、行いません。
set[up] var value
このオプションは、次に示す変数の設定のために使用します:
set accmap hex-value
ACCMap は、非同期制御文字マップ (Asyncronous Control Character
Map) を意味します。これは、いつも相手とネゴシエートされ、デフォル
ト値は、16 進数で 00000000 です。このプロトコルが必要なのは、
(XON/XOFF などの) 特定の文字を終点間で受渡すことに依存するハード
ウェアを使用する場合です。
XON/XOFF については、``set accmap 000a0000'' を使用します。
set [auth]key value
クライアントモードでの PAP または CHAP のネゴシエーションで使用さ
れる認証キー (もしくはパスワード) を、指定した値に設定します。ダ
イヤルまたはログインスクリプトの `\P' シーケンスで使用するパス
ワードもまた指定します。これにより実際のパスワードは、記録されま
せん。command または chat のログが有効な場合、セキュリティの観点
から、value は、`********' として記録されます。
value の最初の文字がエクスクラメーションマーク (``!'') の場合、
ppp は、残りの文字列を、``authname'' と ``authkey'' の値を確定す
るために実行すべきプログラムとして扱います。
実行するプログラムを得るために value をパーズする際には、``!'' が
二重 (``!!'') である場合、単一のリテラル ``!'' として扱います、そ
うでない場合、``!'' を無視します。また、前述の ``!bg'' コマンドと
同様に特殊な名前を置換します。プログラムを実行すると、ppp は、こ
のプログラムに対して次の 3 行の入力を与えます。各行の末尾には、改
行文字が置かれます。
• CHAP チャレンジで送信されるホスト名。
• CHAP チャレンジで送信されるチャレンジ文字列。
• ローカルに定義される ``authname''。
出力の 2 つの行が期待されます:
• CHAP 応答で送信される ``authname''。
• チャレンジと要求 ID で暗号化され、応答が CHAP 応答パケットで
送信されている ``authkey''。
ppp をこのように設定するとき、ホストチャレンジは、ASCII の数値も
しくは文字であることを想定しています。指定されたチャレンジに対す
る適切な秘密情報を計算するために、通常は、暗号化デバイスまたは
Secure ID カードが必要です。
set authname id
クライアントモードでの PAP または CHAP のネゴシエーションで使用さ
れる認証 ID を設定します。
CHAP を enable にして -direct モードで利用すると、id は、初期認証
チャレンジで用いられ、通常は、ローカルマシン名に設定されます。
set autoload min-percent max-percent period
これらの設定は、マルチリンクモードでのみ適用され、デフォルト値
は、それぞれ 0, 0, 5 です。1 つ以上の demand-dial (-auto としても
知られる) モードのリンクが存在する場合、ppp が最初に tun デバイス
からデータを読むときには、最初のリンクのみが有効になっています。
次の demand-dial リンクが開かれるのは、現在のバンドルの period 秒
間のスループットがバンドルの総バンド幅の最低 max-percent パーセン
トであるときに限られます。現在のバンドルの period 秒間のスルー
プットがバンドルの総バンド幅の min-percent パーセント以下に減少し
たとき、最後のアクティブなリンクでない場合、demand-dial リンク
は、ダウンします。
バンドルのスループットは、内向きおよび外向きのトラフィックの最大
値として計測されます。
デフォルト値では、demand-dial リンクは、1 つだけオープンされま
す。
デバイスによっては、物理バンド幅を判定できないものがありますの
で、``set autoload'' が正しく動作するためには、(後述の) ``set
bandwidth'' コマンドを使用する必要がある場合があります。
set bandwidth value
本コマンドは、接続のバンド幅を、秒あたりのビット数で設定します。
value は、0 より大きいことが必要です。現在、前述の ``set
autoload'' コマンドのみが使用します。
set callback option...
引数が与えられない場合、コールバックは、disable になります。そう
でない場合には、ppp は、与えられた option でコールバックを要求し
ます (もしくは -direct モードでは、受け付けます)。クライアント
モードでは、option の否定応答が返されると、ppp は、他に選択肢がな
くなるまで別の option 要求を出します (option のひとつとして
``none'' を指定していた場合を除きます)。サーバモードでは、ppp
は、与えられるプロトコルをなんでも受け付けますが、クライアントが
いずれかひとつを要求する必要があります。コールバックをオプション
にしたいのであれば、オプションとして none を {含め} なければなり
ません。
option は、下記の通りです (優先度順):
auth コールバック応答側は、認証に基づいてコールバック番号を決
定することが求められます。ppp がコールバック応答側である
場合、番号は、/etc/ppp/ppp.secret 中の接続先エントリの 5
番目のフィールドで指定されます。
cbcp Microsoft コールバック制御プロトコルが用いられます。後述
の ``set cbcp'' を参照してください。
クライアントモードで cbcp をネゴシエートしたい場合であり
かつ、CBCP ネゴシエーション時にサーバがコールバックなしを
要求することを許したい場合、コールバックオプションとして
cbcp と none の両方を指定する必要があります。
E.164 *|number[,number]...
コールバック要求側が number を指定します。ppp がコール
バック応答側である場合、number は、許可する番号をコンマで
区切って並べたリスト、もしくは任意の番号を許可するという
意味の ``*'' とします。ppp がコールバック要求側である場
合、1 つの数字だけを指定します。
``*'' を用いる場合、このオプションは、とても危険なものと
なることに注意してください。というのは、悪意あるコール
バック要求者が、最初の認証なしに電話すべき番号として任意
の (国際通話番号も可能です) 番号を伝えることができるから
です。
none 接続相手がコールバックをまったく望まない場合、ppp は、そ
のことを受け入れ、接続を終了するのではなくコールバックせ
ずに処理を続けます。コールバックをオプションにしたいので
あれば、(1 個以上の他のコールバックオプションに加えて) こ
れも指定する必要があります。
set cbcp [*|number[,number...] [delay [retry]]]
引数が与えられない場合、CBCP (Microsofts CallBack Control Proto
col) は、disable です。言い換えれば ``set callback'' コマンドで
CBCP を設定すると ppp が CBCP フェーズでコールバック要求を行わな
くなります。そうでない場合、ppp は、与えられた電話番号 number を
使おうとします。
サーバモード (-direct) では、``*'' を使わない限り ppp は、クライ
アントがこれらの番号の 1 つを使うことを主張します。``*'' を使った
場合には、クライアントが番号を指定するものと想定します。
クライアントモードでは、ppp は、与えられた番号 (そのうち接続相手
と合意可能なもの) を使用しようとします。``*'' が指定された場合に
は、ppp 接続相手が番号を指定するものと想定します。
set cd [off|seconds[!]]
通常、オープンしたデバイスのタイプにより、ppp は、キャリアの存在
をチェックします。
端末デバイス
ログインスクリプト完了後、1 秒間キャリアがチェックされま
す。このパラメータが設定されていない場合、デバイスがキャ
リアをサポートしていない (ほとんどの ``laplink'' ヌルモデ
ムケーブルの場合がそうです) と ppp は、仮定し、この事実を
ログに取って、キャリアのチェックを止めます。
仮想端末 (pty) は、TIOCMGET ioctl をサポートしていないた
め、デバイスが仮想端末であることを検出した場合、端末デバ
イスは、すべてのキャリア検出をオフにします。
PPPoE (netgraph) デバイス
5 秒間、1 秒ごとに 1 回キャリアの検出を行ないます。5 秒後
にキャリアが設定されない場合、接続の試みは、失敗したと見
なされ、デバイスは、クローズされます。PPPoE デバイスの場
合、キャリアが常に要求されます。
他のすべてのデバイスタイプは、キャリアをサポートしていません。デ
バイスをオープンするときにキャリアを設定すると警告が出ます。
モデムによっては、接続が確立してからキャリア信号線がアサートされ
るまで 1 秒以上かかるものがあります。この遅れを増やせない場合、
ppp は、そのデバイスがキャリアをアサートできないと見なすので、ppp
は、リンクのドロップを検出できないことになります。
``set cd'' コマンドは、デフォルトのキャリアの動作を上書きします。
seconds は、ダイヤルスクリプトが完了してからキャリアが利用可能か
判断する前に、ppp が待つべき秒数の上限を指定します。
``off'' が指定されると、ppp は、デバイスのキャリアを確認しませ
ん。そうでない場合、キャリアが検出されるか seconds の秒数が経過す
るまで、ppp は、ログインスクリプトへは進みません。このとき、
seconds の秒数が経過した時点で、ppp は、デバイスがキャリアを設定
できないと想定します。
引数を与えない場合、キャリア設定は、デフォルトの値に戻ります。
seconds の直後にエクスクラメーションマーク (``!'') がある場合、
ppp は、キャリアを要求します。seconds 秒後にキャリアが検出されな
いと、リンクは、切断されます。
set choked [timeout]
これは、ppp がすべての未送出パケットを破棄する前に送出キュー詰ま
りを保持する秒数を設定します。timeout が 0 以下もしくは timeout
が指定されない場合、デフォルト値の 120 秒に設定されます。
送出キュー詰まりは、ppp がローカルネットワークから特定の数の送出
パケットを読み込んだが、リンク失敗 (接続相手がビジーなど) のため
にデータを送れない場合に発生します。ppp は、パケットを無限には読
み込みません。代りに 30 パケット (マルチリンクモードでは、30 +
nlinks * 2 パケット) まで読み込み、timeout 秒経過するか、1 つ以上
のパケットが送られるまでネットワークインタフェースの読み込みを停
止します。
timeout 秒が経過すると、すべての未送出パケットは、破棄されます。
set ctsrts|crtscts on|off
ハードウェアフロー制御をセットします。デフォルトでは、ハードウェ
アフロー制御は、on です。
set deflate out-winsize [in-winsize]
DEFLATE アルゴリズムの、デフォルトの出力ウィンドウサイズと入力
ウィンドウサイズを設定します。out-winsize および in-winsize は、8
から 15 までの値をとる必要があります。in-winsize が指定されると、
ppp は、このウィンドウサイズの使用を強要し、相手が他の値を示して
も受け入れません。
set dns [primary [secondary]]
``accept dns'' コマンドで使用される、DNS 上書きを設定します。詳細
については、前述の ``accept'' コマンドの記述を参照してください。
本コマンドは、``enable dns'' を使用して要求される IP 番号には影響
を与えません。
set device|line value...
ppp が使用するデバイスを、指定された ``value'' に設定します。
すべてのシリアルデバイスの名前は、/dev/ から始まることが仮定され
ています。シリアルデバイスは、通常 cuaXX と呼ばれます。
``value'' が /dev/ から始まらない場合、エクスクラメーションマーク
(``!'') から始めるか、PPPoE:iface[:provider] の形式 (netgraph(4)
が有効なシステム上) であるか、host:port[/tcp|udp] の形式である必
要があります。
エクスクラメーションマークで始まる場合、デバイス名の残りは、プロ
グラム名として扱われ、そのデバイスがオープンされるときにそのプロ
グラムが実行されます。標準入出力およびエラーは、ppp にフィード
バックされ、それらが通常デバイスであるかのように読み書きされま
す。
PPPoE:iface[:provider] 指定が与えられる場合、ppp は、指定された
iface インタフェースを使用して PPP オーバイーサネット接続を作成し
ようとします。この際 netgraph(4) を使用します。netgraph(4) が使用
不能の場合、ppp は、kldload(2) を使用してロードしようとします。こ
れが失敗する場合には、OpenBSD で利用できる pppoed(8) のような外部
プログラムを使用する必要があります。与えられた provider は、PPPoE
Discovery Initiation (PADI) パケット中でサービス名として渡されま
す。provider が与えられないと、空の値が使用されます。
PPPoE 接続が確立されるとき、ppp は、アクセスコンセントレータの名
前を環境変数 ACNAME に設定します。
さらなる詳細は、netgraph(4) と ng_pppoe(4) を参照してください。
host:port[/tcp|udp] 指定が与えられる場合、ppp は、指定された host
の指定された port と接続しようとします。``/tcp'' または ``/udp''
のサフィックスがない場合、デフォルトは、``/tcp'' となります。詳細
は、上述の PPP オーバ TCP と PPP オーバ UDP のセクションを参照し
てください。
複数の ``value'' を指定した場合、ppp は、成功するか全デバイスにつ
いて実行し終るまで、順番にオープンを試みます。
set dial chat-script
相手へダイヤルする際に使用されるチャットスクリプトを指定します。
後述の ``set login'' コマンドも参照してください。チャットスクリプ
トの形式の詳細については、chat(8) と設定ファイルの例を参照してく
ださい。次の特殊な `value' をチャットスクリプトに指定可能です:
\c `送信' 文字列の最後の文字として使用した場合、改行を追加しては
ならないことを意味します。
\d チャットスクリプトがこのシーケンスに出会うと、2 秒待ちます。
\p チャットスクリプトがこのシーケンスに出会うと、1/4 秒待ちま
す。
\n 改行文字と置き換えられます。
\r 復改文字と置き換えられます。
\s 空白文字と置き換えられます。
\t タブ文字と置き換えられます。
\T 現在の電話番号と置き換えられます (後述の ``set phone'' 参
照)。
\P 現在の authkey 値と置き換えられます (前述の ``set authkey''
参照)。
\U 現在の authname 値と置き換えられます (前述の ``set authname''
参照)。
2 つのパーザがこれらのエスケープシーケンスを検査することに注意し
てください。`チャットのパーザ' にエスケープ文字を見せるには、`コ
マンドパーザ' からエスケープする必要があります。つまり、2 つのエ
スケープを使用する必要があります。例えば次のようにします:
set dial "... ATDT\\T CONNECT"
チャットスクリプトから外部コマンドを実行することもできます。そう
するためには、受信待ち文字列または送信文字列の最初の文字をエクス
クラメーションマーク (``!'') にします。リテラルのエクスクラメー
ションマークが必要な場合には、二重 ``!!'' にすれば、単一のリテラ
ル ``!'' として扱われます。コマンドが実行されると、標準入力と標準
出力がオープンデバイス (``set device'' 参照) に向けられ、標準エ
ラー出力が ppp に読まれて受信待ち文字列もしくは送信文字列に置き換
えられます。ppp が対話モードで実行されている場合、ファイル記述子
3 は、/dev/tty に接続されます。
例えば (読み易さのために折り返しています);
set login "TIMEOUT 5 \"\" \"\" login:--login: ppp \
word: ppp \"!sh \\-c \\\"echo \\-n label: >&2\\\"\" \
\"!/bin/echo in\" HELLO"
は、次のチャットのシーケンスの結果となります (ダイヤルの前に `set
log local chat' を使用する出力):
Dial attempt 1 of 1
dial OK!
Chat: Expecting:
Chat: Sending:
Chat: Expecting: login:--login:
Chat: Wait for (5): login:
Chat: Sending: ppp
Chat: Expecting: word:
Chat: Wait for (5): word:
Chat: Sending: ppp
Chat: Expecting: !sh \-c "echo \-n label: >&2"
Chat: Exec: sh -c "echo -n label: >&2"
Chat: Wait for (5): !sh \-c "echo \-n label: >&2" --> label:
Chat: Exec: /bin/echo in
Chat: Sending:
Chat: Expecting: HELLO
Chat: Wait for (5): HELLO
login OK!
複数レベルのネストについて、エスケープ文字の使用方法に (再度) 注
意してください。ここでは、4 つのパーザが動作してます。1 番目は、
オリジナルの行をパーズし、3 つの引数として読みます。2 番目は、第
3 引数を 11 個の引数として読みます。ここで、``-'' 記号がエスケー
プされていることが重要です。そうでなければパーザは、受信待ち-送
信-受信待ちのシーケンスとして見てしまいます。``!'' 文字を見つける
と、実行パーザは、最初のコマンドを 3 つの引数として読み、sh(1) 自
身が -c 以降の引数を展開します。我々は、出力をモデムに送り返した
いので、1 番目の例では、出力をファイル記述子 2 (stderr) にリダイ
レクトして ppp 自身に送信および記録させ、2 番目の例では、単に
stdout に出力して直接モデムに出力させます。
もちろん全体を、組み込みのものではなく外部の ``chat'' コマンドに
実行させることが可能です。良い代替方法については、chat(8) を参照
してください。
実行される外部コマンドは、``!bg'' コマンドと同様に、特殊語の展開
対象となります。
set enddisc [label|IP|MAC|magic|psn value]
このコマンドは、ローカル終点の選択値を設定します。LCP ネゴシエー
ションの前に設定された場合であり、``disable enddisc'' コマンドを
使用していない場合、ppp は、LCP 終点選択値オプションを使用して、
相手に情報を送ります。次の選択値を設定可能です。
label 現在のラベルが使用されます。
IP 当方のローカル IP 番号を使用します。LCP は、IPCP より前に
ネゴシエートされますので、IPCP 層が後からこの値を変更する
ことが可能です。その場合、手動でリセットしない限り、終点
の選択値は、古い値のままとなります。
MAC 前述の IP オプションに似ていますが、ローカル IP 番号に関
係する MAC アドレスが使用される点が異なります。ローカル
IP 番号がどのイーサネットインタフェースにも存在しない場
合、本コマンドは、失敗します。
ローカル IP 番号のデフォルトは、マシンホスト名がなんであ
れ、その名前になりますので、通常 ``set enddisc mac'' を
``set ifaddr'' コマンドよりも先に実行します。
magic 20 桁の乱数が使用されます。マジックナンバを使用するときに
は注意が必要です。ppp の再開や別の ppp を使ったリンク作成
においては、別のマジックナンバを使用するため、同じバンド
ルに属すとは相手に認識されないのです。このため、-direct
接続では使えません。
psn value
指定された value が使用されます。value は、絶対的な公衆ス
イッチネットワーク番号の先頭に国コードを付けたものである
べきです。
引数が与えられない場合、終点の選択値は、リセットされます。
set escape value...
このオプションは、前述の ``set accmap'' オプションに似ています。
リンクを経由する時に `エスケープ' される文字を指定するために使用
します。
set filter dial|alive|in|out rule-no permit|deny|clear|rule-no [!]
[[host] src_addr[/width] [dst_addr[/width]]] [proto [src lt|eq|gt
port] [dst lt|eq|gt port] [estab] [syn] [finrst] [timeout secs]]
ppp は、4 つのフィルタセットをサポートします。alive フィルタは、
接続を活性状態に保つパケットを指定します - アイドルタイマをリセッ
トします。dial フィルタは、-auto モード時に ppp にダイヤルさせる
パケットを指定します。in フィルタは、マシンに入力可能なパケットを
指定します。out フィルタは、マシンから出力可能なパケットを指定し
ます。
フィルタリングが行われるのは、出力パケットでは、NAT エンジンによ
る IP 変更前であり、入力パケットでは、NAT エンジンによる IP 変更
後です。デフォルトでは、すべての空のフィルタセットは、全パケット
の通過を許可します。ルールは、rule-no に従って順番に処理されます
(ルール番号を action に指定してスキップする場合を除きます)。各
セットに対し 40 までのルールを指定可能です。指定されるセットにお
けるどのルールにもマッチしないパケットは、破棄されます。in と out
のフィルタでは、パケットをドロップすることを意味します。alive
フィルタでは、アイドルタイマをリセットしないことを意味します (こ
れは、in/out フィルタが ``timeout'' 付きである場合でもです)。dial
フィルタでは、ダイヤルさせることにはならないことを意味します。ダ
イヤルを引き起こさないパケットは、キューされるのではなく、捨てら
れることに注意してください。上述のパケットのフィルタリングのセク
ションを参照してください。
set hangup chat-script
デバイスを閉じる前にこれをリセットする時に使用する、チャットスク
リプトを指定します。通常は、不要であるべきですが、閉じる時に自己
を正しくリセットできないデバイスに対して使用できます。
set help|? [command]
利用可能な set コマンドのまとめを表示するか、command が指定される
と、コマンドの使用方法を表示します。
set ifaddr [myaddr[/nn] [hisaddr[/nn] [netmask [triggeraddr]]]]
このコマンドは、IPCP ネゴシエーションの間使用される IP アドレスを
指定します。アドレスの形式は、次の通りです。
a.b.c.d/nn
ここで ``a.b.c.d'' は、希望する IP アドレスであり、nn は、このう
ち何ビットが有効であるかを示します。/nn が省略された場合、デフォ
ルトの ``/32'' になります。ただし IP アドレスが 0.0.0.0 である場
合には、マスクのデフォルトは、``/0'' です。
動的な IP 番号をピア (相手側) に割り当てたいなら、hisaddr に IP
番号の範囲として次の形式も指定することができます。
IP[-IP][,IP[-IP]]...
例えば:
set ifaddr 10.0.0.1 10.0.1.2-10.0.1.10,10.0.1.20
は、``10.0.0.1'' のみをローカル IP 番号としてネゴシエートします
が、指定された 10 個の IP 番号から相手に割り当てを行います。相手
がこれらの番号のうちの 1 つを要求し、この番号が未使用な場合には、
ppp は、相手の要求を認めます。相手がリンクを再確立して前回割り当
てていた IP 番号を使用したい場合に有用です (既存の TCP と UDP の
接続を保存します)。
相手が要求した IP 番号が範囲外もしくは使用中の場合、ppp は、範囲
内の未使用 IP 番号をランダムに指示します。
triggeraddr が指定された場合、この値が myaddr の代りに IPCP ネゴ
シエートで使用されます。ただし、myaddr の範囲のアドレスのみ受け入
れられます。これが有用なのは、相手が ``0.0.0.0'' を要求しない限り
IP アドレスを割り当てようとしない PPP 実装とネゴシエートするとき
です。
-auto モードでは、設定ファイルの ``set ifaddr'' 行を読んだ直後に
ppp がインタフェースを構成することに注意してください。他のモード
では、これらの値は、IPCP ネゴシエーションで使用され、IPCP 層が
アップするまでこれらのインタフェースは、構成されません。
(PAP か CHAP が ``enable'' である場合) クライアントが自己証明をし
た後では、HISADDR 引数は、ppp.secret ファイルの第 3 引数で上書き
されうることに注意してください。内向き接続の認証のセクションを参
照してください。
どの場合でも、インタフェースが既に構成されている場合には、ppp
は、インタフェースの IP 番号を保存して、既にバインドされているソ
ケットが正しいままであるようにします。
set ifqueue packets
どのリンクへもデータが送信できない状態のとき、ppp がトンネルイン
タフェースから読み込むパケット数の最大値を指定します。ppp が利用
できるリンクの束よりもトンネルインタフェースがはるかに高速となり
そうな場合に、送出データのフロー制御のためにこのキューの制限は、
必要になります。
packets にリンクの数よりも小さな値を設定した場合、その設定に関わ
らず ppp は、リンクの数までは読み込みます。これにより、遅延の問題
が回避されます。
packets のデフォルトの値は、``30'' です。
set ccpretry|ccpretries [timeout [reqtries [trmtries]]]
set chapretry|chapretries [timeout [reqtries]]
set ipcpretry|ipcpretries [timeout [reqtries [trmtries]]]
set ipv6cpretry|ipv6cpretries [timeout [reqtries [trmtries]]]
set lcpretry|lcpretries [timeout [reqtries [trmtries]]]
set papretry|papretries [timeout [reqtries]]
これらのコマンドは、ppp が有限状態機械 (Finite State Machine;
FSM) に要求パケットを送る前に待つ秒数を指定します。timeout のデ
フォルトは、全 FSM において 3 秒です (ほとんどの場合十分です)。
reqtries を指定すると、相手から応答を受信しなくても諦めるまでに設
定要求を作成する回数を、ppp に指示します。デフォルトの試行回数
は、CCP, LCP, IPCP の場合 5 回であり、PAP と CHAP の場合 3 回で
す。
trmtries を指定すると、相手の応答を待つことを諦めるまでに終了要求
を作成する回数を、ppp に指示します。デフォルトの試行回数は、3 回
です。認証プロトコルは、終了されませんので、PAP や CHAP に対して
指定することは不正です。
合意できない相手とのネゴシエーションを避けるために、どのようなネ
ゴシエーションセッションであっても諦めたり層をクローズする前に
は、ppp は、最大で reqtries の設定値の 3 倍までのみ送信します。
set log [local] [+|-]value...
このコマンドにより現在のログレベルを修正できます。詳細は、ログ機
能のセクションを参照してください。
set login chat-script
この chat-script は、ダイヤルスクリプトを補います。もし両方が指定
された場合、ダイヤルスクリプトの後で、ログインスクリプトが実行さ
れます。ダイヤルスクリプト中で使用可能なエスケープシーケンスは、
ここでも使用可能です。
set logout chat-script
このコマンドは、ハングアップスクリプトが呼ばれる前にログアウトの
ために使用される、チャットスクリプトを指定します。通常では必要な
いでしょう。
set lqrperiod|echoperiod frequency
このコマンドは、LQR または LCP ECHO のパケットが送信される頻度
frequency を秒で指定します。デフォルトは、30 秒です。相手に LQR
要求または LCP ECHO 要求を送りたい場合には、``enable lqr'' コマン
ドや ``enable echo'' コマンドもまた使用する必要があります。
set mode interactive|auto|ddial|background
指定したリンクにおけるモード `mode' を変更できます。通常マルチリ
ンクモードでのみ有用ですが、単一リンクモードでも使用可能です。
`direct' または `dedicated' のリンクを変更することはできません。
注: コマンド ``set mode auto'' を発行し、ネットワークアドレス変換
が enable にされていた場合、後で ``enable iface-alias'' を行うと
便利です。ppp が必要なアドレス変換を行うようにすることにより、相
手が当方に新しい (動的な) IP アドレスを割り当てたとしても、リンク
がアップすると接続のトリガとなるプロセスが接続できるようにしま
す。
set mppe [40|56|128|* [stateless|stateful|*]]
このオプションは、MPPE のネゴシエーション時に使用する暗号パラメー
タを選択します。``disable mppe'' コマンドで、MPPE は、完全に無効
化可能です。引数を指定しないと、ppp は、128 ビット鍵の状態有りリ
ンクをネゴシエートしようとしますが、相手が要求するすべてに合意し
ます (暗号化なしも含みます)。
引数を指定すると、MPPE の使用に ppp は、固執し、相手が拒否すると
リンクを閉じます (注; この動作は、RADIUS サーバの設定により変更可
能です)。
第 1 引数は、ネゴシエート中に ppp が固執すべきビット数を指定し、
第 2 引数は、状態有りモードまたは状態なしモードのいずれに ppp が
固執すべきかを指定します。状態なしモードでは、各パケットに応じて
変更される暗号化鍵に対応し、暗号化辞書が再インストールされます。
状態有りモードでは、暗号化辞書は、256 パケット毎もしくはデータ喪
失後に再インストールされ、鍵は、256 パケット毎に変更されます。状
態なしモードは、効率が悪いものの、信頼性の無いトランスポート層で
は良いです。
set mrru [value]
このオプションを設定すると、マルチリンクプロトコルまたは MP とし
ても知られる、マルチリンク PPP ネゴシエーションを有効にします。
MRRU (Maximum Reconstructed Receive Unit) の値には、デフォルトは
ありません。引数を指定しないと、マルチリンクモードは、無効にされ
ます。
set mru [max[imum]] [value]
デフォルトの MRU (最大受信単位; Maximum Receive Unit) は、1500 で
す。この値を増加させた場合、相手は、MTU を増加させても *かまいま
せん*。理論的には、デフォルトの MRU より減らすことは意味がありま
せん。なぜなら、PPP プロトコルでは、少なくとも 1500 オクテットの
パケットを受信できなければ *ならない* からです。
``maximum'' キーワードが使用された場合、より大きな値のネゴシエー
トを ppp は、拒否します。最大 MRU は、最大でも 2048 です。最大値
を 1500 未満にすることは、PPP RFC 違反ですが、必要な場合もありま
す。例えば、PPPoE では、ハードウェアの制約により最大が 1492 にな
ります。
引数を指定しないと、1500 が仮定されます。``maximum'' 指定時には、
値の指定が必要です。引数が指定されないと、1500 が仮定されます。
set mtu [max[imum]] [value]
デフォルトの MTU は、1500 です。ネゴシエーション時に、(296 バイト
未満でなく、最大値を越えなければ) 相手が望むいかなる MRU も受け付
け可能です。MTU が設定されると、ppp は、value よりも小さい MRU の
値を受け付けなくなります。ネゴシエーションが完了すると、相手がよ
り大きな MRU を要求していたとしても、インタフェースに対して書き込
みを行う時には、MTU が使用されます。当方のパケットサイズを制限す
るのに有用です (よりよくバンド幅を共有できるようになりますが、
ヘッダデータが増えるというコストがかかります)。
``maximum'' キーワードが使用された場合、より大きな値のネゴシエー
トを ppp は、拒否します。最大 MTU は、最大でも 2048 です。PPPoE
を使っている場合には、MTU を制限するために ``maximum'' キーワード
を使う必要があることに注意してください。
value を指定しないと、1500 または相手が要求した値が使用されます。
``maximum'' 指定時には、値の指定が必要です。
set nbns [x.x.x.x [y.y.y.y]]
このオプションは、相手の要求によって返される Microsoft NetBIOS
ネームサーバの値を設定します。値を指定しないと、ppp は、そのよう
な要求を拒否するようになります。
set openmode active|passive [delay]
デフォルトでは、openmode は、常に、1 秒の delay をもって active
となります。この場合、ppp は、回線が設定されてから 1 秒が経過した
ならいつでも LCP/IPCP/CCP のネゴシエーションを開始します。相手が
ネゴシエーションを開始するのを待ちたい場合は、値 passive を使用し
ます。直ちにもしくは 1 秒以上待ってからネゴシエーションを開始した
い場合、delay を秒単位で指定します。
set parity odd|even|none|mark
回線のパリティを設定できます。デフォルト値は、none です。
set phone telno[|backupnumber]...[:nextnumber]...
ダイヤルおよびログインのチャットスクリプトで使用される \\T 文字列
が置き換えられる電話番号を指定できます。複数の電話番号をパイプ
(``|'') もしくはコロン (``:'') で区切って指定可能です。
パイプの後の番号がダイヤルされるのは、直前の番号へのダイヤルもし
くはログインのスクリプトが失敗した場合のみです。
回線の切断の理由にかかわらず、コロンで区切られた番号は、順番に試
行されます。
複数の番号を指定した場合、接続が確立するまで ppp は、このルールに
基づいてダイヤルします。再試行の最大値は、後述の ``set redial''
で指定します。-background モードでは、各番号は、最大 1 回試行され
ます。
set pppoe [standard|3Com]
このオプションは、下にある ng_pppoe(4) ノードを標準の RFC2516
PPPoE か独自の 3Com モードに設定します。設定されなければ、システ
ムのデフォルトが使われます。
set [proc]title [value]
ps(1) が表示する現在のプロセスタイトルを、value に従って変更しま
す。value が指定されないと、元のプロセスタイトルが回復されます。
シェルコマンドが行うすべての語置換 (前述の ``bg'' コマンドを参照
してください) は、ここでも行われます。
プロセスタイトル中に USER が必要な場合、``set proctitle'' コマン
ドは、ppp.linkup 中に登場する必要があることに注意してください。
ppp.conf が実行されているときには、分からないからです。
set radius [config-file]
このコマンドは、RADIUS サポートを (組み込まれていれば) 有効にしま
す。config-file は、radius.conf(5) に記述されている radius クライ
アント設定ファイルを参照します。PAP, CHAP, MSCHAP, MSCHAPv2 のい
ずれかが ``enable'' にされている場合、ppp は、Network Access
Server として振る舞い、設定されている RADIUS サーバを使用して認証
し、ppp.secret ファイルやパスワードデータベースによる認証は、行い
ません。
PAP, CHAP, MSCHAP, MSCHAPv2 のいずれも有効になっていない場合、
``set radius'' は、効果がありません。
ppp は、RADIUS 応答中の、次の属性を使用します:
RAD_FRAMED_IP_ADDRESS
相手の IP アドレスは、指定された値に設定されました。
RAD_FRAMED_IP_NETMASK
tun インタフェースのネットマスクは、指定された値に設定さ
れました。
RAD_FRAMED_MTU
指定された MTU が LCP ネゴシエーションで合意された相手の
MRU より小さい場合であり、*かつ* 設定された MTU のいずれ
よりも小さい場合 (``set mru'' コマンド参照)、tun インタ
フェースの MTU は、指定した値に設定されます。
RAD_FRAMED_COMPRESSION
受信した圧縮タイプが ``1'' の場合、``disable vj'' 設定コ
マンドが指定されていたとしても、IPCP ネゴシエーションにお
いて ppp は、VJ 圧縮を要求します。
RAD_FILTER_ID
この属性が与えられると、ppp は、これを追加のラベルとして
使用して、ppp.linkup および ppp.linkdown のファイルから
ロードを試みます。このロードは、通常のラベル検索の前に
(これに追加して) 試みられます。ラベルが存在しない場合、な
にも実行されず、ppp は、現在のラベルを使用して通常のロー
ドを行います。
RAD_FRAMED_ROUTE
受信した文字列は、dest[/bits] gw [metrics] という書式であ
ると期待します。指定した metrics は、無視されます。MYADDR
と HISADDR は、dest と gw の正当な値として理解されます。
``default'' を dest に使用可能であり、デフォルト経路を指
定します。``0.0.0.0'' は、dest に対する ``default'' と同
じであると解釈され、gw に対する HISADDR と同じであると解
釈されます。
例えば、戻り値 ``1.2.3.4/24 0.0.0.0 1 2 -1 3 400'' は、
1.2.3.0/24 ネットワークへは、HISADDR を介するという経路表
エントリになり、戻り値 ``0.0.0.0 0.0.0.0'' または
``default HISADDR'' は、HISADDR 行きのデフォルト経路にな
ります。
すべての RADIUS の経路は、すべてのスティッキな経路が適用
された後で適用されます。これにより、RADIUS の経路が、設定
済みの経路に優先します。これは、MYADDR または HISADDR と
いうキーワードを {含ま} ない RADIUS の経路にもあてはまり
ます。
RAD_FRAMED_IPV6_PREFIX
この属性が与えられると、その値で、コマンド中の IPV6PREFIX
を置換します。IPv6 接頭語をピア (通信相手) へ委任するため
に DHCPv6 のような上側の層のプロトコルにそれを渡せます。
RAD_FRAMED_IPV6_ROUTE
受信した文字列は、dest[/bits] gw [metrics] という書式であ
ると期待します。指定した metrics は、無視されます。
MYADDR6 と HISADDR6 は、dest と gw の正当な値として理解さ
れます。``default'' を dest に使用可能であり、デフォルト
経路を指定します。``::'' は、dest に対する ``default'' と
同じであると解釈され、gw に対する HISADDR6 と同じであると
解釈されます。
例えば、戻り値 ``3ffe:505:abcd::/48 ::'' は、
3ffe:505:abcd::/48 ネットワークへは、HISADDR6 を介すると
いう経路表エントリになり、戻り値 ``:: ::'' または
``default HISADDR6'' は、HISADDR6 行きのデフォルト経路に
なります。
すべての RADIUS IPv6 の経路は、すべてのスティッキな経路が
適用された後で適用されます。これにより、RADIUS IPv6 の経
路が、設定済みの経路に優先します。これは、MYADDR6 または
HISADDR6 というキーワードを {含ま} ない RADIUS の経路にも
あてはまります。
RAD_SESSION_TIMEOUT
指定した場合、指定した秒数後にクライアント接続が閉じられ
ます。
RAD_REPLY_MESSAGE
指定した場合、認証成功 (SUCCESS) テキストとして、このメッ
セージが相手に渡されます。
RAD_MICROSOFT_MS_CHAP_ERROR
この RAD_VENDOR_MICROSOFT ベンダ固有属性が指定された場
合、認証失敗 (FAILURE) テキストとして、このメッセージが相
手に渡されます。
RAD_MICROSOFT_MS_CHAP2_SUCCESS
この RAD_VENDOR_MICROSOFT ベンダ固有属性が指定された場合
で MS-CHAPv2 認証が使用されている場合、認証成功 (SUCCESS)
テキストとして、このメッセージが相手に渡されます。
RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY
この RAD_VENDOR_MICROSOFT ベンダ固有属性が指定された場合
で値が 2 の場合 (必須の意)、ppp は、MPPE 暗号の使用に固執
します (引数付き ``set mppe'' 設定コマンドの存在にかかわ
らずです)。指定された値が 1 の場合 (許可の意)、暗号化は、
オプションとなります (引数付き ``set mppe'' 設定コマンド
の存在にかかわらずです)。
RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES
この RAD_VENDOR_MICROSOFT ベンダ固有属性が指定された場
合、ビット 1 および 2 が検査されます。どちらかもしくは両
方が設定されていた場合、(それぞれ) 40 ビットおよび/または
128 ビットの暗号化が有効になります。どちらかもしくは両方
が設定された場合、``set mppe'' コマンドへの第 1 引数にか
かわらず、40 ビットおよび/または 128 ビット暗号オプション
が (それぞれ) 設定されます。現状、RADIUS サーバは、56
ビット暗号化は、指定不可能であることに注意してください。
RAD_MICROSOFT_MS_MPPE_RECV_KEY
この RAD_VENDOR_MICROSOFT ベンダ固有属性が指定された場
合、入力データの暗号解読にこの値をマスタキーとして使用し
ます。クライアントが MSCHAPv2 で認証された場合、内向きの
MPPE が動作するためには、RADIUS サーバは、この属性を提供
「しなければなりません」。
RAD_MICROSOFT_MS_MPPE_SEND_KEY
この RAD_VENDOR_MICROSOFT ベンダ固有属性が指定された場
合、出力データの暗号化にこの値をマスタキーとして使用しま
す。クライアントが MSCHAPv2 で認証された場合、外向きの
MPPE が動作するためには、RADIUS サーバは、この属性を提供
「しなければなりません」。
RADIUS サーバから受信した値は、``show bundle'' を使用して見られま
す。
set rad_alive timeout
RADIUS が設定されていれば、``rad_alive'' に非 0 の timeout 値を設
定することで、ppp は、timeout 秒毎に RADIUS アカウント情報を
RADIUS サーバに送るようになります。
set rad_port_id option
RADIUS を設定するとき、``rad_port_id'' 値を設定することは、NAS
Port-Id として RADIUS サーバに何を送信すべきかを指定します。
option は、次の通りです:
pid 対応するトンネルの PID。
tunnum tun(4) インタフェース番号。
ifnum if_nametoindex(3) によって返されるインタフェースのイン
デックス。
default
デフォルトが振る舞いを保持します。
set reconnect timeout ntries
(CD の喪失もしくは LQR の失敗により) 予想外の回線切断となった場
合、指定した timeout の後に接続が再確立されます。回線は、最大
ntries 回、再接続されます。ntries のデフォルトは、0 です。timeout
に random を指定すると、1 から 30 秒の間の任意時間の停止となりま
す。
set recvpipe [value]
ルーティングテーブルの RECVPIPE 値を設定します。最適な値は、MTU
値を 2 倍した値を丁度越える値です。value が指定されないまたは 0
の場合、デフォルトの、カーネルが制御する値を使用します。
set redial secs[+inc[-max]][.next] [attempts]
ppp に attempts 回のリダイヤルを指示できます。1 より大きな数を指
定した場合 (前述の ``set phone'' 参照)、各番号にダイヤルする前
に、next だけ停止します。最初の番号に戻ってダイヤル開始する前に
secs だけ停止します。リテラル値 ``random'' を secs および next の
ところで使用でき、1 から 30 秒の間の任意時間の停止となります。
inc が指定されると、ppp が新規番号を試すたびに、この値が secs に
加えられます。secs が増加されるのは、最大 max 回だけです。max の
デフォルト値は、10 です。
attempts が経過した後でも secs の遅延は、効果があるので、すぐに手
動でダイヤルしても何も起ってないように見えるかもしれません。すぐ
にダイヤルする必要がある場合、``!'' を ``open'' キーワードの直後
に付けます。更なる詳細については、前述の ``open'' の記述を参照し
てください。
set sendpipe [value]
ルーティングテーブルの SENDPIPE 値を設定します。最適な値は、MTU
値を 2 倍した値を丁度越える値です。value が指定されないまたは 0
の場合、デフォルトの、カーネルが制御する値を使用します。
set server|socket TcpPort|LocalName|none|open|closed [password
[mask]]
このコマンドは、ppp に指定したソケットもしくは `診断ポート' にて
コマンド接続の入力を listen するように指示します。
語 ``none'' は、ppp に既に存在するソケットを閉じさせ、ソケット設
定を消させます。語 ``open'' は、ppp にポートを再度オープンさせま
す。語 ``closed'' は、ppp にオープンしているポートを閉じさせま
す。
ローカルドメインソケットを指定したい場合、LocalName に絶対ファイ
ル名を指定します。そうしないと、TCP ポートの名前もしくは番号であ
ると解釈されます。ローカルドメインソケットに使用される 8 進 umask
を指定可能です。umask の詳細については、umask(2) を参照してくださ
い。TCP ポート名がどのように変換されるかについては、services(5)
を参照してください。
このソケットにクライアントが接続するときに使用されねばならないパ
スワードも指定可能です (前述の ``passwd'' 変数を使用します)。パス
ワードが空文字列として指定される場合、クライアントが接続するとき
にパスワードを必要とされません。
ローカルドメインソケットが指定される場合、ソケット名中の最初の
``%d'' シーケンスは、現在のインタフェースユニット番号で置換されま
す。複数接続のために同一のプロファイルを使用したい場合に便利で
す。
同様の方法で TCP ソケットの前に ``+'' 文字を付けることができま
す。この場合、現在のインタフェースユニット番号が、ポート番号に加
算されます。
ppp をサーバソケットと共に使用する場合、通信機構として pppctl(8)
コマンドを使用することが好ましいです。現在 telnet(1) も使用可能で
すが、将来リンク暗号化が実装されるかもしれませんので、telnet(1)
は、避けてください。
注: SIGUSR1 と SIGUSR2 は、診断ソケットと相互に作用します。
set speed value
シリアルデバイスの速度を指定します。速度指定が ``sync'' の場合、
ppp は、デバイスを同期デバイスとして扱います。
デバイスタイプによっては、同期または非同期のいずれかであることが
分るものがあります。これらのデバイスでは、不正な設定を上書きし
て、この結果に対する警告を記録します。
set stopped [LCPseconds [CCPseconds]]
このオプションが指定されると、指定した FSM (有限状態機械; Finite
State Machine) が停止状態になってから ``seconds'' で指定した秒数
だけ停止したのち、ppp は、タイムアウトします。このオプションは、
相手が終了要求を送り我々が終了確認応答を送ったにもかかわらず実際
には接続を閉じない場合に、有用かもしれません。また、``set
openmode passive'' を使用した場合に相手が指定時間内に Configure
Request を送らないことをタイムアウト検出する場合には、便利かもし
れません。``set log +lcp +ccp'' を使用すると、ppp は、適切な状態
遷移を記録します。
デフォルト値は、0 であり、停止状態による ppp のタイムアウトは、発
生しません。
この値は、openmode の遅延 (上述の ``set openmode'' 参照) より小さ
くなってはなりません。
set timeout idleseconds [mintimeout]
このコマンドは、アイドルタイマの値を指定します。更なる詳細につい
ては、アイドルタイマの設定というタイトルのセクションを参照してく
ださい。
mintimeout が指定された場合、最短でも指定された秒数だけリンクが
アップしていないと、ppp は、アイドルアウトしません。
set urgent [tcp|udp|none] [[+|-]port] ...
このコマンドは、データ転送時に ppp が優先するポートを制御します。
デフォルトの優先 TCP ポートは、ポート 21 (ftp control), 22 (ssh),
23 (telnet), 513 (login), 514 (shell), 543 (klogin), 544 (kshell)
です。優先 UDP ポートは、デフォルトではありません。詳細は、
services(5) を参照してください。
``tcp'' も ``udp'' も指定しないと、``tcp'' が仮定されます。
port を指定しないと、優先ポートリストがクリアされます (``tcp'' ま
たは ``udp'' を指定すると、そのリストのみがクリアされます)。最初
の port 引数にプラス (``+'') またはマイナス (``-'') の接頭辞を付
けた場合、現在のリストが修正されますが、そうでない場合には、再割
り当てされます。プラスの接頭辞付きまたは接頭辞なしの port は、リ
ストに追加され、マイナスの接頭辞付きの port は、リストから削除さ
れます。
``none'' が指定された場合、優先ポートリスト全体が無効になり、
IPTOS_LOWDELAY パケットも特別扱いされなくなります。
set vj slotcomp on|off
このコマンドは、ppp に VJ スロット圧縮をネゴシエートするか否かを
指示します。デフォルトでは、スロット圧縮は、on です。
set vj slots nslots
このコマンドは、最初の slots 番号を指定します。ppp は、VJ 圧縮が
enable されている時には、これを使用して相手とネゴシエートします
(前述の `enable' コマンドを参照してください)。デフォルト値は、16
です。nslots は、4 以上 16 以下の値です。
shell|! [command]
command が指定されない場合、SHELL 環境変数で指定されるシェルが起動さ
れます。そうでなければ指定された command が実行されます。語の置換は、
前述の ``!bg'' コマンドと同様の方法で行われます。
文字 ! を使用する場合、コマンドとの間に空白が必要です。このコマンド
は、フォアグラウンドで実行されることに注意してください - ppp は、プロ
セスが終了するまでは実行を続けません。バックグラウンドでコマンド処理
を行いたい場合には、bg コマンドを使用してください。
show var
このコマンドを使用して、次の内容を確認できます:
show bundle
現在のバンドル設定を表示します。
show ccp
現在の CCP 圧縮統計を表示します。
show compress
現在の VJ 圧縮統計を表示します。
show escape
現在のエスケープ文字を表示します。
show filter [name]
指定したフィルタの現在のルールをリストします。name を指定しない
と、全フィルタが表示されます。
show hdlc
現在の HDLC 統計を表示します。
show help|?
利用可能な show コマンドのまとめを表示します。
show iface
現在のインタフェース情報 (``iface show'' と同じです) を表示しま
す。
show ipcp
現在の IPCP 統計を表示します。
show layers
現在使用中のプロトコル層を表示します。
show lcp
現在の LCP 統計を表示します。
show [data]link
高レベルリンク情報を表示します。
show links
利用可能な論理リンクのリストを表示します。
show log
現在のログ値を表示します。
show mem
現在のメモリ統計を表示します。
show ncp
現在の NCP 統計を表示します。
show physical
現在の下位レベルリンク情報を表示します。
show mp
マルチリンク情報を表示します。
show proto
現在のプロトコルの総計を表示します。
show route
現在の経路表を表示します。
show stopped
現在の stopped タイムアウト値を表示します。
show timer
アクティブアラームタイマを表示します。
show version
ppp の現在のバージョン番号を表示します。
term
端末モードに移行します。キーボードからタイプした文字は、デバイスに送
られます。デバイスから読んだ文字は、スクリーンに表示されます。PPP の
相手が認識された時には、ppp は、自動的にパケットモードを有効にし、コ
マンドモードに戻ります。
更なる詳細
• 設定ファイルの例を読み込みます。それらは、情報の良い情報源です。
• 何が利用可能かに関する、オンライン情報を取得するために ``help'',
``nat ?'', ``enable ?'', ``set ?'' と ``show ?'' を使用します。
• 次の URL は、役に立つ情報を含んでいます:
• http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/ppp.html
• http://www.FreeBSD.org/doc/handbook/userppp.html
関連ファイル
ppp は、次の 4 つのファイルを参照します: ppp.conf, ppp.linkup,
ppp.linkdown と ppp.secret。これらのファイルは、/etc/ppp ディレクトリに置
かれます。
/etc/ppp/ppp.conf
システムのデフォルトの設定ファイル。
/etc/ppp/ppp.secret
各システムのための認証ファイル。
/etc/ppp/ppp.linkup
ppp がネットワークレベルの接続を確立したとき、チェックするファイル。
/etc/ppp/ppp.linkdown
ppp がネットワークレベルの接続をクローズするとき、チェックするファイ
ル。
/var/log/ppp.log
ログ記録とデバッグ情報ファイル。この名前は、/etc/syslog.conf で指定さ
れることに注意してください。さらなる詳細については、syslog.conf(5) を
参照してください。
/var/spool/lock/LCK..*
tty ポートのロックファイル。さらなる詳細については、uucplock(3) を参
照してください。
/var/run/tunN.pid
tunN デバイスに接続されている ppp プログラムのプロセス ID (pid)、ここ
で `N' は、デバイスの番号です。
/var/run/ttyXX.if
このポートによって使用される tun インタフェース。再び、このファイル
は、-background, -auto と -ddial モードでのみ作成されます。
/etc/services
ポート番号がサービスを使用しているなら、ポート番号を取得します。
/var/run/ppp-authname-class-value
マルチリンクモードで、ローカルドメインソケットは、通信相手の認証名
(`authname'), 通信相手の終点識別子クラス (`class') と通信相手の終点識
別子値 (`value') を使用して作成されます。終点識別子値が、バイナリ値で
あるように、実際のファイル名を決定するするため HEX (16 進数) に転換さ
れます。
このソケットは、ppp の異なるインスタンスの間のリンクを渡すために使用
されます。
関連項目
at(1), ftp(1), gzip(1), hostname(1), login(1), tcpdump(1), telnet(1),
kldload(2), pipe(2), socketpair(2), libalias(3), libradius(3), syslog(3),
uucplock(3), netgraph(4), ng_pppoe(4), crontab(5), group(5), passwd(5),
protocols(5), radius.conf(5), resolv.conf(5), syslog.conf(5), adduser(8),
chat(8), getty(8), inetd(8), init(8), named(8), ping(8), pppctl(8),
pppoed(8), route(8), sshd(8), syslogd(8), traceroute(8), vipw(8)
歴史
このプログラムは、元々 Toshiharu OHNO <tony-o@iij.ad.jp> によって書かれ、
Atsushi Murai <amurai@spec.co.jp> によって FreeBSD 2.0.5 に提出されまし
た。
それは、Brian Somers <brian@Awfulhak.org> によって 1997 年の間に大幅に修
正されました、(2.2-RELEASE の直後で) その年の 11 月に OpenBSD に移植され
ました。
ほとんどのコードは、マルチリンク ppp サポートが追加されたとき、1998 年の
初頭に Brian Somers によって書き直されました。
FreeBSD 11.3 March 25, 2017 FreeBSD 11.3