drpmsync(8)
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)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
