shuf(1)

💅 shuf — the General Commands Manual page, but make it cute

okay bestie, welcome to shuf(1) ✨ this is the manual page for shuf, and we're gonna go through it together, top to bottom, no skimming, no skipping. periodt.

---

✨ NAME ✨

shuf — shuffle the input by outputting a random permutation of input lines. Each output permutation is equally likely. With no FILE, or when FILE is -, read standard input.

like… it literally just vibes and reorders your lines. every possible ordering has the same chance. no favourites, no bias, main character energy for every line equally 🎀

---

🌈 SYNOPSIS 🌈

shuf [-e|--echo] [-i|--input-range] [-n|--head-count] [-o|--output]
[--random-seed] [--random-source] [-r|--repeat] [-z|--zero-terminated]
[-h|--help] [-V|--version] [file-or-args]

that's the whole shape of it, bestie. flags, then optionally a file or some args. iykyk 💖

---

🦋 DESCRIPTION 🦋

Shuffle the input by outputting a random permutation of input lines. Each output permutation is equally likely. With no FILE, or when FILE is -, read standard input.

fr fr that's the whole thing. it takes lines in, it spits lines out in a random order, and every single ordering is just as likely as every other one. if you don't hand it a FILE, or if the FILE you hand it is -, it reads from standard input. standard input is always down to hang out 💜

---

✨ OPTIONS ✨

the options, bestie, one by one, no skipping, we're eating the whole plate 👑

• -e, --echo — treat each ARG as an input line
• -i, --input-range <LO-HI> — treat each number LO through HI as an input line
• -n, --head-count <COUNT> — output at most COUNT lines
• -o, --output <FILE> — write result to FILE instead of standard output
• --random-seed <STRING> — seed with STRING for reproducible output
• --random-source <FILE> — get random bytes from FILE
• -r, --repeat — output lines can be repeated
• -z, --zero-terminated — line delimiter is NUL, not newline
• -h, --help — Print help
• -V, --version — Print version
• [file-or-args] — yeah that's it, that's the trailing positional. slay.

ngl, --random-seed is lowkey the icon of the group. reproducible shuffles?? obsessed. 🌸

---

💀 VERSION 💀

v(uutils coreutils) 0.7.0

---

and that's the page, bestie 🫶 this was shuf from uutils coreutils, version 0.7.0, in the General Commands Manual — so go forth, shuffle something, and remember: every permutation is equally likely, just like every one of your bad ideas is equally iconic 💖✨🎀🦋🌈💅