[BACK]Return to rdist.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / rdist

Diff for /src/usr.bin/rdist/rdist.1 between version 1.21 and 1.22

version 1.21, 2004/07/13 23:18:10 version 1.22, 2007/02/26 15:38:04
Line 39 
Line 39 
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm rdist  .Nm rdist
 .Bk -words  .Bk -words
 .Op Fl DFn  .Op Fl DFnV
   .Op Fl Server
 .Op Fl A Ar num  .Op Fl A Ar num
 .Op Fl a Ar num  .Op Fl a Ar num
 .Op Fl d Ar var=value  .Op Fl c Ar mini_distfile
 .Op Fl l Ar <local logopts>  .Oo
 .Op Fl L Ar <remote logopts>  .Fl d Ar var Ns = Ns Ar value
   .Oc
 .Op Fl f Ar distfile  .Op Fl f Ar distfile
   .Op Fl L Ar remote_logopts
   .Op Fl l Ar local_logopts
 .Op Fl M Ar maxproc  .Op Fl M Ar maxproc
 .Op Fl m Ar host  .Op Fl m Ar host
 .Op Fl o Ar distopts  .Op Fl o Ar distopts
   .Op Fl P Ar rsh-path
   .Op Fl p Ar rdistd-path
 .Op Fl t Ar timeout  .Op Fl t Ar timeout
 .Op Fl p Ar <rdistd-path>  
 .Op Fl P Ar <rsh-path>  
 .Op Ar name ...  .Op Ar name ...
 .Ek  .Ek
 .Pp  
 .Nm rdist  
 .Fl DFn  
 .Fl c Ar name ...  
 .Ar [login@]host[:dest]  
 .Pp  
 .Nm rdist  
 .Fl Server  
 .Pp  
 .Nm rdist  
 .Fl V  
 .Sh DESCRIPTION  .Sh DESCRIPTION
 .Nm  .Nm
 is a program to maintain identical copies of files over multiple hosts.  is a program to maintain identical copies of files over multiple hosts.
Line 95 
Line 88 
 If label and file names conflict, it is assumed to be a label.  If label and file names conflict, it is assumed to be a label.
 These may be used together to update specific files using specific commands.  These may be used together to update specific files using specific commands.
 .Pp  .Pp
 The  
 .Fl c  
 option forces  
 .Nm  .Nm
 to interpret the remaining arguments as a small  
 .Pa distfile .  
 The equivalent distfile is as follows.  
 .Bd -literal -offset indent  
 ( \fIname\fP ... ) -> [\fIlogin\fP@]\fIhost\fP  
         install [\fIdest\fP] ;  
 .Ed  
 .Pp  
 The  
 .Fl Server  
 option is recognized to provide partial backward compatible support  
 for older versions of  
 .Nm  
 which used this option to put  
 .Nm  
 into server mode.  
 If  
 .Nm  
 is started with the  
 .Fl Server  
 command line option, it will attempt to exec (run) the old version of  
 .Nm rdist ,  
 .Pa /usr/bin/oldrdist .  
 .Pp  
 .Nm  
 uses a remote shell command to access each target host.  uses a remote shell command to access each target host.
 By default,  By default,
 .Xr ssh 1  .Xr ssh 1
Line 197 
Line 162 
 for  for
 .Nm  .Nm
 to update or install a file.  to update or install a file.
   .It Fl c Ar mini_distfile
   Forces
   .Nm
   to interpret the remaining arguments as a small
   .Pa distfile .
   The equivalent distfile is as follows.
   .Bd -literal -offset indent
   ( \fIname\fP ... ) -> [\fIlogin\fP@]\fIhost\fP
           install [\fIdest\fP] ;
   .Ed
 .It Fl D  .It Fl D
 Enable copious debugging messages.  Enable copious debugging messages.
 .It Fl d Ar var=value  .It Xo
   .Fl d Ar var Ns = Ns Ar value
   .Xc
 Define  Define
 .Ar var  .Ar var
 to have  to have
