original/man1/shuf.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.43.3.
   2 .TH SHUF "1" "May 2014" "GNU coreutils 8.22" "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\-count\fR=\fICOUNT\fR
  28 output at most COUNT 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
  35 .TP
  36 \fB\-r\fR, \fB\-\-repeat\fR
  37 output lines can be repeated
  38 .TP
  39 \fB\-z\fR, \fB\-\-zero\-terminated\fR
  40 end lines with 0 byte, not newline
  41 .TP
  42 \fB\-\-help\fR
  43 display this help and exit
  44 .TP
  45 \fB\-\-version\fR
  46 output version information and exit
  47 .PP
  48 With no FILE, or when FILE is \-, read standard input.
  49 .PP
  50 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  51 Report shuf translation bugs to <http://translationproject.org/team/>
  52 .SH AUTHOR
  53 Written by Paul Eggert.
  54 .SH COPYRIGHT
  55 Copyright \(co 2013 Free Software Foundation, Inc.
  56 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  57 .br
  58 This is free software: you are free to change and redistribute it.
  59 There is NO WARRANTY, to the extent permitted by law.
  60 .SH "SEE ALSO"
  61 The full documentation for
  62 .B shuf
  63 is maintained as a Texinfo manual.  If the
  64 .B info
  65 and
  66 .B shuf
  67 programs are properly installed at your site, the command
  68 .IP
  69 .B info coreutils \(aqshuf invocation\(aq
  70 .PP
  71 should give you access to the complete manual.