'\" te
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH SHUF "1" "March 2012" "GNU coreutils 8.16" "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 2012 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.

.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	file/gnu-coreutils
=
Stability	Uncommitted
.TE 
.PP
.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.


.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz

Further information about this software can be found on the open source community website at http://www.gnu.org/software/coreutils/.