Skip to content
rdiff-backup
Python Roff HTML C Other
Branch: master
Clone or download
Eric L and ottok Correct definition of old_test_dir to be independent from Git clone d…
…irectory name

Clarify also how to extract the testfiles archive correctly.
Closes #97
Latest commit 57aa9bf Aug 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist Update metadata to mention rdiff-backup.net and github.com/rdiff-backup Aug 12, 2019
misc Remove misc/myrm as being rather useless May 19, 2019
src Make root tests work with bytes paths Aug 13, 2019
testing Correct definition of old_test_dir to be independent from Git clone d… Aug 24, 2019
.gitignore Extend gitignore to ignore local files by their name Jul 14, 2019
CHANGELOG Add support for Python 3.8, document in changelog May 17, 2019
COPYING Simplify directory structure, move all content from sub-directory int… Feb 16, 2019
DEVELOP.adoc Correct definition of old_test_dir to be independent from Git clone d… Aug 24, 2019
Dockerfile Add initial Dockerfile for development builds in an isolated way Aug 12, 2019
FAQ-body.html Add tox testing framework with first test May 1, 2019
README.md Format README.md contents to use Markdown Aug 20, 2019
Windows-README.txt Update metadata to mention rdiff-backup.net and github.com/rdiff-backup Aug 12, 2019
examples-body.html Simplify directory structure, move all content from sub-directory int… Feb 16, 2019
python-rdiff Replace python with python3 in all shebangs Feb 16, 2019
rdiff-backup Update metadata to mention rdiff-backup.net and github.com/rdiff-backup Aug 12, 2019
rdiff-backup-statistics Fix rdiff-backup-statistics to work with bytes paths and without lazy Aug 17, 2019
rdiff-backup-statistics.1 Update metadata to mention rdiff-backup.net and github.com/rdiff-backup Aug 12, 2019
rdiff-backup.1 Update metadata to mention rdiff-backup.net and github.com/rdiff-backup Aug 12, 2019
setup.py Fix setup.py after 8111745 Aug 23, 2019
tox.ini Extend Tox to include flake8 static Python code analysis and style ch… Aug 22, 2019
tox_root.ini Make root test work Jul 2, 2019
tox_slow.ini Add support for Python 3.8, document in changelog May 17, 2019

README.md

rdiff-backup

INSTALLATION

Thank you for trying rdiff-backup. To install, run:

python3 setup.py install

The build process can be also be run separately:

python3 setup.py build

The default prefix is generally /usr, so files would be put in /usr/bin, /usr/share/man/, etc. An alternate prefix can be specified using the --prefix= option. For example:

python3 setup.py install --prefix=/usr/local

The default prefix depends on how you (or your distribution) installed and configured Python. Suggested reading is "How installation works" from the Python docs, which includes commands to determine your default prefix: http://docs.python.org/install/index.html#how-installation-works

The setup script expects to find librsync headers and libraries in the default location, usually /usr/include and /usr/lib. If you want the setup script to check different locations, use the --librsync-dir switch or the LIBRSYNC_DIR environment variable. For instance,

python3 setup.py --librsync-dir=/usr/local build

instructs the setup program to look in /usr/local/include and /usr/local/lib for the librsync files.

Finally, the --lflags and --libs options, and the LFLAGS and LIBS environment variables are also recognized. Running setup.py with no arguments will display some help. Additional help is displayed by the command:

python3 setup.py install --help

More information about using setup.py and how rdiff-backup is installed is available from the Python guide, Installing Python Modules for System Administrators, located at http://docs.python.org/install/index.html

NB: There is no uninstall command provided by the Python distutils system. One strategy is to use the python3 setup.py install --record option to save a list of the files installed to .

To build from source on Windows, you can use the command:

python3 setup.py py2exe --single-file

to build a single executable file which contains Python, librsync, and all required modules.

REQUIREMENTS

Remember that you must have Python 3.5 or later and librsync 1.0.0 or later installed. For Python, see http://www.python.org. The rdiff-backup homepage at https://rdiff-backup.net/ should have a recent version of librsync; otherwise see the librsync homepage at http://librsync.sourceforge.net/. On Windows, you must have the Python for Windows extensions installed if you are building from source. The extensions can be downloaded from: http://pywin32.sourceforge.net/ If you are not building from source on Windows, you do not need Python or librsync; they are bundled with the executable.

For remote operation, rdiff-backup should be installed and in the PATH on remote system(s) (see man page for more information). On Windows, if you are using the provided .exe binary, you must have an SSH package installed for remote operation.

The python modules pylibacl and pyxattr are optional. If they are installed and in the default pythonpath, rdiff-backup will support access control lists and user extended attributes, provided the file system(s) also support these features. Pylibacl and pyxattr can be downloaded from http://pylibacl.sourceforge.net/ and http://pyxattr.sourceforge.net/. Mac OS X users need a different pyxattr module, which can be downloaded from http://cheeseshop.python.org/pypi/xattr

In order to build rdiff-backup, you need python3-devel and librsync-devel, as well as a C compiler (gcc).

TROUBLESHOOTING

If you have everything installed properly, and it still doesn't work, see the enclosed FAQ.html, the web page at http://rdiff-backup.nongnu.org and/or the mailing list.

The FAQ in particular is an important reference, especially if you are using smbfs/CIFS, Windows, or have compiled by hand on Mac OS X.

You can’t perform that action at this time.