1ypxfr(1M)               System Administration Commands               ypxfr(1M)
2
3
4

NAME

6       ypxfr,  ypxfr_1perday, ypxfr_1perhour, ypxfr_2perday - transfer NIS map
7       from a NIS server to host
8

SYNOPSIS

10       /usr/lib/netsvc/yp/ypxfr [-c] [-f] [-C tid prog server]
11            [-d ypdomain] [-h host] [-s ypdomain] mapname
12
13

DESCRIPTION

15       The ypxfr command moves an NIS map in the default domain for the  local
16       host to the local host by making use of normal NIS services. It creates
17       a temporary map in the directory /var/yp/ypdomain (this directory  must
18       already  exist;  ypdomain  is  the  default domain for the local host),
19       fills it by enumerating the map's entries, fetches the  map  parameters
20       (master and order number), and loads them. It then deletes any old ver‐
21       sions of the map and moves the temporary map to the real name.
22
23
24       If run interactively, ypxfr writes its output to the terminal. However,
25       if  it  is  started without a controlling terminal, and if the log file
26       /var/yp/ypxfr.log exists, it appends all its output to that file. Since
27       ypxfr  is most often run from the privileged user's crontab file, or by
28       ypserv, the log file can retain a record of  what  was  attempted,  and
29       what the results were.
30
31
32       For  consistency  between servers, ypxfr should be run periodically for
33       every map in the NIS data base.  Different  maps  change  at  different
34       rates:  a  map might not change for months at a time, for instance, and
35       can therefore be checked only once a day. Some maps might  change  sev‐
36       eral  times per day. In such a case, you might want to check hourly for
37       updates. A crontab(1) entry can be used to automatically perform  peri‐
38       odic updates. Rather than having a separate crontab entry for each map,
39       you can group commands to update several maps in a shell script.  Exam‐
40       ples   (mnemonically   named)   are   in  /usr/sbin/yp:  ypxfr_1perday,
41       ypxfr_2perday, and ypxfr_1perhour.
42
43
44       Refer to ypfiles(4) for an overview of the NIS name service.
45

OPTIONS

47       -c                    Do not send a "Clear current map" request to  the
48                             local  ypserv process. Use this flag if ypserv is
49                             not running locally at the time you  are  running
50                             ypxfr.  Otherwise, ypxfr complains that it cannot
51                             communicate with the local ypserv, and the trans‐
52                             fer fails.
53
54
55       -f                    Force  the  transfer to occur even if the version
56                             at the master is not more recent than  the  local
57                             version.
58
59
60       -C tid prog server    This  option  is  for  use  only  by ypserv. When
61                             ypserv starts  ypxfr,  it  specifies  that  ypxfr
62                             should  call  back  a  yppush process at the host
63                             server, registered as program  number  prog,  and
64                             waiting for a response to transaction tid.
65
66
67       -d ypdomain           Specify a domain other than the default domain.
68
69
70       -h host               Get  the map from host, regardless of the master.
71                             If host is not specified, ypxfr asks the NIS ser‐
72                             vice for the name of the master, and tries to get
73                             the map from there. host must  be  a  valid  host
74                             name.
75
76
77       -s ypdomain           Specify  a source domain from which to transfer a
78                             map that should be the same across domains.
79
80

FILES

82       /var/yp/ypxfr.log
83
84           Log file
85
86
87       /usr/lib/netsvc/yp/ypxfr_1perday
88
89           Script to run one transfer per day, for use with cron(1M)
90
91
92       /usr/lib/netsvc/yp/ypxfr_2perday
93
94           Script to run two transfer per day, for use with cron(1M)
95
96
97       /usr/lib/netsvc/yp/ypxfr_1perhour
98
99           Script for hourly transfers of volatile maps
100
101
102       /var/yp/ypdomain
103
104           NIS domain
105
106
107       /usr/spool/cron/crontabs/root
108
109           Privileged user's crontab file
110
111

ATTRIBUTES

113       See attributes(5) for descriptions of the following attributes:
114
115   ypxfr Only
116       ┌─────────────────────────────┬─────────────────────────────┐
117       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
118       ├─────────────────────────────┼─────────────────────────────┤
119       │Availability                 │SUNWnisu                     │
120       └─────────────────────────────┴─────────────────────────────┘
121
122   ypxfr_1perday, ypxfr_1perhour, and ypxfr_2perday
123       ┌─────────────────────────────┬─────────────────────────────┐
124       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
125       ├─────────────────────────────┼─────────────────────────────┤
126       │Availability                 │SUNWypu                      │
127       └─────────────────────────────┴─────────────────────────────┘
128

SEE ALSO

130       crontab(1), cron(1M), ypinit(1M), yppush(1M),  ypserv(1M),  ypfiles(4),
131       attributes(5)
132
133
134
135SunOS 5.11                        11 Mar 1998                        ypxfr(1M)
Impressum