shuf.1 (913B)
- .\" utils-std: Collection of commonly available Unix tools
- .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
- .\" SPDX-License-Identifier: MPL-2.0
- .Dd 2025-01-06
- .Dt SHUF 1
- .Os
- .Sh NAME
- .Nm shuf
- .Nd print contents shuffled
- .Sh SYNOPSIS
- .Nm
- .Op Fl z
- .Op Fl n Ar num
- .Op Ar file...
- .Nm
- .Fl e
- .Op Fl z
- .Op Fl n Ar num
- .Op Ar string...
- .Sh DESCRIPTION
- .Nm
- reads each
- .Ar file
- in sequence and writes it on the standard output with some shuffling applied to each line.
- If no
- .Ar file
- is given or if
- .Ar file is
- .Qq - ,
- .Nm
- reads from the standard input.
- .Sh OPTIONS
- .Bl -tag -width _n_num
- .It Fl e
- Use each
- .Ar string
- as an input line.
- .It Fl n Ar num
- Output at most
- .Ar num
- lines.
- .It Fl z
- Use NULL as line delimiter, not newline.
- .El
- .Sh EXIT STATUS
- .Ex -std
- .Sh HISTORY
- An
- .Nm
- utility appeared in GNU coreutils 6.0.
- .Sh AUTHORS
- .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me