{
    "content": [
        {
            "type": "text",
            "text": "# SHUF(1) (man)\n\n**Summary:** shuf - generate random permutations\n\n**Synopsis:** shuf [OPTION]... [FILE]\nshuf -e [OPTION]... [ARG]...\nshuf -i LO-HI [OPTION]...\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -e | --echo | — | treat each ARG as an input line |\n| -i | --input-range | — | treat each number LO through HI as an input line |\n| -n | --head-count | — | output at most COUNT lines |\n| -o | --output | — | write result to FILE instead of standard output --random-source=FILE get random bytes from FILE |\n| -r | --repeat | — | output lines can be repeated |\n| -z | --zero-terminated | — | line delimiter is NUL, not newline --help display this help and exit |\n| — | --version | — | output version information and exit |\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (4 lines)\n- **DESCRIPTION** (6 lines) — 7 subsections\n  - -e --echo (2 lines)\n  - -i --input-range (2 lines)\n  - -n --head-count (2 lines)\n  - -o --output (5 lines)\n  - -r --repeat (2 lines)\n  - -z --zero-terminated (4 lines)\n  - --version (2 lines)\n- **AUTHOR** (2 lines)\n- **REPORTING BUGS** (3 lines)\n- **COPYRIGHT** (5 lines)\n- **SEE ALSO** (6 lines)\n\n## Full Content\n\n### NAME\n\nshuf - generate random permutations\n\n### SYNOPSIS\n\nshuf [OPTION]... [FILE]\nshuf -e [OPTION]... [ARG]...\nshuf -i LO-HI [OPTION]...\n\n### DESCRIPTION\n\nWrite 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\n#### -e --echo\n\ntreat each ARG as an input line\n\n#### -i --input-range\n\ntreat each number LO through HI as an input line\n\n#### -n --head-count\n\noutput at most COUNT lines\n\n#### -o --output\n\nwrite result to FILE instead of standard output\n\n--random-source=FILE\nget random bytes from FILE\n\n#### -r --repeat\n\noutput lines can be repeated\n\n#### -z --zero-terminated\n\nline delimiter is NUL, not newline\n\n--help display this help and exit\n\n#### --version\n\noutput version information and exit\n\n### AUTHOR\n\nWritten by Paul Eggert.\n\n### REPORTING BUGS\n\nGNU coreutils online help: <https://www.gnu.org/software/coreutils/>\nReport any translation bugs to <https://translationproject.org/team/>\n\n### COPYRIGHT\n\nCopyright  ©  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\n### SEE ALSO\n\nFull 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)\n\n"
        }
    ],
    "structuredContent": {
        "command": "SHUF",
        "section": "1",
        "mode": "man",
        "summary": "shuf - generate random permutations",
        "synopsis": "shuf [OPTION]... [FILE]\nshuf -e [OPTION]... [ARG]...\nshuf -i LO-HI [OPTION]...",
        "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": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 6,
                "subsections": [
                    {
                        "name": "-e --echo",
                        "lines": 2,
                        "flag": "-e",
                        "long": "--echo"
                    },
                    {
                        "name": "-i --input-range",
                        "lines": 2,
                        "flag": "-i",
                        "long": "--input-range"
                    },
                    {
                        "name": "-n --head-count",
                        "lines": 2,
                        "flag": "-n",
                        "long": "--head-count"
                    },
                    {
                        "name": "-o --output",
                        "lines": 5,
                        "flag": "-o",
                        "long": "--output"
                    },
                    {
                        "name": "-r --repeat",
                        "lines": 2,
                        "flag": "-r",
                        "long": "--repeat"
                    },
                    {
                        "name": "-z --zero-terminated",
                        "lines": 4,
                        "flag": "-z",
                        "long": "--zero-terminated"
                    },
                    {
                        "name": "--version",
                        "lines": 2,
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "REPORTING BUGS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 6,
                "subsections": []
            }
        ]
    }
}