1updateclnt(8)               System Manager's Manual              updateclnt(8)
2
3
4

NAME

6       updateclnt - update client executables
7

SYNOPSIS

9       updateclnt [ -d debug_level ] [ -h host_name ] [ -q service_name ] [ -w
10       wait_interval ] [ -r reps ]
11

DESCRIPTION

13       The updateclnt command is a client process to  the  updatesrv  process.
14       It is used to keep the binaries and data bases on a file server in sync
15       with those on a control machine.  The arguments include:
16
17       -d debug_level
18              This  option  changes  the  debugging  level.   The  higher  the
19              debug_level, the more information is printed.  Maximum debugging
20              level is 10.
21
22
23       -h host_name
24              This is the hostname of the  control  machine  with  which  this
25              process keeps up-to-date.  Default: scm.
26
27
28       -q service_name
29              This  is  the  name  in /etc/services that should be used as the
30              connect portal on the  machine  specified  by  host_name  above.
31              Default: rupdsrv.
32
33
34       -w wait_interval
35              The interval between probes, in seconds.  The lower this number,
36              the quicker the servers will be updated when a change occurs and
37              the  more  cpu  and  network  resources required.  Default: 300s
38              (5min).
39
40
41       -b     This option forces a .BAK file to be kept for any file  that  is
42              changed.
43
44
45       -r reps
46              This is the number of wait intervals between long checks.  Files
47              are checked at two intervals.  The interval specified by  -w  is
48              used  for  those files in /vice/db.  All other files are checked
49              once each -r repetitions of length -w. Default: 6, so  the  long
50              interval is 30min.
51
52
53       Updateclnt checks /vice/db every wait_interval seconds.  This directory
54       contains a file called files.  Each file specified in it has  its  cur‐
55       rent  date checked at the server, and a new copy of the file is fetched
56       if the date does not match that on the control machine.  The format  of
57       the files file is defined below.
58

EXAMPLES

60       The  command  updateclnt  -h  mahler  would cause the client machine to
61       check the host "mahler" every 5 minutes to see if any of  the  /vice/db
62       files  have changed and every 30 minutes to see if any other files have
63       changed.  Normally the command is invoked by issuing the updatemon  (8)
64       command with the same operands.
65

FORMAT

67       The  format  of  the files file is one file name per line. A "-" as the
68       first character on the line causes the file to be  deleted  instead  of
69       copied.
70

DIAGNOSTICS

72       The  updateclnt  program can have its debug level turned on while it is
73       running by sending a kill -TSTP signal to  a  running  updateclnt.   To
74       reset the debug level back to zero, send a kill -HUP signal to the run‐
75       ning updateclnt. This also causes the UpdateLog file to not be  written
76       anymore.
77

FILES

79       /vice/srv/UpdateLog
80              is  the name of the log file for the updateclnt command.  It can
81              be viewed by using the command tail -f /vice/file/UpdateLog.  It
82              is only written if debugging has been started.
83
84
85       /vice/srv/UpdatePid
86              is the pid of the updateclnt process.
87
88
89       /vice/srv/UpdateMon
90              is  the  pid of the updatemon process that is keeping updateclnt
91              running.
92
93

BUGS

95       There is no easy way to add to the list of directories checked.
96
97       The -r option is now obsolete as updateclnt does not update any  direc‐
98       tory other then /vice/db.
99

SEE ALSO

101       updatesrv (8)
102

AUTHOR

104       Maria R. Ebling, 1990, Adapted from AFS
105
106                                                                 updateclnt(8)
Impressum