NAME<\/a> drpmsync \u2212 sync a file tree with deltarpms<\/p>\n drpmsync<\/b> [-c<\/b> config<\/i>] [source<\/i>] dir<\/i> 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.<\/p>\n 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.<\/p>\n In this mode drpmsync updates the tree in dir<\/i>. It opens the configuration file dir<\/i>\/drpmsync\/config<\/b> to get information about which server to use and other settings. You can specify a different configuration file with the -c<\/b> option. The following settings are understood (the default for the boolean settings is false):<\/p>\n source:<\/b> server1 server2<\/i>…<\/p>\n 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<\/i>[:<\/b>port<\/i>]\/tree<\/i>“.<\/p>\n log:<\/b> logfile<\/i><\/p>\n Specifies the name of a logfile. If the name does not start with a slash, dir<\/i>\/drpmsync\/<\/b> is prepended to it.<\/p>\n generate_deltas: true|false<\/b><\/p>\n Controls whether drpmsync generates a delta if it receives a new version of a rpm and the server doesn\u2019t provide a delta. This is only useful if the local tree is also exported to other clients via a local drpmsync server.<\/p>\n generate_delta_compression:<\/b> comp<\/i><\/p>\n This parameter is forwarded to the makedeltarpm program when creating deltas. An example would be gzip,gzip<\/b>.<\/p>\n keep_deltas: true|false<\/b><\/p>\n Tell drpmsync to save received or freshly created deltas to the dir<\/i>\/drpmsync\/delta<\/b> directory. Automatically true if generate_deltas<\/b> or keep_uncombined<\/b> is set to true.<\/p>\n keep_uncombined: true|false<\/b><\/p>\n 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.<\/p>\n always_get_rpm: true|false<\/b><\/p>\n 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.<\/p>\n deltarpmpath:<\/b> path<\/i><\/p>\n Sets the directory where drpmsync searches for the deltarpm programs. The default is to search the $PATH<\/b> variable.<\/p>\n Drpmsync can wither work as CGI script or as a standalone server. CGI script mode is automatically selected if the REQUEST_METHOD<\/b> environment variable is set. In this mode drpmsync expects the DRPMSYNC_CONFIG<\/b> environment variable to contain the path to a server config file. For apache you can set this with the SetEnv<\/b> directive.<\/p>\n Standalone mode is selected with the -s<\/b> or -S<\/b> option. In this mode the server configuration must be specified as an argument to the drpmsync program. The -s<\/b> option makes the drpmsync program background itself and exit right away, while -S<\/b> keeps the server in the foreground.<\/p>\n The server configuration can contain the following settings:<\/p>\n allow:<\/b> pattern1 pattern2<\/i>… This provides the access control for the server. pattern<\/i> can either be a simple glob pattern (only *<\/b> is supported) or it can be a full regular expression if it is written as \/RE\/<\/b>. The regular expression is automatically anchored at the start and the end. Examples are 10.10.*<\/b> or \/10.10..*\/<\/b> 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.<\/p>\n log:<\/b> logfile<\/i><\/p>\n Specifies the path of a logfile.<\/p>\n no_combine: true|false<\/b><\/p>\n 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.<\/p>\n tree:<\/b> external_path internal_path<\/i><\/p>\n This statements exports the tree located at internal_path<\/i> to the clients as directory external_path<\/i>. 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<\/b> statement.<\/p>\n The following settings are global and only needed for standalone mode:<\/p>\n serverlog:<\/b> logfile<\/i><\/p>\n Specifies the path of a logfile used for logging server events.<\/p>\n servername:<\/b> hostname<\/i>[:port<\/i>]<\/p>\n The name of the server. If hostname<\/i> is empty, the fully qualified domain name is used instead. The port defaults to port 80.<\/p>\n serveraddr:<\/b> addr<\/i><\/p>\n This address is used for binding the server\u2019s socket. If not specified, connections can come from any interface.<\/p>\n serveruser:<\/b> user<\/i> Configures the user and group the servers swicthes to after binding the socket to the desired port. Examples are nobody<\/b> or wwwrun<\/b>.<\/p>\n maxclients:<\/b> num<\/i><\/p>\n This settings limits the maximum number of concurrent connections to num<\/i>. The default value is 10 connections.<\/p>\n deltarpmpath:<\/b> path<\/i><\/p>\n Sets the directory where drpmsync searches for the deltarpm programs. The default is to search the $PATH<\/b> variable.<\/p>\n dir<\/i>\/drpmsync\/deltas<\/p>\n directory used to store the deltas<\/p>\n dir<\/i>\/drpmsync\/lock<\/p>\n lock used to serialize syncrpm calls<\/p>\n dir<\/i>\/drpmsync\/wip<\/p>\n temporary storing space for the transmitted objects<\/p>\n dir<\/i>\/drpmsync\/cache<\/p>\n md5sum cache to speed up the calculation of the tree state<\/p>\n dir<\/i>\/drpmsync\/timstamp<\/p>\n contains the time of the last finished sync and the last time the remote tree state was requested.<\/p>\n
SYNOPSIS<\/a>
DESCRIPTION<\/a>
CLIENT MODE<\/a>
SERVER MODE<\/a>
FILES<\/a>
SEE ALSO<\/a>
AUTHOR<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
drpmsync<\/b> [-s<\/b>|-S<\/b>] serverconfig<\/i>
cgi-bin\/drpmsync<\/b><\/p>\nDESCRIPTION <\/a> <\/h2>\n
CLIENT MODE <\/a> <\/h2>\n
SERVER MODE <\/a> <\/h2>\n
deny:<\/b> pattern1 pattern2<\/i>…<\/p>\n
servergroup:<\/b> group<\/i><\/p>\nFILES <\/a> <\/h2>\n
SEE ALSO <\/a> <\/h2>\n