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
|
.\" Copyright (c) 1995, 1996
.\" Bill Paul <wpaul@ctr.columbia.edu>. 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 Bill Paul.
.\" 4. Neither the name of the author nor the names of contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul 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/rpc.ypxfrd/rpc.ypxfrd.8,v 1.9.2.1 2000/12/08 15:28:53 ru Exp %
.\" $FreeBSD$
.\"
.Dd June 2, 1996
.Dt RPC.YPXFRD 8
.Os
.Sh 名称
.Nm rpc.ypxfrd
.Nd "NIS マップ転送サーバ"
.Sh 書式
.Nm
.Op Fl p Ar path
.Sh 解説
.Nm
デーモンは NIS マスタサーバから NIS スレーブサーバへの巨大な NIS
マップの配布を高速化するためのに使われます。通常、マップの転送はいくつ
かの手順を経ます:
.Bl -bullet -offset indent
.It
マスタサーバが
.Xr yppush 8
を呼び出し、スレーブサーバが転送を開始するよう指示します。
.It
スレーブサーバは、
.Xr ypxfr 8
を起動します。
.Xr ypxfr 8
は、マスタサーバから yp_all() を使ってマップの内容をすべて読みます。
.It
次に
.Xr ypxfr 8
は、
.Xr db 3
ライブラリを使ってサーバから受け取ったデータをハッシュし新しいマップ
データベースファイルを作成します。
.It
全てのデータを書き終えてから、
.Xr ypxfr 8
は、新しいファイルを置き換え、ローカルマシンの
.Xr ypserv 8
宛にデータベースハンドルを更新するよう YPPROC_CLEAR を送ります。
.El
.Pp
巨大なマップが含まれている場合、この処理に数分かかることがあります。
たとえば、数万のエントリのあるパスワードデータベースでは、数メガバイト
のディスクを消費し、
.Xr db 3
ライブラリがハッシュテーブルに全てのエントリをソートし納めるのに
長時間かかります。さらに、マップファイルは2セットあります:
.Pa master.passwd.by{name,uid}
と
.Pa passwd.by{name,uid}
です。
.Pp
.Nm
サーバは NIS スレーブサーバがマスターサーバのマップファイルを
コピーし、マップファイルの構築を行わないことで、転送処理を高速化し
ます。
.Nm
は、単に RPC ベースのファイル転送プロトコルを実装しているだけです。
十分に高速なスレーブサーバが数メガバイトのファイルからマップを構築する
のに数分かかるのにたいし、転送では数秒しかかかりません。
.Pp
.Nm
サーバは、
.Xr ypserv 8
と同じアクセス制限メカニズムを使っています。
したがって、
.Xr securenets 5
データベースで許されているスレーブサーバのみがファイルを転送できます。
さらに、reserved ポートを使うスレーブサーバのみが、
.Pa master.passwd
マップを転送することを許されています。
.Sh オプション
オプションは以下の通りです:
.Bl -tag -width indent
.It Fl p Ar path
このオプションにより、デフォルトの NIS データベースへのパスを変更しま
す。デフォルトパスは、
.Pa /var/yp
です。
.El
.Sh 関連ファイル
.Bl -tag -width Pa -compact
.It Pa /var/yp/[domainname]/[maps]
ある NIS ドメインの NIS マップ群。
.El
.Sh 関連項目
.Xr yp 4 ,
.Xr yppush 8 ,
.Xr ypserv 8 ,
.Xr ypxfr 8
.Sh バグ
.Fx
の
.Nm
プロトコルは SunOS で使われているものと互換性がありません。これは残念な
ことではありますが、避けることが出来ません: Sun のプロトコルは
自由に入手することは出来ず、さらに入手できたとしても、
SunOS NIS v2 の実装ではマップデータベースに ndbm パッケージを使ってお
り、
.Fx
の実装で使われている Berkeley DB パッケージではないため不便です。
これらの二つのパッケージ間のフォーマットは非常に異なっています。
さらに、 ndbm はバイトオーダの問題があり、ビッグエンディアンのシステムで
作った ndbm データベースはリトルエンディアンのシステムでは読むことが出来
ません。
.Sh 作者
.An Bill Paul Aq wpaul@ctr.columbia.edu
|
