.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH SHUF 1 "2026-09-01"
.SH NAME
shuf \- Shuffle the input by outputting a random permutation of input lines.
Each output permutation is equally likely.
With no FILE, or when FILE is \-, read standard input.
.SH SYNOPSIS
\fBshuf\fR [OPTION]... [FILE]
.br
\fBshuf\fR \-e [OPTION]... [ARG]...
.br
\fBshuf\fR \-i LO\-HI [OPTION]...
.SH DESCRIPTION
Shuffle the input by outputting a random permutation of input lines.
Each output permutation is equally likely.
With no FILE, or when FILE is \-, read standard input.
.SH OPTIONS
.TP
\fB\-e\fR, \fB\-\-echo\fR
treat each ARG as an input line
.TP
\fB\-i\fR, \fB\-\-input\-range\fR \fI<LO\-HI>\fR
treat each number LO through HI as an input line
.TP
\fB\-n\fR, \fB\-\-head\-count\fR \fI<COUNT>\fR
output at most COUNT lines
.TP
\fB\-o\fR, \fB\-\-output\fR \fI<FILE>\fR
write result to FILE instead of standard output
.TP
\fB\-\-random\-seed\fR \fI<STRING>\fR
seed with STRING for reproducible output
.TP
\fB\-\-random\-source\fR \fI<FILE>\fR
get random bytes from FILE
.TP
\fB\-r\fR, \fB\-\-repeat\fR
output lines can be repeated
.TP
\fB\-z\fR, \fB\-\-zero\-terminated\fR
line delimiter is NUL, not newline
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.TP
[\fIfile\-or\-args\fR]

.SH VERSION
v(uutils coreutils) 0.11.0