SHUF(1)

📦 version 0.12.0, in arch rolling

💅 NAME 💅

ok so shuf — bestie, it shuffles your input by outputting a random permutation of the input lines. every single output permutation is, like, equally likely (yes, truly, the math ate). and if you give it no FILE, or if FILE is literally just -, it reads from standard input. periodt. 🎀

✨ SYNOPSIS ✨

shuf [OPTION]... [FILE]
shuf -e [OPTION]... [ARG]...
shuf -i LO-HI [OPTION]...

three whole moods, pick your fighter 🦋

🌸 DESCRIPTION 🌸

okay so real talk: shuf shuffles the input by outputting a random permutation of input lines. every output permutation is equally likely — no cap, that's the whole personality. 🫶

and like, with no FILE, or when FILE is -, it reads standard input. classic.

🔥 OPTIONS 🔥

  • -e, --echo — treat each ARG as an input line. so instead of feeding it a file, you just hand it the lines directly, iconic behavior 💅
  • -i, --input-range <LO-HI> — treat each number LO through HI as an input line. number go brrr 🌈
  • -n, --head-count <COUNT> — output at most COUNT lines. a little taste, not the whole meal 🍓
  • -o, --output <FILE> — write the result to FILE instead of standard output. take it to go ✨
  • --random-seed <STRING> — seed with STRING for reproducible output. same seed, same shuffle, every time — lowkey obsessed 😭
  • --random-source <FILE> — get random bytes from FILE. you're sourcing your chaos from somewhere specific, main character energy 👑
  • -r, --repeat — output lines can be repeated. yes bestie, the same line can show up more than once, that's the point 🙈
  • -z, --zero-terminated — line delimiter is NUL, not newline. for when newlines are simply not the vibe 💀
  • -h, --help — print help. we love a helper 🧚
  • -V, --version — print version. let's see what we're working with 💜
  • [file-or-args] — yeah this is just sitting here at the bottom of the list, exactly where it was, no notes 🌸

⭐ VERSION ⭐

v(uutils coreutils) 0.12.0

and that's the whole page, bestie — no notes, fr fr 💖 go forth and randomize. this lil writeup was brought to you by v(uutils coreutils) 0.12.0, dated 2026-09-17 🦋🎀

📦 where this page comes from