aboutsummaryrefslogtreecommitdiff
path: root/ja_JP.eucJP/man/man8/xntpdc.8
blob: 3b3e7beecafc7983d5c3075ee0952f1c798ee96c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
''' $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
は、未完成のハックです。表示される情報の多くは死ぬほど退屈で、実装した
人間だけに気に入られるものです。このプログラムは、新しい (一時的な)
仕様を追加し易いようデザインされており、使いやすくするには手間が
かかります。それでも、このプログラムは、場合によっては有用です。