===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/rdist/rdist.1,v
retrieving revision 1.7
retrieving revision 1.8
diff -c -r1.7 -r1.8
*** src/usr.bin/rdist/rdist.1	1998/07/24 20:49:04	1.7
--- src/usr.bin/rdist/rdist.1	1999/06/05 01:21:37	1.8
***************
*** 1,4 ****
! .\"	$OpenBSD: rdist.1,v 1.7 1998/07/24 20:49:04 deraadt Exp $
  .\"
  .\" Copyright (c) 1983 Regents of the University of California.
  .\" All rights reserved.
--- 1,4 ----
! .\"	$OpenBSD: rdist.1,v 1.8 1999/06/05 01:21:37 aaron Exp $
  .\"
  .\" Copyright (c) 1983 Regents of the University of California.
  .\" All rights reserved.
***************
*** 40,89 ****
  rdist \- remote file distribution client program
  .SH SYNOPSIS
  .B rdist
! [ 
  .B \-DFn
  ]
! [ 
! .B \-A 
  .I num
- ] 
- [ 
- .B \-a 
- .I num 
  ]
! [ 
! .B \-d 
! .I var=value 
! ] 
! [ 
  .B \-l
  .I <local logopts>
! ] 
! [ 
  .B \-L
  .I <remote logopts>
! ] 
! [ 
! .B \-f 
! .I distfile 
! ] 
! [ 
! .B \-M 
  .I maxproc
- ] 
- [ 
- .B \-m 
- .I host 
  ]
! [ 
  .B \-o
  .I distopts
  ]
- [ 
- .B \-t 
- .I timeout 
- ] 
  [
  .B \-p
  .I <rdistd-path>
  ]
--- 40,89 ----
  rdist \- remote file distribution client program
  .SH SYNOPSIS
  .B rdist
! [
  .B \-DFn
  ]
! [
! .B \-A
  .I num
  ]
! [
! .B \-a
! .I num
! ]
! [
! .B \-d
! .I var=value
! ]
! [
  .B \-l
  .I <local logopts>
! ]
! [
  .B \-L
  .I <remote logopts>
! ]
! [
! .B \-f
! .I distfile
! ]
! [
! .B \-M
  .I maxproc
  ]
! [
! .B \-m
! .I host
! ]
! [
  .B \-o
  .I distopts
  ]
  [
+ .B \-t
+ .I timeout
+ ]
+ [
  .B \-p
  .I <rdistd-path>
  ]
***************
*** 91,104 ****
  .B \-P
  .I <rsh-path>
  ]
! [ 
  .I name ...
  ]
  .PP
  .B rdist
  .B \-DFn
! .B -c 
! .I name ... 
  .I [login@]host[:dest]
  .PP
  .B rdist
--- 91,104 ----
  .B \-P
  .I <rsh-path>
  ]
! [
  .I name ...
  ]
  .PP
  .B rdist
  .B \-DFn
! .B -c
! .I name ...
  .I [login@]host[:dest]
  .PP
  .B rdist
***************
*** 108,114 ****
  .B \-V
  .SH DESCRIPTION
  .I Rdist
! is a program to maintain identical copies of files over multiple hosts. 
  It preserves the owner, group, mode, and mtime of files if possible and
  can update programs that are executing.
  .I Rdist
--- 108,114 ----
  .B \-V
  .SH DESCRIPTION
  .I Rdist
! is a program to maintain identical copies of files over multiple hosts.
  It preserves the owner, group, mode, and mtime of files if possible and
  can update programs that are executing.
  .I Rdist
***************
*** 158,168 ****
  into server mode.
  If
  .I rdist
! is started with the 
  .B \-Server
  command line option, it will attempt to exec (run) the old version of
  .I rdist.
