Provided by: deltarpm_3.6+dfsg-1build2_amd64 bug

NAME

       drpmsync - sync a file tree with deltarpms

SYNOPSIS

       drpmsync [-c config] [source] dir
       drpmsync [-s|-S] serverconfig
       cgi-bin/drpmsync

DESCRIPTION

       Drpmsync keeps a local file system tree in sync with a remote one.  Its intended use is to
       work with rpm trees;  the  deltarpm  technology  can  only  save  bandwidth  if  rpms  get
       transmitted. Please use the rsync program for normal file trees.

       Drpmsync  can  run in two modes: as a client it connects to a server, receives a file list
       and brings the tree up to date, as a server it answers  incoming  requests  and  transmits
       files and rpms.

CLIENT MODE

       In  this  mode  drpmsync  updates  the  tree  in  dir.   It  opens  the configuration file
       dir/drpmsync/config to get information about which server to use and other settings.   You
       can specify a different configuration file with the -c option.  The following settings are
       understood (the default for the boolean settings is false):

       source: server1 server2...

       This is a list of servers to connect to. Drpmsync  advances  through  this  list  until  a
       working  server  is found. If a source is specified on the command line it is used instead
       of  the  one  from  the  configuration.   The   syntax   for   the   server   entries   is
       "host[:port]/tree".

       log: logfile

       Specifies the name of a logfile. If the name does not start with a slash, dir/drpmsync/ is
       prepended to it.

       generate_deltas: true|false

       Controls whether drpmsync generates a delta if it receives a new version of a rpm and  the
       server  doesn't provide a delta. This is only useful if the local tree is also exported to
       other clients via a local drpmsync server.

       generate_delta_compression: comp

       This parameter is forwarded to the makedeltarpm program when creating deltas.  An  example
       would be gzip,gzip.

       keep_deltas: true|false

       Tell  drpmsync  to  save  received  or  freshly  created  deltas to the dir/drpmsync/delta
       directory. Automatically true if generate_deltas or keep_uncombined is set to true.

       keep_uncombined: true|false

       This tells drpmsync to request uncombined deltas from the server instead of a  precombined
       single  delta.  This makes sense if you re-export the tree and want to maximize the number
       of versions your clients can update from.

       always_get_rpm: true|false

       Configures whether drpmsync should request that the full rpm is always sent along with the
       delta.  Only makes sense if you have a fast network connection so that applydeltarpm takes
       longer than transmitting the ful rpm.

       deltarpmpath: path

       Sets the directory where drpmsync searches for the deltarpm programs.  The default  is  to
       search the $PATH variable.

SERVER MODE

       Drpmsync  can  wither  work  as  CGI script or as a standalone server.  CGI script mode is
       automatically selected if the REQUEST_METHOD environment variable is  set.  In  this  mode
       drpmsync  expects the DRPMSYNC_CONFIG environment variable to contain the path to a server
       config file.  For apache you can set this with the SetEnv directive.

       Standalone mode  is  selected  with  the  -s  or  -S  option.  In  this  mode  the  server
       configuration  must  be  specified  as  an argument to the drpmsync program. The -s option
       makes the drpmsync program background itself and exit  right  away,  while  -S  keeps  the
       server in the foreground.

       The server configuration can contain the following settings:

       allow: pattern1 pattern2...
       deny: pattern1 pattern2...

       This  provides  the  access  control  for the server.  pattern can either be a simple glob
       pattern (only * is supported) or it can be a full regular expression if it is  written  as
       /RE/.  The regular expression is automatically anchored at the start and the end. Examples
       are 10.10.*  or /10\.10\..*/ If either the numerical ip address or the domain name of  the
       client  matches  any entry of the deny list, access is forbidden. Otherwise the allow list
       is searched for a match. If none is found, access is also denied. The default setting  for
       both lists is empty, so you have to provide an allow list to allow access for the clients.

       log: logfile

       Specifies the path of a logfile.

       no_combine: true|false

       If  this  setting is true the server does not combine deltarpms.  This increases to amount
       of data that has to be transferred but reduces the processor load on the server.

       tree: external_path internal_path

       This statements exports the tree located at internal_path  to  the  clients  as  directory
       external_path.   All  of the above settings are saved as settings of this particular tree,
       so  different  trees  can  use  different  configurations.  This  also  means   that   the
       configuration directives of a tree must be above the tree statement.

       The following settings are global and only needed for standalone mode:

       serverlog: logfile

       Specifies the path of a logfile used for logging server events.

       servername: hostname[:port]

       The  name  of  the  server.  If hostname is empty, the fully qualified domain name is used
       instead. The port defaults to port 80.

       serveraddr: addr

       This address is used for binding the server's socket. If not  specified,  connections  can
       come from any interface.

       serveruser: user
       servergroup: group

       Configures  the  user  and  group  the servers swicthes to after binding the socket to the
       desired port. Examples are nobody or wwwrun.

       maxclients: num

       This settings limits the maximum number of concurrent connections  to  num.   The  default
       value is 10 connections.

       deltarpmpath: path

       Sets  the  directory where drpmsync searches for the deltarpm programs.  The default is to
       search the $PATH variable.

FILES

       dir/drpmsync/deltas
              directory used to store the deltas
       dir/drpmsync/lock
              lock used to serialize syncrpm calls
       dir/drpmsync/wip
              temporary storing space for the transmitted objects
       dir/drpmsync/cache
              md5sum cache to speed up the calculation of the tree state
       dir/drpmsync/timstamp
              contains the time of the last finished sync and the last time the remote tree state
              was requested.

SEE ALSO

       makedeltarpm(8), combinedeltarpm(8), applydeltarpm(8),

AUTHOR

       Michael Schroeder <mls@suse.de>

                                             Jun 2005                                 DRPMSYNC(8)