NAME

muntar - create a directory hierarchy from a tar file

SYNOPSIS

muntar -f tarfile [OPTION...] PATH...

DESCRIPTION

The muntar utility extracts the contents of a tar file and creates the corresponding objects in the path specified. If the destination directories do not exist, they are created.

EXAMPLES

muntar -f shakespeare.tar  ~~/stor/plays/shakespeare
~~/stor/plays/shakespeare/README
~~/stor/plays/shakespeare/comedies/cymbeline
~~/stor/plays/shakespeare/glossary
. . .
~~/stor/plays/shakespeare/comedies/merrywivesofwindsor
~~/stor/plays/shakespeare/poetry/rapeoflucrece
~~/stor/plays/shakespeare/poetry/various
~~/stor/plays/shakespeare/poetry/sonnets

If the tarball is compressed, you can store it as an object and use muntar in the compute environment.

mput -f /var/tmp/backup.tar.gz ~~/stor/backup.tar.gz
$ echo ~~/stor/backup.tar.gz | \
    mjob create -o -m gzcat -m 'muntar -f $MANTA_INPUT_FILE ~~/stor'

OPTIONS

-a, --account=login Authenticate as account (login name).

-c, --copies=copies Number of copies to make.

-f, --file=tarfile The tar file to extract from.

-H, --header=header HTTP headers to include.

-h, --help Print a help message and exit.

-i, --insecure This option explicitly allows "insecure" SSL connections and transfers. All SSL connections are attempted to be made secure by using the CA certificate bundle installed by default.

-k fingerprint, --key=fingerprint Authenticate using the SSH key described by FINGERPRINT. The key must either be in ~/.ssh or loaded in the SSH agent via ssh-add.

-p NUM, --parallel=NUM Limit concurrent operations to NUM. Default is 20.

-t, --type type Specify d for directories, and o for objects. If specified, only names of that type will be returned.

--role=ROLE,ROLE,... Specify which roles to assume for the request.

--role-tag=ROLE,ROLE,... Set the role tags on created objects and directories.

--user user Authenticate as user under account.

-u, --url url Manta base URL (such as https://us-central.manta.mnx.io).

-v, --verbose Print debug output to stderr. Repeat option to increase verbosity.

ENVIRONMENT

MANTA_USER In place of -a, --account.

MANTA_SUBUSER In place of --user.

MANTA_KEY_ID In place of -k, --key.

MANTA_ROLE In place of --role.

MANTA_URL In place of -u, --url.

MANTA_TLS_INSECURE In place of -i, --insecure.

The shortcut ~~ is equivalent to /:login where :login is the account login name.

DIAGNOSTICS

When using the -v option, diagnostics will be sent to stderr in bunyan output format. As an example of tracing all information about a request, try:

mfind -vv ~~/stor 2>&1 | bunyan

NOTES

BUGS

DSA keys do not work when loaded via the SSH agent.

Report bugs at Github