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
|
.\" Copyright (c) 1991, 1993, 1995
.\" The Regents of the University of California. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" %FreeBSD: src/usr.sbin/yppush/yppush.8,v 1.15 2002/07/14 14:47:08 charnier Exp %
.\"
.\" $FreeBSD$
.\"
.Dd February 5, 1995
.Dt YPPUSH 8
.Os
.Sh 名称
.Nm yppush
.Nd "NIS データベースの更新を強制的に伝搬させる"
.Sh 書式
.Nm
.Op Fl d Ar domain
.Op Fl t Ar timeout
.Op Fl j Ar #parallel jobs
.Op Fl h Ar host
.Op Fl p Ar path
.Op Fl v
.Ar mapname
.Sh 解説
.Nm
ユーティリティは、NIS ドメインにおいて、更新した NIS データベース(もしくは
.Pa マップ )
を NIS マスタサーバから NIS スレーブサーバへ配布します。
通常、NIS マップが更新された場合に NIS マスタの
.Pa /var/yp/Makefile
からのみ起動されます。
.Pa /var/yp/Makefile
はデフォルトでは
.Nm
を起動しない事に注意して下さい:
これを変えるにはまず、Makefile 中の
.Dq Li NOPUSH=True
エントリをコメントアウトしなければなりません
(デフォルトの
.Fx
の設定は小さなネットワークに
単一の NIS サーバがある状況を想定しています; この様な設定では
.Nm
は不要です)。
.Pp
デフォルトでは、
.Nm
はドメイン内のスレーブサーバ名を決定するために
.Pa ypservers
マップを検索します。
宛先ホスト(もしくはホストのリスト)は手動でコマンドラインから指定可能です。
スレーブサーバのリストが与えられると、
`マップ転送' 要求を各スレーブに送信します。
今度はスレーブが、
.Xr ypxfr 8
を使用して、NIS マスタサーバからマップのコピーを読み取ります。
コピーされるマップ名と
.Xr ypxfr 8
が
.Nm
に `コールバック' して転送を完遂するために必要な特別な情報とが、
各リクエストに含まれます。
コールバックにおいて
.Nm
が
.Xr ypxfr 8
から受け取るエラーメッセージは全て標準エラー出力に出力されます。
.Pp
以下のオプションが使用可能です:
.Bl -tag -width indent
.It Fl d Ar domain
ドメイン名を指定します。
ローカルホストの NIS ドメイン名がデフォルトで使用されます。
ローカルホストのドメイン名が設定されていない場合には、
このフラグでドメイン名を指定しなければなりません。
.It Fl t Ar timeout
タイムアウト値を秒単位で指定します。
このタイムアウトは、
.Nm
がリスト中の次のスレーブサーバ宛にマップ転送要求を送る前に
返答をどれくらい待つかを制御します。
.It Fl j Ar #parallel jobs
.Nm
ユーティリティは通常、転送を逐次的に行います。すなわち、
マップ転送要求を一つのスレーブサーバに送り
次のスレーブサーバに取り掛かる前に返答を待つということです。
多くのスレーブがいる環境では、
同時に複数のマップ転送を開始し、転送を並列に行う方が効率が良くなります。
.Fl j
フラグにて並列処理するジョブ数を指定します:
.Nm
は指定された数の転送をすぐに開始し、返答を待ちます。
並列ジョブ数がスレーブ数より少ない場合は、
.Nm
は指定されたジョブ数の処理のみを開始し、返答を待ち、
処理が完了してから残りの処理に取り掛かります。
.Pp
.Nm
はコールバックを非同期に取り扱う事に注意して下さい。
これはどういうことかというと、
全てのマップ転送要求を送信する前であろうとも、
.Xr ypxfr 8
からコールバック情報を受け取るとすぐに、
この情報を表示する事を意味します。
.It Fl h Ar host
.Pa ypservers
マップ中のサーバのリストの代わりに、
ユーザが指定するマシンもしくはマシンのグループ宛にマップを転送できます。
複数のホストを指定するためには、複数の
.Fl h
フラグを使用します。
.It Fl p Ar path
デフォルトでは、
.Nm
は全てのローカル NIS マップは
.Pa /var/yp
以下に格納してあると期待しています。
.Fl p
フラグにて別のパスを指定することにより、
システム管理者が NIS マップを別の場所に格納する状況に対処できます。
.It Fl v
冗長モード:
.Nm
の実行時にデバッグ情報を表示させます。
このフラグを 2 回指定すると、
.Nm
はより冗長に情報を表示します。
.El
.Sh 関連ファイル
.Bl -tag -width Pa -compact
.It Pa /var/yp/[domainname]/ypservers
ある NIS ドメインにおける全てのサーバ名を格納した NIS ypservers マップ
.El
.Sh 関連項目
.Xr yp 8 ,
.Xr ypserv 8 ,
.Xr ypxfr 8
.Sh バグ
NIS v1 における NIS マップ転送機構は NIS v2 におけるものとは異なります。
このバージョンの
.Nm
は NIS v2 システム宛のマップ転送のみをサポートしています。
.Sh 作者
.An Bill Paul Aq wpaul@ctr.columbia.edu
|
