mls(1)

📦 version 5.4.2, in nixos 26.05, nixpkgs unstable

💅 mls(1) — the Manta Commands era, bestie

okay so real talk: this is mls(1) from the Manta Commands set, and yes she's here to list your stuff. so iconic of her.

✨ NAME ✨

mls — list directory contents. that's it, that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

mls [OPTION...] [FILE]...

🦋 DESCRIPTION 🦋

okay so mls lists info about the FILEs you hand it. and if you hand it literally nothing? she defaults to /:login/stor, where :login is either the login you gave her with -a or whatever $MANTA_USER says. main character energy, honestly. 👑

entries come sorted by creation time. and heads up — directories will look like they have a trailing / after them, while objects are just the name, unless you passed -l. no cap. 💖

🌈 EXAMPLES 🌈

$ mls ~~/stor
foo
home/
README.md
tmp/

look at that. flawless. directories got their lil slashes, objects didn't. slay. ✨

💜 OPTIONS 💜

  • -a, --account login — authenticate as login name. be that account, periodt.
  • -h, --human-readable — human readable output when you're using a long listing format. cute lil numbers for humans. 🫶
  • --help — print a help message and exit. she'll explain herself.
  • -i, --insecure — this option explicitly allows "insecure" SSL connections and transfers. ngl, all SSL connections are attempted to be made secure by using the CA certificate bundle installed by default — so this is you going "yeah ik, do it anyway." 🙈
  • -j, --json — output records in JSON instead of the human readable form. for the machine girlies. 💀
  • -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. no shortcuts, bestie.
  • -l, --long — use a long listing format. note that since Manta does not have group information, this is like ls -o, not ls -l, in a traditional shell. important lore. 📚
  • -m, --marker name — start listing at name NAME. useful to paginate through large listings. lowkey the pagination queen.
  • -r, --reverse — reverse order while sorting. flip it. 🔄
  • --role=ROLE,ROLE,... — specify which roles to assume for the request. yes, plural, comma-separated, she can multitask. 👑
  • -t, --time — sort by modification time, newest first. fresh to death. ⭐
  • --user user — authenticate as user under account. subuser era.
  • -u, --url url — Manta base URL, like https://us-central.manta.mnx.io. point her somewhere. 🌍
  • -v, --verbose — print debug output to stderr. repeat the option to increase verbosity. (-v, -vv, -vvv… you get it. 🩷)

🧚 ENVIRONMENT 🧚

the environment variables are literally the same thing as the flags, just living in your shell instead. iykyk.

  • 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.

also!! the shortcut ~~ is equivalent to /:login where :login is the account login name. saving you so many keystrokes, you're welcome bestie 🎀

ngl the ~~ shortcut is the moment. type less, vibe more.

🔥 DIAGNOSTICS 🔥

when you use the -v option, diagnostics get sent to stderr in bunyan output format. and if you wanna trace, like, all the information about a request, try:

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

that 2>&1? that's the whole trick. pipe it straight into bunyan and watch the tea spill. ☕✨

💀 BUGS 💀

🍓 sign-off 🍓

that's the whole page, bestie — brought to you by Manta, dated Sep 2018, and she ate, no crumbs. go list some directories. 💅💖✨

📦 where this page comes from