Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9087 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SHUFFLE(1)		  BSD General Commands Manual		    SHUFFLE(1)

NAME
     shuffle — print a random permutation of the command line arguments

SYNOPSIS
     shuffle [-0] [-f filename ...] [-n number] [-p number] [arg] [...]

DESCRIPTION
     The shuffle program prints a random permutation (or “shuffle”) of its
     command line arguments.  This can be useful in shell scripts for select‐
     ing a random order in which to do a set of tasks, view a set of files,
     etc.

     If the -f option is given, the data is taken from that files' contents or
     if the filename is - “stdin”.

     If the -n option is given, its argument is treated as a number, and the
     program prints a random permutation of the numbers greater than or equal
     to 0 and less than the argument.

     If the -p option is given, its argument is treated as a number, and the
     program prints that number of randomly selected lines or arguments in a
     random order.

     The -0 option changes the field separator character from \n to \0, so
     that the output is suitable to be sent to xargs(1) (to handle filenames
     with whitespace in them).

EXAMPLES
	   $ shuffle a b c d
	   c
	   b
	   d
	   a
	   $ shuffle -p 1 a b c d
	   d
	   $ shuffle -n 4 -p 2
	   0
	   3

SEE ALSO
     jot(1), random(6)

HISTORY
     The shuffle program first appeared in NetBSD 1.4.

AUTHORS
     Written by Perry E. Metzger ⟨perry@piermont.com⟩.

BSD			       February 18, 2009			   BSD

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome