util-linux/chrt.c

   1 /* vi: set sw=4 ts=4: */
   2 /*
   3  * chrt - manipulate real-time attributes of a process
   4  * Copyright (c) 2006-2007 Bernhard Reutner-Fischer
   5  *
   6  * Licensed under GPLv2 or later, see file LICENSE in this source tree.
   7  */
   8 //config:config CHRT
   9 //config:       bool "chrt (4.4 kb)"
  10 //config:       default y
  11 //config:       help
  12 //config:       manipulate real-time attributes of a process.
  13 //config:       This requires sched_{g,s}etparam support in your libc.
  14
  15 //applet:IF_CHRT(APPLET_NOEXEC(chrt, chrt, BB_DIR_USR_BIN, BB_SUID_DROP, chrt))
  16
  17 //kbuild:lib-$(CONFIG_CHRT) += chrt.o
  18
  19 //usage:#define chrt_trivial_usage
  20 //usage:       "[-prfom] [PRIO] [PID | PROG ARGS]"
  21 //usage:#define chrt_full_usage "\n\n"
  22 //usage:       "Change scheduling priority and class for a process\n"
  23 //usage:     "\n        -p      Operate on PID"
  24 //usage:     "\n        -r      Set SCHED_RR class"
  25 //usage:     "\n        -f      Set SCHED_FIFO class"
  26 //usage:     "\n        -o      Set SCHED_OTHER class"
  27 //usage:     "\n        -m      Show min/max priorities"
  28 //usage:
  29 //usage:#define chrt_example_usage
  30 //usage:       "$ chrt -r 4 sleep 900; x=$!\n"
  31 //usage:       "$ chrt -f -p 3 $x\n"
  32 //usage:       "You need CAP_SYS_NICE privileges to set scheduling attributes of a process"
  33
  34 #include <sched.h>
  35 #include "libbb.h"
  36
  37 static const struct {
  38         int policy;
  39         char name[sizeof("SCHED_OTHER")];
  40 } policies[] = {
  41         {SCHED_OTHER, "SCHED_OTHER"},
  42         {SCHED_FIFO, "SCHED_FIFO"},
  43         {SCHED_RR, "SCHED_RR"}
  44 };
  45
  46 //TODO: add
  47 // -b, SCHED_BATCH
  48 // -i, SCHED_IDLE
  49
  50 static void show_min_max(int pol)
  51 {
  52         const char *fmt = "%s min/max priority\t: %u/%u\n";
  53         int max, min;
  54
  55         max = sched_get_priority_max(pol);
  56         min = sched_get_priority_min(pol);
  57         if ((max|min) < 0)
  58                 fmt = "%s not supported\n";
  59         printf(fmt, policies[pol].name, min, max);
  60 }
  61
  62 #define OPT_m (1<<0)
  63 #define OPT_p (1<<1)
  64 #define OPT_r (1<<2)
  65 #define OPT_f (1<<3)
  66 #define OPT_o (1<<4)
  67
  68 int chrt_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
  69 int chrt_main(int argc UNUSED_PARAM, char **argv)
  70 {
  71         pid_t pid = 0;
  72         unsigned opt;
  73         struct sched_param sp;
  74         char *pid_str;
  75         char *priority = priority; /* for compiler */
  76         const char *current_new;
  77         int policy = SCHED_RR;
  78
  79         /* only one policy accepted */
  80         opt = getopt32(argv, "^+" "mprfo" "\0" "r--fo:f--ro:o--rf");
  81         if (opt & OPT_m) { /* print min/max and exit */
  82                 show_min_max(SCHED_FIFO);
  83                 show_min_max(SCHED_RR);
  84                 show_min_max(SCHED_OTHER);
  85                 fflush_stdout_and_exit(EXIT_SUCCESS);
  86         }
  87         if (opt & OPT_r)
  88                 policy = SCHED_RR;
  89         if (opt & OPT_f)
  90                 policy = SCHED_FIFO;
  91         if (opt & OPT_o)
  92                 policy = SCHED_OTHER;
  93
  94         argv += optind;
  95         if (!argv[0])
  96                 bb_show_usage();
  97         if (opt & OPT_p) {
  98                 pid_str = *argv++;
  99                 if (*argv) { /* "-p <priority> <pid> [...]" */
 100                         priority = pid_str;
 101                         pid_str = *argv;
 102                 }
 103                 /* else "-p <pid>", and *argv == NULL */
 104                 pid = xatoul_range(pid_str, 1, ((unsigned)(pid_t)ULONG_MAX) >> 1);
 105         } else {
 106                 priority = *argv++;
 107                 if (!*argv)
 108                         bb_show_usage();
 109         }
 110
 111         current_new = "current\0new";
 112         if (opt & OPT_p) {
 113                 int pol;
 114  print_rt_info:
 115                 pol = sched_getscheduler(pid);
 116                 if (pol < 0)
 117                         bb_perror_msg_and_die("can't %cet pid %d's policy", 'g', (int)pid);
 118                 printf("pid %d's %s scheduling policy: %s\n",
 119                                 pid, current_new, policies[pol].name);
 120                 if (sched_getparam(pid, &sp))
 121                         bb_perror_msg_and_die("can't get pid %d's attributes", (int)pid);
 122                 printf("pid %d's %s scheduling priority: %d\n",
 123                                 (int)pid, current_new, sp.sched_priority);
 124                 if (!*argv) {
 125                         /* Either it was just "-p <pid>",
 126                          * or it was "-p <priority> <pid>" and we came here
 127                          * for the second time (see goto below) */
 128                         return EXIT_SUCCESS;
 129                 }
 130                 *argv = NULL;
 131                 current_new += 8;
 132         }
 133
 134         /* from the manpage of sched_getscheduler:
 135         [...] sched_priority can have a value in the range 0 to 99.
 136         [...] SCHED_OTHER or SCHED_BATCH must be assigned static priority 0.
 137         [...] SCHED_FIFO or SCHED_RR can have static priority in 1..99 range.
 138         */
 139         sp.sched_priority = xstrtou_range(priority, 0, policy != SCHED_OTHER ? 1 : 0, 99);
 140
 141         if (sched_setscheduler(pid, policy, &sp) < 0)
 142                 bb_perror_msg_and_die("can't %cet pid %d's policy", 's', (int)pid);
 143
 144         if (!argv[0]) /* "-p <priority> <pid> [...]" */
 145                 goto print_rt_info;
 146
 147         BB_EXECVP_or_die(argv);
 148 }