manual/util-linux/draft/man8/renice.8

   1 .\" Copyright (c) 1983, 1991, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)renice.8    8.1 (Berkeley) 6/9/93
  33 .\"
  34 .\" Japanese Version Copyright (c) 1998 Kanda Mitsuru
  35 .\"         all rights reserved.
  36 .\" Translated Nov 6 JST 1998
  37 .\"         by Kanda Mitsuru <kanda@@nn.iij4u.or.jp>
  38 .Dd June 9, 1993
  39 .Dt RENICE 8
  40 .Os BSD 4
  41 .\"O .Sh NAME
  42 .Sh Ì¾Á°
  43 .Nm renice
  44 .\"O .Nd alter priority of running processes
  45 .Nd ¼Â¹Ô¤·¤Æ¤¤¤ë¥×¥í¥»¥¹¤ÎÍ¥Àè½ç°Ì¤òÊÑ¹¹¤¹¤ë
  46 .\"O .Sh SYNOPSIS
  47 .Sh ½ñ¼°
  48 .Nm renice
  49 .Ar priority
  50 .Oo
  51 .Op Fl p
  52 .Ar pid ...
  53 .Oc
  54 .Oo
  55 .Op Fl g
  56 .Ar pgrp ...
  57 .Oc
  58 .Oo
  59 .Op Fl u
  60 .Ar user ...
  61 .Oc
  62 .\"O .Sh DESCRIPTION
  63 .Sh ÀâÌÀ
  64 .\"O .Nm Renice
  65 .\"O alters the
  66 .\"O scheduling priority of one or more running processes.
  67 .\"O The following
  68 .\"O .Ar who
  69 .\"O parameters are interpreted as process ID's, process group
  70 .\"O ID's, or user names.
  71 .\"O .Nm Renice Ns 'ing
  72 .\"O a process group causes all processes in the process group
  73 .\"O to have their scheduling priority altered.
  74 .\"O .Nm Renice Ns 'ing
  75 .\"O a user causes all processes owned by the user to have
  76 .\"O their scheduling priority altered.
  77 .\"O By default, the processes to be affected are specified by
  78 .\"O their process ID's.
  79 .Nm renice
  80 ¤ÏÆ°ºîÃæ¤Î¥×¥í¥»¥¹¤Î¥¹¥±¥¸¥å¡¼¥ê¥ó¥°Í¥Àè½ç°Ì¤òÊÑ¹¹¤¹¤ë
  81 (Ê£¿ô¤Î¥×¥í¥»¥¹¤òÆ±»þ¤ËÊÑ¹¹¤¹¤ë¤³¤È¤â¤Ç¤¤ë)¡£
  82 °Ê²¼¤Î
  83 .Ar who
  84 ¥Ñ¥é¥á¡¼¥¿¤Ï¡¢¥×¥í¥»¥¹ ID¡¢¥×¥í¥»¥¹¥°¥ë¡¼¥× ID¡¢¤â¤·¤¯¤Ï¥æ¡¼¥¶Ì¾¤È
  85 ¤·¤Æ²ò¼á¤µ¤ì¤ë¡£
  86 ¥×¥í¥»¥¹¥°¥ë¡¼¥×¤ò
  87 .Nm renice
  88 ¤¹¤ë¤È¡¢
  89 ¤½¤Î¥°¥ë¡¼¥×¤ËÂ°¤¹¤ëÁ´¤Æ¤Î¥×¥í¥»¥¹¤Î¥¹¥±¥¸¥å¡¼¥ê¥ó¥°Í¥Àè½ç°Ì¤¬ÊÑ¹¹¤µ¤ì¤ë¡£
  90 ¥æ¡¼¥¶Ì¾¤ËÂÐ¤¹¤ë
  91 .Nm renice
  92 ¤ò¹Ô¤¦¤È¡¢
  93 ¤½¤Î¥æ¡¼¥¶¤¬½êÍ¤·¤Æ¤¤¤ëÁ´¤Æ¤Î¥×¥í¥»¥¹¤Î¥¹¥±¥¸¥å¡¼¥ê¥ó¥°Í¥Àè½ç°Ì¤¬
  94 ÊÑ¹¹¤µ¤ì¤ë¡£
  95 ¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï¡¢¥×¥í¥»¥¹ ID ¤Ë¤è¤Ã¤Æ»ØÄê¤µ¤ì¤¿¥×¥í¥»¥¹¤¬½èÍýÂÐ¾Ý¤È¤Ê¤ë¡£
  96 .Pp
  97 .\"O Options supported by
  98 .Nm renice
  99 ¤Î¥µ¥Ý¡¼¥È¤¹¤ë¥ª¥×¥·¥ç¥ó¤Ï°Ê²¼¤ÎÄÌ¤ê:
 100 .Bl -tag -width Ds
 101 .It Fl g
 102 .\"O Force
 103 .\"O .Ar who
 104 .\"O parameters to be interpreted as process group ID's.
 105 ¶¯À©Åª¤Ë
 106 .Ar who
 107 ¥Ñ¥é¥á¡¼¥¿¤ò¥×¥í¥»¥¹¥°¥ë¡¼¥×¤Î ID ¤È¤·¤Æ²ò¼á¤¹¤ë¡£
 108 .It Fl u
 109 .\"O Force the
 110 .\"O .Ar who
 111 .\"O parameters to be interpreted as user names.
 112 ¶¯À©Åª¤Ë
 113 .Ar who
 114 ¥Ñ¥é¥á¡¼¥¿¤ò¥æ¡¼¥¶Ì¾¤È¤·¤Æ²ò¼á¤¹¤ë¡£
 115 .It Fl p
 116 .\"O Resets the
 117 .\"O .Ar who
 118 .\"O interpretation to be (the default) process ID's.
 119 .Ar who
 120 ¤¬¥×¥í¥»¥¹ ID ¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¤è¤¦¤Ë¥ê¥»¥Ã¥È¤¹¤ë
 121 (¤³¤ì¤Ï¥Ç¥Õ¥©¥ë¥È¤Î²ò¼á¤Ç¤¢¤ë)¡£
 122 .El
 123 .Pp
 124 .\"O For example,
 125 Îã¤¨¤Ð
 126 .Bd -literal -offset
 127 renice +1 987 -u daemon root -p 32
 128 .Ed
 129 .Pp
 130 .\"O would change the priority of process ID's 987 and 32, and
 131 .\"O all processes owned by users daemon and root.
 132 ¥×¥í¥»¥¹ ID 987 ¤È 32 ¤ÎÍ¥ÀèÅÙ¤È¡¢¥æ¡¼¥¶ daemon ¤È root ¤Ë¤è¤Ã¤Æ
 133 ½êÍ¤µ¤ì¤Æ¤¤¤ëÁ´¤Æ¤Î¥×¥í¥»¥¹¤ÎÍ¥ÀèÅÙ¤òÊÑ¹¹¤¹¤ë¡£
 134 .Pp
 135 .\"O Users other than the super-user may only alter the priority of
 136 .\"O processes they own,
 137 .\"O and can only monotonically increase their ``nice value''
 138 .\"O within the range 0 to
 139 .\"O .Dv PRIO_MAX
 140 ¥¹¡¼¥Ñ¡¼¥æ¡¼¥¶¤Ç¤Ê¤¤¥æ¡¼¥¶¤Ï¡¢
 141 ¼«Ê¬¤¬½êÍ¤·¤Æ¤¤¤ë¥×¥í¥»¥¹¤ÎÍ¥ÀèÅÙ¤·¤«ÊÑ¹¹¤Ç¤¤Ê¤¤¡£
 142 ¤Þ¤¿ ``nice ÃÍ'' ¤òÁý¤ä¤¹¤³¤È¤·¤«¤Ç¤¤Ê¤¤¡£
 143 Áý¤ä¤»¤ëÃÍ¤Ï 0 ¤«¤é
 144 .Dv PRIO_MAX
 145 (20)
 146 ¤Þ¤Ç¤ÎÈÏ°Ï¤Ç¤¢¤ë¡£
 147 .\"O (This prevents overriding administrative fiats.)
 148 .\"O The super-user
 149 .\"O may alter the priority of any process
 150 .\"O and set the priority to any value in the range
 151 .\"O .Dv PRIO_MIN
 152 .\"O (\-20)
 153 .\"O to
 154 .\"O .Dv PRIO_MAX .
 155 (¤³¤ì¤ÏºÇ½ÅÍ×¤Ê¥·¥¹¥Æ¥à´ÉÍýÌ¿Îá¤òË¸¤²¤Ê¤¤¤¿¤á¤Ç¤¢¤ë)
 156 ¥¹¡¼¥Ñ¡¼¥æ¡¼¥¶¤Ï¤¢¤é¤æ¤ë¥×¥í¥»¥¹¤ÎÍ¥ÀèÅÙ¤òÊÑ¹¹¤Ç¤¡¢
 157 .Dv PRIO_MIN
 158 (\-20)
 159 ¤«¤é
 160 .Dv PRIO_MAX
 161 ¤ÎÈÏ°Ï¤ÇÍ¥ÀèÅÙ¤ÎÃÍ¤òÊÑ¹¹¤Ç¤¤ë¡£
 162 .\"O Useful priorities are:
 163 .\"O 20 (the affected processes will run only when nothing else
 164 .\"O in the system wants to),
 165 .\"O 0 (the ``base'' scheduling priority),
 166 .\"O anything negative (to make things go very fast).
 167 ÊØÍø¤ÊÍ¥ÀèÅÙ¤Ï:
 168 20 (±Æ¶Á¤µ¤ì¤¿¥×¥í¥»¥¹¤Ï¡¢¥·¥¹¥Æ¥à¤Ë¼Â¹Ô¤¹¤ë¤â¤Î¤¬¤Ê¤¤¾ì¹ç¤À¤±¼Â¹Ô¤µ¤ì¤ë)
 169 0 (``´ðËÜ'' ¤Î¥¹¥±¥¸¥å¡¼¥ê¥ó¥°Í¥ÀèÅÙ)¡¢
 170 Éé¤ÎÃÍ (¤È¤Æ¤âÁá¤¯¼Â¹Ô¤µ¤ì¤ë)
 171 .\"O .Sh FILES
 172 .Sh ¥Õ¥¡¥¤¥ë
 173 .Bl -tag -width /etc/passwd -compact
 174 .It Pa /etc/passwd
 175 .\"O to map user names to user ID's
 176 ¥æ¡¼¥¶Ì¾¤È¥æ¡¼¥¶ID¤ÎÂÐ±þ¤ò¼è¤ë¡£
 177 .El
 178 .\"O .Sh SEE ALSO
 179 .Sh ´ØÏ¢¹àÌÜ
 180 .Xr getpriority 2 ,
 181 .Xr setpriority 2
 182 .\"O .Sh BUGS
 183 .Sh ¥Ð¥°
 184 .\"O Non super-users can not increase scheduling priorities of their own processes,
 185 .\"O even if they were the ones that decreased the priorities in the first place.
 186 ¥¹¡¼¥Ñ¥æ¡¼¥¶¤Ç¤Ê¤¤¥æ¡¼¥¶¤Ï¡¢°ìÅÙ¥¹¥±¥¸¥å¡¼¥ê¥ó¥°Í¥ÀèÅÙ¤ò
 187 ¸º¤é¤µ¤ì¤¿¥×¥í¥»¥¹¤Ë´Ø¤·¤Æ¤â¡¢¤³¤ì¤òÁý¤ä¤¹¤³¤È¤Ï¤Ç¤¤Ê¤¤¡£
 188 .br
 189 .\"O The Linux kernel (at least version 2.0.0) and linux libc (at least
 190 .\"O version 5.2.18) does not agree entierly on what the specifics of the
 191 .\"O systemcall interface to set nice values is.  Thus causes renice to
 192 .\"O report bogus previous nice values.
 193 linux ¥«¡¼¥Í¥ë (¸½ºß 2.0.0) ¤È linux libc (¸½ºß 5.2.18) ¤È¤Ç¤Ï¡¢
 194 nice ÃÍ¤òÀßÄê¤¹¤ë¥·¥¹¥Æ¥à¥³¡¼¥ë¤Î¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤¬´°Á´¤ËÆ±¤¸¤Ç¤Ê¤¤¡£
 195 ¤·¤¿¤¬¤Ã¤Æ renice ¤Ï ÊÑ¹¹Á°¤Î nice ÃÍ¤È¤·¤ÆÀµ¤·¤¤ÃÍ¤òÊÖ¤µ¤Ê¤¤¤³¤È¤¬¤¢¤ë¡£
 196 .\"O .Sh HISTORY
 197 .Sh ÍúÎò
 198 .\"O The
 199 .\"O .Nm
 200 .\"O command appeared in
 201 .Nm renice
 202 ¤Ï
 203 .Bx 4.0
 204 ¤«¤éÅÐ¾ì¤·¤¿¡£