{
    "mode": "man",
    "parameter": "renice",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/renice/1/json",
    "generated": "2026-06-16T10:01:45Z",
    "synopsis": "renice [-n] priority [-g|-p|-u] identifier...",
    "sections": {
        "NAME": {
            "content": "renice - alter priority of running processes\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "renice [-n] priority [-g|-p|-u] identifier...\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "renice alters the scheduling priority of one or more running processes. The first argument is\nthe priority value to be used. The other arguments are interpreted as process IDs (by\ndefault), process group IDs, user IDs, or user names. renice'ing a process group causes all\nprocesses in the process group to have their scheduling priority altered. renice'ing a user\ncauses all processes owned by the user to have their scheduling priority altered.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-n --priority",
                    "content": "Specify the scheduling priority to be used for the process, process group, or user. Use\nof the option -n or --priority is optional, but when used it must be the first argument.\n",
                    "flag": "-n",
                    "long": "--priority"
                },
                {
                    "name": "-g --pgrp",
                    "content": "Interpret the succeeding arguments as process group IDs.\n",
                    "flag": "-g",
                    "long": "--pgrp"
                },
                {
                    "name": "-p --pid",
                    "content": "Interpret the succeeding arguments as process IDs (the default).\n",
                    "flag": "-p",
                    "long": "--pid"
                },
                {
                    "name": "-u --user",
                    "content": "Interpret the succeeding arguments as usernames or UIDs.\n",
                    "flag": "-u",
                    "long": "--user"
                },
                {
                    "name": "-V --version",
                    "content": "Display version information and exit.\n",
                    "flag": "-V",
                    "long": "--version"
                },
                {
                    "name": "-h --help",
                    "content": "Display help text and exit.\n",
                    "flag": "-h",
                    "long": "--help"
                }
            ]
        },
        "FILES": {
            "content": "/etc/passwd\nto map user names to user IDs\n",
            "subsections": []
        },
        "NOTES": {
            "content": "Users other than the superuser may only alter the priority of processes they own.\nFurthermore, an unprivileged user can only increase the \"nice value\" (i.e., choose a lower\npriority) and such changes are irreversible unless (since Linux 2.6.12) the user has a\nsuitable \"nice\" resource limit (see ulimit(1p) and getrlimit(2)).\n\nThe superuser may alter the priority of any process and set the priority to any value in the\nrange -20 to 19. Useful priorities are: 19 (the affected processes will run only when nothing\nelse in the system wants to), 0 (the \"base\" scheduling priority), anything negative (to make\nthings go very fast).\n",
            "subsections": []
        },
        "HISTORY": {
            "content": "The renice command appeared in 4.0BSD.\n",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "The following command would change the priority of the processes with PIDs 987 and 32, plus\nall processes owned by the users daemon and root:\n",
            "subsections": [
                {
                    "name": "renice +1 987 -u daemon root -p 32",
                    "content": ""
                }
            ]
        },
        "SEE ALSO": {
            "content": "nice(1), chrt(1), getpriority(2), setpriority(2), credentials(7), sched(7)\n",
            "subsections": []
        },
        "REPORTING BUGS": {
            "content": "For bug reports, use the issue tracker at https://github.com/karelzak/util-linux/issues.\n",
            "subsections": []
        },
        "AVAILABILITY": {
            "content": "The renice command is part of the util-linux package which can be downloaded from Linux\nKernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.\n\n\n\nutil-linux 2.37.2                            2021-06-02                                    RENICE(1)",
            "subsections": []
        }
    },
    "summary": "renice - alter priority of running processes",
    "flags": [
        {
            "flag": "-n",
            "long": "--priority",
            "arg": null,
            "description": "Specify the scheduling priority to be used for the process, process group, or user. Use of the option -n or --priority is optional, but when used it must be the first argument."
        },
        {
            "flag": "-g",
            "long": "--pgrp",
            "arg": null,
            "description": "Interpret the succeeding arguments as process group IDs."
        },
        {
            "flag": "-p",
            "long": "--pid",
            "arg": null,
            "description": "Interpret the succeeding arguments as process IDs (the default)."
        },
        {
            "flag": "-u",
            "long": "--user",
            "arg": null,
            "description": "Interpret the succeeding arguments as usernames or UIDs."
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "Display version information and exit."
        },
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "Display help text and exit."
        }
    ],
    "examples": [
        "The following command would change the priority of the processes with PIDs 987 and 32, plus",
        "all processes owned by the users daemon and root:"
    ],
    "see_also": [
        {
            "name": "nice",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/nice/1/json"
        },
        {
            "name": "chrt",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/chrt/1/json"
        },
        {
            "name": "getpriority",
            "section": "2",
            "url": "https://www.chedong.com/phpMan.php/man/getpriority/2/json"
        },
        {
            "name": "setpriority",
            "section": "2",
            "url": "https://www.chedong.com/phpMan.php/man/setpriority/2/json"
        },
        {
            "name": "credentials",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/credentials/7/json"
        },
        {
            "name": "sched",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/sched/7/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Alter the scheduling priority/niceness of running processes.",
        "examples": [
            {
                "description": "Increase/decrease the priority of a running [p]rocess",
                "command": "renice -n {{3}} -p {{pid}}"
            },
            {
                "description": "Increase/decrease the priority of all processes owned by a [u]ser",
                "command": "renice -n {{4}} -u {{uid|user}}"
            },
            {
                "description": "Increase/decrease the priority of all processes that belong to a process [g]roup",
                "command": "renice -n {{5}} -g {{process_group}}"
            }
        ]
    }
}