Line 223 
Line 200 
 is specified as  is specified as
 .Dq -  .Dq -
 (dash) then read from standard input (stdin).  (dash) then read from standard input (stdin).
 .It Fl l Ar logopts  .It Fl L Ar remote_logopts
 Set local logging options.  
 See the section  
 .Sy MESSAGE LOGGING  
 for details on the syntax for  
 .Ar logopts .  
 .It Fl L Ar logopts  
 Set remote logging options.  Set remote logging options.
 .Ar logopts  .Ar logopts
 is the same as for local logging except the values are passed to the remote  is the same as for local logging except the values are passed to the remote
Line 238 
Line 209 
 .Sy MESSAGE LOGGING  .Sy MESSAGE LOGGING
 for details on the syntax for  for details on the syntax for
 .Ar logopts .  .Ar logopts .
 .It Fl M Ar num  .It Fl l Ar local_logopts
   Set local logging options.
   See the section
   .Sy MESSAGE LOGGING
   for details on the syntax for
   .Ar logopts .
   .It Fl M Ar maxproc
 Set the maximum number of simultaneously running child  Set the maximum number of simultaneously running child
 .Nm  .Nm
 processes to  processes to
 .Ar num .  .Ar maxproc .
 The default is 4.  The default is 4.
 .It Fl m Ar machine  .It Fl m Ar host
 Limit which machines are to be updated.  Limit which machines are to be updated.
 Multiple  Multiple
 .Fl m  .Fl m
Line 254 
Line 231 
 Print the commands without executing them.  Print the commands without executing them.
 This option is useful for debugging a  This option is useful for debugging a
 .Pa distfile .  .Pa distfile .
 .It Fl o Ns Ar distopts  .It Fl o Ar distopts
 Specify the dist options to enable.  Specify the dist options to enable.
 .Ar distopts  .Ar distopts
 is a comma separated list of options which are listed below.  is a comma separated list of options which are listed below.
