X-Git-Url: http://git.tuebingen.mpg.de/?p=dss.git;a=blobdiff_plain;f=INSTALL;h=ff4274b26b3560f404aaaf73591deb6efa998c61;hp=58a03fbae85a5e73962d53b2fa3364c6e9c47bf8;hb=fd4b3f4de0f4ea6065b3dadcf86e6bd878a06a95;hpb=6e42820324ffb57f3d1fc1e58e1ec5bbdf97c820 diff --git a/INSTALL b/INSTALL index 58a03fb..ff4274b 100644 --- a/INSTALL +++ b/INSTALL @@ -2,14 +2,25 @@ Type make -in the dss source directory to build the dss executable. You -likely need a recent version of gnu gengetopt, -ftp://ftp.gnu.org/pub/gnu/gengetopt/, to compile dss. +in the dss source directory to build the dss executable and copy it to +some directory that is included in your PATH, e.g. to $HOME/bin or to +/usr/local/bin. + +Note that you'll likely need a recent version of +ftp://ftp.gnu.org/pub/gnu/gengetopt/ (gnu gengetopt) to compile dss. + +Optionally, type + + make man + +to create the man page of dss. This invokes help2man so make sure +that help2man is installed on your system. Note that the man page is +just the nroff variant of the output of "dss --detailed-help". dss is known to compile on Linux, MacOS, Solaris, FreeBSD and -NetBSD. However, it is run-tested on Linux only. +NetBSD. However, it is run-tested only on Linux. -Also make sure that rsync, http://rsync.samba.org/, is installed on +Also make sure that http://rsync.samba.org/ (rsync) is installed on your system. Version 2.6.1 or newer is required. Example: @@ -36,21 +47,21 @@ as follows: Then execute the commands mkdir /baz/qux - ./dss --run + dss --run In order to print the list of all snapshots created so far, use - ./dss --list + dss --ls Yes, it's really that easy. Of course, dss supports many more features and config options such as taking snapshots from remote -hosts and several hooks that are executed whenever on certain events, -for example whenever a snapshot was created successfully. Try +hosts and several hooks that are executed on certain events, for +example whenever a snapshot was created successfully. Try - ./dss -h + dss -h for an overview of all supported command line options or - ./dss --detailed-help + dss --detailed-help for the full help text.