FreeBSD Manual Pages
SHUF(1) General Commands Manual SHUF(1) NAME shuf -- randomly permute input lines SYNOPSIS shuf [-hv] [-n count] [-o outfile] [-rz] [file] shuf [-hv] -e [-n count] [-o outfile] [-rz] [args ...] shuf [-hv] -i lo-hi [-n count] [-o outfile] [-rz] DESCRIPTION shuf is a utility that outputs a random permutation of its input lines. By default, shuf reads from stdin and outputs to stdout. The options are as follows: -e Use a space-separated list of command-line args as input. Cannot be combined with -i. -h Print usage information and exit. -i lo-hi Use the range of unsigned integers from lo to hi as input. Cannot be combined with -e. -n count Print at most count lines. -o outfile Write output to outfile instead of stdout. -r Do not permute. Instead, choose lines at random, with replace- ment. When used without -n, shuf repeats indefinitely. -v Print version information and exit. -z Delineate lines with the NUL character instead of the newline character. EXIT STATUS The shuf utility exits 0 on success, and >0 if an error occurs. EXAMPLES Flip a coin ten times: shuf -e -n 10 -r Heads Tails Select five numbers from 10 to 20: shuf -i 10-20 -n 5 Set a random desktop background image from the user's collection: ls ~/wallpaper | shuf -n 1 | feh --bg-fill Read a shuffled version of this manual page: shuf shuf.1 | mandoc -mdoc | less AUTHORS shuf was written by Brian Callahan <bcallah@openbsd.org>. CAVEATS This implementation of shuf intentionally omits all long options. The maximum range for lo-hi is INT_MAX-1. FreeBSD Ports 14.quarterly March 20, 2020 SHUF(1)
NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | AUTHORS | CAVEATS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=shuf&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>