1DRPMSYNC(8)                 System Manager's Manual                DRPMSYNC(8)
2
3
4

NAME

6       drpmsync - sync a file tree with deltarpms
7
8

SYNOPSIS

10       drpmsync [-c config] [source] dir
11       drpmsync [-s|-S] serverconfig
12       cgi-bin/drpmsync
13
14

DESCRIPTION

16       Drpmsync keeps a local file system tree in sync with a remote one.  Its
17       intended use is to work with rpm trees;  the  deltarpm  technology  can
18       only  save bandwidth if rpms get transmitted. Please use the rsync pro‐
19       gram for normal file trees.
20
21       Drpmsync can run in two modes: as a client it  connects  to  a  server,
22       receives  a  file  list  and brings the tree up to date, as a server it
23       answers incoming requests and transmits files and rpms.
24
25

CLIENT MODE

27       In this mode drpmsync updates the tree in dir.  It opens the configura‐
28       tion  file dir/drpmsync/config to get information about which server to
29       use and other settings.  You can specify a different configuration file
30       with the -c option.  The following settings are understood (the default
31       for the boolean settings is false):
32
33       source: server1 server2...
34
35       This is a list of servers to connect to. Drpmsync advances through this
36       list  until  a working server is found. If a source is specified on the
37       command line it is used instead of the one from the configuration.  The
38       syntax for the server entries is "host[:port]/tree".
39
40       log: logfile
41
42       Specifies  the  name  of  a  logfile. If the name does not start with a
43       slash, dir/drpmsync/ is prepended to it.
44
45       generate_deltas: true|false
46
47       Controls whether drpmsync generates a delta if it receives a  new  ver‐
48       sion of a rpm and the server doesn't provide a delta. This is only use‐
49       ful if the local tree is also exported to other  clients  via  a  local
50       drpmsync server.
51
52       generate_delta_compression: comp
53
54       This  parameter  is forwarded to the makedeltarpm program when creating
55       deltas. An example would be gzip,gzip.
56
57       keep_deltas: true|false
58
59       Tell drpmsync to  save  received  or  freshly  created  deltas  to  the
60       dir/drpmsync/delta  directory. Automatically true if generate_deltas or
61       keep_uncombined is set to true.
62
63       keep_uncombined: true|false
64
65       This tells drpmsync  to  request  uncombined  deltas  from  the  server
66       instead  of  a  precombined  single  delta. This makes sense if you re-
67       export the tree and want  to  maximize  the  number  of  versions  your
68       clients can update from.
69
70       always_get_rpm: true|false
71
72       Configures  whether drpmsync should request that the full rpm is always
73       sent along with the delta. Only makes sense if you have a fast  network
74       connection so that applydeltarpm takes longer than transmitting the ful
75       rpm.
76
77       deltarpmpath: path
78
79       Sets the directory where drpmsync searches for the  deltarpm  programs.
80       The default is to search the $PATH variable.
81
82

SERVER MODE

84       Drpmsync  can wither work as CGI script or as a standalone server.  CGI
85       script mode is automatically selected if the REQUEST_METHOD environment
86       variable  is  set.  In  this  mode drpmsync expects the DRPMSYNC_CONFIG
87       environment variable to contain the path to a server config file.   For
88       apache you can set this with the SetEnv directive.
89
90       Standalone  mode is selected with the -s or -S option. In this mode the
91       server configuration must be specified as an argument to  the  drpmsync
92       program. The -s option makes the drpmsync program background itself and
93       exit right away, while -S keeps the server in the foreground.
94
95       The server configuration can contain the following settings:
96
97       allow: pattern1 pattern2...
98       deny: pattern1 pattern2...
99
100       This provides the access control for the server.  pattern can either be
101       a simple glob pattern (only * is supported) or it can be a full regular
102       expression if it is written as /RE/.  The regular expression  is  auto‐
103       matically  anchored  at the start and the end. Examples are 10.10.*  or
104       /10\.10\..*/ If either the numerical ip address or the domain  name  of
105       the  client  matches  any  entry of the deny list, access is forbidden.
106       Otherwise the allow list is searched for a match.  If  none  is  found,
107       access  is also denied. The default setting for both lists is empty, so
108       you have to provide an allow list to allow access for the clients.
109
110       log: logfile
111
112       Specifies the path of a logfile.
113
114       no_combine: true|false
115
116       If this setting is true the server does not  combine  deltarpms.   This
117       increases  to amount of data that has to be transferred but reduces the
118       processor load on the server.
119
120       tree: external_path internal_path
121
122       This statements exports  the  tree  located  at  internal_path  to  the
123       clients  as  directory  external_path.   All  of the above settings are
124       saved as settings of this particular tree, so different trees  can  use
125       different configurations. This also means that the configuration direc‐
126       tives of a tree must be above the tree statement.
127
128
129       The following settings are global and only needed for standalone mode:
130
131       serverlog: logfile
132
133       Specifies the path of a logfile used for logging server events.
134
135       servername: hostname[:port]
136
137       The name of the server. If  hostname  is  empty,  the  fully  qualified
138       domain name is used instead. The port defaults to port 80.
139
140       serveraddr: addr
141
142       This address is used for binding the server's socket. If not specified,
143       connections can come from any interface.
144
145       serveruser: user
146       servergroup: group
147
148       Configures the user and group the servers swicthes to after binding the
149       socket to the desired port. Examples are nobody or wwwrun.
150
151       maxclients: num
152
153       This  settings  limits  the maximum number of concurrent connections to
154       num.  The default value is 10 connections.
155
156       deltarpmpath: path
157
158       Sets the directory where drpmsync searches for the  deltarpm  programs.
159       The default is to search the $PATH variable.
160
161

FILES

163       dir/drpmsync/deltas
164              directory used to store the deltas
165       dir/drpmsync/lock
166              lock used to serialize syncrpm calls
167       dir/drpmsync/wip
168              temporary storing space for the transmitted objects
169       dir/drpmsync/cache
170              md5sum cache to speed up the calculation of the tree state
171       dir/drpmsync/timstamp
172              contains  the  time  of the last finished sync and the last time
173              the remote tree state was requested.
174

SEE ALSO

176       makedeltarpm(8), combinedeltarpm(8), applydeltarpm(8),
177

AUTHOR

179       Michael Schroeder <mls@suse.de>
180
181
182
183                                   Jun 2005                        DRPMSYNC(8)
Impressum