Reviewed by: The Japanese Manual Project <man-jp@jp.FreeBSD.ORG> Submitted by: horikawa@jp.freebsd.org
737 lines
20 KiB
Groff
737 lines
20 KiB
Groff
''' $Header
|
|
'''
|
|
.de Sh
|
|
.\" jpman %Id: xntpdc.8,v 1.3 1997/09/10 04:36:59 yugawa Stab %
|
|
.br
|
|
.ne 5
|
|
.PP
|
|
\fB\\$1\fR
|
|
.PP
|
|
..
|
|
.de Sp
|
|
.if t .sp .5v
|
|
.if n .sp
|
|
..
|
|
.de Ip
|
|
.br
|
|
.ie \\n.$>=3 .ne \\$3
|
|
.el .ne 3
|
|
.IP "\\$1" \\$2
|
|
..
|
|
'''
|
|
''' Set up \*(-- to give an unbreakable dash;
|
|
''' string Tr holds user defined translation string.
|
|
''' Greek uppercase omega is used as a dummy character.
|
|
'''
|
|
.tr \(*W-|\(bv\*(Tr
|
|
.ie n \{\
|
|
.ds -- \(*W-
|
|
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
|
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
|
.ds L" ""
|
|
.ds R" ""
|
|
.ds L' '
|
|
.ds R' '
|
|
'br\}
|
|
.el\{\
|
|
.ds -- \(em\|
|
|
.tr \*(Tr
|
|
.ds L" ``
|
|
.ds R" ''
|
|
.ds L' `
|
|
.ds R' '
|
|
'br\}
|
|
.TH XNTPDC 8 LOCAL
|
|
.SH 名称
|
|
xntpdc - Network Time Protocol デーモンのための問い合わせ、制御プログラム
|
|
.SH 書式
|
|
.B xntpdc
|
|
[
|
|
.B -ilnps
|
|
] [
|
|
.B -c
|
|
.I command
|
|
] [
|
|
.I host
|
|
] [
|
|
.I ...
|
|
]
|
|
.SH 解説
|
|
.I xntpdc
|
|
は、
|
|
.IR xntpd (8)
|
|
デーモンの現在の状態についての問い合わせや、状態の変更を要求する際に使
|
|
われます。このプログラムは、対話的なモードでもコマンドライン引数を
|
|
使った制御でも動作させることができます。
|
|
広範囲にわたる状態や統計の情報が、
|
|
.I xntpdc
|
|
のインタフェースを通じて提供されています。
|
|
それに加えて、
|
|
.I xntpd
|
|
の設定ファイルを使って起動時に指定できるほとんどすべて
|
|
のオプションが、
|
|
.I xntpdc
|
|
を使って、実行時にも指定できます。
|
|
.PP
|
|
.I xntpdc
|
|
が実行されたとき、一つまたは複数のリクエストオプションが、
|
|
コマンドラインに含まれる場合は、それぞれのリクエストは、コマンドライン
|
|
引数で与えられるホスト、またはデフォルトである
|
|
.I localhost
|
|
の NTP サーバに送られます。
|
|
リクエストオプションが付けられなかったとき、
|
|
.I xntpdc
|
|
はコマンドを標準入力から読み込もうとし、コマンドラインで与えられた
|
|
最初のホストで走っている NTP サーバに対してそのコマンドを実行します。
|
|
ホストが指定されなかったときは、
|
|
デフォルトである
|
|
.I localhost
|
|
のサーバに対して実行します。
|
|
.I xntpdc
|
|
は、標準入力が端末である場合だけ、プロンプトを出します。
|
|
.PP
|
|
.I xntpdc
|
|
は、 NTP サーバとの通信に NTP mode 7 パケットを使うため、
|
|
ネットワーク上でそれを許すような互換サーバへの問い合わせに使えます。
|
|
NTP は UDP プロトコルなので、特にネットワークトポロジー的に遠くに
|
|
ある場合は、この通信はやや信頼性に欠けるということを覚えておいて下さい。
|
|
.I xntpdc
|
|
は、リクエストを再送する試みを行ないません。適当なタイムアウト時間の
|
|
範囲内でリモートホストから返答がなかったときは、時間切れとなります。
|
|
.PP
|
|
コマンドラインオプションは以下の通りです。
|
|
.B -i
|
|
または
|
|
.B -n
|
|
以外のコマンドラインオプションを指定すると、指定したホスト (群) に、
|
|
指定した問い合わせ (または複数の問い合わせ) を直ちに送ることになります。
|
|
指定しなかった場合、
|
|
.I xntpdc
|
|
は標準入力から対話的なフォーマットのコマンドを読み込もうとします。
|
|
.Ip -c 8
|
|
次の引数が対話的なフォーマットのコマンドとして解釈され、指定したホストで
|
|
実行されるようにコマンドのリストに加えられます。
|
|
複数の
|
|
.B -c
|
|
オプションを与えることができます。
|
|
.Ip -i 8
|
|
.I xntpdc
|
|
を強制的に対話的モードで動作させます。標準出力にプロンプトが
|
|
表示され、標準入力からコマンドが読み込まれます。
|
|
.Ip -l 8
|
|
サーバに既知の peer のリストを取得します。このスイッチは、
|
|
\*(L"-c listpeers\*(R" と同等です。
|
|
.Ip -n 8
|
|
すべてのホストアドレスを、標準的なホスト名でなく、ドット区切りの 4 個
|
|
の数値で出力します。
|
|
.Ip -p 8
|
|
サーバに既知の peer のリストと、それらの状況の要約を出力します。
|
|
これは、 \*(L"-c peers\*(R" と同等です。
|
|
.Ip -s 8
|
|
サーバに既知の peer のリストと、それらの状況の要約を、
|
|
.B -p
|
|
スイッチとは少し異なるフォーマットで出力します。
|
|
これは \*(L"-c dmpeers\*(R" と同等です。
|
|
.SH 内部コマンド
|
|
.PP
|
|
対話的なフォーマットのコマンドは、キーワードとそれに続く 0 から 4 個の
|
|
引数から構成されます。キーワード全長のうち、他と区別できる文字数が
|
|
タイプされれば、有効になります。
|
|
コマンドの出力は通常標準出力に送られますが、コマンドライン上で
|
|
\*(L">\*(R" に続けてファイル名を指定することで、個々のコマンドの出力を
|
|
ファイルに送ることができます。
|
|
.PP
|
|
いくつかの対話的フォーマットのコマンドは、
|
|
.I xntpdc
|
|
プログラム自身の中で全体が実行され、サーバへの NTP mode 7 リクエストは
|
|
送られません。この種類のコマンドには以下の物があります。
|
|
.PP
|
|
.B ?
|
|
[
|
|
.I command_keyword
|
|
]
|
|
.PP
|
|
\*(L"?\*(R" のみのコマンドは、
|
|
.I xntpdc
|
|
が知っているすべてのコマンドキーワードのリストを出力します。
|
|
\*(L"?\*(R" とそれに続くコマンドキーワードは、コマンドの機能と用法を
|
|
出力します。このコマンドは、
|
|
.I xntpdc
|
|
に関して、このマニュアルよりも多分良い情報源となるでしょう。
|
|
.PP
|
|
.B help
|
|
[
|
|
.I command_keyword
|
|
]
|
|
.PP
|
|
.B ?
|
|
コマンドと同義です。
|
|
.PP
|
|
.B timeout
|
|
.I millseconds
|
|
.PP
|
|
サーバ問い合わせに対する応答のタイムアウト時間を指定します。デフォルト
|
|
は、約 8000 ミリ秒です。
|
|
.PP
|
|
.B delay
|
|
.I milliseconds
|
|
.PP
|
|
認証を求めるリクエストに含まれるタイムスタンプに加えられる時間を
|
|
指定します。これは、長い遅延のあるネットワーク経路や時刻の同期していない
|
|
マシン間で (信頼できない) サーバの再設定ができるようにするために
|
|
使われます。
|
|
.PP
|
|
.B host
|
|
.I hostname
|
|
.PP
|
|
問い合わせを送るホストを指定します。
|
|
.I hostname
|
|
は、ホスト名でも数値アドレス (ドット区切りの数値 4 つ) でもかまいません。
|
|
.PP
|
|
.B keyid
|
|
.I #
|
|
.PP
|
|
このコマンドで、認証設定リクエストに使われるキー番号を指定できます。
|
|
この番号は、この目的で使うためにサーバが設定したキー番号に一致して
|
|
いなければなりません。
|
|
.PP
|
|
.B passwd
|
|
.PP
|
|
このコマンドは、認証設定リクエストに使われるパスワードの入力
|
|
(エコーされません) を求めるプロンプトを出します。
|
|
このリクエストが成功するためには、NTP サーバが認証のために使うよう
|
|
設定したキーに、パスワードが一致していなければなりません。
|
|
.PP
|
|
.B "hostnames yes|no"
|
|
.PP
|
|
\*(L"yes\*(R" が指定されると、情報の表示の際、ホスト名が使用されます。
|
|
\*(L"no\*(R" が与えられると、代わりに数値アドレスが使用されます。
|
|
コマンドラインの
|
|
.B -n
|
|
スイッチが使われなければ、
|
|
デフォルトは \*(L"yes\*(R" になります。
|
|
.PP
|
|
.B quit
|
|
.PP
|
|
.I xntpdc
|
|
を終了します。
|
|
.SH 問い合わせコマンド
|
|
.PP
|
|
問い合わせコマンドは、情報を要求する NTP mode 7 パケットをサーバに送ります。
|
|
これらは、サーバの設定状態を変更できない \*(L"読み込み専用\*(R" コマンドです。
|
|
.PP
|
|
.B listpeers
|
|
.PP
|
|
サーバが状態を管理する peer の簡略なリストを得て、出力します。
|
|
これには、サーバが同期する予定の候補であるとみなす階層の peer を含めた、
|
|
すべての設定された隣接 peer を含んでいるはずです。
|
|
.PP
|
|
.B peers
|
|
.PP
|
|
サーバが状態を管理する peer と、その状態の要約を出力します。
|
|
状態の要約は、以下のものを含みます。すなわち、リモート peer のアドレス、
|
|
ローカルインタフェースアドレス (ローカルアドレスが決まっていないなら
|
|
0.0.0.0) 、リモート peer の階層 (階層 16 は、リモートの peer が同期していない
|
|
事を示します)、秒で表すポーリング間隔、8 進で表す到達可能性レジスタ、
|
|
peer の現在の遅れ、オフセット、バラツキの秒で表した推定値です。
|
|
更に、左端の文字は、この peer エントリが操作しているモードを
|
|
示します。 \*(L"+\*(R" は symmetric active を、 \*(L"-\*(R" は、
|
|
symmetric passive を表し、 \*(L"=\*(R" は、リモートサーバが
|
|
クライアントモードでポーリングされていることを意味し、 \*(L"^\*(R" は、
|
|
サーバがこのアドレスに broadcast していることを示し、 \*(L"~\*(R" は、
|
|
リモート peer が broadcast を送っていることを示し、 \*(L"*\*(R" は、
|
|
サーバが現在同期している peer であることを示します。
|
|
.PP
|
|
ホストフィールドの内容は、ホスト名、IP アドレス、パラメータと
|
|
参照時刻実装名、 \*(L"REFCLK(<implementation number>,
|
|
<parameter>)\*(R" の
|
|
4 つの形のうち一つです。 \*(L"hostnames no\*(R" の状態では、
|
|
IP アドレスだけが表示されます。
|
|
.PP
|
|
.B dmpeers
|
|
.PP
|
|
少々異なる peer 要約リストです。
|
|
行の左端の文字以外は
|
|
.B peers
|
|
と同じ出力になります。
|
|
文字は、時刻選択アルゴリズムの最後のステージに含まれる peer の隣にだけ
|
|
現れます。 \*(L".\*(R" は、誤りチェッカの検出でその peer が捨てられた
|
|
ことを、 \*(L"+\*(R" はチェッカにより同期対象として適切であると判断された
|
|
ことを示します。
|
|
\*(L"*\*(R" は、サーバが現在同期している peer であることを
|
|
示しています。
|
|
.PP
|
|
.B showpeer
|
|
.I peer_address
|
|
[
|
|
.I addr2
|
|
] [
|
|
.I addr3
|
|
] [
|
|
.I addr4
|
|
]
|
|
.PP
|
|
一つ以上の peer の、現在の詳細な内容を表示します。
|
|
値については、 NTP バージョン 2 仕様に詳しく述べられています。
|
|
.PP
|
|
.B pstats
|
|
.I peer_address
|
|
[
|
|
.I addr2
|
|
] [
|
|
.I addr3
|
|
] [
|
|
.I addr4
|
|
]
|
|
.PP
|
|
指定した peer に関連する統計カウンタを peer 毎に表示します。
|
|
.PP
|
|
.B clockinfo
|
|
.I clock_peer_address
|
|
[
|
|
.I addr2
|
|
] [
|
|
.I addr3
|
|
] [
|
|
.I addr4
|
|
]
|
|
.PP
|
|
peer クロックに関する情報を得て、それを表示します。得られた値は、
|
|
設定上のあいまいな要因の情報と他のクロックの性能の情報を
|
|
提供してくれます。
|
|
.PP
|
|
.B kerninfo
|
|
.PP
|
|
カーネルの phase-lock ループ操作パラメータを得て、それを表示します。
|
|
この情報は、精度の高い時刻保持機能のために、カーネルが特に
|
|
修正されている場合にだけ得られます。
|
|
.PP
|
|
.B loopinfo
|
|
[
|
|
.B oneline|multiline
|
|
]
|
|
.PP
|
|
選択されたループフィルタ変数の値を表示します。ループフィルタとは、
|
|
ローカルシステムクロックの調節を行なう NTP の一部です。
|
|
\*(L"offset\*(R" は、パケット処理コードによってループフィルタに
|
|
与えられる最後のオフセットです。 \*(L"frequency\*(R" は、
|
|
parts-per-million (ppm) で表わされるローカルクロックの周波数誤差です。
|
|
\*(L"time_const\*(R" は、 phase-lock ループの"堅固さ"を制御し、
|
|
その速度で発振器のゆらぎを調節します。 \*(L"watchdog timer\*(R" の値は、
|
|
ループフィルタに最後のサンプルのオフセットが与えられてから経過した秒数です。
|
|
\*(L"oneline\*(R" と \*(L"multiline\*(R" オプションはこの情報が
|
|
出力されるフォーマットの指定で、 \*(L"multiline\*(R" がデフォルトです。
|
|
.PP
|
|
.B sysinfo
|
|
.PP
|
|
システム状態変数、すなわち、ローカルサーバに関する状態の変化を
|
|
表示します。
|
|
最後の 4 行以外は、皆 NTP バージョン 3 仕様である RFC 1305 で
|
|
述べられています。 \*(L"system flags\*(R" は、いろいろなシステムフラグ
|
|
を表示し、一部は \*(L"enable\*(R" 及び \*(L"disable\*(R" 設定コマンド
|
|
で、それぞれの設定やクリアができます。 \*(L"stability\*(R" は、
|
|
システム周波数の修正がされた後に残る残留周波数誤差で、
|
|
保守やデバッグに使われます。
|
|
多くのアーキテクチャでは、この値は初期の 500 ppm 程度から、.01 から 0.1 ppm
|
|
という低い範囲にまで減少します。
|
|
もしデーモンが起動されてからも、この値が高いままである場合は、
|
|
ローカルな時計がどこかおかしいか、カーネル変数 \*(L"tick\*(R" が
|
|
間違っているかもしれません。 \*(L"broadcastdelay\*(R" は、
|
|
\*(L"broadcastdelay\*(R" 変更コマンドで設定されるデフォルトの
|
|
ブロードキャスト遅延時間を表示し、 \*(L"authdelay\*(R" は、
|
|
\*(L"authdelay\*(R"変更コマンドで設定されるデフォルトの認証遅延時間を
|
|
表示します。
|
|
.PP
|
|
.B sysstats
|
|
.PP
|
|
プロトコルモジュールで管理される統計カウンタを表示します。
|
|
.PP
|
|
.B memstats
|
|
.PP
|
|
メモリ割り当てコードに関する統計カウンタを表示します。
|
|
.PP
|
|
.B iostats
|
|
.PP
|
|
入力\-出力モジュールで管理される統計カウンタを表示します。
|
|
.PP
|
|
.B timerstats
|
|
.PP
|
|
timer/event キューをサポートするコードで管理される統計カウンタを
|
|
表示します。
|
|
.PP
|
|
.B reslist
|
|
.PP
|
|
サーバの制限リストを得て、表示します。このリストは、
|
|
(通常) ソートされた順で出力され、制限がどのように適用されるかを
|
|
理解する助けになるかもしれません。
|
|
.PP
|
|
.B monlist
|
|
[
|
|
.I version
|
|
]
|
|
.PP
|
|
モニタ機能により収集、管理されるトラフィックカウントの値を得て、表示します。
|
|
通常、バージョン番号は指定する必要がありません。
|
|
.PP
|
|
.B clkbug
|
|
.I clock_peer_address
|
|
[
|
|
.I addr2
|
|
] [
|
|
.I addr3
|
|
] [
|
|
.I addr4
|
|
]
|
|
.PP
|
|
時刻参照ドライバのデバッグ情報を得ます。この情報は、
|
|
一部のクロックドライバでだけ提供され、
|
|
ドライバのソースのコピーが手元に無い場合、ほとんどデコードできません。
|
|
.SH 実行時設定リクエスト
|
|
.PP
|
|
サーバ内で状態を変更するようなリクエストは、すべてサーバが設定した NTP
|
|
キーを使って認証されます
|
|
(この機能はキーを設定しないことで、無効にもできます) 。
|
|
キー番号とそれに対応するキーも、
|
|
.I xtnpdc
|
|
が知っていなければなりません。
|
|
これは、
|
|
.B keyid
|
|
と
|
|
.B passwd
|
|
コマンドを使えば可能で、後者では、暗号化されたキーを使うために
|
|
パスワードを求めるプロンプトを端末に出します。
|
|
サーバへの認証リクエストを必要とするコマンドが最初に実行された場合でも、
|
|
自動的にキー番号とパスワードの入力を要求します。
|
|
認証は、そのような変更をする権限を持っているリクエストであるかを
|
|
検証するだけでなく、送信エラーに対するより一層の保護を行う事になります。
|
|
.PP
|
|
認証リクエストは、常にパケットデータの中に、認証コードの計算に
|
|
含まれているタイムスタンプを含んでいます。
|
|
このタイムスタンプは、サーバによって受信時刻と比較されます。この差がある小さな
|
|
値より大きければ、リクエストは拒否されます。これには二つの理由があります。
|
|
一つは、あなたの LAN のトラフィックを盗み聞きできる誰かによるサーバへの
|
|
単純かつ繰り返しによる攻撃を困難にします。二つ目は、ネットワーク的に
|
|
離れたホストから、あなたのサーバへ設定変更リクエストを行なうことを
|
|
困難にします。
|
|
再設定は、ローカルホストのサーバに対しては簡単で、時刻同期した
|
|
同じ LAN 上のホストでも普通に行なえますが、より離れたホストでは
|
|
やりにくくなっています。
|
|
したがって、適当なパスワードを選択し、キーの配布と防護に注意を払い、
|
|
適切なソースアドレス制限が施されれば、実行時再設定の機能については
|
|
適切なセキュリティレベルにあることになります。
|
|
.PP
|
|
以下のコマンドは皆、認証リクエストです。
|
|
.PP
|
|
.B addpeer
|
|
.I peer_address
|
|
[
|
|
.I keyid
|
|
] [
|
|
.I version#
|
|
] [
|
|
.B prefer
|
|
]
|
|
.PP
|
|
与えられたアドレスを設定された隣接 peer として追加し、symmetric active
|
|
モードで動作します。
|
|
既に隣接 peer として設定されている peer を指定した場合、その peer は
|
|
このコマンドが実行されたときに削除
|
|
されるか、単に新しい設定に従うよう適当に変更されます。
|
|
オプションの \*(L"keyid\*(R" が 0 でない整数の場合、リモートサーバに
|
|
出ていくすべてのパケットは、このキーにより暗号化された
|
|
認証フィールドを持つことになります。値が 0 の場合
|
|
(または指定されなかった場合)、認証は行なわれません。
|
|
\*(L"version#\*(R" は、1, 2, 3 のどれか
|
|
となり、デフォルトは 3 です。 \*(L"prefer\*(R" キーワードは、
|
|
優先する peer を示します(その結果、可能であれば時刻同期の主要元として
|
|
使用されます)。
|
|
優先する peer は、 PPS 信号の信頼性も決めます。優先する peer が同期に
|
|
適している場合、PPS 信号も信頼できると判断されます。
|
|
.PP
|
|
.B addserver
|
|
.I peer_address
|
|
[
|
|
.I keyid
|
|
] [
|
|
.I version#
|
|
] [
|
|
.B prefer
|
|
]
|
|
.PP
|
|
操作モードがクライアントであること以外は、
|
|
.B addpeer
|
|
コマンドと同等です。
|
|
.PP
|
|
.B broadcast
|
|
.I peer_address
|
|
[
|
|
.I keyid
|
|
] [
|
|
.I version#
|
|
]
|
|
.PP
|
|
操作モードが broadcast であること以外は、
|
|
.B addpeer
|
|
コマンドと同等です。この場合、正当なキー識別子とキーが
|
|
必要になります。 \*(L"peer_address\*(R" パラメータは、
|
|
ローカルネットワークのブロードキャストアドレスか、または NTP に
|
|
割り当てられたマルチキャストグループアドレス にできます。
|
|
マルチキャストアドレスの場合、マルチキャストに対応したカーネルが
|
|
必要になります。
|
|
.PP
|
|
.B unconfig
|
|
.I peer_address
|
|
[
|
|
.I addr2
|
|
] [
|
|
.I addr3
|
|
] [
|
|
.I addr4
|
|
]
|
|
.PP
|
|
このコマンドは、指定した peer (群) から設定されている bit を除きます。
|
|
多くの場合、これによって隣接 peer の設定が削除されることになります。
|
|
しかしながら、リモートの peer が設定されていない状態のまま継続しようとし、
|
|
それが適切である場合は、隣接関係は、設定されていないモードのまま残る場合も
|
|
あります。
|
|
.PP
|
|
.B fudge
|
|
.I peer_address
|
|
[
|
|
.I time1
|
|
] [
|
|
.I time2
|
|
] [
|
|
.I stratum
|
|
] [
|
|
.I refid
|
|
]
|
|
.PP
|
|
このコマンドは、あるデータを参照時刻としてセットすることができます。
|
|
詳しい情報は、ソースリストを見て下さい。
|
|
.PP
|
|
.B enable auth|bclient|pll|monitor|stats
|
|
[
|
|
.I ...
|
|
]
|
|
.PP
|
|
各種サーバオプションを有効にします。言及されていないフラグ
|
|
は影響を受けません。 \*(L"auth\*(R" フラグは、 peer が信頼できるキーと
|
|
キー識別子を使って正しく認証されたときだけ、設定されていない
|
|
peer にサーバを同期させます。
|
|
デフォルトは無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバが
|
|
ブロードキャストサーバやマルチキャストサーバからのメッセージを
|
|
聞く (listen) ようにして、 自動的にそのサーバと隣接関係を設定します。
|
|
デフォルトは無効 (オフ) です。 \*(L"pll\*(R" フラグは、
|
|
サーバがローカルクロックを修正するようにします。
|
|
デフォルトは有効 (オン) です。これが設定されていないと、ローカルクロック
|
|
は内部の時間および周波数オフセットによって勝手に動作することになります。
|
|
このフラグは、ローカルクロックが他のデバイスやプロトコルにより
|
|
制御されていて、 NTP は他のクライアントが同期するためだけに使われるような
|
|
場合に便利です。 \*(L"monitor\*(R" フラグは、
|
|
モニタ機能 (他を参照のこと) を可能にするもので、
|
|
デフォルトは無効 (オフ) です。 \*(L"stats\*(R" フラグは、統計機能
|
|
ファイル出力 (他の説明を参照のこと) を可能にします。
|
|
デフォルトは、有効 (オン) です。
|
|
.PP
|
|
.B disable auth|bclient|pll|monitor|stats
|
|
[
|
|
.I ...
|
|
]
|
|
.PP
|
|
各種サーバオプションを無効 (オフ) にします。言及されていない
|
|
フラグは影響を受けません。現在有効なフラグは、 enable コマンドのところで
|
|
述べられています。
|
|
.PP
|
|
.B restrict
|
|
.I address
|
|
.I mask
|
|
.I flag
|
|
[
|
|
.I flag
|
|
]
|
|
.PP
|
|
フラグ (群) を存在する制限リストエントリに加えるか、または指定した
|
|
フラグ (群) で新しいエントリをリストにつけ加えます。
|
|
可能なフラグ引数の選択は、以下の通りとなります:
|
|
.Ip ignore 10
|
|
このエントリにマッチするホストからのすべてのパケットを無視します。
|
|
このフラグが指定されると、どんな問い合わせやタイムサーバの
|
|
ポーリングにも反応しなくなります。
|
|
.Ip noquery 10
|
|
ソースからの NTP mode 7 のパケット
|
|
(すなわち、情報問い合わせと設定リクエスト) をすべて無視します。
|
|
時刻サービスは影響されません。
|
|
.Ip nomodify 10
|
|
サーバの状態を変更しようとする NTP mode 7 のパケット (すなわち、
|
|
実行時再設定) をすべて無視します。
|
|
情報を返すような問い合わせは許されます。
|
|
.Ip notrap 10
|
|
一致するホストへの、モード 6 制御メッセージのトラップサービスを
|
|
提供しません。このトラップサービスはモード 6 制御メッセージプロトコルの
|
|
サブシステムで、リモートイベントの記録を行うようなプログラムで使用される
|
|
事を意図しています。
|
|
.Ip lowpriotrap 10
|
|
一致するホストによるトラップの優先度を低くします。
|
|
サーバが管理できるトラップの数は制限されています (現在の制限は 3)。
|
|
トラップは、通常早い物勝ちベースで割り当てられ、制限に達すると以降の
|
|
トラップ要求は拒否されます。このフラグは割り当てアルゴリズムを変更し、
|
|
優先度の低いトラップは後から発生した通常の優先度のトラップ要求により
|
|
無効にされるようになります。
|
|
.Ip noserve 10
|
|
モードが 7 以外の NTP パケットを無視します。要するに、問い合わせは受け
|
|
付けるが、時刻サービスは拒否することになります。
|
|
.Ip nopeer 10
|
|
問い合わせて来たホストに、状態を保存しない時刻サービスを行ないます。
|
|
しかし、たとえ将来同期先の相手として便利だとしても、
|
|
これらのホストには peer メモリのリソースを割り当てません。
|
|
.Ip notrust 10
|
|
これらのホストを同期する元としては決して使用しませんが、その他の
|
|
部分では通常に扱います。
|
|
.Ip limited 10
|
|
これらのホストは同一のネットからのクライアントの数の制限を受けます。
|
|
この文脈でいう
|
|
ネットとは、ネットの IP の概念 (クラス A 、クラス B 、クラス C 等) を
|
|
指します。
|
|
サーバが認識している \*(L"client_limit\*(R" 以下のホスト数で、
|
|
過去 \*(L"client_limit_period\*(R" 秒間アクティブ
|
|
だったホストは受け入れられます。同じネットの他のクライアントからの
|
|
リクエストは、拒否されます。時刻リクエストパケットだけが考慮されます。
|
|
\*(L"private\*(R" と \*(L"control\*(R" と
|
|
\*(L"broadcast\*(R" のパケットは、クライアントの制限を受けず、
|
|
したがってクライアント数にも数えられません。
|
|
クライアントの履歴は、
|
|
.I xntpd
|
|
のモニタ機能により保存されます。
|
|
したがって、モニタ機能は、 \*(L"limited\*(R" フラグで制限されたエントリが
|
|
ある限り機能します。
|
|
デフォルトの \*(L"client_limit\*(R" 値は 3 です。
|
|
デフォルトの \*(L"client_limit_period\*(R" 値は 3600 秒です。
|
|
現在、どちらの変数も実行時には変更できません。
|
|
.Ip ntpport 10
|
|
これは制限フラグというより、実際にはマッチアルゴリズム修飾子です。
|
|
これがあると、パケットのソースポートが標準 NTP UDP ポート (123) である
|
|
場合だけ、制限エントリがマッチします。
|
|
\*(L"ntpport\*(R" と non\-\*(L"ntpport\*(R" の両方が指定できます。
|
|
\*(L"ntpport\*(R" の方がより特別に扱われ、リスト中で
|
|
後ろの方にソートされます。
|
|
.PP
|
|
.B unrestrict
|
|
.I address
|
|
.I mask
|
|
.I flag
|
|
[
|
|
.I flag
|
|
]
|
|
.PP
|
|
.I address
|
|
や
|
|
.I mask
|
|
の引数で指定された制限リストエントリから、指定されたフラグを除きます。
|
|
.PP
|
|
.B delrestrict
|
|
.I address
|
|
.I mask
|
|
[
|
|
.B ntpport
|
|
]
|
|
.PP
|
|
制限リストから一致するエントリを削除します。
|
|
.PP
|
|
.B "monitor yes|no"
|
|
.PP
|
|
モニタ機能を有効または無効にします。
|
|
.B "monitor no"
|
|
に続けて
|
|
.B "monitor yes"
|
|
コマンドを送るのは、パケット数をリセットする良い方法です。
|
|
.PP
|
|
.B readkeys
|
|
.PP
|
|
現在の認証キーのセットを一掃し、キーファイル (これは
|
|
.I xntpd
|
|
設定ファイルの中で指定されていなければなりません) の
|
|
再読み込みを行なって新しいセットにします。
|
|
こうすることで、サーバを再スタートさせずに暗号化キーの変更ができます。
|
|
.PP
|
|
.B trustkey
|
|
.I keyid
|
|
[
|
|
.I keyid
|
|
] [
|
|
.I keyid
|
|
] [
|
|
.I keyid
|
|
]
|
|
.PP
|
|
一つないしそれ以上のキーを、信頼キーリストに加えます。
|
|
認証が有効になっているとき、信頼性のある時刻を持つ peer は、
|
|
信頼キーを使って認証されなければなりません。
|
|
.PP
|
|
.B untrustkey
|
|
.I keyid
|
|
[
|
|
.I keyid
|
|
] [
|
|
.I keyid
|
|
] [
|
|
.I keyid
|
|
]
|
|
.PP
|
|
一つないしそれ以上のキーを、信頼キーリストから削除します。
|
|
.PP
|
|
.B authinfo
|
|
.PP
|
|
既知のキーや実行された暗号化、復号化の数を含む、認証モジュールに関する
|
|
情報を返します。
|
|
.PP
|
|
.B setprecision
|
|
.I precision_value
|
|
.PP
|
|
サーバが通知する精度の値を設定します。
|
|
値は、 -4 から -20 の範囲の負の整数でなければなりません。
|
|
.PP
|
|
.B traps
|
|
.PP
|
|
サーバに設定されているトラップを表示します。
|
|
詳しくはソースリストを参照して下さい。
|
|
.PP
|
|
.B addtrap
|
|
.I address
|
|
[
|
|
.I port
|
|
] [
|
|
.I interface
|
|
]
|
|
.PP
|
|
非同期メッセージのトラップをセットします。
|
|
詳しくはソースリストを参照して下さい。
|
|
.PP
|
|
.B clrtrap
|
|
.I address
|
|
[
|
|
.I port
|
|
] [
|
|
.I interface
|
|
]
|
|
.PP
|
|
非同期メッセージのトラップを解除します。
|
|
詳しくはソースリストを参照して下さい。
|
|
.PP
|
|
.B reset ...
|
|
.PP
|
|
サーバのいろいろなモジュールのなかの統計カウンタをクリアします。
|
|
詳しくはソースリストを参照して下さい。
|
|
.SH 関連項目
|
|
.PP
|
|
.IR xntpd (8)
|
|
.SH 歴史
|
|
.PP
|
|
Toronto 大学の Dennis Ferguson によって書かれました。
|
|
.SH バグ
|
|
.PP
|
|
.I xntpdc
|
|
は、未完成のハックです。表示される情報の多くは死ぬほど退屈で、実装した
|
|
人間だけに気に入られるものです。このプログラムは、新しい (一時的な)
|
|
仕様を追加し易いようデザインされており、使いやすくするには手間が
|
|
かかります。それでも、このプログラムは、場合によっては有用です。
|