Arch manual pages

Package containing this man page: core/coreutils (version 8.28-1)

SHUF(1) User Commands SHUF(1)


shuf - generate random permutations


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.


GNU coreutils online help: <>
Report shuf translation bugs to <>


Copyright © 2017 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.


Full documentation at: <>
or available locally via: info '(coreutils) shuf invocation'
September 2017 GNU coreutils 8.28