Man page - borg2-export-tar(1)
Packages contas this manual
- borg2-prune(1)
- borg2-with-lock(1)
- borg2-delete(1)
- borg2-key(1)
- borg2-repo-space(1)
- borg2-mount(1)
- borg2-list(1)
- borg2-info(1)
- borg2-common(1)
- borg2-recreate(1)
- borg2-key-import(1)
- borg2-benchmark-crud(1)
- borg2-match-archives(1)
- borg2-repo-info(1)
- borg2-key-change-location(1)
- borg2-repo-delete(1)
- borg2-compression(1)
- borg2-compact(1)
- borg2-repo-create(1)
- borg2-version(1)
- borg2-key-export(1)
- borg2-break-lock(1)
- borg2-benchmark-cpu(1)
- borgfs2(1)
- borg2-tag(1)
- borgbackup2(1)
- borg2-benchmark(1)
- borg2-rename(1)
- borg2-umount(1)
- borg2-import-tar(1)
- borg2-repo-compress(1)
- borg2-serve(1)
- borg2-undelete(1)
- borg2-placeholders(1)
- borg2-transfer(1)
- borg2(1)
- borg2-analyze(1)
- borg2-export-tar(1)
- borg2-key-change-passphrase(1)
- borg2-extract(1)
- borg2-patterns(1)
- borg2-diff(1)
- borg2-repo-list(1)
- borg2-create(1)
- borg2-check(1)
apt-get install borgbackup2
Manual
| BORG-EXPORT-TAR(1) | borg backup tool | BORG-EXPORT-TAR(1) |
NAME
borg-export-tar - Export archive contents as a tarball
SYNOPSIS
borg [common options] export-tar [options] NAME FILE [PATH...]
DESCRIPTION
This command creates a tarball from an archive.
When giving '-' as the output FILE, Borg will write a tar stream to standard output.
By default (--tar-filter=auto) Borg will detect whether the FILE should be compressed based on its file extension and pipe the tarball through an appropriate filter before writing it to FILE:
- .tar.gz or .tgz: gzip
- .tar.bz2 or .tbz: bzip2
- .tar.xz or .txz: xz
- .tar.zstd or .tar.zst: zstd
- .tar.lz4: lz4
Alternatively, a --tar-filter program may be explicitly specified. It should read the uncompressed tar stream from stdin and write a compressed/filtered tar stream to stdout.
Depending on the -tar-format option, these formats are created:
| --tar-format | Specification | Metadata |
| BORG | BORG specific, like PAX | all as supported by borg |
| PAX | POSIX.1-2001 (pax) format | GNU + atime/ctime/mtime ns + xattrs |
| GNU | GNU tar format | mtime s, no atime/ctime, no ACLs/xattrs/bsdflags |
A --sparse option (as found in borg extract) is not supported.
By default the entire archive is extracted but a subset of files and directories can be selected by passing a list of PATHs as arguments. The file selection can further be restricted by using the --exclude option.
For more help on include/exclude patterns, see the borg_patterns command output.
--progress can be slower than no progress display, since it makes one additional pass over the archive metadata.
OPTIONS
See borg-common(1) for common options of Borg commands.
arguments
options
- --tar-filter
- filter program to pipe data through
- --list
- output verbose list of items (files, dirs, ...)
- --tar-format FMT
- select tar format: BORG, PAX or GNU
Include/Exclude options
- -e PATTERN, --exclude PATTERN
- exclude paths matching PATTERN
- --exclude-from EXCLUDEFILE
- read exclude patterns from EXCLUDEFILE, one per line
- --pattern PATTERN
- include/exclude paths matching PATTERN
- --patterns-from PATTERNFILE
- read include/exclude patterns from PATTERNFILE, one per line
- --strip-components NUMBER
- Remove the specified number of leading path elements. Paths with fewer elements will be silently skipped.
SEE ALSO
borg-common(1)
AUTHOR
The Borg Collective
| 2025-08-04 |