dumpnet.host.fstab.tar - backup a single directory using tar
- BACKUP MODE
-
dumpnet.host.fstab.tar [-N] [-t] [-S] [-n DIRNAME] [-c COMPRESSION] [-l LEVEL] [-s SESSIONID] [-d DUMPNET_CONFIG] MOUNT_POINT HOST_CONFIG
- RESOTRE MODE
-
dumpnet.host.fstab.tar -R [-S] [-v] [-f FILE] [-n DIRNAME] [-d DUMPNET_CONFIG] MOUNT_POINT HOST_CONFIG
dumpnet.host.fstab.tar does a backup of a single directory specified by MOUNT_POINT using tar(1). It will call dumpnet.host.userdefined.cmd to do most of the job. All command options are the same as for dumpnet.host.fstab.dump(8) and dumpnet.host.fstab.rsync.
If you already have an entry for the filesystem to backup in a dumpnet.fstab.conf file it is recommended to call dumpnet.host.fstab and grep the specific line you need into it. Please see the EXAMPLES section in dumpnet.host.fstab(8).
- BACKUP MODE
- -N
-
Do not update dumpnet.cmddates. This is useful for an irregular backup. Keep in mind that a backup created with the -N switch will not be listed in restore mode. See dumpnet.cmddates(8).
- -t
-
Create a separate file to store the TOC (Table Of Contents). It will be named like the archive file with the extension .toc appended.
- -S
-
Use sudo to run the command that creates the archive.
- -n DIRNAME
-
The name of the sub-directory where the archives are to be stored: $backupDir/$host/$dirname. When backing up a top-level directory (like /usr or /var) it is recommended to use the name of the backuped directory (``usr'' or ``var''). If this option is not specified the dirname is generated by replacing all slashes (`/') in MOUNT_POINT. For example /home/jdoe/somedir would become ``homejdoesomedir''.
- -c COMPRESSION
-
Compression of the archive: ``remote'', ``local'' or ``none''.
- remote
-
Does the compression on the target host before transferring the data. This requires more CPU-resources on the target host but is fastest on slow connections. It is recommended for use over the Internet.
- local
-
Does the compression on the backup machine after transferring the data. This is easyier to handle for the target host but requires a fast connection and a lot of CPU-power on the backup machine.
- none
-
Does no compression at all. Choose this option if the data is already compressed or if you always need it to be available in uncrompressed form for some reason.
- -l LEVEL
-
Set level to LEVEL. This can be a numerical level (0-9) or a level mode. See the sections LEVELS and LEVEL MODES in dumpnet(8) for details.
- -s SESSIONID
-
Set sessionId to SESSIONID. If you don't know if you need this option, you don't! Read the SESSIONID section in dumpnet(8) before using it!
- -d DUMPNET_CONFIG
-
Use DUMPNET_CONFIG instead of the default $DUMPNET_HOME/conf/dumpnet.conf.
- MOUNT_POINT
-
The directory to backup.
- HOST_CONFIG
-
The host configuration file. For the target host 192.168.1.10 it could be conf/192.168.1.10/dumpnet.HOST.conf.
- RESTORE MODE
- -R
-
Restore mode. This will not actually do the restore but will list the files you will need to perform it manually.
- -S
-
sudo was used to run the command that created the archive.
- -v
-
Be verbose.
- -f FILE
-
Find the files that are needed to restore FILE. FILE will be used as a pattern to grep in the TOC-files.
- -n DIRNAME
-
The name of the sub-directory where the archives are stored: $backupDir/$host/$dirname. If this option is not specified the dirname is generated by replacing all slashes (`/') in MOUNT_POINT. For example /home/jdoe/somedir would become ``homejdoesomedir''.
- -d DUMPNET_CONFIG
-
Use DUMPNET_CONFIG instead of the default $DUMPNET_HOME/conf/dumpnet.conf.
- MOUNT_POINT
-
The directory to restore.
- HOST_CONFIG
-
The host configuration file. For the target host 192.168.1.10 it could be conf/192.168.1.10/dumpnet.HOST.conf.
Do a backup of the filesystem 192.168.1.10:/usr
dumpnet.host.fstab.tar /usr conf/192.168.1.10/dumpnet.HOST.conf
Do a backup of 192.168.1.11:/ compress it remotly and save it in $backupDir/$host/ROOT/
dumpnet.host.fstab.tar -n ROOT -c remote / conf/192.168.1.11/dumpnet.HOST.conf
Like the previous but force the use of level 0, generate a TOC and do not update dumpnet.cmddates:
dumpnet.host.fstab.tar -Ntn ROOT -c remote -l 0 / conf/192.168.1.11/dumpnet.HOST.conf
List the files I need to restore 192.168.1.10:/usr (archives stored in the subdir usr)
dumpnet.host.fstab.tar -R /usr conf/192.168.1.10/dumpnet.HOST.conf
Find the backup of 192.168.1.10:/home I need to restore /home/jdoe/somefile.txt. Please note that the leading slash must be removed. This
is because the tar TOC-files do not contain a leading slash (only the dump TOC-files do).
dumpnet.host.fstab.tar -Rf home/jdoe/somefile.txt /home conf/192.168.1.10/dumpnet.HOST.conf
dumpnet.host.fstab.tar will return a zero exit status if the call to dumpnet.host.userdefined.cmd exits with 0. In any other case it will return 1.
dumpnet(8)
dumpnet.host(8)
dumpnet.host.fstab(8)
Lukas Feiler <lukas.feiler@lukasfeiler.com>
dumpnet is published under the LGPL (GNU LESSER GENERAL PUBLIC LICENSE). Please see the LICENSE file contained in the installation tarball for details. The official web site is http://dumpnet.sourceforge.net.