Your company here — click to reach over 10,000 unique daily visitors

shuf - Man Page

generate random permutations

Examples (TL;DR)


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


Write a random permutation of the input lines to standard output.

With no FILE, or when FILE is -, read standard input.

Mandatory arguments to long options are mandatory for short options too.

-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


get random bytes from FILE

-r,  --repeat

output lines can be repeated

-z,  --zero-terminated

line delimiter is NUL, not newline


display this help and exit


output version information and exit


Written by Paul Eggert.

Reporting Bugs

GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
Report any translation bugs to <https://translationproject.org/team/>

See Also

Full documentation <https://www.gnu.org/software/coreutils/shuf>
or available locally via: info '(coreutils) shuf invocation'

Referenced By


July 2024 GNU coreutils 9.5