Line 262 
Line 239 
 .Ar distopts  .Ar distopts
 are:  are:
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Sy verify  .It Ic chknfs
 Verify that the files are up to date on all the hosts.  
 Any files that are out of date will be displayed but no files will be  
 changed nor will any mail be sent.  
 .It Sy whole  
 Whole mode.  
 The whole file name is appended to the destination directory name.  
 Normally, only the last component of a name is used when renaming files.  
 This will preserve the directory structure of the files being  
 copied instead of flattening the directory structure.  
 For example, rdisting a list of files such as  
 .Pa /path/dir1/f1  
 and  
 .Pa /path/dir2/f2  
 to  
 .Pa /tmp/dir  
 would create files  
 .Pa /tmp/dir/path/dir1/f1  
 and  
 .Pa /tmp/dir/path/dir2/f2  
 instead of  
 .Pa /tmp/dir/dir1/f1  
 and  
 .Pa /tmp/dir/dir2/f2 .  
 .It Sy noexec  
 Automatically exclude executable files that are in  
 .Xr a.out 5  
 format from being checked or updated.  
 .It Sy younger  
 Younger mode.  
 Files are normally updated if their  
 .Em mtime  
 and  
 .Em size  
 (see  
 .Xr stat 2 )  
 disagree.  
 This option causes  
 .Nm  
 not to update files that are younger than the master copy.  
 This can be used to prevent newer copies on other hosts from being replaced.  
 A warning message is printed for files which are newer than the master copy.  
 .It Sy compare  
 Binary comparison.  
 Perform a binary comparison and update files if they differ rather than  
 comparing dates and sizes.  
 .It Sy follow  
 Follow symbolic links.  
 Copy the file that the link points to rather than the link itself.  
 .It Sy ignlnks  
 Ignore unresolved links.  
 .Nm  
 will normally try to maintain the link structure of files being transferred  
 and warn the user if all the links cannot be found.  
 .It Sy chknfs  
 Do not check or update files on target host that reside on NFS filesystems.  Do not check or update files on target host that reside on NFS filesystems.
 .It Sy chkreadonly  .It Ic chkreadonly
 Enable check on target host to see if a file resides on a read-only filesystem.  Enable check on target host to see if a file resides on a read-only filesystem.
 If a file does, then no checking or updating of the file is attempted.  If a file does, then no checking or updating of the file is attempted.
 .It Sy chksym  .It Ic chksym
 If the target on the remote host is a symbolic link, but is not on the  If the target on the remote host is a symbolic link, but is not on the
 master host, the remote target will be left a symbolic link.  master host, the remote target will be left a symbolic link.
 This behavior is generally considered a bug in the original version of  This behavior is generally considered a bug in the original version of
 .Nm rdist ,  .Nm rdist ,
 but is present to allow compatibility with older versions.  but is present to allow compatibility with older versions.
 .It Sy defgroup[=groupname]  .It Ic compare
   Binary comparison.
   Perform a binary comparison and update files if they differ rather than
   comparing dates and sizes.
   .It Ic defgroup Ns Op = Ns Ic groupname
 If the group of a file to be transferred does not exist on the destination  If the group of a file to be transferred does not exist on the destination
 host, use the specified group instead.  host, use the specified group instead.
 If groupname is not specified, the  If groupname is not specified, the
 .Em bin  .Em bin
 group is used.  group is used.
 .It Sy defowner[=owner]  .It Ic defowner Ns Op = Ns Ic owner
 If the owner of a file to be transferred does not exist on the destination  If the owner of a file to be transferred does not exist on the destination
 host, use the specified owner instead.  host, use the specified owner instead.
 If owner is not specified, the user  If owner is not specified, the user
 .Em bin  .Em bin
 is used.  is used.
 .It Sy updateperm  .It Ic follow
 Do not send the whole file when the size and the modification time match.  Follow symbolic links.
 Instead, just update the ownership, group, and permissions as necessary.  Copy the file that the link points to rather than the link itself.
 .It Sy quiet  .It Ic history
 Quiet mode.  When
 Files that are being modified are normally printed on standard output.  .Ic savetargets
 This option suppresses that.  and
 .It Sy remove  .Ic history
 Remove extraneous files.  are both defined then the target file that is updated is first renamed from
 If a directory is being updated, any files that exist on the remote host  .Pa file
 that do not exist in the master directory are removed.  to
 This is useful for maintaining truly identical copies of directories.  .Pa file.NNN
 .It Sy nochkowner  where NNN increases for each generation update.
 Do not check user ownership of files that already exist.  The first generation is 001, and the last is 999.
 The file ownership is only set when the file is updated.  After 999 generations, the counter is reset to 001 and 001 will get
 .It Sy nochkgroup  overwritten all the time.
   This is undesirable behavior, so some other method needs to be devised
   to clean up or limit the number of generations.
   .It Ic ignlnks
   Ignore unresolved links.
   .Nm
   will normally try to maintain the link structure of files being transferred
   and warn the user if all the links cannot be found.
   .It Ic nochkgroup
 Do not check group ownership of files that already exist.  Do not check group ownership of files that already exist.
 The file ownership is only set when the file is updated.  The file ownership is only set when the file is updated.
 .It Sy nochkmode  .It Ic nochkmode
 Do not check file and directory permission modes.  Do not check file and directory permission modes.
 The permission mode is only set when the file is updated.  The permission mode is only set when the file is updated.
 .It Sy nodescend  .It Ic nochkowner
   Do not check user ownership of files that already exist.
   The file ownership is only set when the file is updated.
   .It Ic nodescend
 Do not descend into a directory.  Do not descend into a directory.
 Normally,  Normally,
 .Nm  .Nm
