shuf
(1)generate random permutations
Options
9-e--echotreat each ARG as an input line
-i--input-rangeLO-HItreat each number LO through HI as an input line
-n--head-countCOUNToutput at most COUNT lines
-o--outputFILEwrite result to FILE instead of standard output
--random-sourceFILEget random bytes from FILE
-r--repeatoutput lines can be repeated
-z--zero-terminatedline delimiter is NUL, not newline
--helpdisplay this help and exit
--versionoutput version information and exit
DESCRIPTION
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
- --random-source=FILE
- get random bytes from FILE
- -r, --repeat
- output lines can be repeated
- -z, --zero-terminated
- line delimiter is NUL, not newline
- --help
- display this help and exit
- --version
- output version information and exit
AUTHOR
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'
Packaged by Debian (9.7-3)
Copyright © 2025 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later
https://gnu.org/licenses/gpl.html.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.