manual/ypserv/draft/man8/ypxfr.8

   1 .\" Copyright (c) 1996, 1997, 1999 Thorsten Kukuk <kukuk@suse.de>
   2 .\" Copyright (c) 1996, 1997, 1999, 2001 Thorsten Kukuk <kukuk@suse.de>
   3
   4 .\" $Id: ypxfr.8,v 1.4 2001/12/01 15:25:31 nakano Exp $
   5 .\"
   6 .\" This manual page is a part of ypserv archive.
   7 .\" README states the following
   8 .\"
   9 .\" See the file COPYING for copying restrictions. It is available under
  10 .\" the GNU General Public License.
  11 .\"
  12 .\" Japanese Version Copyright (c) 1998, 1999 NAKANO Takeo all rights reserved.
  13 .\" Translated Mon 23 Nov 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  14 .\" Updated Fri 22 Oct 1999 by NAKANO Takeo
  15 .\"
  16 .\"O .TH YPSERV 8 "August 2001" "YP Server" ""
  17 .TH YPXFR 8 "August 2001" "YP Server" ""
  18 .\"O .SH NAME
  19 .\"O ypxfr - transfer NIS database from remote server to local host
  20 .SH Ì¾Á°
  21 ypxfr \- NIS ¥Ç¡¼¥¿¡¼¥Ù¡¼¥¹¤ò¥ê¥â¡¼¥È¥µ¡¼¥Ð¡¼¤«¤é¥í¡¼¥«¥ë¥Û¥¹¥È¤ËÅ¾Á÷¤¹¤ë
  22 .\"O .SH SYNOPSIS
  23 .SH ½ñ¼°
  24 .B /usr/lib/yp/ypxfr
  25 [
  26 .B \-f
  27 ]
  28 [
  29 .B \-c
  30 ]
  31 [
  32 .B \-d
  33 .I target domain
  34 ]
  35 .if n .ti +5n
  36 [
  37 .B \-h
  38 .I source host
  39 ]
  40 [
  41 .B \-s
  42 .I source domain
  43 ]
  44 .if n .ti +5n
  45 [
  46 .B \-C
  47 .I taskid
  48 .I program-number
  49 .I ipaddr port
  50 ]
  51 .if n .ti +5n
  52 [
  53 .B \-p
  54 .I yp_path
  55 ]
  56 mapname ...
  57
  58 .\"O .SH DESCRIPTION
  59 .SH ÀâÌÀ
  60 .\"O .B ypxfr
  61 .\"O copies an NIS database from one NIS server to the local host by
  62 .\"O using the NIS service.
  63 .B ypxfr
  64 ¤Ï NIS ¥Ç¡¼¥¿¡¼¥Ù¡¼¥¹¤ò NIS ¥µ¡¼¥Ð¡¼¤«¤é¥í¡¼¥«¥ë¥Û¥¹¥È¤Ë
  65 NIS ¥µ¡¼¥Ó¥¹¤òÍÑ¤¤¤Æ¥³¥Ô¡¼¤¹¤ë¡£
  66 .\"O .B ypxfr
  67 .\"O is generally invoked by
  68 .\"O .B ypinit
  69 .\"O or by
  70 .\"O .B ypserv,
  71 .\"O when
  72 .\"O .B ypserv
  73 .\"O receives a map transfer request from
  74 .\"O .B yppush.
  75 .B ypxfr
  76 ¤ÏÄÌ¾ï
  77 .B ypinit
  78 ¤«¤éµ¯Æ°¤µ¤ì¤ë¤«¡¢
  79 .B yppush
  80 ¤«¤é¥Þ¥Ã¥×Å¾Á÷Í×µá¤ò¼õ¤±¼è¤Ã¤¿
  81 .B ypserv
  82 ¤Ë¤è¤Ã¤Æµ¯Æ°¤µ¤ì¤ë¡£
  83 .\"O It creates a temporary map in the directory
  84 .\"O .B /var/yp/domain
  85 .\"O (this  directory  must already  exist;
  86 .\"O .I domain
  87 .\"O is the default domainname for the local host), fills it by getting
  88 .\"O the map's entries and fetches the map parameters (master and order number).
  89 .B ypxfr
  90 ¤Ï°ì»þÅª¤Ê¥Þ¥Ã¥×¤ò
  91 .B /var/yp/domain
  92 ¥Ç¥£¥ì¥¯¥È¥ê¤ËÀ¸À®¤· (¤³¤Î¥Ç¥£¥ì¥¯¥È¥ê¤ÏÂ¸ºß¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
  93 .I domain
  94 ¤Ï¥í¡¼¥«¥ë¥Û¥¹¥È¤Î¥Ç¥Õ¥©¥ë¥È¥É¥á¥¤¥óÌ¾¤Ç¤¢¤ë)¡¢
  95 ¤½¤Î¥Þ¥Ã¥×¤Î¥¨¥ó¥È¥ê¤ò¼èÆÀ¤·¤ÆÆâÍÆ¤ò½ñ¤¹þ¤ß¡¢¥Þ¥Ã¥×¤Î¥Ñ¥é¥á¡¼¥¿
  96 (¥Þ¥¹¥¿¡¼¤È¥ª¡¼¥À¡¼ÈÖ¹æ) ¤ò¼èÆÀ¤¹¤ë¡£
  97 .\"O If the transfer was successful, the old version of the map will be
  98 .\"O deleted and the temporary copy will be moved into its place.
  99 .\"O Then,
 100 .\"O .B ypxfr
 101 .\"O will attempt to send a "clear current map" request to the local
 102 .\"O .B ypserv.
 103 Å¾Á÷¤¬À®¸ù¤·¤¿¤é¡¢¸Å¤¤¥Ð¡¼¥¸¥ç¥ó¤Î¥Þ¥Ã¥×¤Ïºï½ü¤µ¤ì¡¢
 104 ¤³¤Î°ì»þÅª¤Ê¥Þ¥Ã¥×¤ÎÆâÍÆ¤¬¤½¤³¤Ë½ñ¤¹þ¤Þ¤ì¤ë¡£
 105 ¼¡¤Ë
 106 .B ypxfr
 107 ¤Ï "clear current map" Í×µá¤ò¥í¡¼¥«¥ë¤Î
 108 .B ypserv
 109 ¤ËÁ÷¤í¤¦¤È»î¤ß¤ë¡£
 110
 111 .\"O If  run interactively,
 112 .\"O .B ypxfr
 113 .\"O writes its output to stderr.
 114 .\"O However, if it is invoked without a controlling terminal, it will
 115 .\"O log the output to syslog.
 116 ¥¤¥ó¥¿¥é¥¯¥Æ¥£¥Ö¤Ê·Á¼°¤Ç¼Â¹Ô¤µ¤ì¤ë¤È¡¢
 117 .B ypxfr
 118 ¤Ï½ÐÎÏ¤òÉ¸½à¥¨¥é¡¼½ÐÎÏ¤Ë½ñ¤½Ð¤¹¡£¤·¤«¤·À©¸æÃ¼Ëö¤Ê¤·¤Ç
 119 µ¯Æ°¤µ¤ì¤¿¾ì¹ç¤Ë¤Ï¡¢½ÐÎÏ¤Ï syslog ¤ËµÏ¿¤µ¤ì¤ë¡£
 120
 121 .\"O .B ypxfr
 122 .\"O is used primarily in environments where several NIS servers are in use.
 123 .\"O For all maps, you have a NIS master server, which  maintains a canonical
 124 .\"O copy of the NIS map, and all the other servers, the NIS slaves, copy
 125 .\"O the new version of the map from the master whenever a update was made.
 126 .\"O Normally, you have one NIS master for all maps.
 127 .B ypxfr
 128 ¤¬ÍÑ¤¤¤é¤ì¤ë¤Î¤Ï¡¢Ê£¿ô¤Î NIS ¥µ¡¼¥Ð¡¼¤¬ÍÑ¤¤¤é¤ì¤Æ¤¤¤ë¤è¤¦¤Ê
 129 ´Ä¶¤Ë¤ª¤¤¤Æ¤Ç¤¢¤ë¡£¤¢¤é¤æ¤ë¥Þ¥Ã¥×¤ËÂÐ¤·¤Æ¡¢¤½¤Î¥Þ¥Ã¥×¤Î¸¶ËÜ¤ò
 130 ÊÝ»ý¤·¤Æ¤¤¤ë NIS ¥Þ¥¹¥¿¡¼¥µ¡¼¥Ð¡¼¤¬°ì¤Ä¤À¤±Â¸ºß¤¹¤ë¡£Â¾¤Î¥µ¡¼¥Ð¤Ï
 131 ¤¹¤Ù¤Æ NIS ¥¹¥ì¡¼¥Ö¥µ¡¼¥Ð¡¼¤È¤Ê¤ê¡¢¥Þ¥¹¥¿¡¼¥µ¡¼¥Ð¡¼¤Ç¥Þ¥Ã¥×¤¬
 132 ¹¹¿·¤µ¤ì¤ë¤¿¤Ó¤Ë¡¢¿·¤·¤¤ÈÇ¤Î¥Þ¥Ã¥×¤ò¥³¥Ô¡¼¤¹¤ë¡£
 133 ÄÌ¾ï¤Ï°ìÂæ¤Î NIS ¥µ¡¼¥Ð¡¼¤Ë¤¹¤Ù¤Æ¤Î¥Þ¥Ã¥×¤Î´ÉÍý¤ò½¸Ãæ¤µ¤»¤ë¡£
 134
 135 .\"O In order to maintain consistency across all NIS servers,
 136 .\"O .B ypxfr
 137 .\"O can be run periodically in a
 138 .\"O .B cron
 139 .\"O job. Maps which change infrequently need only be updated once a day
 140 .\"O (preferably late at night when system usage is lowest), where those
 141 .\"O with frequent changes (such as
 142 .\"O .I passwd.byname
 143 .\"O and
 144 .\"O .I passwd.byuid )
 145 .\"O should be updated perhaps once every hour.
 146 ¤³¤ì¤é¤¹¤Ù¤Æ¤Î NIS ¥µ¡¼¥Ð¡¼¤Î´Ö¤Ç¥Þ¥Ã¥×¤ÎÆâÍÆ¤ò°ìÃ×¤µ¤»¤Æ¤ª¤¯¤¿¤á¤Ë¤Ï¡¢
 147 .B ypxfr
 148 ¤ò
 149 .B cron
 150 ¥¸¥ç¥Ö¤È¤·¤ÆÄê´üÅª¤ËÆ°ºî¤µ¤»¤ë¤ÈÎÉ¤¤¡£¤¢¤Þ¤êÊÑ¹¹¤µ¤ì¤Ê¤¤¥Þ¥Ã¥×¤Ï
 151 °ìÆü¤Ë°ì²ó¹¹¿·¤¹¤ì¤Ð¤è¤¤¤À¤í¤¦¤· (¥·¥¹¥Æ¥à¤Î»ÈÍÑÎ¨¤¬ºÇÄã¤È¤Ê¤ë¤è¤¦¤Ê
 152 ÌëÃÙ¤¯¤¬¹¥¤Þ¤ì¤ë)¡¢ÉÑÈË¤ËÊÑ¹¹¤µ¤ì¤ë¥Þ¥Ã¥× (
 153 .IR passwd.byname " ¤ä " passwd.byuid
 154 ¤Ê¤É) ¤Ï°ì»þ´Ö¤Ë°ì²ó¤¯¤é¤¤¹¹¿·¤¹¤ëÉ¬Í×¤¬¤¢¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
 155 .\"O Examples are in
 156 .\"O .B /usr/lib/yp: ypxfr_1perday, ypxfr_2perday,
 157 .\"O and
 158 .\"O .B ypxfr_1perhour.
 159 .\"O They can serve as reasonable first cuts.
 160 ¤³¤ì¤é¤ÎÎã¤Ï
 161 .B /usr/lib/yp
 162 ¤Î
 163 .BR ypxfr_1perday ", " ypxfr_2perday ", " ypxfr_1perhour
 164 ¤Ê¤É¤Ë¼¨¤·¤Æ¤¢¤ë¡£¤È¤ê¤¢¤¨¤ºÆ°¤«¤·¤Æ¤ß¤ë¤Ë¤Ï¡¢
 165 ¤³¤ì¤é¤òÍÑ¤¤¤Æ¤ß¤ë¤ÈÎÉ¤¤¤À¤í¤¦¡£
 166
 167 .\"O Normally all updates should be propagated by
 168 .\"O .B yppush
 169 .\"O when
 170 .\"O .B /var/yp/Makefile
 171 .\"O is run on the NIS master server, however it is a good practice
 172 .\"O on large networks where possible outages could cause NIS slaves to
 173 .\"O fall out of sync with the master.
 174 NIS ¥Þ¥¹¥¿¡¼¥µ¡¼¥Ð¡¼¤Ç
 175 .B /var/yp/Makefile
 176 ¤¬¼Â¹Ô¤µ¤ì¤¿¤é¡¢
 177 ÄÌ¾ï¤Ï¤½¤Î¹¹¿·ÆâÍÆ¤ò
 178 .B yppush
 179 ¤òÍÑ¤¤¤ÆÅÁÇÅ¤µ¤»¤ë¤Ù¤¤Ç¤¢¤ë¡£
 180 ¤·¤«¤·Âç¤¤Ê¥Í¥Ã¥È¥ï¡¼¥¯¤Î¾ì¹ç¤Ë¤Ï¡¢ÄÌ¿®¾ã³²¤Ê¤É¤Ë¤è¤Ã¤Æ
 181 NIS ¥¹¥ì¡¼¥Ö¤ÎÆ±´ü¤¬¥Þ¥¹¥¿¡¼¤È¤º¤ì¤ë¤³¤È¤â¤¢¤ë¤À¤í¤¦¤«¤é¡¢
 182 ¤³¤Î¤è¤¦¤Ë
 183 .B ypxfr
 184 ¤ò»È¤¦¤Î¤ÏÎÉ¤¤¤³¤È¤Ç¤¢¤ë¡£
 185
 186 .\"O .SH OPTIONS
 187 .\"O The following options are supported:
 188 .SH ¥ª¥×¥·¥ç¥ó
 189 °Ê²¼¤Î¥ª¥×¥·¥ç¥ó¤¬¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¡£
 190 .TP
 191 .B \-f
 192 .\"O Force a map transfer. Normally,
 193 .\"O .B ypxfr
 194 .\"O will not transfer a map if it determines that the NIS master's copy
 195 .\"O is not newer than the existing copy already on the local host. This
 196 .\"O flag forces a transfer regardless of which server's version is more
 197 .\"O recent.
 198 ¥Þ¥Ã¥×¤ÎÅ¾Á÷¤ò¶¯À©¤¹¤ë¡£ÄÌ¾ï¤ÎÆ°ºî¤Ç¤Ï¡¢
 199 NIS ¥Þ¥¹¥¿¡¼¤Ë¤¢¤ë¥Þ¥Ã¥×¤¬¥í¡¼¥«¥ë¥Û¥¹¥È¤Ë¤¹¤Ç¤ËÂ¸ºß¤¹¤ë¥³¥Ô¡¼¤è¤ê¤â
 200 ¿·¤·¤¯¤Ê¤¤¤ÈÈ½ÃÇ¤µ¤ì¤ë¤È¡¢
 201 .B ypxfr
 202 ¤Ï¥Þ¥Ã¥×¤ÎÅ¾Á÷¤ò¹Ô¤ï¤Ê¤¤¡£¤³¤Î¥Õ¥é¥°¤ò»ØÄê¤¹¤ë¤È¡¢
 203 ¤É¤Î¥µ¡¼¥Ð¡¼¤ÎÈÇ¤¬ºÇ¿·¤Ç¤¢¤ë¤«¤òÌä¤ï¤º¡¢¶¯À©Åª¤ËÅ¾Á÷¤¬¹Ô¤ï¤ì¤ë¡£
 204 .TP
 205 .B \-c
 206 .\"O Do not send a "clear current map" request to the
 207 .\"O .B ypserv
 208 .\"O process running on the local host. This flag is normally used when
 209 .\"O invoking
 210 .\"O .B ypxfr
 211 .\"O by
 212 .\"O .B ypinit
 213 .\"O or if
 214 .\"O .B ypserv
 215 .\"O is not  running  locally  at  the time you are running
 216 .\"O .B ypxfr.
 217 .\"O Otherwise,
 218 .\"O .B ypxfr
 219 .\"O will complain that it cannot talk to the local
 220 .\"O .B ypserv,
 221 .\"O and the transfer will fail.
 222 ¥í¡¼¥«¥ë¤ÇÆ°ºî¤·¤Æ¤¤¤ë
 223 .B ypserv
 224 ¥×¥í¥»¥¹¤Ë "clear current map" Í×µá¤òÁ÷¤é¤Ê¤¤¡£
 225 .B ypxfr
 226 ¤¬
 227 .B ypinit
 228 ¤«¤éµ¯Æ°¤µ¤ì¤¿¾ì¹ç¤ä¡¢
 229 .B ypxfr
 230 ¤Îµ¯Æ°»þ¤Ë
 231 .B ypserv
 232 ¤¬Æ°ºî¤·¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ê¤É¤Ë¤ÏÄÌ¾ï¤³¤Î¥Õ¥é¥°¤ò»ØÄê¤¹¤ë¡£¤µ¤â¤Ê¤¤¤È
 233 .B ypxfr
 234 ¤Ï¥í¡¼¥«¥ë¤Î
 235 .B ypserv
 236 ¤ÈÄÌ¿®¤Ç¤¤Ê¤¤»Ý¤Î¥¨¥é¡¼¤ò½Ð¤·¡¢Å¾Á÷¤Ï¼ºÇÔ¤¹¤ë¡£
 237 .TP
 238 .BI \-d " domain"
 239 .\"O Specify a domain other than the default NIS domain.
 240 ¥Ç¥Õ¥©¥ë¥È¤Î NIS ¥É¥á¥¤¥ó¤ÎÂå¤ï¤ê¤ËÍÑ¤¤¤ë¥É¥á¥¤¥ó¤ò»ØÄê¤¹¤ë¡£
 241 .TP
 242 .BI \-h " source host"
 243 .\"O Get the map from
 244 .\"O .IR host ,
 245 .\"O regardless of what the map says the master is.  If
 246 .\"O .I host
 247 .\"O is not specified,
 248 .\"O .B ypxfr
 249 .\"O asks the
 250 .\"O .SM NIS
 251 .\"O service for the name of the master, and tries to get the
 252 .\"O map from there. This option is used to insure that ypxfr only copies
 253 .\"O maps from the NIS master server.
 254 ¥Þ¥Ã¥×¤Ë½ñ¤«¤ì¤Æ¤¤¤ë¥Þ¥¹¥¿¡¼¤Î¾ðÊó¤òÌµ»ë¤·¤Æ¡¢¥Þ¥Ã¥×¤ò
 255 .I host
 256 ¤«¤é¼èÆÀ¤¹¤ë¡£
 257 .I host
 258 ¤¬»ØÄê¤µ¤ì¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢
 259 .B ypxfr
 260 ¤Ï
 261 .SM NIS
 262 ¥µ¡¼¥Ó¥¹¤Ë¥Þ¥¹¥¿¡¼¤ÎÌ¾Á°¤òÌä¤¤¹ç¤ï¤»¤Æ¡¢¤½¤³¤«¤é¥Þ¥Ã¥×¤ò¼èÆÀ¤·¤è¤¦¤È¤¹¤ë¡£
 263 ¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï
 264 .B ypxfr
 265 ¤¬¥Þ¥Ã¥×¤Î¼èÆÀÀè¤È¤¹¤ë NIS ¥Þ¥¹¥¿¡¼¥µ¡¼¥Ð¡¼¤òÊÝ¾Ú¤¹¤ë¤¿¤á¤ËÍÑ¤¤¤é¤ì¤ë¡£
 266 .TP
 267 .BI \-s " source domain"
 268 .\"O Specify a source domain from which to transfer a map that should be the same
 269 .\"O across domains.
 270 ¥Þ¥Ã¥×¤Î¼èÆÀÀè¤È¤¹¤ë¥½¡¼¥¹¥É¥á¥¤¥ó¤ò»ØÄê¤¹¤ë¡£
 271 ¤½¤Î¥Þ¥Ã¥×¤ò¥É¥á¥¤¥ó¤òÄÌ¤·¤ÆÆ±¤¸¤â¤Î¤È¤·¤¿¤¤¾ì¹ç¤ËÍ¸ú¡£
 272 .TP
 273 .BI \-C  " taskid progam-number ipaddr port"
 274 .\"O This option is
 275 .\"O .B only
 276 .\"O for use by
 277 .\"O .B ypserv .
 278 .\"O When
 279 .\"O .B ypserv
 280 .\"O invokes
 281 .\"O .BR ypxfr ,
 282 .\"O it specifies that
 283 .\"O .B ypxfr
 284 .\"O should call back a
 285 .\"O .B yppush
 286 .\"O process at the host with
 287 .\"O .SM IP
 288 .\"O address
 289 .\"O .IR ipaddr ,
 290 .\"O registered as program number
 291 .\"O .IR progam-number ,
 292 .\"O listening on port
 293 .\"O .IR port ,
 294 .\"O and waiting for a response to transaction
 295 .\"O .IR taskid .
 296 ¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï
 297 .B ypserv
 298 ¤Ë¤è¤Ã¤Æ\fB¤Î¤ß\fPÍÑ¤¤¤é¤ì¤ë¡£
 299 .B ypserv
 300 ¤¬
 301 .B ypxfr
 302 ¤òµ¯Æ°¤¹¤ë¤È¤¤Ë¡¢
 303 .B ypxfr
 304 ¤¬
 305 .B yppush
 306 ¥×¥í¥»¥¹¤ò¥³¡¼¥ë¥Ð¥Ã¥¯¤¹¤ëÀè (
 307 .SM IP
 308 ¥¢¥É¥ì¥¹
 309 .I ipaddr
 310 ¤Î¥Û¥¹¥È¤Î¡¢Í½ÌóºÑ¤ß¥×¥í¥°¥é¥àÈÖ¹æ
 311 .IR progam-number ¡¢
 312 ¥Ý¡¼¥ÈÈÖ¹æ
 313 .IR port
 314 ¤¬¡¢¥È¥é¥ó¥¶¥¯¥·¥ç¥ó
 315 .I taskid
 316 ¤Ø¤Î¥ì¥¹¥Ý¥ó¥¹¤òÂÔ¤Ã¤Æ¤¤¤ë)
 317 ¤ò»ØÄê¤¹¤ë¡£
 318 .TP
 319 .BI \-p " yp_path"
 320 .\"O Change the directory for the maps to
 321 .\"O \fIyp_path/[domainname]/\fP, the default
 322 .\"O is \fI/var/yp/[domainname]\fP.
 323 ¥Þ¥Ã¥×¤Î¥Ç¥£¥ì¥¯¥È¥ê¤ò
 324 .I yp_path/[domainname]
 325 ¤ËÊÑ¹¹¤¹¤ë¡£¥Ç¥Õ¥©¥ë¥È¤Ï
 326 .I /var/yp/[domainname]
 327 ¤Ç¤¢¤ë¡£
 328 .TP
 329 .I mapname
 330 .\"O One or more names of the map to transfer.
 331 Å¾Á÷¤¹¤ë¥Þ¥Ã¥×¤ÎÌ¾Á°¤ò»ØÄê¤¹¤ë (Ê£¿ô»ØÄê²Ä)¡£
 332 .\"O .SH FILES
 333 .SH ¥Õ¥¡¥¤¥ë
 334 /var/yp/[domainname]/[maps]
 335 .\"O .SH "SEE ALSO"
 336 .SH ´ØÏ¢¹àÌÜ
 337 .BR ypserv (8),
 338 .BR yppush (8),
 339 .BR ypinit (8),
 340 .BR cron (8),
 341 .BR crontab (5)
 342 .\"O .SH AUTHOR
 343 .SH Ãø¼Ô
 344 Thorsten Kukuk <kukuk@suse.de>