2022-01-23 14:52:21 +00:00
|
|
|
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
|
|
|
|
|
|
|
|
|
|
.. _borg_import-tar:
|
|
|
|
|
|
|
|
|
|
borg import-tar
|
|
|
|
|
---------------
|
|
|
|
|
.. code-block:: none
|
|
|
|
|
|
|
|
|
|
borg [common options] import-tar [options] ARCHIVE TARFILE
|
|
|
|
|
|
|
|
|
|
.. only:: html
|
|
|
|
|
|
|
|
|
|
.. class:: borg-options-table
|
|
|
|
|
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| **positional arguments** |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``ARCHIVE`` | name of archive to create (must be also a valid directory name) |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``TARFILE`` | input tar file. "-" to read from stdin instead. |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| **optional arguments** |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``--tar-filter`` | filter program to pipe data through |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``-s``, ``--stats`` | print statistics for the created archive |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``--list`` | output verbose list of items (files, dirs, ...) |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``--filter STATUSCHARS`` | only display items with the given status characters |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``--json`` | output stats as JSON (implies --stats) |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| .. class:: borg-common-opt-ref |
|
|
|
|
|
| |
|
|
|
|
|
| :ref:`common_options` |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| **Archive options** |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``--comment COMMENT`` | add a comment text to the archive |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``--timestamp TIMESTAMP`` | manually specify the archive creation date/time (UTC, yyyy-mm-ddThh:mm:ss format). alternatively, give a reference file/directory. |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``-c SECONDS``, ``--checkpoint-interval SECONDS`` | write checkpoint every SECONDS seconds (Default: 1800) |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``--chunker-params PARAMS`` | specify the chunker parameters (ALGO, CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE). default: buzhash,19,23,21,4095 |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``-C COMPRESSION``, ``--compression COMPRESSION`` | select compression algorithm, see the output of the "borg help compression" command for details. |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
|
|
|
|
|
|
.. raw:: html
|
|
|
|
|
|
|
|
|
|
<script type='text/javascript'>
|
|
|
|
|
$(document).ready(function () {
|
|
|
|
|
$('.borg-options-table colgroup').remove();
|
|
|
|
|
})
|
|
|
|
|
</script>
|
|
|
|
|
|
|
|
|
|
.. only:: latex
|
|
|
|
|
|
|
|
|
|
ARCHIVE
|
|
|
|
|
name of archive to create (must be also a valid directory name)
|
|
|
|
|
TARFILE
|
|
|
|
|
input tar file. "-" to read from stdin instead.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
optional arguments
|
|
|
|
|
--tar-filter filter program to pipe data through
|
|
|
|
|
-s, --stats print statistics for the created archive
|
|
|
|
|
--list output verbose list of items (files, dirs, ...)
|
|
|
|
|
--filter STATUSCHARS only display items with the given status characters
|
|
|
|
|
--json output stats as JSON (implies --stats)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
:ref:`common_options`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Archive options
|
|
|
|
|
--comment COMMENT add a comment text to the archive
|
|
|
|
|
--timestamp TIMESTAMP manually specify the archive creation date/time (UTC, yyyy-mm-ddThh:mm:ss format). alternatively, give a reference file/directory.
|
|
|
|
|
-c SECONDS, --checkpoint-interval SECONDS write checkpoint every SECONDS seconds (Default: 1800)
|
|
|
|
|
--chunker-params PARAMS specify the chunker parameters (ALGO, CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE). default: buzhash,19,23,21,4095
|
|
|
|
|
-C COMPRESSION, --compression COMPRESSION select compression algorithm, see the output of the "borg help compression" command for details.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
This command creates a backup archive from a tarball.
|
|
|
|
|
|
|
|
|
|
When giving '-' as path, Borg will read a tar stream from standard input.
|
|
|
|
|
|
|
|
|
|
By default (--tar-filter=auto) Borg will detect whether the file is compressed
|
|
|
|
|
based on its file extension and pipe the file through an appropriate filter:
|
|
|
|
|
|
|
|
|
|
- .tar.gz or .tgz: gzip -d
|
|
|
|
|
- .tar.bz2 or .tbz: bzip2 -d
|
|
|
|
|
- .tar.xz or .txz: xz -d
|
|
|
|
|
- .tar.zstd: zstd -d
|
|
|
|
|
- .tar.lz4: lz4 -d
|
|
|
|
|
|
|
|
|
|
Alternatively, a --tar-filter program may be explicitly specified. It should
|
|
|
|
|
read compressed data from stdin and output an uncompressed tar stream on
|
|
|
|
|
stdout.
|
|
|
|
|
|
|
|
|
|
Most documentation of borg create applies. Note that this command does not
|
|
|
|
|
support excluding files.
|
|
|
|
|
|
|
|
|
|
A ``--sparse`` option (as found in borg create) is not supported.
|
|
|
|
|
|
2022-04-14 19:09:23 +00:00
|
|
|
About tar formats and metadata conservation or loss, please see ``borg export-tar``.
|
|
|
|
|
|
|
|
|
|
import-tar reads these tar formats:
|
|
|
|
|
|
|
|
|
|
- BORG: borg specific (PAX-based)
|
|
|
|
|
- PAX: POSIX.1-2001
|
|
|
|
|
- GNU: GNU tar
|
|
|
|
|
- POSIX.1-1988 (ustar)
|
|
|
|
|
- UNIX V7 tar
|
|
|
|
|
- SunOS tar with extended attributes
|
