Go to main content

man pages section 1: User Commands

Exit Print View

Updated: July 2017
 
 

shuf (1)

Name

shuf - generate random permutations

Synopsis

shuf [OPTION]... [FILE]
shuf -e [OPTION]... [ARG]...
shuf -i LO-HI [OPTION]...

Description

SHUF(1)                          User Commands                         SHUF(1)



NAME
       shuf - generate random permutations

SYNOPSIS
       shuf [OPTION]... [FILE]
       shuf -e [OPTION]... [ARG]...
       shuf -i LO-HI [OPTION]...

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

       Mandatory  arguments  to  long  options are mandatory for short options
       too.

       -e, --echo
              treat each ARG as an input line

       -i, --input-range=LO-HI
              treat each number LO through HI as an input line

       -n, --head-count=COUNT
              output at most COUNT lines

       -o, --output=FILE
              write result to FILE instead of standard output

       --random-source=FILE
              get random bytes from FILE

       -z, --zero-terminated
              end lines with 0 byte, not newline

       --help display this help and exit

       --version
              output version information and exit

       With no FILE, or when FILE is -, read standard input.

AUTHOR
       Written by Paul Eggert.

REPORTING BUGS
       Report shuf bugs to bug-coreutils@gnu.org
       GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
       General help using GNU software: <http://www.gnu.org/gethelp/>
       Report shuf translation bugs to <http://translationproject.org/team/>

COPYRIGHT
       Copyright (C) 2012 Free Software Foundation, Inc.  License GPLv3+:  GNU
       GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
       This  is  free  software:  you  are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.


ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       +---------------+--------------------+
       |ATTRIBUTE TYPE |  ATTRIBUTE VALUE   |
       +---------------+--------------------+
       |Availability   | file/gnu-coreutils |
       +---------------+--------------------+
       |Stability      | Uncommitted        |
       +---------------+--------------------+
SEE ALSO
       The full documentation for shuf is maintained as a Texinfo manual.   If
       the  info  and  shuf  programs are properly installed at your site, the
       command

              info coreutils 'shuf invocation'

       should give you access to the complete manual.



NOTES
       This    software    was    built    from    source     available     at
       https://java.net/projects/solaris-userland.    The  original  community
       source  was  downloaded  from    http://ftp.gnu.org/gnu/coreutils/core-
       utils-8.16.tar.xz

       Further information about this software can be found on the open source
       community website at http://www.gnu.org/software/coreutils/.



GNU coreutils 8.16                March 2012                           SHUF(1)