Debian Codegraph @

upstream/debian-unstable/man1/shuf.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH SHUF "1" "February 2026" "GNU coreutils 9.10" "User Commands"
3 .SH NAME
4 shuf \- generate random permutations
5 .SH SYNOPSIS
6 .B shuf
7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]
8 .br
9 .B shuf
10 \fI\,-e \/\fR[\fI\,OPTION\/\fR]... [\fI\,ARG\/\fR]...
11 .br
12 .B shuf
13 \fI\,-i LO-HI \/\fR[\fI\,OPTION\/\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 With no FILE, or when FILE is \-, read standard input.
20 .PP
21 Mandatory arguments to long options are mandatory for short options too.
22 .TP
23 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-e'\fB\-e, \-\-echo\fP\X'tty: link'
24 treat each ARG as an input line
25 .TP
26 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-i'\fB\-i, \-\-input\-range=\,LO\-HI\fP\X'tty: link'\/\fR
27 treat each number LO through HI as an input line
28 .TP
29 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-n'\fB\-n, \-\-head\-count=\,COUNT\fP\X'tty: link'\/\fR
30 output at most COUNT lines
31 .TP
32 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-o'\fB\-o, \-\-output=\,FILE\fP\X'tty: link'\/\fR
33 write result to FILE instead of standard output
34 .TP
35 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf--random-source'\fB\-\-random\-source=FILE\fP\X'tty: link'
36 get random bytes from FILE
37 .TP
38 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-r'\fB\-r, \-\-repeat\fP\X'tty: link'
39 output lines can be repeated
40 .TP
41 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#shuf-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link'
42 line delimiter is NUL, not newline
43 .TP
44 \X'tty: link https://www.gnu.org/software/coreutils/shuf#shuf--help'\fB\-\-help\fP\X'tty: link'
45 display this help and exit
46 .TP
47 \X'tty: link https://www.gnu.org/software/coreutils/shuf#shuf--version'\fB\-\-version\fP\X'tty: link'
48 output version information and exit
49 .SH AUTHOR
50 Written by Paul Eggert.
51 .SH "REPORTING BUGS"
52 Report bugs to: bug\[email protected]
53 .br
54 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
55 .br
56 General help using GNU software: <https://www.gnu.org/gethelp/>
57 .br
58 Report any translation bugs to <https://translationproject.org/team/>
59 .SH "SEE ALSO"
60 Full documentation <https://www.gnu.org/software/coreutils/shuf>
61 .br
62 or available locally via: info \(aq(coreutils) shuf invocation\(aq
63 .PP
64 .br
65 Packaged by Debian (9.10\-1)
66 .br
67 Copyright \(co 2026 Free Software Foundation, Inc.
68 .br
69 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
70 .br
71 This is free software: you are free to change and redistribute it.
72 .br
73 There is NO WARRANTY, to the extent permitted by law.