TARSNAP(1) General Commands Manual TARSNAP(1) (NAME) tarsnap - (SYNOPSIS) tarsnap {-c} --keyfile key-file --cachedir cache-dir -f archive-name [options] [files | directories] tarsnap {-d} --keyfile key-file --cachedir cache-dir -f archive-name [options] tarsnap {-t | -x} --keyfile key-file -f archive-name [options] [patterns] tarsnap {-r} --keyfile key-file -f archive-name tarsnap {--list-archives} --keyfile key-file tarsnap {--print-stats} --keyfile key-file --cachedir cache-dir [-f archive-name] tarsnap {--recover} --keyfile key-file --cachedir cache-dir tarsnap {--fsck} --keyfile key-file --cachedir cache-dir tarsnap {--fsck-prune} --keyfile key-file --cachedir cache-dir tarsnap {--initialize-cachedir} --keyfile key-file --cachedir cache-dir tarsnap {--nuke} --keyfile key-file tarsnap --verify-config tarsnap --version (DESCRIPTION) tarsnap . tarsnap (mode) : -c . -d . -t stdout. -x . -r tar stdout. --list-archives . -v -v tarsnap . --print-stats () . << (PRINTING ARCHIVE STATISTICS)>> . --recover (checkpoint) . . --fsck cache-dir. tarsnap --fsck-prune . --fsck-prune --fsck - (prune) . --initialize-cachedir cachedir. (GUI) . --nuke . --nuke - tarsnap "No Tomorrow" . --verify-config () . --version tarsnap . -c - . . -t -x - . . globbing tcsh(1) . POSIX `[]' (escape) . . . (OPTIONS) @archive-file ( c) . archive-file "-" . tarsnap -c --keyfile key-file --cachedir cache-dir -f mybackup @backup.tar backup.tar tarsnap . @@archive-name ( c) tarsnap . --aggressive-networking ( c) TCP tarsnap. () tarsnap . --archive-names filename filename. -C directory ( c x) c . x . --cachedir cache-dir ( c d print- stats fsck) tarsnap cache-dir (cache) . tarsnap . cache-dir tarsnap --fsck . --check-links ( c) . --checkpoint-bytes bytespercheckpoint ( c) (checkpoint) bytespercheckpoint . bytespercheckpoint . --chroot ( x) chroot() -C . --configfile filename filename . . --creationtime X ( c) ( unix timestamp) . tarsnap . --csv-file filename ( --print-stats) CSV . --disk-pause X ( c) X . tarsnap . ATA --disk-pause 10 . --dry-run ( c) . ( -v) - ( --progress-bytes) ( --print-stats) tarsnap --dry-run ( ). --maxbw --dry-run tarsnap (dry run) tarsnap . @@archive-name archive-name tarsnap tarsnap . --dry-run . --dry-run-metadata ( c) . --dry-run . --dry-run ( -v) - ( --totals --progress-bytes) . --print-stats . --dump-config . --exclude pattern ( c x t) . . -f archive-name ( c d x t r list-archives print-stats) archive-name. c ^Q SIGQUIT --maxbw ".part" . print-stats archive-name * . print-stats d -f archive-name ( ) . / ( ) . --list-archives --hashes -f archive-name tapehash () . . ( -f --list-archives --hashes .) --force-resources (passphrase) (CPU) . -H ( c) . -h ( c) -L. --hashes ( list-archives) . -v . . --humanize-numbers SI --print-stats SIGINFO. -I -T. --include pattern ( c x t) . --exclude . . --include . tarsnap -c -f foo-backup --include='*foo*' @@all-backup foo-backup all-backup `foo' . --insane-filesystems ( c) procfs. . --iso-dates ( t) yyyy-mm-dd hh:mm:ss. "ls -l" : . -k ( x) . . --keep-going ( d print-stats) . --keep-newer-files ( x) . --keyfile key-file ( ) key-file. tarsnap-keygen(1) . -L ( c) . . . -l --check-links . --lowmem ( c) . . -m ( x) (modification time) . . --maxbw numbytes ( c) numbytes (upstream) ( << (INTERRUPTING ARCHIVAL)>> ). --maxbw-rate bytespersecond bytespersecond . --maxbw-rate-down bytespersecond bytespersecond . --maxbw-rate-up bytespersecond bytespersecond . -n ( c) . --newer date ( c x t) . ctime . --newer-mtime date ( c) --newer - ctime mtime . --newer-than filename ( c) . ctime . --newer-mtime-than filename ( c) --newer-than - ctime mtime . --no-aggressive-networking aggressive-networking . --no-config-exclude exclude . exclude . --no-config-include include . include . --no-default-config /etc/tarsnap/tarsnap.conf $XDG_CONFIG_HOME/tarsnap/tarsnap.conf ~/.tarsnaprc. --no-disk-pause disk-pause . --no-force-resources force-resources . --no-humanize-numbers humanize-numbers . --no-insane-filesystems insane-filesystems . --no-iso-dates iso-dates . --no-maxbw maxbw . --no-maxbw-rate-down maxbw-rate-down . maxbw-rate ( --no-maxbw-rate-up ). --no-maxbw-rate-up maxbw-rate-up . maxbw-rate ( --no-maxbw-rate-down ). --no-noatime noatime . --no-nodump nodump . --no-print-stats print-stats . --no-progress-bytes progress-bytes . --no-quiet quiet . --no-retry-forever retry-forever . --no-snaptime snaptime . --no-store-atime store-atime . --no-totals totals . --noatime ( c) atime . . --nodump ( c) nodump . --noisy-warnings . . --normalmem lowmem verylowmem . --null ( -I - -T -X) --null-input. tar . --null-input ( -I - -T -X) null . -print0 find(1) . --null-output ( x t list- archives print-stats) null . null . null . --numeric-owner ( x) uid gid . -O ( x t) (x-) . (t-) stderr . -o ( x) . -p (root) . ACL . --one-file-system ( c) (mount points) . -P ( c x t) . ( / ) . tarsnap .. . . -p ( x) . ACL ( ) . tarsnap . tarsnap (root) -o . --passphrase method:arg (passphrase) . dev:tty-stdin dev/tty/ stdin. . dev:stdin-once stdin . infile stdin ( '-') . dev:tty-once dev/tty/ . env:VAR VAR. . . file:FILENAME FILENAME. . . --print-stats ( c d) ( c) ( d). << (PRINTING ARCHIVE STATISTICS)>> . --progress-bytes X ( SIGUSR1 SIGINFO ) X . . -q (--fast-read) ( x t) . . . . --quiet . : "Removing leading '/' ..." "Not adding cache directory to archive" "... file may have grown while being archived" "Skipping entry on filesystem of type ..." tarsnap . --resume-extract ( x) mtime . . mtime . -k --resume-extract tarsnap . --retry-forever tarsnap tarsnap . . . -S ( x) (sparse files). (non-NULL) (seek over). conv=sparse dd . -s pattern pattern. /old/new/[gps] . old (basic regular expression) . . new . ~ \1 \9 . g . s . p (stderr) . --snaptime filename ( c) (filesystem snapshot) filename . ( tarsnap .) --store-atime ( c) (atime). tarsnap ( ) tarsnap . --strip-components count ( x) . . / . -T filename ( c x t) x t tarsnap filename . c tarsnap filename . "-C" . --null-input . --null-input "-C" . filename "-" . : find(1) -n . --totals ( c) . GNU tar --print-stats . -U ( x) (unlink) . tarsnap (hardlinks) . . -v ( c d t x list-archives) (verbose). tarsnap . tarsnap . tarsnap ls(1) . -v . --verify-config () . --version tarsnap . --verylowmem ( c) --lowmem - . -w ( c x) . -X filename ( c x t) . --exclude . (SIGNALS) tarsnap : SIGUSR1 SIGINFO SIGUSR1 ( ) SIGINFO tarsnap ( ) . . (buffering) tarsnap . SIGSTOP SIGTSTP SIGSTOP SIGTSTP tarsnap . SIGCONT tarsnap ( ) . SIGUSR2 SIGUSR2 tarsnap ( c) (checkpoint) . SIGQUIT SIGQUIT tarsnap ( c) (truncate) ( << (INTERRUPTING ARCHIVAL)>> ). (PRINTING ARCHIVE STATISTICS) : o : tarsnap --print-stats o () : tarsnap --print-stats -f archive-name1 [-f ...] o : tarsnap --print-stats -f '*' o () : tarsnap -c --print-stats -f archive-name DIR tarsnap -d --print-stats -f archive-name1 [-f ...] tarsnap : Total size Compressed size All archives 104491640436 51510524844 (unique data) 14830618089 7733620463 This archive 808723344 289077325 New data 17858641 5658308 tarsnap . ( Tarsnap .) ( ) Tarsnap . tarsnap --print-stats --print-stats (stderr) . keyfile Tarsnap. (INTERRUPTING ARCHIVAL) SIGQUIT ^Q --maxbw - tarsnap (truncate) . ".part" . . (FIREWALLS) tarsnap TCP tarsnap TCP . ( ) IP tarsnap IP IP / IP . (ENVIRONMENT) tarsnap : LANG (locale) . environ(7) . TZ . environ(7) . (FILES) /etc/tarsnap/tarsnap.conf tarsnap. . $XDG_CONFIG_HOME/tarsnap/tarsnap.conf tarsnap . XDG_CONFIG_HOME ~/.config/tarsnap/tarsnap.conf . ~/.tarsnaprc . ~/.tarsnaprc tarsnap . . (EXIT STATUS) The tarsnap utility exits 0 on success, and >0 if an error occurs. . (EXAMPLES) : tarsnap-keygen --keyfile /usr/tarsnap.key --user me@example.com --machine myserver /usr/home /other/stuff/to/backup: tarsnap --keyfile /usr/tarsnap.key --cachedir /usr/tarsnap-cache -c -f backup-2008-04-24 /usr/home /other/stuff/to/backup tarsnap : tarsnap --keyfile /usr/tarsnap.key --cachedir /usr/tarsnap-cache -c -f backup-2008-04-25 /usr/home /other/stuff/to/backup : tarsnap --keyfile /usr/tarsnap.key --list-archives : tarsnap --keyfile /usr/tarsnap.key --cachedir /usr/tarsnap-cache -d -f backup-2008-04-24 : tarsnap --keyfile /usr/tarsnap.key -tv -f backup-2008-04-25 : tarsnap --keyfile /usr/tarsnap.key -x -f backup-2008-04-25 usr/home/auser usr/home/anotheruser /etc/crontab : : 32 10 * * * root tarsnap --keyfile /usr/tarsnap.key --cachedir /usr/tarsnap-cache -c -f backup-`date +\%Y\%m\%d` / --keyfile --cachedir tarsnap.conf(5) . (SECURITY) tarsnap . tarsnap . . (superuser) . . tarsnap : o . tarsnap / . o .. . tarsnap .. . o . . tarsnap . . -U . -U -P tarsnap . tarsnap key-file () tarsnap -t --keyfile key-file -f archive-name . -P tarsnap .. . (SEE ALSO) tarsnap-keygen(1), tar(5), tarsnap.conf(5) (HISTORY) tar (Seventh Edition Unix) . . pdtar John Gilmore ( ) GNU tar . GNU tar FreeBSD 1.0 tar FreeBSD FreeBSD 5.3 bsdtar libarchive(3) Tim Kientzle . tarsnap bsdtar libarchive(3) . (BUGS) -l tar(5) ISO/IEC 9945-1:1996 ("POSIX.1") . GNU tar -l --one-file-system . @foo @@foo -foo ./@foo ./@@foo ./-foo . ./ . / -P . @archive-file "tar" . ( .) . --maxbw . tarsnap chroot (terminal devices) ^Q SIGQUIT . Linux 6.12.107+deb13-amd64 March 20, 2025 Linux 6.12.107+deb13-amd64