summaryrefslogtreecommitdiffstats
path: root/docs/usage/tar.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/usage/tar.rst')
-rw-r--r--docs/usage/tar.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/usage/tar.rst b/docs/usage/tar.rst
new file mode 100644
index 000000000..3ef38e164
--- /dev/null
+++ b/docs/usage/tar.rst
@@ -0,0 +1,18 @@
+.. include:: export-tar.rst.inc
+
+Examples
+~~~~~~~~
+::
+
+ # export as uncompressed tar
+ $ borg export-tar /path/to/repo::Monday Monday.tar
+
+ # exclude some types, compress using gzip
+ $ borg export-tar /path/to/repo::Monday Monday.tar.gz --exclude '*.so'
+
+ # use higher compression level with gzip
+ $ borg export-tar testrepo::linux --tar-filter="gzip -9" Monday.tar.gz
+
+ # export a gzipped tar, but instead of storing it on disk,
+ # upload it to a remote site using curl.
+ $ borg export-tar ... --tar-filter="gzip" - | curl --data-binary @- https://somewhere/to/POST