.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH SHUF "1" "March 2007" "GNU coreutils 6.9" "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\-lines\fR=\fILINES\fR
output at most LINES 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 (default /dev/urandom)
.TP
\fB\-z\fR, \fB\-\-zero\-terminated\fR
end lines with 0 byte, 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.
.SH AUTHOR
Written by Paul Eggert.
.SH "REPORTING BUGS"
Report bugs to <bug\-coreutils@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2007 Free Software Foundation, Inc.
.br
This is free software.  You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
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 shuf
.PP
should give you access to the complete manual.