---

User Commands  - shuf- (1)

---

NAME

shuf- - [FUNIX] generate a random permutation of file lines, whole numbers, or strings (LICENSE:PD)

CONTENTS

Synopsis
Description
Examples
Author
License

SYNOPSIS

syntax:

   shuf- FILES(s)   [ -n]
   shuf- STRINGS -e [ -n]
   shuf- -i LO-HI   [ -n]

DESCRIPTION

Write a random permutation of the input lines to standard output.

FILES(s)
	files to use as input
-e	treat each ARG as an input line
-i LO HI
	treat each number LO through HI as an input line
-n	output at most COUNT lines (per file)
--help	display this help and exit
--version
	output version information and exit

EXAMPLES

Sample usage:

   # generate a random number from 0 to 100
   shuf- -i 0 100 -n 1
   # randomly select xterm(1) color
   xterm -bg ‘shuf- -e green black gray blue -n 1‘
   # output up to five randomly selected lines from a file
   shuf -n 5 FILE

AUTHOR

John S. Urban

LICENSE

Public Domain

---

Nemo Release 3.1

shuf- (1)

August 28, 2026

Generated by manServer 1.08 from 3773a7a2-30f2-4329-b8de-c184a36678e6 using man macros.