muntar(1)

Hey bestie! 💖 Welcome to muntar(1), the Manta Commands page for the one and only muntar. Strap in, because she is deprecated (😭) but the facts are still facts.

💖 NAME 💖

muntar — deprecated; create a directory hierarchy from a tar file. That is the whole gig, no cap.

✨ SYNOPSIS ✨

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

💅 DESCRIPTION 💅

Okay so first things first: muntar is deprecated and will be removed in a future release. Do not get attached, bestie. 💀

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

🎀 EXAMPLES 🎀

Here is the example, exactly as it appears:

$ 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), bestie.
• -c, --copies=copies — number of copies to make.
• -f, --file=tarfile — the tar file to extract from. Yes, this is the main character.
• -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 📝

The original page has a NOTES section with no notes in it. So this is us honoring the void. 🫡

💀 BUGS 💀

• DSA keys do not work when loaded via the SSH agent.
• Report bugs at Github ⟨https://github.com/TritonDataCenter/node-manta/issues⟩.

Stay iconic, bestie! Source/version: Manta. Date: May 2023. Mwah 💋✨