Return to renice.8 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / renice

Annotation of 43BSDReno/usr.bin/renice/renice.8, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"    @(#)renice.8    6.4 (Berkeley) 6/24/90
                     19: .\"
                     20: .UC 7
                     21: .TH RENICE 8 "June 24, 1990"
                     22: .UC 4
                     23: .SH NAME
                     24: renice \- alter priority of running processes
                     25: .SH SYNOPSIS
                     26: .B renice
                     27: priority [ [
                     28: .B \-p
                     29: ] pid ... ] [ [
                     30: .B \-g
                     31: ] pgrp ... ] [ [
                     32: .B \-u
                     33: ] user ... ]
                     34: .SH DESCRIPTION
                     35: .I Renice
                     36: alters the 
                     37: scheduling priority of one or more running processes.
                     38: The
                     39: .I who
                     40: parameters are interpreted as process ID's, process group
                     41: ID's, or user names.
                     42: .IR Renice 'ing
                     43: a process group causes all processes in the process group
                     44: to have their scheduling priority altered.  
                     45: .IR Renice 'ing
                     46: a user causes all processes owned by the user to have
                     47: their scheduling priority altered.
                     48: By default, the processes to be affected are specified by
                     49: their process ID's.  To force 
                     50: .I who
                     51: parameters to be interpreted as process group ID's, a
                     52: .B \-g 
                     53: may be specified.  To force the
                     54: .I who
                     55: parameters to be interpreted as user names, a
                     56: .B \-u
                     57: may be given.  Supplying
                     58: .B \-p
                     59: will reset 
                     60: .I who
                     61: interpretation to be (the default) process ID's.
                     62: For example,
                     63: .sp
                     64:        renice +1 987 -u daemon root -p 32 
                     65: .sp
                     66: would change the priority of process ID's 987 and 32, and
                     67: all processes owned by users daemon and root.
                     68: .PP
                     69: Users other than the super-user may only alter the priority of
                     70: processes they own,
                     71: and can only monotonically increase their ``nice value''
                     72: within the range 0 to PRIO_MAX (20).
                     73: (This prevents overriding administrative fiats.)
                     74: The super-user
                     75: may alter the priority of any process
                     76: and set the priority to any value in the range PRIO_MIN (\-20)
                     77: to PRIO_MAX.
                     78: Useful priorities are:
                     79: 20 (the affected processes will run only when nothing else
                     80: in the system wants to),
                     81: 0 (the ``base'' scheduling priority),
                     82: anything negative (to make things go very fast).
                     83: .SH FILES
                     84: /etc/passwd    to map user names to user ID's
                     85: .SH SEE ALSO
                     86: getpriority(2), setpriority(2)
                     87: .SH BUGS
                     88: Non super-users can not increase scheduling priorities of their own processes,
                     89: even if they were the ones that decreased the priorities in the first place.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.