manual/ypserv/draft/man8/ypserv.8

   1 .\" -*- nroff -*-
   2 .\" $Id: ypserv.8,v 1.4 2004/02/23 18:56:53 ysato Exp $
   3 .\"
   4 .\" This manual page is a part of ypserv archive.
   5 .\" README states the following
   6 .\"
   7 .\" See the file COPYING for copying restrictions. It is available under
   8 .\" the GNU General Public License.
   9 .\"
  10 .\" Japanese Version Copyright (c) 1998, 1999 NAKANO Takeo all rights reserved.
  11 .\" Translated Mon 23 Nov 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  12 .\" Updated Fri 22 Oct 1999 by NAKANO Takeo
  13 .\" Updated Sun 02 Dec 2001 by NAKANO Takeo
  14 .\"
  15 .TH YPSERV 8 "April 1997" "NYS YP Server" "Linux Reference Manual"
  16 .\"O .SH NAME
  17 .\"O ypserv \- NIS server
  18 .SH 名前
  19 ypserv \- NIS サーバー
  20 .\"O .SH SYNOPSIS
  21 .SH 書式
  22 .B /usr/sbin/ypserv
  23 [
  24 .B \-d
  25 [
  26 .B path
  27 ] ]
  28 [
  29 .B \-p port
  30 ]
  31 .LP
  32 .\"O .SH DESCRIPTION
  33 .SH 説明
  34 .IX  "ypserv"  ""  "\fLypserv\fP \(em NIS server process"
  35 .LP
  36 .\"O The
  37 .\"O Network Information Service (NIS)
  38 .\"O provides a simple network lookup service
  39 .\"O consisting of databases and processes.  The databases are
  40 .\"O .B gdbm
  41 .\"O files in a directory tree rooted at
  42 .\"O .BR /var/yp .
  43 Network Information Service (NIS) は、
  44 データベースとそれらを扱うプロセスとからなる
  45 シンプルなネットワーク検索サービスである。
  46 データベースは
  47 .B gdbm
  48 形式のファイルで、
  49 .B /var/yp
  50 以下のディレクトリツリーに置かれる。
  51 .LP
  52 .\"O The
  53 .\"O .B ypserv
  54 .\"O daemon is typically activated at system startup.
  55 .B ypserv
  56 デーモンは、通常システムのスタートアップの時に起動される。
  57 .\"O .B ypserv
  58 .\"O runs only on
  59 .\"O .SM NIS
  60 .\"O server machines with a complete
  61 .\"O .SM NIS
  62 .\"O database. On other machines using the
  63 .\"O .SM NIS
  64 .\"O services, you have to run
  65 .\"O .B ypbind
  66 .\"O as client or under Linux you could use the libc with
  67 .\"O .SM NYS
  68 .\"O support.
  69 .B ypserv
  70 は、完全な
  71 .SM NIS
  72 データーベースを保管する
  73 .SM NIS
  74 サーバーマシンでのみ実行される。
  75 .SM NIS
  76 サービスを利用する他のマシンでは、クライアントとして
  77 .B ypbind
  78 を動作しさえすればよい。あるいは Linux なら
  79 .SM NYS
  80 のサポートされた libc を用いてもよい。
  81 .\"O .B ypbind
  82 .\"O must run on every machine which has
  83 .\"O .SM NIS
  84 .\"O client processes;
  85 .\"O .B ypserv
  86 .\"O may or may not be running on the same node,
  87 .\"O but must be running somewhere
  88 .\"O on the network. On startup or when receiving the signal SIGHUP,
  89 .\"O .B ypserv
  90 .\"O parses the file
  91 .\"O .B /etc/ypserv.conf.
  92 .B ypbind
  93 は
  94 .SM NIS
  95 クライアントプロセスの動作するすべてのマシンで起動しなければならない。
  96 その際
  97 .B ypserv
  98 の動作しているマシンは、
  99 ネットワークの同じノードでも他のノードでもかまわないが、
 100 必ずネットワークのどこかに存在していなければならない。
 101 スタートアップの時や SIGHUP シグナルを受け取った時には、
 102 .B ypserv
 103 は
 104 .B /etc/ypserv.conf
 105 ファイルを読み込み、その内容を解釈して利用する。
 106 .LP
 107 .\"O .SH OPTIONS
 108 .SH オプション
 109 .TP
 110 .B "\-d" "\-\-debug" "[path]"
 111 .\"O Causes the server to run in debugging mode. Normally,
 112 .\"O .B ypserv
 113 .\"O reports only errors (access violations, dbm failures)
 114 .\"O using the syslog(3) facility. In debug mode, the server does not
 115 .\"O background itself and prints extra status messages to stderr for
 116 .\"O each request that it revceives.
 117 .\"O .B path
 118 .\"O is an optionally parameter.
 119 .\"O .B ypserv
 120 .\"O is using this directory instead of /var/yp
 121 サーバーをデバッグモードで起動する。
 122 通常
 123 .B ypserv
 124 は
 125 .BR syslog (3)
 126 を通してエラーメッセージ (アクセス権の侵害や dbm の障害など) のみを
 127 報告する。これに対してデバッグモードでは、
 128 サーバーはバックグラウンドへ待避せず、
 129 アクセス要求を受けるたびに細かなステータスメッセージを
 130 標準エラー出力に表示する。
 131 .B path
 132 は省略可能なパラメータで、指定すると
 133 .B ypserv
 134 はこのディレクトリを /var/yp の代わりに利用する。
 135 .TP
 136 .B "\-p" "\-\-port"  port
 137 .\"O .B ypserv
 138 .\"O will bind itself to this port.
 139 .\"O This makes it possible to have a router filter packets
 140 .\"O to the NIS ports, so that access to the NIS server from
 141 .\"O hosts on the Internet can be restricted.
 142 .B ypserv
 143 がバインドするポート番号を指定する。このオプションを用いると、
 144 ルータに NIS ポートへのパケットをフィルタリングさせ、
 145 インターネットからの NIS サーバーへのアクセスを制限できる。
 146 .TP
 147 .B "\-v" "\-\-version"
 148 .\"O Prints the version number
 149 バージョン番号を表示する。
 150 .\"O .SH SECURITY
 151 .SH セキュリティ
 152 .\"O In general, any remote user can issue an RPC to
 153 .\"O .B ypserv
 154 .\"O and retrieve the contents of your NIS maps, if he knows your
 155 .\"O domain name. To prevent such unauthorized transactions,
 156 .\"O .B ypserv
 157 .\"O supports a feature called
 158 .\"O .B securenets
 159 .\"O which can be used to restrict access to a given set of hosts.
 160 .\"O At startup or when arriving the SIGHUP Signal,
 161 .\"O .B ypserv
 162 .\"O will attempt to load the securenets information from a file
 163 .\"O called
 164 .\"O .B /var/yp/securenets .
 165 .\"O This file contains entries that consist of a netmask
 166 .\"O and a network pair separated by white spaces.
 167 .\"O Lines starting with ``#'' are considered to be comments.
 168 いったんドメインネームがわかってしまうと、リモートユーザーは誰でも
 169 .B ypserv
 170 への RPC を発行して、 NIS マップの内容を入手できてしまう。
 171 このような、本来許可されるべきでないトランザクションを防ぐために、
 172 .B ypserv
 173 では
 174 .B securenets
 175 という機能をサポートしており、指定されたホスト以外からのアクセスを
 176 制限できるようになっている。起動時や SIGHUP シグナルを受けた時に、
 177 .B ypserv
 178 は
 179 .B /var/yp/securenets
 180 というファイルから securenets 情報をロードしようと試みる。
 181 このファイルにはネットワークとネットマスクの組を、スペースで
 182 区切ったものが指定されている。``#'' で始まる行はコメントと
 183 みなされる。
 184 .TP
 185 .\"O A sample securenets file might look like this:
 186 以下に securenets ファイルの簡単な例を示す。
 187
 188 # allow connections from local host -- necessary
 189 .br
 190 host 127.0.0.1
 191 .br
 192 # same as 255.255.255.255 127.0.0.1
 193 .br
 194 #
 195 .br
 196 # allow connections from any host
 197 .br
 198 # on the 131.234.223.0 network
 199 .br
 200 255.255.255.0   131.234.223.0
 201 .br
 202 # allow connections from any host
 203 .br
 204 # between 131.234.214.0 and 131.234.215.255
 205 .br
 206 255.255.254.0   131.234.214.0
 207 .LP
 208 .\"O If
 209 .\"O .B ypserv
 210 .\"O receives a request from an address that fails to match a rule,
 211 .\"O the request will be ignored and a warning message will be
 212 .\"O logged. If the
 213 .\"O .B /var/yp/securenets
 214 .\"O file does not exist,
 215 .\"O .B ypserv
 216 .\"O will allow connections from any host.
 217 .B ypserv
 218 がルールにマッチしなかったアドレスからの要求を受け取ると、
 219 その要求は無視され、警告メッセージがログに記録される。
 220 .B /var/yp/securentes
 221 ファイルが存在しない場合には、
 222 .B ypserv
 223 はすべてのホストからの接続を許可する。
 224 .LP
 225 .\"O In the
 226 .\"O .B /etc/ypserv.conf
 227 .\"O you could specify some access rules for special maps and hosts. But
 228 .\"O it is not very secure, it makes the life only a little bit harder
 229 .\"O for a potential hacker. If a mapname doesn't match a rule, ypserv will
 230 .\"O look for the YP_SECURE key in the map. If it exists, ypserv will
 231 .\"O only allow requests on a reserved port.
 232 .B /etc/ypserv.conf
 233 に、特殊なマップやホストに対するアクセスルールを指定することもできる。
 234 しかしこれは必ずしも安全ではなく、クラッカーからのアタックを多少面倒に
 235 させるだけにすぎない。 mapname がルールにマッチしないと、
 236 .B ypserv
 237 はそのマップの YPSECURE キーを見る。キーが存在すれば、
 238 .B ypserv
 239 は特権ポートからの要求以外を許可しない。
 240
 241 .\"O For security reasons, ypserv will only accept ypproc_xfr requests for
 242 .\"O updating maps from the same master server as the old one. This means,
 243 .\"O you have to reinstall the slave servers if you change the master server
 244 .\"O for a map.
 245 セキュリティ上の理由から、
 246 .B ypserv
 247 はマップ更新のために用いられる ypproc_xfr 要求を、以前と同じ
 248 マスターサーバーからしか受けつけない。つまり、あるマップに対する
 249 マスターサーバを変更するには、スレーブサーバーは
 250 再インストールする必要がある。
 251 .\"O .SH FILES
 252 .SH ファイル
 253 /etc/ypserv.conf
 254 /var/yp/securenets
 255 .\"O .SH "SEE ALSO"
 256 .SH 関連項目
 257 .BR domainname (1),
 258 .BR ypcat (1),
 259 .BR ypmatch (1),
 260 .BR ypserv.conf (5),
 261 .BR netgroup (5),
 262 .BR makedbm (8),
 263 .BR revnetgroup (8),
 264 .BR ypinit (8),
 265 .BR yppoll (8),
 266 .BR yppush (8),
 267 .BR ypset (8),
 268 .BR ypwhich (8),
 269 .BR ypxfr (8),
 270 .BR rpc.ypxfrd (8)
 271 .LP
 272 .\"O The Network Information Service
 273 .\"O (\s-1NIS\s0)
 274 .\"O was formerly known as Sun Yellow Pages
 275 .\"O (\s-1YP\s0).
 276 .\"O The functionality of the two remains the same;
 277 .\"O only the name has changed.
 278 .\"O The name Yellow Pages is a registered trademark in the United Kingdom
 279 .\"O of British Telecommunications plc,
 280 .\"O and may not be used without permission.
 281 Network Information Service
 282 (\s-1NIS\s0)
 283 は、以前は Sun Yellow Pages
 284 (\s-1YP\s0).
 285 と呼ばれていた。
 286 この両者の機能はまったく同じものであり、名前が違うだけである。
 287 Yellow Pages という名前は、英国で
 288 British Telecommunications plc の登録商標となっており、
 289 許可を得ずに用いることはできない。
 290 .\"O .SH AUTHOR
 291 .SH 著者
 292 .\"O .B ypserv
 293 .\"O was written by Peter Eriksson <pen@lysator.liu.se>.
 294 .\"O Thorsten Kukuk <kukuk@suse.de> added support for master/slave
 295 .\"O server and is the new Maintainer.
 296 .B ypserv
 297 は Peter Eriksson <pen@lysator.liu.se> によって書かれた。
 298 Thorsten Kukuk <kukuk@suse.de> がマスター/スレーブサーバの
 299 サポートを追加し、現在のメンテナンスを行っている。