mget(1)

🦋 mget(1) — Manta Commands bestie energy 🦋

💖 NAME 💖

mget — download an object from Manta, no cap. This little icon is serving Manta Commands realness and it's here to fetch your stuff.

✨ SYNOPSIS ✨

mget [OPTION...] PATH...

🎀 DESCRIPTION 🎀

Okay so bestie, mget retrieves the content of object(s) specified by PATH(s) and dumps them straight to stdout. It's giving "grab and go" energy. 💅

Important vibe check: mget does not perform incremental/resumable downloads. So any network-level errors that happen during transfer will result in an incomplete and/or corrupt output. You should check for an exit status of 0 to know that the request was successful. Fr fr, check that exit status. 😭

Also, mget by default will emit a progress meter on stderr. You can disable this with -q. Slay, quiet mode. 🤫

🌈 EXAMPLES 🌈

Retrieves the given object, with a progress indicator. Cute:

$ mget ~~/stor/README.md > /tmp/README.md

Retrieves the given object, with a progress indicator, and stores it in the file README.md in the current directory. Iconic behavior:

$ mget -O ~~/stor/README.md

Finds and fetches a set of Javascript files, and pipes them to less. The pipeline is piping, honestly:

$ mfind -t o -n '.js$' ~~/stor/foo | xargs mget -q | less

🦋 OPTIONS 🦋

• -a, --account login — Authenticate as account (login name). Like, tell it who you are. 💁‍♀️
• -H, --header='header: value' — Additional HTTP header to include. Can be specified multiple times. Must be specified for each additional header. Yes, every single one, bestie. 🎀
• -h, --help — Print a help message and exit. Your little escape hatch. ✨
• -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. It's giving risky business, so be aware. 😬
• -k, --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. Key check, but make it secure. 🔐
• --role=ROLE,ROLE,... — Specify which roles to assume for the request. Role call, literally. 👑
• -o, --output file — Write output to <file> instead of stdout. Choose your destination, main character. 🎯
• -O, --remote-name — Write output to a file using the requested object's name (i.e. the last element of the full object path) instead of stdout. It names the file for you, periodt. 💅
• -q, --quiet — Do not display a progress meter. Silence is golden, honestly. 🤫
• --user user — Authenticate as user under account. Subuser moment. 🫶
• -u, --url url — Manta base URL (such as https://us-central.manta.mnx.io). Pick your Manta address, bestie. 🌐
• -v, --verbose — Print debug output to stderr. Repeat option to increase verbosity. More v's, more lore. 🔍

🌸 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. Tiny shortcut, big convenience. 🧚

💜 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:

$ mget -vv ~~/stor/foo 2>&1 | bunyan

🍓 BUGS 🍓

DSA keys do not work when loaded via the SSH agent. That's the bug note, bestie. 🫠

Report bugs at Github: https://github.com/TritonDataCenter/node-manta/issues

---

🫶 this page came from Manta, dated March 2019, and yes bestie it's mget(1) 💖