manual/ypserv/draft/man8/yppush.8

   1 .\"
   2 .\" This manual page is a part of ypserv archive.
   3 .\" README states the following
   4 .\"
   5 .\" See the file COPYING for copying restrictions. It is available under
   6 .\" the GNU General Public License.
   7 .\"
   8 .\" Japanese Version Copyright (c) 1998, 1999 NAKANO Takeo all rights reserved.
   9 .\" Translated Mon 23 Nov 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  10 .\" Updated Fri 22 Oct 1999 by NAKANO Takeo
  11 .\" Updated & Modified Sun Feb 29 17:36:12 JST 2004
  12 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  13 .\"
  14 .TH YPPUSH 8 "August 2002" "YP Server" "Reference Manual"
  15 .\"O .SH NAME
  16 .\"O yppush \- force propagation of changed NIS databases
  17 .SH 名前
  18 yppush \- NIS データーベースの変更を強制的に伝播させる
  19 .\"O .SH SYNOPSIS
  20 .SH 書式
  21 .B /usr/sbin/yppush
  22 [
  23 .B \-d
  24 .I domain
  25 ]
  26 [
  27 .B \-t
  28 .I timeout
  29 ]
  30 [
  31 .B --parallel
  32 .I #
  33 |
  34 .B --port
  35 .I port
  36 ]
  37 [
  38 .B \-h
  39 .I host
  40 ]
  41 [
  42 .B \-v
  43 ]
  44 mapname ...
  45 .LP
  46 .\"O .SH DESCRIPTION
  47 .SH 説明
  48 .LP
  49 .\"O .B yppush
  50 .\"O copies updated NIS databases (or maps) from the master NIS server to
  51 .\"O the slave servers within a NIS domain. It is normally run only on
  52 .\"O the NIS master by
  53 .\"O .I /var/yp/Makefile
  54 .\"O after the master databases are changed.
  55 .\"O .I /var/yp/Makefile
  56 .\"O does not invoke
  57 .\"O .B yppush
  58 .\"O by default, the
  59 .\"O .B NOPUSH=true
  60 .\"O line must be commented out.
  61 .B yppush
  62 は更新された NIS データーベース (やマップ) を、マスターの NIS サーバー
  63 から同じ NIS ドメインに所属しているスレーブサーバーにコピーする。
  64 通常は NIS マスターでのみ実行され、
  65 .I /var/yp/Makefile
  66 でマスターのデーターベースが更新された後に起動される。
  67 デフォルトでは、
  68 .I /var/yp/Makefile
  69 からの
  70 .B yppush
  71 の起動は有効になっていない。これを有効にするには
  72 .B NOPUSH="True"
  73 の行をコメントアウトすること。
  74 .\"O .br
  75 .\"O .B yppush
  76 .\"O first constructs a list of NIS slave servers by reading the NIS map
  77 .\"O .B ypservers
  78 .\"O within the
  79 .\"O .I domain.
  80 .\"O A destination host (or a list of hosts with multiple \-h commands)
  81 .\"O can also be specified on the command line.
  82 .\"O A "transfer map" request is sent to the NIS serger at each slave, along
  83 .\"O with the information needed by the transfer agent ypxfr(8) to callback
  84 .\"O to yppush, which may be printed the result to stderr. Messages are
  85 .\"O also pritned when a transfer is not possible; for instance when the request
  86 .\"O message is undeliverable.
  87 .PP
  88 .B yppush
  89 は最初に所属するドメインの
  90 .B ypservers
  91 NIS マップを読み、スレーブサーバーのリストを生成する。
  92 送り先のホスト (\-h コマンドを使えば複数のホストを同時指定できる) は
  93 コマンドラインからも指定できる。
  94 "transfer map" 要求がそれぞれのスレーブの NIS サーバーに送られ、
  95 転送エージェントである
  96 .BR ypxfr (8)
  97 が
  98 .B yppush
  99 にコールバックを行う際に必要な情報が渡される。
 100 このコールバックの結果は標準エラー出力に表示することもできる。
 101 転送ができなかったとき (要求メッセージが受付けられなかったときなど)
 102 にもメッセージを表示させることができる。
 103 .\"O .SH OPTION
 104 .SH オプション
 105 .TP
 106 .BI "\-d " domain
 107 .\"O Specify a particular domain. The NIS domain of the local host system is
 108 .\"O used by default. If the local host's domain name is not set, the domain
 109 .\"O name must be specified with this flag.
 110 ドメインを指定する。デフォルトではローカルホストの NIS ドメインが
 111 用いられる。ローカルホストのドメイン名が設定されていない場合は、
 112 このフラグで指定しなければならない。
 113 .TP
 114 .BI "\-t " timeout
 115 .\"O The timeout flag is used to specify a timeout value in seconds. This timeout
 116 .\"O controls how long
 117 .\"O .B yppush
 118 .\"O will wait for a response from a slave server before sending a
 119 .\"O map transfer request to the next slave server in the list.
 120 .\"O By default,
 121 .\"O .B yppush
 122 .\"O will wait 90 seconds. For big maps, this is not long enough.
 123 タイムアウトの時間を秒単位で指定する。このタイムアウトは、
 124 .B yppush
 125 マップ転送要求をあるスレーブサーバーに出したあと、
 126 スレーブからの反応を待つ時間である。ここで指定しただけ待つと、
 127 リストの次のスレーブサーバーへ転送要求を送る。
 128 デフォルトでは、
 129 .B yppush
 130 は 90 秒待つ。大きなマップでは充分でないかもしれない。
 131 .TP
 132 .BI \-\^\-parallel " #" "\fR,\fP \-p " #
 133 .\"O .B yppush
 134 .\"O normally performs transfers serially, meaning that it will
 135 .\"O send a map transfer request to one slave server and then wait for
 136 .\"O it to respond before sending the next map transfer request to the
 137 .\"O next slave server. In environments with many slaves, it is more
 138 .\"O efficient to initiate several map transfers at once so that the
 139 .\"O transfers can take place in parallel.
 140 .B yppush
 141 は通常転送を直列に行う。すなわちマップの転送要求を一つのスレーブサーバーに
 142 出し、その回答を待ち、そして次のスレーブサーバーに次の転送要求を出す。
 143 多くのスレーブがあるような環境下では、複数のマップ転送を同時にスタートし、
 144 転送を並列に行う方が効率的である。
 145 .\"O It is not possible to run in parallel and assign a fixed port with
 146 .\"O the
 147 .\"O .B \--port
 148 .\"O flag
 149 .B \--port
 150 フラグで固定のポートを割り当てて、並列に動作させるのは不可能である。
 151 .TP
 152 .BI "\--port " port
 153 .\"O specify a port for
 154 .\"O .B yppush
 155 .\"O to  listen  on.   By default,
 156 .\"O .B yppush
 157 .\"O will ask
 158 .\"O .B portmap(8)
 159 .\"O to assign it a random port number.
 160 .B yppush
 161 が接続を待つポートを指定する。
 162 デフォルトでは
 163 .B yppush
 164 は
 165 .B portmap(8)
 166 に無作為なポートを割り当ててもらう。
 167 .\"O It is not possible to assign a port with this option and run in parallel with
 168 .\"O the
 169 .\"O .B \--parallel
 170 .\"O or
 171 .\"O .B \-p
 172 .\"O flag
 173 このオプションでポートを割り当てて、
 174 .B \--parallel
 175 または
 176 .B \-p
 177 フラグで並列に動作させることは不可能である。
 178 .TP
 179 .BI "\-h " host
 180 .\"O The host flag can be used to transfer a map to a user-specified machine or
 181 .\"O group of machines instead of the list of servers contained in
 182 .\"O the
 183 .\"O .B ypservers
 184 .\"O map. A list of hosts can be specified by using multiple
 185 .\"O instances of the
 186 .\"O .B "\-h"
 187 .\"O flag.
 188 このフラグは、ユーザーの指定するマシン (もしくはマシンのグループ)
 189 にマップ転送を行うために用いる。通常は
 190 .B ypservers
 191 マップにリストされているサーバーに転送が行われる。
 192 ホストのリストを指定したい場合は、
 193 .B \-h
 194 フラグを複数回用いればよい。
 195 .TP
 196 .B \-v
 197 .\"O Verbose mode: causes
 198 .\"O .B yppush
 199 .\"O to print debugging messages as it runs. Note specifying this flag twice
 200 .\"O makes
 201 .\"O .B yppush
 202 .\"O even more verbose.
 203 詳細モード。実行時にデバッグ情報を表示するようになる。
 204 このフラグを二回指定すれば、
 205 .B yppush
 206 はさらに詳細に表示する。
 207 .LP
 208 .\"O .SH "SEE ALSO"
 209 .SH 関連項目
 210 .BR domainname (1),
 211 .BR ypserv (8),
 212 .BR ypxfr (8)
 213 .LP
 214 .\"O .SH BUGS
 215 .SH バグ
 216 .\"O The mechanism for transferring NIS maps in NIS v1 is different
 217 .\"O that that in NIS version 2. This version of
 218 .\"O .Nm yppush
 219 .\"O has support for transferring maps to NIS v2 systems only.
 220 NIS v1 での NIS マップ転送メカニズムは NIS バージョン 2 とは
 221 異なっている。この
 222 .B yppush
 223 は NIS v2 システムのマップ転送しかサポートしていない。
 224 .LP
 225 .\"O .SH AUTHOR
 226 .SH 著者
 227 Thorsten Kukuk <kukuk@suse.de>