{ "mode": "man", "parameter": "RENICE", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/RENICE/1/json", "generated": "2026-10-10T06:07:04Z", "synopsis": "renice [--priority|--relative] priority [-g|-p|-u] identifier...", "sections": { "NAME": { "content": "renice - alter priority of running processes\n", "subsections": [] }, "SYNOPSIS": { "content": "renice [--priority|--relative] 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\nIf no -n, --priority or --relative option is used, then the priority is set as absolute.\n", "subsections": [] }, "OPTIONS": { "content": "", "subsections": [ { "name": "-n _", "content": "Specify the absolute or relative (depending on environment variable POSIXLYCORRECT)\nscheduling priority to be used for the process, process group, or user. Use of the option\n-n is optional, but when used, it must be the first argument. See NOTES for more\ninformation.\n\n--priority priority\nSpecify an absolute scheduling priority. Priority is set to the given value. This is the\ndefault, when no option is specified.\n\n--relative priority\nSpecify a relative scheduling priority. Same as the standard POSIX -n option. Priority\ngets incremented/decremented by the given value.\n", "flag": "-n" }, { "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": "-h --help", "content": "Display help text and exit.\n", "flag": "-h", "long": "--help" }, { "name": "-V --version", "content": "Print version and exit.\n", "flag": "-V", "long": "--version" } ] }, "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\nFor historical reasons in this implementation, the -n option did not follow the POSIX\nspecification. Therefore, instead of setting a relative priority, it sets an absolute\npriority by default. As this may not be desirable, this behavior can be controlled by setting\nthe environment variable POSIXLYCORRECT to be fully POSIX compliant. See the -n option for\ndetails. See --relative and --priority for options that do not change behavior depending on\nenvironment variables.\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/util-linux/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 .\n\nutil-linux 2.39.3 2023-11-21 RENICE(1)", "subsections": [] } }, "summary": "renice - alter priority of running processes", "flags": [ { "flag": "-n", "long": null, "arg": null, "description": "Specify the absolute or relative (depending on environment variable POSIXLYCORRECT) scheduling priority to be used for the process, process group, or user. Use of the option -n is optional, but when used, it must be the first argument. See NOTES for more information. --priority priority Specify an absolute scheduling priority. Priority is set to the given value. This is the default, when no option is specified. --relative priority Specify a relative scheduling priority. Same as the standard POSIX -n option. Priority gets incremented/decremented by the given value." }, { "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": "-h", "long": "--help", "arg": null, "description": "Display help text and exit." }, { "flag": "-V", "long": "--version", "arg": null, "description": "Print version 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 {{process_id}}" }, { "description": "Increase/decrease the priority of all processes owned by a [u]ser", "command": "renice -n {{4}} -u {{user_id|username}}" }, { "description": "Increase/decrease the priority of all processes that belong to a process [g]roup", "command": "renice -n {{5}} -g {{process_group}}" } ] } }