.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH SHUF "1" "March 2016" "GNU coreutils 8.21" "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\-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 shuf bugs to bug\-coreutils@gnu.org
.br
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
.br
General help using GNU software: <http://www.gnu.org/gethelp/>
.br
Report shuf translation bugs to <http://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2013 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.
