OS Manuals

/usr/bin/shuf

Cross-platform Rust rewrite of the GNU coreutils.

From uutils 0.12.0-r6 (os), captured 2026-11-07 by running shuf --help (exit 0). permalink

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.

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

Arguments:
  [file-or-args]...

Options:
  -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
Options (10)
OptionDescriptionSource
-e, --echotreat each ARG as an input linehelp + man
-i, --input-range LO-HItreat each number LO through HI as an input linehelp + man
-n, --head-count COUNToutput at most COUNT lineshelp + man
-o, --output FILEwrite result to FILE instead of standard outputhelp + man
--random-seed STRINGseed with STRING for reproducible outputhelp + man
--random-source FILEget random bytes from FILEhelp + man
-r, --repeatoutput lines can be repeatedhelp + man
-z, --zero-terminatedline delimiter is NUL, not newlinehelp + man
-h, --helpPrint helphelp + man
-V, --versionPrint versionhelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.