Line 368 
Line 306 
 If this option is enabled, then any files listed in the file list in the  If this option is enabled, then any files listed in the file list in the
 distfile that are directories are not recursively scanned.  distfile that are directories are not recursively scanned.
 Only the existence, ownership, and mode of the directory are checked.  Only the existence, ownership, and mode of the directory are checked.
 .It Sy numchkgroup  .It Ic noexec
   Automatically exclude executable files that are in
   .Xr a.out 5
   format from being checked or updated.
   .It Ic numchkgroup
 Use the numeric group ID (GID) to check group ownership instead of  Use the numeric group ID (GID) to check group ownership instead of
 the group name.  the group name.
 .It Sy numchkowner  .It Ic numchkowner
 Use the numeric user ID (UID) to check user ownership instead of  Use the numeric user ID (UID) to check user ownership instead of
 the user name.  the user name.
 .It Sy savetargets  .It Ic quiet
   Quiet mode.
   Files that are being modified are normally printed on standard output.
   This option suppresses that.
   .It Ic remove
   Remove extraneous files.
   If a directory is being updated, any files that exist on the remote host
   that do not exist in the master directory are removed.
   This is useful for maintaining truly identical copies of directories.
   .It Ic savetargets
 Save files that are updated instead of removing them.  Save files that are updated instead of removing them.
 Any target file that is updated is first renamed from  Any target file that is updated is first renamed from
 .Pa file  .Pa file
 to  to
 .Pa file.OLD .  .Pa file.OLD .
 .It Sy history  .It Ic sparse
 When  
 .Sy savetargets  
 and  
 .Sy history  
 are both defined then the target file that is updated is first renamed from  
 .Pa file  
 to  
 .Pa file.NNN  
 where NNN increases for each generation update.  
 The first generation is 001, and the last is 999.  
 After 999 generations, the counter is reset to 001 and 001 will get  
 overwritten all the time.  
 This is undesirable behavior, so some other method needs to be devised  
 to clean up or limit the number of generations.  
 .It Sy sparse  
 Enable checking for sparse (aka  Enable checking for sparse (aka
 .Dq wholely )  .Dq wholely )
 files.  files.
Line 403 
Line 339 
 .Xr db 3 .  .Xr db 3 .
 This option adds some additional processing overhead so it should  This option adds some additional processing overhead so it should
 only be enabled for targets likely to contain sparse files.  only be enabled for targets likely to contain sparse files.
   .It Ic updateperm
   Do not send the whole file when the size and the modification time match.
   Instead, just update the ownership, group, and permissions as necessary.
   .It Ic verify
   Verify that the files are up to date on all the hosts.
   Any files that are out of date will be displayed but no files will be
   changed nor will any mail be sent.
   .It Ic whole
   Whole mode.
   The whole file name is appended to the destination directory name.
   Normally, only the last component of a name is used when renaming files.
   This will preserve the directory structure of the files being
   copied instead of flattening the directory structure.
   For example, rdisting a list of files such as
   .Pa /path/dir1/f1
   and
   .Pa /path/dir2/f2
   to
   .Pa /tmp/dir
   would create files
   .Pa /tmp/dir/path/dir1/f1
   and
   .Pa /tmp/dir/path/dir2/f2
   instead of
   .Pa /tmp/dir/dir1/f1
   and
   .Pa /tmp/dir/dir2/f2 .
   .It Ic younger
   Younger mode.
   Files are normally updated if their
   .Em mtime
   and
   .Em size
   (see
   .Xr stat 2 )
   disagree.
   This option causes
   .Nm
   not to update files that are younger than the master copy.
   This can be used to prevent newer copies on other hosts from being replaced.
   A warning message is printed for files which are newer than the master copy.
 .El  .El
 .It Fl p Ar <rdistd-path>  .It Fl P Ar rsh-path
 Set the path where the rdistd server is searched for on the target host.  
 .It Fl P Ar <rsh-path>  
 Set the path to the remote shell command.  Set the path to the remote shell command.
 The  The
 .Ar rsh-path  .Ar rsh-path
Line 415 
Line 390 
 e.g.,  e.g.,
 .Pa "/usr/bin/ssh:/usr/bin/rsh" ,  .Pa "/usr/bin/ssh:/usr/bin/rsh" ,
 .Pa /usr/bin/ssh .  .Pa /usr/bin/ssh .
   .It Fl p Ar rdistd-path
   Set the path where the rdistd server is searched for on the target host.
   .It Fl Server
   This option is recognized to provide partial backward compatible support
   for older versions of
   .Nm
   which used this option to put
   .Nm
   into server mode.
   If
   .Nm
   is started with the
   .Fl Server
   command line option, it will attempt to exec (run) the old version of
   .Nm rdist ,
   .Pa /usr/bin/oldrdist .
 .It Fl t Ar timeout  .It Fl t Ar timeout
 Set the timeout period (in seconds) for waiting for responses from the remote  Set the timeout period (in seconds) for waiting for responses from the remote
 .Nm  .Nm
Legend:
Removed from v.1.21  
changed lines
  Added in v.1.22