--- name: "drpmsync" section: "8" platform: "linux" package: "deltarpm" version: "3.6.5+dfsg-1+b1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/drpmsync" --- # drpmsync(8) sync a file tree with deltarpms ## 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 full 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 either 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 the 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)](/makedeltarpm/8.md), [**combinedeltarpm**(8)](/combinedeltarpm/8.md), [**applydeltarpm**(8)](/applydeltarpm/8.md), ## AUTHOR Michael Schroeder \