S6-LS(1)

📦 version 2.3.1.2, in nixpkgs unstable

💖 s6-ls — like, list a directory's contents, bestie ✨

okay so real talk: this is page one of the General Commands Manual, and the star of the show is s6-ls, from the s6-portable-utils squad. she's small, she's fierce, she lists dirs. let's go 💅

🎀 NAME 🎀

s6-ls — list the contents of a directory. that's it. that's the whole job. and she ATE. 💖

🌸 SYNOPSIS 🌸

s6-ls [-0] [-a | -A] [-x exclude] dir

like, you give her a dir, you sprinkle on some flags, she gives you the vibes (the file names). iconic behavior honestly 🦋

✨ DESCRIPTION ✨

so s6-ls lists the contents of dir, one file per line — very demure, very mindful. 📋

and listen: it omits files starting with a dot, so all your sneaky little hidden files stay hidden unless you say otherwise. lowkey the default we all deserve 🙈✨

👑 OPTIONS 👑

  • -0 — separate file names with a null character instead of a newline. yes queen, null-terminated output, ideal for when you're piping into something that can't handle spaces. 🔥
  • -a — do not omit files starting with a dot. hidden files, come on out! 🎉 but ngl, it will not list . or .. though. those two stay in the shadows 💀
  • -A — do not omit files starting with a dot, and this time even . and .. get listed. she's giving full transparency. no secrets. none. 👁️👄👁️
  • -x exclude — if a file name is exactly exclude, do not print it. one specific name, blocked, unfollowed, uninvited. ⛔💅

🦋 EXIT STATUS 🦋

bestie, check these codes when she dips, okay? each one is telling you something:

  • 111 — temporary error. it's giving "try again later, she's not in the mood" 😭
  • 100 — permanent error, such as a misuse. you did something wrong and there's no fixing it, sorry queen 🙈
  • 127 — unable to execute program — not found. literally doesn't exist. nowhere. gone. 👻
  • 126 — unable to execute program — other reason. she's there but she's not coming to the door 🚪💀

💜 SEE ALSO 💜

the whole friend group showed up for this one, fr fr 🫶

s6-basename(1), s6-cat(1), s6-chmod(1), s6-chown(1), s6-clock(1), s6-cut(1), s6-dirname(1), s6-dumpenv(1), s6-echo(1), s6-env(1), s6-expr(1), s6-false(1), s6-format-filter(1), s6-grep(1), s6-head(1), s6-hiercopy(1), s6-linkname(1), s6-ln(1), s6-maximumtime(1), s6-mkdir(1), s6-mkfifo(1), s6-nice(1), s6-nuke(1), s6-pause(1), s6-printenv(1), s6-quote(1), s6-quote-filter(1), s6-rename(1), s6-rmrf(1), s6-seq(1), s6-sleep(1), s6-sort(1), s6-sync(1), s6-tai64ndiff(1), s6-tail(1), s6-touch(1), s6-true(1), s6-uniquename(1), s6-unquote(1), s6-unquote-filter(1), s6-update-symlinks(1), seekablepipe(1)

also there's this reference, keep it in your notes app 📝:

[1] https://pubs.opengroup.org/onlinepubs/9799919799/utilities/ls.html

💌 and for the record, this man page is ported from the authoritative documentation at: https://skarnet.org/software/s6-portable-utils/s6-ls.html — so all credit to the source material, we're just making it cute 🎀

🌈 STANDARDS 🌈

no cap, s6-ls is not suitable as an ls[1] program conforming to . periodt. she's her own thing, not a POSIX ls cosplay 💅 (that's the official wording, we don't make the rules 🫠)

⭐ AUTHORS ⭐

giving credit where credit is due, mwah 💋

  • Laurent Bercot
  • Alexis <flexibeast@gmail.com> (man page port)

and that's the page!! 🌸 this one came from Debian, dated April 18, 2022 — so go forth and list those directories, bestie, you're gonna slay 💖✨👑

📦 where this page comes from