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>