STEST(1)

💅 STEST — like, the file filter of your dreams (section 1, bestie)

okay so welcome to stest(1) from the General Commands Manual, and no cap this little cutie is SO underrated 🫶

---

✨ NAME ✨

stest — filter a list of files by properties 💖

---

🌸 SYNOPSIS 🌸

stest [-abcdefghlpqrsuwx] [-n file] [-o file] [file...]

---

🦋 DESCRIPTION 🦋

okay so here's the tea: stest takes a whole list of files and filters them by the files' properties, literally analogous to test(1) 🎀 Files that pass all the tests get printed to stdout, slay.

And if you don't hand it any files at all? It just reads files from stdin instead. lowkey iconic behaviour 💅

---

👑 OPTIONS 👑

one bullet per flag, all of them, no skipping, periodt:

• -a — test hidden files 👀
• -b — test that files are block specials
• -c — test that files are character specials
• -d — test that files are directories 📁
• -e — test that files exist (the bare minimum tbh)
• -f — test that files are regular files
• -g — test that files have their set-group-ID flag set
• -h — test that files are symbolic links 🔗
• -l — test the contents of a directory given as an argument
• -n file — test that files are newer than file ⏰
• -o file — test that files are older than file 🕰️
• -p — test that files are named pipes
• -q — no files are printed, only the exit status is returned 🤫
• -r — test that files are readable 📖
• -s — test that files are not empty
• -u — test that files have their set-user-ID flag set
• -v — invert the sense of tests, only failing files pass 🙃 (the plot twist flag)
• -w — test that files are writable ✍️
• -x — test that files are executable 🏃

---

💀 EXIT STATUS 💀

• 0 — at least one file passed all tests 🎉
• 1 — no files passed all tests 😭
• 2 — an error occurred 💥

---

🔥 SEE ALSO 🔥

dmenu(1), test(1) — go read those too, iykyk 💜

---

and that's the whole vibe check, bestie 🌈 this page is from dmenu-5.4 and it's the STEST(1) manual, so go filter some files and be the main character of your own shell session ✨💅🎀