{
    "mode": "man",
    "parameter": "SHUF",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/SHUF/1/json",
    "generated": "2026-05-30T17:11:39Z",
    "synopsis": "shuf [OPTION]... [FILE]\nshuf -e [OPTION]... [ARG]...\nshuf -i LO-HI [OPTION]...",
    "sections": {
        "NAME": {
            "content": "shuf - generate random permutations\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "shuf [OPTION]... [FILE]\nshuf -e [OPTION]... [ARG]...\nshuf -i LO-HI [OPTION]...\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Write a random permutation of the input lines to standard output.\n\nWith no FILE, or when FILE is -, read standard input.\n\nMandatory arguments to long options are mandatory for short options too.\n",
            "subsections": [
                {
                    "name": "-e --echo",
                    "content": "treat each ARG as an input line\n",
                    "flag": "-e",
                    "long": "--echo"
                },
                {
                    "name": "-i --input-range",
                    "content": "treat each number LO through HI as an input line\n",
                    "flag": "-i",
                    "long": "--input-range"
                },
                {
                    "name": "-n --head-count",
                    "content": "output at most COUNT lines\n",
                    "flag": "-n",
                    "long": "--head-count"
                },
                {
                    "name": "-o --output",
                    "content": "write result to FILE instead of standard output\n\n--random-source=FILE\nget random bytes from FILE\n",
                    "flag": "-o",
                    "long": "--output"
                },
                {
                    "name": "-r --repeat",
                    "content": "output lines can be repeated\n",
                    "flag": "-r",
                    "long": "--repeat"
                },
                {
                    "name": "-z --zero-terminated",
                    "content": "line delimiter is NUL, not newline\n\n--help display this help and exit\n",
                    "flag": "-z",
                    "long": "--zero-terminated"
                },
                {
                    "name": "--version",
                    "content": "output version information and exit\n",
                    "long": "--version"
                }
            ]
        },
        "AUTHOR": {
            "content": "Written by Paul Eggert.\n",
            "subsections": []
        },
        "REPORTING BUGS": {
            "content": "GNU coreutils online help: <https://www.gnu.org/software/coreutils/>\nReport any translation bugs to <https://translationproject.org/team/>\n",
            "subsections": []
        },
        "COPYRIGHT": {
            "content": "Copyright  ©  2020 Free Software Foundation, Inc.  License GPLv3+: GNU GPL version 3 or later\n<https://gnu.org/licenses/gpl.html>.\nThis is free software: you are free to change and redistribute it.  There is NO WARRANTY,  to\nthe extent permitted by law.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "Full documentation <https://www.gnu.org/software/coreutils/shuf>\nor available locally via: info '(coreutils) shuf invocation'\n\n\n\nGNU coreutils 8.32                          January 2026                                     SHUF(1)",
            "subsections": []
        }
    },
    "summary": "shuf - generate random permutations",
    "flags": [
        {
            "flag": "-e",
            "long": "--echo",
            "arg": null,
            "description": "treat each ARG as an input line"
        },
        {
            "flag": "-i",
            "long": "--input-range",
            "arg": null,
            "description": "treat each number LO through HI as an input line"
        },
        {
            "flag": "-n",
            "long": "--head-count",
            "arg": null,
            "description": "output at most COUNT lines"
        },
        {
            "flag": "-o",
            "long": "--output",
            "arg": null,
            "description": "write result to FILE instead of standard output --random-source=FILE get random bytes from FILE"
        },
        {
            "flag": "-r",
            "long": "--repeat",
            "arg": null,
            "description": "output lines can be repeated"
        },
        {
            "flag": "-z",
            "long": "--zero-terminated",
            "arg": null,
            "description": "line delimiter is NUL, not newline --help display this help and exit"
        },
        {
            "flag": "",
            "long": "--version",
            "arg": null,
            "description": "output version information and exit"
        }
    ],
    "examples": [],
    "see_also": []
}