! This option will only work if 
  .I rdist
  was compiled with the location of the old rdist
  (usually either
--- 158,168 ----
  into server mode.
  If
  .I rdist
! is started with the
  .B \-Server
  command line option, it will attempt to exec (run) the old version of
  .I rdist.
! This option will only work if
  .I rdist
  was compiled with the location of the old rdist
  (usually either
***************
*** 174,180 ****
  .I Rdist
  can use either the
  .I rcmd(3)
! function call or the 
  .I rsh(1c),
  remote shell, command to access each target host.
  The method used is selected at compile-time.
--- 174,180 ----
  .I Rdist
  can use either the
  .I rcmd(3)
! function call or the
  .I rsh(1c),
  remote shell, command to access each target host.
  The method used is selected at compile-time.
***************
*** 183,189 ****
  method is used and
  the target host is the string
  .B localhost
! and 
  the remote user name is the same as the local user name,
  .I rdist
  will run the command
--- 183,189 ----
  method is used and
  the target host is the string
  .B localhost
! and
  the remote user name is the same as the local user name,
  .I rdist
  will run the command
***************
*** 204,210 ****
  .RE
  .sp
  .fi
! where 
  .I host
  is the name of the target host,
  .I remuser
--- 204,210 ----
  .RE
  .sp
  .fi
! where
  .I host
  is the name of the target host,
  .I remuser
***************
*** 213,228 ****
  is the rdist server command on the target host as shown below.
  .PP
  If the
! .I rcmd(3) 
  method is used, then
  .I rdist
  makes the connection to the target host itself and runs
! the 
  .I rdistd
  server program as shown below.
  The default, and preferred method, is to use
  .I rsh(1c)
! to make the connection to target hosts.  This allows 
  .I rdist
  to be run without being setuid to ``root''.
  .PP
--- 213,228 ----
  is the rdist server command on the target host as shown below.
  .PP
  If the
! .I rcmd(3)
  method is used, then
  .I rdist
  makes the connection to the target host itself and runs
! the
  .I rdistd
  server program as shown below.
  The default, and preferred method, is to use
  .I rsh(1c)
! to make the connection to target hosts.  This allows
  .I rdist
  to be run without being setuid to ``root''.
  .PP
***************
*** 248,254 ****
  .I \-p
  option was specified.
  If no
! .B \-p 
  option is included,
  or the
  .I <rdistd path>
--- 248,254 ----
  .I \-p
  option was specified.
  If no
! .B \-p
  option is included,
  or the
  .I <rdistd path>
***************
*** 256,262 ****
  .I rdistd
  or
  .I <rdistd path>
! must be somewhere in the 
  .B $PATH
  of the user running
  .B rdist
--- 256,262 ----
  .I rdistd
  or
  .I <rdistd path>
! must be somewhere in the
  .B $PATH
  of the user running
  .B rdist
***************
*** 265,277 ****
  .TP
  .B "\-A \fInum\fR"
  Set the minimum number of free files (inodes) on a filesystem that must exist
! for 
  .I rdist
  to update or install a file.
  .TP
  .B "\-a \fInum\fR"
  Set the minimum amount of free space (in bytes) on a filesystem that must exist
! for 
  .I rdist
  to update or install a file.
  .TP
--- 265,277 ----
  .TP
  .B "\-A \fInum\fR"
  Set the minimum number of free files (inodes) on a filesystem that must exist
! for
  .I rdist
  to update or install a file.
  .TP
  .B "\-a \fInum\fR"
  Set the minimum amount of free space (in bytes) on a filesystem that must exist
! for
  .I rdist
  to update or install a file.
  .TP
***************
*** 291,297 ****
  parentheses and separated by tabs and/or spaces.
  .TP
  .B \-F
! Do not fork any child 
  .I rdist
  processes.
  All clients are updated sequentially.
--- 291,297 ----
  parentheses and separated by tabs and/or spaces.
  .TP
  .B \-F
! Do not fork any child
  .I rdist
  processes.
  All clients are updated sequentially.
***************
*** 299,305 ****
  .B "\-f \fIdistfile\fR"
  Set the name of the distfile to use to be
  .I distfile .
! If 
  .I distfile
  is specified as
  ``\-'' (dash)
--- 299,305 ----
  .B "\-f \fIdistfile\fR"
  Set the name of the distfile to use to be
  .I distfile .
! If
  .I distfile
  is specified as
  ``\-'' (dash)
***************
*** 307,313 ****
  .TP
  .B "\-l \fIlogopts\fR"
  Set local logging options.
! See the section 
  .B "MESSAGE LOGGING"
  for details on the syntax for
  .I logopts.
--- 307,313 ----
  .TP
  .B "\-l \fIlogopts\fR"
  Set local logging options.
! See the section
  .B "MESSAGE LOGGING"
  for details on the syntax for
  .I logopts.
***************
*** 318,324 ****
  is the same as for local logging
  except the values are passed to the remote
  server (\fIrdistd\fR).
! See the section 
  .B "MESSAGE LOGGING"
  for details on the syntax for
  .I logopts.
--- 318,324 ----
  is the same as for local logging
  except the values are passed to the remote
  server (\fIrdistd\fR).
! See the section
  .B "MESSAGE LOGGING"
  for details on the syntax for
  .I logopts.
***************
*** 360,383 ****
  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
! .I /path/dir1/f1 
  and
! .I /path/dir2/f2 
! to 
! .I /tmp/dir 
  would create
! files 
! .I /tmp/dir/path/dir1/f1 
! and 
! .I /tmp/dir/path/dir2/f2 
! instead of 
! .I /tmp/dir/dir1/f1 
! and 
  .I /tmp/dir/dir2/f2.
  .IP \fBnoexec\fR
! Automatically exclude executable files that are in 
  .I a.out(5)
! format from being checked or updated. 
  .IP \fByounger\fR
  Younger mode. Files are normally updated if their
  .I mtime
--- 360,383 ----
  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
! .I /path/dir1/f1
  and
! .I /path/dir2/f2
! to
! .I /tmp/dir
  would create
! files
! .I /tmp/dir/path/dir1/f1
! and
! .I /tmp/dir/path/dir2/f2
! instead of
! .I /tmp/dir/dir1/f1
! and
  .I /tmp/dir/dir2/f2.
  .IP \fBnoexec\fR
! Automatically exclude executable files that are in
  .I a.out(5)
! format from being checked or updated.
  .IP \fByounger\fR
  Younger mode. Files are normally updated if their
  .I mtime
***************
*** 435,441 ****
  The permission mode is only set when the file is updated.
  .IP \fBnodescend\fR
  Do not descend into a directory.
! Normally 
  .I rdist
  will recursively check directories.
  If this option is enabled, then any files listed in the
--- 435,441 ----
  The permission mode is only set when the file is updated.
  .IP \fBnodescend\fR
  Do not descend into a directory.
! Normally
  .I rdist
  will recursively check directories.
  If this option is enabled, then any files listed in the
***************
*** 465,483 ****
  Set the path where the rdistd server is searched for on the target host.
  .TP
  .B "\-P \fI<rsh-path>\fR"
! Set the path to the 
  .I rsh(1c)
  command.
  The
  .I rsh-path
  may be a colon separated list of possible pathnames.
  In this case, the first component of the path to exist is used.
! i.e. 
  .B "/usr/ucb/rsh:/usr/bin/remsh",
  .B /usr/bsd/rsh.
  .TP
  .B "\-t \fItimeout\fR"
! Set the timeout period (in seconds) for waiting for responses from the remote 
  .I rdist
  server.
  The default is 900 seconds.
--- 465,483 ----
  Set the path where the rdistd server is searched for on the target host.
  .TP
  .B "\-P \fI<rsh-path>\fR"
! Set the path to the
  .I rsh(1c)
  command.
  The
  .I rsh-path
  may be a colon separated list of possible pathnames.
  In this case, the first component of the path to exist is used.
! i.e.
  .B "/usr/ucb/rsh:/usr/bin/remsh",
  .B /usr/bsd/rsh.
  .TP
  .B "\-t \fItimeout\fR"
! Set the timeout period (in seconds) for waiting for responses from the remote
  .I rdist
  server.
  The default is 900 seconds.
***************
*** 490,502 ****
  .B facilities
  that each contain a list of message
  .B types
! specifying which types of messages to send to that 
  .I facility.
  The local client (\fIrdist\fR) and the remote server (\fIrdistd\fR) each
  maintain
  their own copy of what types of messages to log to what facilities.
  .LP
! The 
  .B \-l
  .I logopts
  option to
--- 490,502 ----
  .B facilities
  that each contain a list of message
  .B types
! specifying which types of messages to send to that
  .I facility.
  The local client (\fIrdist\fR) and the remote server (\fIrdistd\fR) each
  maintain
  their own copy of what types of messages to log to what facilities.
  .LP
! The
  .B \-l
  .I logopts
  option to
***************
*** 504,510 ****
  tells
  .I rdist
  what logging options to use locally.
! The 
  .B \-L
  .I logopts
  option to
--- 504,510 ----
  tells
  .I rdist
  what logging options to use locally.
! The
  .B \-L
  .I logopts
  option to
***************
*** 528,539 ****
  .IP \fBstdout\fR
  Messages to standard output.
  .IP \fBfile\fR
! Log to a file.  To specify the file name, use the format 
  ``\fBfile=\fIfilename\fB=\fItypes\fR''.
  e.g.
  .B "``file=/tmp/rdist.log=all,debug''.
  .IP \fBsyslog\fR
! Use the 
  .I syslogd(8)
  facility.
  .IP \fBnotify\fR
--- 528,539 ----
  .IP \fBstdout\fR
  Messages to standard output.
  .IP \fBfile\fR
! Log to a file.  To specify the file name, use the format
  ``\fBfile=\fIfilename\fB=\fItypes\fR''.
  e.g.
  .B "``file=/tmp/rdist.log=all,debug''.
  .IP \fBsyslog\fR
! Use the
  .I syslogd(8)
  facility.
  .IP \fBnotify\fR
***************
*** 543,549 ****
  facility.
  This facility is used in conjunction with the
  .B notify
! keyword in a 
  .I distfile
  to specify what messages are mailed to the
  .B notify
--- 543,549 ----
  facility.
  This facility is used in conjunction with the
  .B notify
! keyword in a
  .I distfile
  to specify what messages are mailed to the
  .B notify
***************
*** 551,562 ****
  .RE
  .LP
  .I types
! should be a comma separated list of message types.  Each message type 
  specified enables that message level.  This is unlike the
  .I syslog(3)
  system facility which uses an ascending order scheme.
  The following
! are the valid 
  .I types:
  .RS
  .IP \fBchange\fR
--- 551,562 ----
  .RE
  .LP
  .I types
! should be a comma separated list of message types.  Each message type
  specified enables that message level.  This is unlike the
  .I syslog(3)
  system facility which uses an ascending order scheme.
  The following
! are the valid
  .I types:
  .RS
  .IP \fBchange\fR
***************
*** 594,600 ****
  .fi
  This entry will set local message logging to have all but debug
  messages sent to standard output, change and notice messages will
! be sent to 
  .I syslog(3),
  and all messages will be written to the file
  .B /tmp/rdist.log.
--- 594,600 ----
  .fi
  This entry will set local message logging to have all but debug
  messages sent to standard output, change and notice messages will
! be sent to
  .I syslog(3),
  and all messages will be written to the file
  .B /tmp/rdist.log.
***************
*** 754,760 ****
  commands that are to be executed on the
  remote host after the file in \fIname list\fP is updated or installed.
  If the \fIname list\fP is omitted then the shell commands will be executed
! for every file updated or installed.  
  .I String
  starts and ends with `"' and can cross multiple lines in
  .I distfile.
--- 754,760 ----
  commands that are to be executed on the
  remote host after the file in \fIname list\fP is updated or installed.
  If the \fIname list\fP is omitted then the shell commands will be executed
! for every file updated or installed.
  .I String
  starts and ends with `"' and can cross multiple lines in
  .I distfile.
***************
*** 765,771 ****
  .I special
  command can be used to rebuild private databases, etc.
  after a program has been updated.
! The following environment variables are set for each 
  .I special
  command:
  .IP \fBFILE\fR
--- 765,771 ----
  .I special
  command can be used to rebuild private databases, etc.
  after a program has been updated.
! The following environment variables are set for each
  .I special
  command:
  .IP \fBFILE\fR
***************
*** 781,787 ****
  .I special
  command, except it is executed only when the entire command is completed
  instead of after each file is updated.
! The list of files is placed in the environment variable 
  .B $FILES.
  Each file name in
  .B $FILES
--- 781,787 ----
  .I special
  command, except it is executed only when the entire command is completed
  instead of after each file is updated.
! The list of files is placed in the environment variable
  .B $FILES.
  Each file name in
  .B $FILES
***************
*** 830,836 ****
  .fi
  .SH ENVIRONMENT
  .IP TMPDIR
! Name of temporary directory to use.  Default is 
  .B /tmp.
  .IP RSH
  Name of the default remote shell program to use.  Default is
--- 830,836 ----
  .fi
  .SH ENVIRONMENT
  .IP TMPDIR
! Name of temporary directory to use.  Default is
  .B /tmp.
  .IP RSH
  Name of the default remote shell program to use.  Default is
***************
*** 851,858 ****
  .SH NOTES
  .LP
  If the basename of a file  (the last component in the pathname)
! is ".", then 
! .B rdist 
  assumes the remote (destination) name is a directory.
  i.e.
  .B /tmp/.
--- 851,858 ----
  .SH NOTES
  .LP
  If the basename of a file  (the last component in the pathname)
! is ".", then
! .B rdist
  assumes the remote (destination) name is a directory.
  i.e.
  .B /tmp/.
***************
*** 876,882 ****
  aborts on files which have a negative mtime (before Jan 1, 1970).
  .PP
  If a hardlinked file is listed more than once in the same target,
! then 
! .I rdist 
  will report missing links.
  Only one instance of a link should be listed in each target.
--- 876,882 ----
  aborts on files which have a negative mtime (before Jan 1, 1970).
  .PP
  If a hardlinked file is listed more than once in the same target,
! then
! .I rdist
  will report missing links.
  Only one instance of a link should be listed in each target.