[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.23 and 1.24

version 1.23, 2007/02/26 15:53:12 version 1.24, 2007/02/26 16:17:10
Line 101 
Line 101 
 .Em localhost  .Em localhost
 and the remote user name is the same as the local user name,  and the remote user name is the same as the local user name,
 .Nm  .Nm
 will run the command  will run the command:
 .Bd -literal -offset indent  .Bd -literal -offset indent
 /bin/sh -c rdistd -S  /bin/sh -c rdistd -S
 .Ed  .Ed
 .Pp  .Pp
 Otherwise,  Otherwise,
 .Nm  .Nm
 run will run the command  run will run the command:
 .Bd -literal -offset indent  .Bd -literal -offset indent
 \fBssh \fIhost\fB -l \fIremuser \fBrdistd -S\fR  ssh host -l remuser rdistd -S
 .Ed  .Ed
 .Pp  .Pp
 where  where
Line 127 
Line 127 
 .Bd -literal -offset indent  .Bd -literal -offset indent
 rdistd -S  rdistd -S
 .Ed  .Ed
 .Pp  
 or  or
 .Bd -literal -offset indent  .Bd -literal -compact -offset indent
 <rdistd path> -S  \*(Ltrdistd path\*(Gt -S
 .Ed  .Ed
 .Pp  .Pp
 if the  if the
Line 139 
Line 138 
 If no  If no
 .Fl p  .Fl p
 option is included, or the  option is included, or the
 .Ar <rdistd path>  .Aq Ar rdistd path
 is a simple filename,  is a simple filename,
 .Em rdistd  .Xr rdistd 1
 or  or
 .Em <rdistd path>  .Aq Ar rdistd path
 must be somewhere in the  must be somewhere in the
 .Ev PATH  .Ev PATH
 of the user running  of the user running
Line 169 
Line 168 
 .Pa distfile .  .Pa distfile .
 The equivalent distfile is as follows.  The equivalent distfile is as follows.
 .Bd -literal -offset indent  .Bd -literal -offset indent
 ( \fIname\fP ... ) -> [\fIlogin\fP@]\fIhost\fP  (  name ... ) -\*(Gt [login@]host
         install [\fIdest\fP] ;          install [dest] ;
 .Ed  .Ed
 .It Fl D  .It Fl D
 Enable copious debugging messages.  Enable copious debugging messages.
Line 204 
Line 203 
 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
 server (\fIrdistd\fR).  server,
   .Xr rdistd 1 .
 See the section  See the section
 .Sy MESSAGE LOGGING  .Sy MESSAGE LOGGING
 for details on the syntax for  for details on the syntax for
Line 387 
Line 387 
 .Ar rsh-path  .Ar rsh-path
 may be a colon separated list of possible pathnames.  may be a colon separated list of possible pathnames.
 In this case, the first component of the path to exist is used.  In this case, the first component of the path to exist is used.
 e.g.,  For example,
 .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  .It Fl p Ar rdistd-path
Line 422 
Line 422 
 to do the updating.  to do the updating.
 Each entry has one of the following formats.  Each entry has one of the following formats.
 .Bd -literal -offset indent  .Bd -literal -offset indent
 <variable name> `=' <name list>  \*(Ltvariable name\*(Gt `=' \*(Ltname list\*(Gt
 [ label: ] <source list> `\->' <destination list> <command list>  [ label: ] \*(Ltsource list\*(Gt `\-\*(Gt' \*(Ltdestination list\*(Gt \*(Ltcommand list\*(Gt
 [ label: ] <source list> `::' <time_stamp file> <command list>  [ label: ] \*(Ltsource list\*(Gt `::' \*(Lttime_stamp file\*(Gt \*(Ltcommand list\*(Gt
 .Ed  .Ed
 .Pp  .Pp
 The first format is used for defining variables.  The first format is used for defining variables.
Line 458 
Line 458 
 .Pp  .Pp
 The source and destination lists have the following format:  The source and destination lists have the following format:
 .Bd -literal -offset indent  .Bd -literal -offset indent
 <name>  \*(Ltname\*(Gt
 .Ed  .Ed
 or  or
 .Bd -literal -compact -offset indent  .Bd -literal -compact -offset indent
 `(' <zero or more names separated by whitespace> `)'  `(' \*(Ltzero or more names separated by whitespace\*(Gt `)'
 .Ed  .Ed
 .Pp  .Pp
 These simple lists can be modified by using one level of set addition,  These simple lists can be modified by using one level of set addition,
Line 479 
Line 479 
 list '&' list  list '&' list
 .Ed  .Ed
 .Pp  .Pp
 If additional modifications are needed (e.g.,  If additional modifications are needed (e.g.\&
 .Do  .Do
 all servers and client machines except for the OSF/1 machines  all servers and client machines except for the OSF/1 machines
 .Dc )  .Dc )
Line 503 
Line 503 
 .Pp  .Pp
 The command list consists of zero or more commands of the following  The command list consists of zero or more commands of the following
 format.  format.
 .Bl -column "except_pat" "<pattern list>" "opt_dest_name" ";" -offset indent  .Bl -column "except_pat" "pattern listXX" "opt_dest_name" ";" -offset indent
 .It `install' Ta <options> Ta opt_dest_name Ta `;'  .\" .It `install' Ta \*(Ltoptions\*(Gt Ta opt_dest_name Ta `;'
 .It `notify' Ta <name list> Ta "" Ta `;'  .\" .It `notify' Ta \*(Ltname list\*(Gt Ta "" Ta `;'
 .It `except' Ta <name list> Ta "" Ta `;'  .\" .It `except' Ta \*(Ltname list\*(Gt Ta "" Ta `;'
 .It `except_pat' Ta <pattern list> Ta "" Ta `;'  .\" .It `except_pat' Ta \*(Ltpattern list\*(Gt Ta "" Ta `;'
 .It `special' Ta <name list> Ta string Ta `;'  .\" .It `special' Ta \*(Ltname list\*(Gt Ta string Ta `;'
 .It `cmdspecial' Ta <name list> Ta string Ta `;'  .\" .It `cmdspecial' Ta \*(Ltname list\*(Gt Ta string Ta `;'
 .El  .El
 .Pp  .Pp
 The  The
Line 541 
Line 541 
 that may have occurred) to the listed names.  that may have occurred) to the listed names.
 If no `@' appears in the name, the destination host is appended to  If no `@' appears in the name, the destination host is appended to
 the name  the name
 (e.g., name1@host, name2@host, ...).  (e.g. name1@host, name2@host, ...).
 .Pp  .Pp
 The  The
 .Em except  .Em except
Line 629 
Line 629 
 .Sy types  .Sy types
 specifying which types of messages to send to that  specifying which types of messages to send to that
 .Em facility .  .Em facility .
 The local client (\fIrdist\fR) and the remote server (\fIrdistd\fR) each  The local client
 maintain their own copy of what types of messages to log to what facilities.  .Pq Nm rdist
   and the remote server
   .Pq Xr rdistd 1
   each maintain their own copy
   of what types of messages to log to what facilities.
 .Pp  .Pp
 The  The
 .Fl l  .Fl l
 .Em logopts  .Ar local_logopts
 option to  option to
 .Nm  .Nm
 tells  tells
Line 642 
Line 646 
 what logging options to use locally.  what logging options to use locally.
 The  The
 .Fl L  .Fl L
 .Em logopts  .Ar remote_logopts
 option to  option to
 .Nm  .Nm
 tells  tells
Line 652 
Line 656 
 server.  server.
 .Pp  .Pp
 .Em logopts  .Em logopts
 should be of the form  should be of the form:
 .Bd -literal -offset indent  
 \fIfacility\fB=\fItypes\fB:\fIfacility\fB=\fItypes...  
 .Ed  
 .Pp  .Pp
   .D1 facility=types:facility=types...
   .Pp
 The valid facility names are:  The valid facility names are:
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Sy stdout  .It Ic stdout
 Messages to standard output.  Messages to standard output.
 .It Sy file  .It Ic file
 Log to a file.  Log to a file.
 To specify the file name, use the format  To specify the file name, use the format
 .Dq \fBfile=\fIfilename\fB=\fItypes\fR .  .Dq file=filename=types .
 e.g.,  For example:
 .Dq \fBfile=\fI/tmp/rdist.log\fB=\fIall,debug\fR .  .Pp
 .It Sy syslog  .Dl file=/tmp/rdist.log=all,debug
   .It Ic syslog
 Use the  Use the
 .Xr syslogd 8  .Xr syslogd 8
 facility.  facility.
 .It Sy notify  .It Ic notify
 Use the internal  Use the internal
 .Nm  .Nm
 .Sy notify  .Ic notify
 facility.  facility.
 This facility is used in conjunction with the  This facility is used in conjunction with the
 .Sy notify  .Ic notify
 keyword in a  keyword in a
 .Pa distfile  .Pa distfile
 to specify what messages are mailed to the  to specify what messages are mailed to the
 .Sy notify  .Ic notify
 address.  address.
 .El  .El
 .Pp  .Pp
Line 694 
Line 698 
 The following are the valid  The following are the valid
 .Em types :  .Em types :
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Sy change  .It Ic change
 Things that change.  Things that change.
 This includes files that are installed or updated in some way.  This includes files that are installed or updated in some way.
 .It Sy info  .It Ic info
 General information.  General information.
 .It Sy notice  .It Ic notice
 General info about things that change.  General info about things that change.
 This includes things like making directories which are needed in order  This includes things like making directories which are needed in order
 to install a specific target, but which are not explicitly specified in the  to install a specific target, but which are not explicitly specified in the
 .Pa distfile .  .Pa distfile .
 .It Sy nerror  .It Ic nerror
 Normal errors that are not fatal.  Normal errors that are not fatal.
 .It Sy ferror  .It Ic ferror
 Fatal errors.  Fatal errors.
 .It Sy warning  .It Ic warning
 Warnings about errors which are not as serious as  Warnings about errors which are not as serious as
 .Sy nerror  .Ic nerror
 type messages.  type messages.
 .It Sy debug  .It Ic debug
 Debugging information.  Debugging information.
 .It Sy all  .It Ic all
 All but debug messages.  All but debug messages.
 .El  .El
 .Pp  .Pp
Line 758 
Line 762 
 EXLIB = ( Mail.rc aliases aliases.db crontab dshrc  EXLIB = ( Mail.rc aliases aliases.db crontab dshrc
         sendmail.cf sendmail.hf sendmail.st uucp vfont )          sendmail.cf sendmail.hf sendmail.st uucp vfont )
   
 ${FILES} -> ${HOSTS}  ${FILES} -\*(Gt ${HOSTS}
         install -oremove,chknfs ;          install -oremove,chknfs ;
         except /usr/lib/${EXLIB} ;          except /usr/lib/${EXLIB} ;
         except /usr/games/lib ;          except /usr/games/lib ;
         special /usr/lib/sendmail "/usr/lib/sendmail -bi" ;          special /usr/lib/sendmail "/usr/lib/sendmail -bi" ;
   
 srcs:  srcs:
 /usr/src/bin -> arpa  /usr/src/bin -\*(Gt arpa
         except_pat ( \e\e.o\e$ /SCCS\e$ ) ;          except_pat ( \e\e.o\e$ /SCCS\e$ ) ;
   
 IMAGEN = (ips dviimp catdvi)  IMAGEN = (ips dviimp catdvi)
   
 imagen:  imagen:
 /usr/local/${IMAGEN} -> arpa  /usr/local/${IMAGEN} -\*(Gt arpa
         install /usr/local/lib ;          install /usr/local/lib ;
         notify ralph ;          notify ralph ;
   
Line 793 
Line 797 
 If the basename of a file  (the last component in the pathname) is ".", then  If the basename of a file  (the last component in the pathname) is ".", then
 .Nm  .Nm
 assumes the remote (destination) name is a directory.  assumes the remote (destination) name is a directory.
 i.e.,  That is,
 .Pa /tmp/ .  .Pa /tmp/ .
 means that  means that
 .Pa /tmp  .Pa /tmp
Legend:
Removed from v.1.23  
changed lines
  Added in v.1.24