620 lines
20 KiB
Groff
620 lines
20 KiB
Groff
.\"
|
|
.\" %FreeBSD: src/usr.sbin/ntp/doc/ntpdc.8,v 1.12 2004/07/03 18:35:51 ru Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.Dd January 7, 2000
|
|
.\" WORD: dotted-quad form ドットで 4 つの部分に区切られた形式
|
|
.\" WORD: local clock ローカル時計
|
|
.\" WORD: request リクエスト (名詞の場合)
|
|
.\" WORD: common key 共通鍵
|
|
.\" WORD: key identifier 鍵の識別子
|
|
.\" WORD: key number 鍵番号
|
|
.\" WORD: The following options are available:
|
|
.\" WORD: 以下のオプションが使用可能です:
|
|
.\" WORD: falsetick 偽時計
|
|
.\" WORD: the precision time kernel modifications are in use
|
|
.\" WORD: カーネルに高精度な時刻保持のための変更がなされている
|
|
.\" WORD: discipline 規律
|
|
.\" WORD: association
|
|
.\" WORD: 無理に訳さなかった (ntp.conf.5, ntpq.8 とは不整合)
|
|
.\" WORD: reference clock 参照クロック
|
|
.\" WORD: symmetric active 対称的アクティブ
|
|
.\" WORD: symmetric passive 対称的パッシブ
|
|
.Dt NTPDC 8
|
|
.Os
|
|
.Sh 名称
|
|
.Nm ntpdc
|
|
.Nd NTP の特別な問い合わせプログラム
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl ilnps
|
|
.Op Fl c Ar command
|
|
.Op Ar host ...
|
|
.Sh 解説
|
|
.Nm
|
|
ユーティリティは
|
|
.Xr ntpd 8
|
|
デーモンの現在の状態について問い合わせたり、状態の変更を要求する際に使
|
|
われます。このプログラムは、対話的モードで実行させることも
|
|
コマンドライン引数を使って制御することもできます。
|
|
広範囲にわたる状態や統計の情報が、
|
|
.Nm
|
|
のインタフェースを通じて提供されています。
|
|
それに加えて、
|
|
.Xr ntpd 8
|
|
の設定ファイルを使って起動時に指定できるほとんどすべて
|
|
の設定オプションが、
|
|
.Nm
|
|
を使って、実行時にも指定できます。
|
|
.Pp
|
|
以下のオプションが使用可能です:
|
|
.Bl -tag -width indent
|
|
.It Fl c Ar command
|
|
次の引数が対話的なフォーマットのコマンドとして解釈され、
|
|
指定されたホスト (群) 上で実行すべきコマンドのリストに
|
|
付け加えられます。
|
|
複数の
|
|
.Fl c
|
|
オプションを与えることもできます。
|
|
.It Fl i
|
|
.Nm
|
|
を強制的に対話的モードで動作させます。標準出力にプロンプトが
|
|
表示され、標準入力からコマンドが読み込まれます。
|
|
.It Fl l
|
|
サーバ (群) が知っている通信相手 (peer) のリストを取得します。
|
|
このスイッチは、
|
|
.Ql -c listpeers
|
|
と同等です。
|
|
.It Fl n
|
|
すべてのホストアドレスを、ドットで 4 つの部分に区切られた数値の形式で出力し、
|
|
正規のホスト名に変換しません。
|
|
.It Fl p
|
|
サーバが知っている通信相手のリストと、それらの状態の概要を出力します。
|
|
これは、
|
|
.Ql -c peers
|
|
と同等です。
|
|
.It Fl s
|
|
サーバが知っている通信相手のリストと、それらの状態の概要を、
|
|
.Fl p
|
|
スイッチとは少し異なるフォーマットで出力します。
|
|
これは
|
|
.Ql -c dmpeers
|
|
と同等です。
|
|
.El
|
|
.Pp
|
|
.Nm
|
|
が実行されたとき、1 つ以上のリクエストオプションが
|
|
コマンドラインに含まれる場合は、それぞれのリクエストは、コマンドライン
|
|
引数で与えられた各ホスト (デフォルトでは
|
|
localhost)
|
|
で動いている NTP サーバに送られます。
|
|
リクエストオプションが与えられなかった場合、
|
|
.Nm
|
|
は、コマンドを標準入力から読み込み、
|
|
コマンドラインで指定された最初のホストで動いている
|
|
NTP サーバに対して実行しようとします。
|
|
このときも、
|
|
ホストが指定されていないときは、デフォルトで
|
|
localhost
|
|
になります。
|
|
.Nm
|
|
ユーティリティは、
|
|
標準入力が端末である場合は、プロンプトを出してコマンドを受け付けます。
|
|
.Pp
|
|
.Nm
|
|
ユーティリティは、NTP サーバとの通信に NTP モード 7 パケットを使うため、
|
|
ネットワーク上でそれを許すような互換サーバへの問い合わせに使用できます。
|
|
NTP は UDP のプロトコルなので、特にネットワークトポロジ的に
|
|
遠くにある場合は、この通信はやや信頼性に欠けるということに注意して
|
|
ください。
|
|
.Nm
|
|
ユーティリティは、リクエストを再送する試みを行ないません。適当な制限時間の
|
|
範囲内でリモートホストから返事がなかったときは、時間切れとなります。
|
|
.Pp
|
|
.Nm
|
|
の動作は
|
|
.Xr ntpd 8
|
|
の特定の実装に特化しており、このデーモンまたは、古いバージョンのものの
|
|
いくつかに対してしか動かないでしょう。
|
|
リモートの
|
|
.Nm
|
|
ユーティリティからのリクエストがローカルサーバの状態を変更する場合は、
|
|
そのリクエストが認証される必要があります。その際に、
|
|
リモートプログラムとローカルサーバの両方が共通鍵と鍵の識別子を共有する
|
|
ことが必要です。
|
|
.Fl i
|
|
または
|
|
.Fl n
|
|
以外のコマンドラインオプションを指定すると、指定したホスト (群) に、
|
|
指定した問い合わせ (または複数の問い合わせ) を直ちに送ることになります。
|
|
指定しなかった場合、
|
|
.Nm
|
|
は標準入力から対話的なフォーマットのコマンドを読み込もうとします。
|
|
.Ss 対話的コマンド
|
|
対話的なフォーマットのコマンドは、キーワードとそれに続く 0 から 4 個の
|
|
引数から構成されます。キーワード全長のうち、他と区別できる文字数が
|
|
タイプされれば、有効になります。
|
|
コマンドの出力は通常標準出力に送られますが、コマンドライン上で
|
|
.\"kuma 英語版は .Ql \&; であった。訂正要求を send-pr 予定
|
|
.Ql \&>
|
|
に続けてファイル名を指定することで、個々のコマンドの出力を
|
|
ファイルに送ることができます。
|
|
.Pp
|
|
いくつかの対話的フォーマットのコマンドは、
|
|
.Nm
|
|
ユーティリティ自身の中で全体が実行され、サーバへの NTP モード 7 リクエストは
|
|
送られません。この種類のコマンドには以下のものがあります:
|
|
.Bl -tag -width indent
|
|
.It Ic \&? Ar command_keyword
|
|
.It Ic help Ar command_keyword
|
|
単独の
|
|
.Ic \&?
|
|
は、
|
|
.Nm
|
|
が知っているすべてのコマンドキーワードのリストを出力します。
|
|
.Ic \&?
|
|
の後にコマンドキーワードが続くときは、コマンドの機能と用法を出力します。この
|
|
コマンドは、
|
|
.Xr ntpq 8
|
|
に関して、多分このマニュアルよりも良い情報源となるでしょう。
|
|
.It Ic delay Ar milliseconds
|
|
認証を求めるリクエストに含まれるタイムスタンプに加えられる時間間隔を
|
|
指定します。これは、長い遅延のあるネットワーク経路や時計の同期していない
|
|
マシン間で (信頼できない) サーバの再設定ができるようにするために
|
|
使われます。
|
|
実際にはもうサーバは認証リクエストにおいてタイムスタンプを要求しませんので、
|
|
このコマンドはもはや用いられないかもしれません。
|
|
.It Ic host Ar hostname
|
|
今後問い合わせを送るホストを指定します。
|
|
ホスト名
|
|
は、ホストの名前でも数値アドレスでもかまいません。
|
|
.It Ic hostnames Op Cm yes | Cm no
|
|
.Cm yes
|
|
が指定されると、情報の表示の際、ホスト名が使用されます。
|
|
.Cm no
|
|
が与えられると、代わりに数値アドレスが使用されます。
|
|
コマンドラインの
|
|
.Fl n
|
|
スイッチによって変えられていなければ、
|
|
デフォルトは
|
|
.Cm yes
|
|
になります。
|
|
.It Ic keyid Ar keyid
|
|
このコマンドで、認証設定リクエストに使われる鍵番号を指定できます。
|
|
この番号は、この目的で使うためにサーバに設定しておいた鍵番号に対応して
|
|
いなければなりません。
|
|
.It Ic quit
|
|
.Nm
|
|
を終了します。
|
|
.It Ic passwd
|
|
このコマンドは、認証設定リクエストに使われるパスワードの入力
|
|
(画面に表示されません) を求めるプロンプトを出します。
|
|
このリクエストが成功するためには、NTP サーバが認証のために使うよう
|
|
設定した鍵に、パスワードが対応していなければなりません。
|
|
.It Ic timeout Ar milliseconds
|
|
サーバへの問い合わせに対する応答の制限時間を指定します。デフォルト
|
|
は、約 8000 ミリ秒です。
|
|
.Nm
|
|
はそれぞれの問い合わせに対して時間切れを待ったあと再試行するため、
|
|
合計の待ち時間は設定された制限時間の値の 2 倍になることに注意してください。
|
|
.\" XXX retry しないんじゃなかったの？
|
|
.El
|
|
.Ss 制御メッセージコマンド
|
|
問い合わせコマンドは、情報を要求する NTP モード 7 パケットをサーバに送ります。
|
|
これらは、サーバの設定状態を変更しない
|
|
読み込み専用
|
|
コマンドです。
|
|
.Bl -tag -width indent
|
|
.It Ic listpeers
|
|
サーバが状態を管理する通信相手の簡略なリストを得て、出力します。
|
|
これには、サーバが今後同期する可能性のある候補であるとみなす階層の
|
|
通信相手とのアソシエーションを含め、
|
|
設定された通信相手とのアソシエーションのすべてを含んでいるはずです。
|
|
.It Ic peers
|
|
サーバが状態を管理する通信相手と、その状態の概要を出力します。
|
|
状態の概要は、以下のものを含みます。すなわち、リモートの通信相手のアドレス、
|
|
ローカルインタフェースアドレス (ローカルアドレスが決まっていないなら
|
|
0.0.0.0)、リモートの通信相手の階層 (階層 16 は、リモートの通信相手が同期し
|
|
ていない事を示します)、秒で表すポーリング間隔、8 進で表す到達可能性レジスタ、
|
|
通信相手の遅れ、オフセット、ばらつきを秒で表した現在の推定値です。
|
|
.Pp
|
|
左端の文字は、この通信相手エントリが操作しているモードを
|
|
示します。
|
|
.Ql \&+
|
|
は対称的アクティブを、
|
|
.Ql \&-
|
|
は対称的パッシブを表し、
|
|
.Ql \&=
|
|
は、リモートサーバがクライアントモードでポーリングされていることを意味し、
|
|
.Ql \&^
|
|
は、サーバがこのアドレスにブロードキャストしていることを示し、
|
|
.Ql \&~
|
|
は、リモートの通信相手がブロードキャストを送っていることを示し、
|
|
.Ql \&*
|
|
は、サーバが現在同期している通信相手であることを示します。
|
|
.Pp
|
|
ホストフィールドの内容は、ホスト名、IP アドレス、
|
|
参照クロック実装名とパラメータ、あるいは、
|
|
.Fn REFCLK "implementation number" "parameter"
|
|
の 4 つの形のうち 1 つです。
|
|
.Ic hostnames
|
|
.Cm no
|
|
の状態では、IP アドレスだけが表示されます。
|
|
.It Ic dmpeers
|
|
少々異なる通信相手概要リストです。
|
|
行の左端の文字以外は
|
|
.Ic peers
|
|
と同じ出力になります。
|
|
文字は、時計選択アルゴリズムの最後のステージに含まれる通信相手の隣にだけ
|
|
現れます。
|
|
.Ql \&.
|
|
は、偽時計検出でこの通信相手が捨てられたことを、
|
|
.Ql \&+
|
|
は検出により同期対象として適切であると判断されたことを示します。
|
|
.Ql \&*
|
|
は、通信相手であるサーバは現在同期しているサーバであることを示しています。
|
|
.It Ic showpeer Ar peer_address ...
|
|
1 つ以上の通信相手に対して、現在の通信相手の変数に関する詳細な内容を
|
|
表示します。
|
|
ほとんどの値に関しては、NTP バージョン 2 仕様書に詳しく述べられています。
|
|
.It Ic pstats Ar peer_address ...
|
|
指定した通信相手に関連する統計カウンタを通信相手毎に表示します。
|
|
.It Ic clockinfo Ar clock_peer_address ...
|
|
通信相手の時計に関する情報を得て、それを表示します。得られた値は、
|
|
設定上のあいまいな要因の情報と他の時計性能の情報を
|
|
提供してくれます。
|
|
.It Ic kerninfo
|
|
カーネルのフェーズロックループ操作パラメータを得て、それを表示します。
|
|
この情報は、精度の高い時刻保持機能のために、カーネルが特に
|
|
修正されている場合にだけ得られます。
|
|
.It Ic loopinfo Op Cm oneline | Cm multiline
|
|
選択されたループフィルタ変数の値を表示します。ループフィルタとは、
|
|
ローカルシステム時計の調節を行なう NTP の一部です。
|
|
.Sq offset
|
|
は、パケット処理コードによってループフィルタに与えられた最後のオフセットです。
|
|
.Sq frequency
|
|
は、100 万分の 1 (ppm) で表わされるローカル時計の周波数誤差です。
|
|
.Sq time_const
|
|
は、フェーズロックループの
|
|
堅固さ (stiffness)、
|
|
つまり発振器のゆらぎを調整する速度を制御します。
|
|
.Sq watchdog timer
|
|
の値は、ループフィルタに最後のサンプルのオフセットが与えられてから
|
|
経過した秒数です。
|
|
.Cm oneline
|
|
と
|
|
.Cm multiline
|
|
オプションはこの情報が
|
|
出力されるフォーマットの指定で、
|
|
.Cm multiline
|
|
がデフォルトです。
|
|
.It Ic sysinfo
|
|
システム状態変数、すなわち、ローカルサーバに関するさまざまな状態を
|
|
表示します。
|
|
最後の 4 行以外は、皆 NTP バージョン 3 仕様である RFC-1305 で
|
|
述べられています。
|
|
.Pp
|
|
.Sq system flags
|
|
は、いろいろなシステムフラグを表示し、一部は
|
|
.Ic enable
|
|
及び
|
|
.Ic disable
|
|
設定コマンドで、それぞれの設定やクリアができます。
|
|
それらのフラグは
|
|
.Cm auth ,
|
|
.Cm bclient ,
|
|
.Cm monitor ,
|
|
.Cm pll ,
|
|
.Cm pps ,
|
|
.Cm stats
|
|
です。
|
|
これらのフラグの意味については、
|
|
.Xr ntpd 8
|
|
の文書を参照して下さい。
|
|
その他に
|
|
.Cm kernel_pll
|
|
と
|
|
.Cm kernel_pps
|
|
という
|
|
読み込み専用のフラグが 2 つあります。
|
|
カーネルに高精度な時刻保持のための変更がなされている時に、
|
|
これらのフラグは同期状態を示します。
|
|
.Sq kernel_pll
|
|
は kernel がローカル時計を学習されていることを示し、
|
|
.Sq kernel_pps
|
|
は PPS 信号により kernel が学習していることを
|
|
示します。
|
|
.Pp
|
|
.Sq stability
|
|
は、システム周波数の修正がされた後に残る残留周波数誤差で、
|
|
保守やデバッグに使われます。
|
|
多くのアーキテクチャでは、この値は初期の 500 ppm 程度から、.01 から 0.1 ppm
|
|
という低い範囲にまで減少します。
|
|
もしデーモンが起動後しばらくしてもこの値が高いままである場合は、
|
|
ローカルな時計がどこかおかしいか、カーネル変数
|
|
.Va kern.clockrate.tick
|
|
が正しくないかもしれません。
|
|
.Pp
|
|
.\"kuma .Ic -> .Sq, send-pr 提出予定
|
|
.Sq broadcastdelay
|
|
は、
|
|
.Ic broadcastdelay
|
|
設定コマンドで設定されるデフォルトのブロードキャスト遅延時間を
|
|
表示します。
|
|
.Pp
|
|
.Sq authdelay
|
|
は、
|
|
.Ic authdelay
|
|
設定コマンドで設定されるデフォルトの認証遅延時間を表示します。
|
|
.It Ic sysstats
|
|
プロトコルモジュールで管理される統計カウンタを表示します。
|
|
.It Ic memstats
|
|
メモリ割り当てコードに関する統計カウンタを表示します。
|
|
.It Ic iostats
|
|
入出力モジュールで管理される統計カウンタを表示します。
|
|
.It Ic timerstats
|
|
タイマ/イベントキューをサポートするコードで管理される統計カウンタを表示します。
|
|
.It Ic reslist
|
|
サーバの制限リストを得て、表示します。このリストは、
|
|
(通常) ソートされた順で出力され、制限がどのように適用されるかを
|
|
理解する助けになるかもしれません。
|
|
.It Ic monlist Op Ar version
|
|
モニタ機能により収集、管理されるトラフィックカウントの値を得て、表示します。
|
|
通常、バージョン番号は指定する必要がありません。
|
|
.\"kuma clock_peer_address に Ar 修飾子付加は send-pr 予定(2001-12-25)
|
|
.It Ic clkbug Ar clock_peer_address ...
|
|
参照クロックドライバのデバッグ情報を得ます。この情報は、
|
|
一部の時計ドライバでのみ提供され、
|
|
ドライバのソースのコピーが手元に無い場合、ほとんどデコードできません。
|
|
.El
|
|
.Ss 実行時設定リクエスト
|
|
サーバ内で状態を変更するようなリクエストは、
|
|
設定された NTP 鍵を使って、サーバがすべてを認証します
|
|
(この機能はサーバ側で鍵を設定しないことにより、無効にすることもできます)。
|
|
鍵番号とそれに対応する鍵を、
|
|
.Nm
|
|
にも知らせておかねばなりません。
|
|
これは、
|
|
.Ic keyid
|
|
と
|
|
.Ic passwd
|
|
コマンドを使えば可能で、後者では、暗号化鍵を使うために
|
|
パスワードを求めるプロンプトを端末に出します。
|
|
サーバにより認証されるリクエストを送出するコマンドが最初に与えられた
|
|
時点にもまた、自動的に鍵番号とパスワード両方の入力が要求されます。
|
|
認証は、リクエスト送出側がそのような変更をする権限を持っているか
|
|
どうかを検証するだけでなく、送信エラーに対するより一層の保護を
|
|
提供することになります。
|
|
.Pp
|
|
認証されるリクエストは、常にパケットデータの中にタイムスタンプを
|
|
含んでいます。これは認証コードの計算に含まれます。
|
|
このタイムスタンプは、サーバによって受信時刻と比較されます。
|
|
この差がある小さな値より大きければ、そのリクエストは拒否されます。
|
|
これには 2 つの理由があります。
|
|
1 つ目は、あなたの LAN のトラフィックを盗み聞きできる誰かが、サーバへ
|
|
単純な繰り返し攻撃 (replay attack) を行なうことをより困難にします。
|
|
2 つ目は、ネットワーク的に
|
|
離れたホストから、あなたのサーバへ設定変更リクエストを行なうことを
|
|
より困難にします。
|
|
この再設定機能は、ローカルホストのサーバに対してはうまくいきますし、
|
|
同じ LAN 上にある時刻同期したホストでも普通に行なえますが、
|
|
より離れたホストでは非常にやりにくくなっています。
|
|
したがって、適当なパスワードを選択し、鍵の配布と防護に注意を払い、
|
|
適切な送信元アドレス制限が施されれば、実行時再設定の機能については
|
|
適切なセキュリティレベルにあることになります。
|
|
.Pp
|
|
以下のコマンドは皆、認証を必要とするリクエストです。
|
|
.Bl -tag -width indent
|
|
.It Xo Ic addpeer Ar peer_address
|
|
.Op Ar keyid
|
|
.Op Ar version
|
|
.Op Cm prefer
|
|
.Xc
|
|
与えられたアドレスにある通信相手アソシエーションを設定に追加し、
|
|
そのアソシエーションを対称的アクティブモードで動作させます。
|
|
その通信相手とすでにアソシエーションが存在している場合、
|
|
そのアソシエーションは
|
|
このコマンドが実行されたときに削除
|
|
されるか、単に新しい設定に従うよう適当に変更されることに注意してください。
|
|
オプションの
|
|
.Ar keyid
|
|
が 0 でない整数の場合、リモートサーバに
|
|
出ていくすべてのパケットは、この鍵により暗号化された
|
|
認証フィールドを付加されることになります。値が 0 の場合
|
|
(または指定されなかった場合)、認証は行なわれません。
|
|
.Ar version
|
|
は、1, 2, 3 のどれでもよく、デフォルトでは 3 になります。
|
|
.Cm prefer
|
|
キーワードは、優先する通信相手を示します
|
|
(その結果、可能であれば主要な時計同期元として使用されます)。
|
|
優先する通信相手は、 PPS 信号の信頼性も決めます。優先する通信相手が同期に
|
|
適している場合、PPS 信号も同期に適していると判断されます。
|
|
.It Xo Ic addserver Ar peer_address
|
|
.Op Ar keyid
|
|
.Op Ar version
|
|
.Op Cm prefer
|
|
.Xc
|
|
操作モードがクライアントであること以外は、
|
|
addpeer
|
|
コマンドと同等です。
|
|
.It Xo Ic broadcast Ar peer_address
|
|
.Op Ar keyid
|
|
.Op Ar version
|
|
.Op Cm prefer
|
|
.Xc
|
|
操作モードがブロードキャストであること以外は、
|
|
addpeer
|
|
コマンドと同等です。この場合、正当な鍵の識別子と鍵が必要になります。
|
|
.Ar peer_address
|
|
パラメータは、ローカルネットワークのブロードキャストアドレスか、または
|
|
NTP に割り当てられたマルチキャストグループアドレスにできます。
|
|
マルチキャストアドレスの場合、マルチキャストに対応したカーネルが
|
|
必要になります。
|
|
.It Ic unconfig Ar peer_address ...
|
|
このコマンドは、指定した通信相手 (群) から設定済みを表すビットを除去します。
|
|
多くの場合、これによってその通信相手とのアソシエーションが
|
|
削除されることになります。
|
|
しかしながら、リモートの通信相手が未設定状態の継続を希望し、
|
|
それが適切である場合は、アソシエーションは未設定モードのまま
|
|
残る場合もあります。
|
|
.It Xo Ic fudge Ar peer_address
|
|
.Op Cm time1
|
|
.Op Cm time2
|
|
.Op Ar stratum
|
|
.Op Ar refid
|
|
.Xc
|
|
このコマンドは、あるデータを参照クロックとしてセットできるようにします。
|
|
詳細な情報は、ソースリストを参照してください。
|
|
.\"kuma 以下2つに Ic を追加、これも send-pr 予定(2001-12-25)
|
|
.It Ic enable Ar flag ...
|
|
.It Ic disable Ar flag ...
|
|
これらのコマンドは
|
|
.Xr ntpd 8
|
|
の設定ファイルにおける
|
|
.Ic enable
|
|
や
|
|
.Ic disable
|
|
と同じ方法で操作します。
|
|
以下はフラグの説明です。
|
|
.Cm auth ,
|
|
.Cm bclient ,
|
|
.Cm monitor ,
|
|
.Cm pll ,
|
|
.Cm pps ,
|
|
.Cm stats
|
|
フラグのみが
|
|
.Nm
|
|
で設定でき、
|
|
.Cm pll_kernel ,
|
|
.Cm pps_kernel
|
|
フラグは読み込み専用であることに
|
|
注意してください。
|
|
.Bl -tag -width indent
|
|
.It Cm auth
|
|
通信相手が信頼できる鍵と
|
|
鍵の識別子を使って正しく認証されたときだけ、未設定の
|
|
通信相手にサーバを同期させるようにします。
|
|
デフォルトでは有効になっています。
|
|
.It Cm bclient
|
|
デフォルトアドレス付きの
|
|
.Ic mutlicastclient
|
|
コマンドの場合と同様に、
|
|
ブロードキャストサーバやマルチキャストサーバからのメッセージを
|
|
聞く (listen) ようにします。
|
|
デフォルトでは無効になっています。
|
|
.It Cm monitor
|
|
モニタ機能を有効にします。詳細な情報については、
|
|
.Ic monlist
|
|
コマンドを参照して下さい。
|
|
デフォルトでは有効になっています。
|
|
.It Cm pll
|
|
サーバが NTP を使ってローカル時計を合わせるようにします。
|
|
無効の場合は、ローカル時計は
|
|
内部の時間および周波数オフセットによって勝手に動作することになります。
|
|
このフラグは、ローカル時計が他のデバイスやプロトコルにより制御されていて、
|
|
NTP は他のクライアントが同期するためだけに使われるような場合に便利です。
|
|
この場合、ローカル時計ドライバが使用されます。
|
|
より詳細な情報は
|
|
.Qq "参照クロックドライバ"
|
|
のページを参照してください (より詳細な情報については、
|
|
.Pa /usr/share/doc/ntp
|
|
ページにある HTML 文書の一部が利用可能です)。
|
|
デフォルトでは有効になっています。
|
|
.It Cm pps
|
|
高精度な時刻保持のための変更がなされたカーネルにより、
|
|
周波数と時刻が学習されている場合に、
|
|
1 秒ごとのパルス信号 (PPS) を有効にします。
|
|
より詳細な情報は
|
|
.Qq "高精度な時刻保持のためのカーネルモデル"
|
|
のページを参照してください。
|
|
デフォルトでは無効になっています。
|
|
.It Cm stats
|
|
統計機能を有効にします。
|
|
より詳細な情報は
|
|
.Xr ntp.conf 5
|
|
マニュアルページの
|
|
.Sx 監視機能のサポート
|
|
節を参照してください。
|
|
デフォルトでは有効になっています。
|
|
.It Cm pll_kernel
|
|
高精度な時刻保持のための変更がカーネルになされている場合、
|
|
カーネルが時計の学習を制御していることを示します。
|
|
そうでない場合はデーモンが時計の学習を制御しています。
|
|
.It Cm pps_kernel
|
|
高精度な時刻保持のための変更がカーネルになされており、
|
|
また1 秒ごとのパルス信号 (PPS) が存在している場合、
|
|
PPS 信号が時計の学習を制御していることを示します。
|
|
そうでない場合は
|
|
.Cm pll_kernel
|
|
フラグの示すとおり、
|
|
デーモンまたはカーネルが時計の学習を制御しています。
|
|
.El
|
|
.It Xo Ic restrict Ar address Ar mask
|
|
.Ar flag ...
|
|
.Xc
|
|
このコマンドは
|
|
.Xr ntpd 8
|
|
の
|
|
.Ic restrict
|
|
設定ファイルコマンドと同様に動作します。
|
|
.It Xo Ic unrestrict Ar address Ar mask
|
|
.Ar flag ...
|
|
.Xc
|
|
制限リストにおいて、マッチしたエントリの制限を解除します。
|
|
.It Xo Ic delrestrict Ar address Ar mask
|
|
.Op Cm ntpport
|
|
.Xc
|
|
制限リストから一致するエントリを削除します。
|
|
.It Ic readkeys
|
|
現在の認証鍵のセットを一掃し、鍵ファイル (これは
|
|
.Xr ntpd 8
|
|
設定ファイルの中で指定されていなければなりません) の
|
|
再読み込みを行なって新しいセットにします。
|
|
こうすることで、サーバを再スタートさせずに暗号化鍵の変更ができます。
|
|
.It Ic trustedkey Ar keyid ...
|
|
.It Ic untrustedkey Ar keyid ...
|
|
これらのコマンドは
|
|
.Xr ntpd 8
|
|
の
|
|
.Ic trustedkey
|
|
設定ファイルコマンドや
|
|
.Ic untrustedkey
|
|
設定ファイルコマンドと同様に動作します。
|
|
.It Ic authinfo
|
|
既知の鍵や実行した暗号化、復号化の数を含む、認証モジュールに関する
|
|
情報を返します。
|
|
.It Ic traps
|
|
サーバに設定されているトラップを表示します。
|
|
詳細はソースリストを参照してください。
|
|
.It Xo Ic addtrap Ar address
|
|
.Op Ar port
|
|
.Op Ar interface
|
|
.Xc
|
|
非同期メッセージに対するトラップをセットします。
|
|
詳細はソースリストを参照してください。
|
|
.It Xo Ic clrtrap Ar address
|
|
.Op Ar port
|
|
.Op Ar interface
|
|
.Xc
|
|
非同期メッセージに対するトラップを解除します。
|
|
詳細はソースリストを参照してください。
|
|
.It Ic reset
|
|
サーバのいろいろなモジュールのなかの統計カウンタをクリアします。
|
|
詳細はソースリストを参照してください。
|
|
.El
|
|
.Sh 関連項目
|
|
.Xr ntp.conf 5 ,
|
|
.Xr ntpd 8
|
|
.Rs
|
|
.%A David L. Mills
|
|
.%T Network Time Protocol (Version 3)
|
|
.%O RFC1305
|
|
.Re
|
|
.Sh バグ
|
|
.Nm
|
|
ユーティリティは、未完成のハックです。
|
|
表示される情報の多くは死ぬほど退屈で、実装した
|
|
人間だけに気に入られるものです。このプログラムは、新しい (そして一時的な)
|
|
仕様を追加しやすいようデザインされており、使いやすくするしようとすると
|
|
無茶苦茶手間が
|
|
かかります。それでも、このプログラムは、場合によっては有用です。
|