.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.43.3.
.TH SHUF "1" "November 2014" "GNU coreutils 8.23" "User Commands"
.SH NAME
shuf \- generate random permutations
.SH SYNOPSIS
.B shuf
[\fIOPTION\fR]... [\fIFILE\fR]
.br
.B shuf
\fI-e \fR[\fIOPTION\fR]... [\fIARG\fR]...
.br
.B shuf
\fI-i LO-HI \fR[\fIOPTION\fR]...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Write a random permutation of the input lines to standard output.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-e\fR, \fB\-\-echo\fR
treat each ARG as an input line
.TP
\fB\-i\fR, \fB\-\-input\-range\fR=\fILO\-HI\fR
treat each number LO through HI as an input line
.TP
\fB\-n\fR, \fB\-\-head\-count\fR=\fICOUNT\fR
output at most COUNT lines
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
write result to FILE instead of standard output
.TP
\fB\-\-random\-source\fR=\fIFILE\fR
get random bytes from FILE
.TP
\fB\-r\fR, \fB\-\-repeat\fR
output lines can be repeated
.TP
\fB\-z\fR, \fB\-\-zero\-terminated\fR
line delimiter is NUL, not newline
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
With no FILE, or when FILE is \-, read standard input.
.PP
GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
Report shuf translation bugs to <http://translationproject.org/team/>
.SH AUTHOR
Written by Paul Eggert.
.SH COPYRIGHT
Copyright \(co 2014 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B shuf
is maintained as a Texinfo manual.  If the
.B info
and
.B shuf
programs are properly installed at your site, the command
.IP
.B info coreutils \(aqshuf invocation\(aq
.PP
should give you access to the complete manual.