man/shuf.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH SHUF "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 shuf \- generate random permutations
   5 .SH SYNOPSIS
   6 .B shuf
   7 [\fIOPTION\fR]... [\fIFILE\fR]
   8 .br
   9 .B shuf
  10 \fI-e \fR[\fIOPTION\fR]... [\fIARG\fR]...
  11 .br
  12 .B shuf
  13 \fI-i LO-HI \fR[\fIOPTION\fR]...
  14 .SH DESCRIPTION
  15 .\" Add any additional description here
  16 .PP
  17 Write a random permutation of the input lines to standard output.
  18 .PP
  19 Mandatory arguments to long options are mandatory for short options too.
  20 .TP
  21 \fB\-e\fR, \fB\-\-echo\fR
  22 treat each ARG as an input line
  23 .TP
  24 \fB\-i\fR, \fB\-\-input\-range\fR=\fILO\-HI\fR
  25 treat each number LO through HI as an input line
  26 .TP
  27 \fB\-n\fR, \fB\-\-head\-lines\fR=\fILINES\fR
  28 output at most LINES lines
  29 .TP
  30 \fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
  31 write result to FILE instead of standard output
  32 .TP
  33 \fB\-\-random\-source\fR=\fIFILE\fR
  34 get random bytes from FILE (default /dev/urandom)
  35 .TP
  36 \fB\-z\fR, \fB\-\-zero\-terminated\fR
  37 end lines with 0 byte, not newline
  38 .TP
  39 \fB\-\-help\fR
  40 display this help and exit
  41 .TP
  42 \fB\-\-version\fR
  43 output version information and exit
  44 .PP
  45 With no FILE, or when FILE is \-, read standard input.
  46 .SH AUTHOR
  47 Written by Paul Eggert.
  48 .SH "REPORTING BUGS"
  49 Report bugs to <bug\-coreutils@gnu.org>.
  50 .SH COPYRIGHT
  51 Copyright \(co 2007 Free Software Foundation, Inc.
  52 .br
  53 This is free software.  You may redistribute copies of it under the terms of
  54 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
  55 There is NO WARRANTY, to the extent permitted by law.
  56 .SH "SEE ALSO"
  57 The full documentation for
  58 .B shuf
  59 is maintained as a Texinfo manual.  If the
  60 .B info
  61 and
  62 .B shuf
  63 programs are properly installed at your site, the command
  64 .IP
  65 .B info shuf
  66 .PP
  67 should give you access to the complete manual.