busybox/util-linux/chrt.c
<<
>>
Prefs
   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.7 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:       "-m | -p [PRIO] PID | [-rfobi] PRIO PROG ARGS"
  21//usage:#define chrt_full_usage "\n\n"
  22//usage:       "Change scheduling priority and class for a process\n"
  23//usage:     "\n        -m      Show min/max priorities"
  24//usage:     "\n        -p      Operate on PID"
  25//usage:     "\n        -r      Set SCHED_RR class"
  26//usage:     "\n        -f      Set SCHED_FIFO class"
  27//usage:     "\n        -o      Set SCHED_OTHER class"
  28//usage:     "\n        -b      Set SCHED_BATCH class"
  29//usage:     "\n        -i      Set SCHED_IDLE class"
  30//usage:
  31//usage:#define chrt_example_usage
  32//usage:       "$ chrt -r 4 sleep 900; x=$!\n"
  33//usage:       "$ chrt -f -p 3 $x\n"
  34//usage:       "You need CAP_SYS_NICE privileges to set scheduling attributes of a process"
  35
  36#include <sched.h>
  37#include "libbb.h"
  38#ifndef SCHED_IDLE
  39# define SCHED_IDLE 5
  40#endif
  41
  42//musl has no __MUSL__ or similar define to check for,
  43//but its <sys/types.h> has these lines:
  44// #define __NEED_fsblkcnt_t
  45// #define __NEED_fsfilcnt_t
  46#if defined(__linux__) && defined(__NEED_fsblkcnt_t) && defined(__NEED_fsfilcnt_t)
  47# define LIBC_IS_MUSL 1
  48# include <sys/syscall.h>
  49#else
  50# define LIBC_IS_MUSL 0
  51#endif
  52
  53static const char *policy_name(int pol)
  54{
  55        if (pol > 6)
  56                return utoa(pol);
  57        return nth_string(
  58                "OTHER"   "\0" /* 0:SCHED_OTHER */
  59                "FIFO"    "\0" /* 1:SCHED_FIFO */
  60                "RR"      "\0" /* 2:SCHED_RR */
  61                "BATCH"   "\0" /* 3:SCHED_BATCH */
  62                "ISO"     "\0" /* 4:SCHED_ISO */
  63                "IDLE"    "\0" /* 5:SCHED_IDLE */
  64                "DEADLINE",    /* 6:SCHED_DEADLINE */
  65                pol
  66        );
  67}
  68
  69static void show_min_max(int pol)
  70{
  71        const char *fmt = "SCHED_%s min/max priority\t: %u/%u\n";
  72        int max, min;
  73
  74        max = sched_get_priority_max(pol);
  75        min = sched_get_priority_min(pol);
  76        if ((max|min) < 0)
  77                fmt = "SCHED_%s not supported\n";
  78        printf(fmt, policy_name(pol), min, max);
  79}
  80
  81#define OPT_m (1<<0)
  82#define OPT_p (1<<1)
  83#define OPT_r (1<<2)
  84#define OPT_f (1<<3)
  85#define OPT_o (1<<4)
  86#define OPT_b (1<<5)
  87#define OPT_i (1<<6)
  88
  89int chrt_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
  90int chrt_main(int argc UNUSED_PARAM, char **argv)
  91{
  92        pid_t pid = 0;
  93        unsigned opt;
  94        struct sched_param sp;
  95        char *pid_str;
  96        char *priority = NULL;
  97        const char *current_new;
  98        int policy = SCHED_RR;
  99        int ret;
 100
 101        opt = getopt32(argv, "^"
 102                        "+" "mprfobi"
 103                        "\0"
 104                        /* only one policy accepted: */
 105                        "r--fobi:f--robi:o--rfbi:b--rfoi:i--rfob"
 106        );
 107        if (opt & OPT_m) { /* print min/max and exit */
 108                show_min_max(SCHED_OTHER);
 109                show_min_max(SCHED_FIFO);
 110                show_min_max(SCHED_RR);
 111                show_min_max(SCHED_BATCH);
 112                show_min_max(SCHED_IDLE);
 113                fflush_stdout_and_exit(EXIT_SUCCESS);
 114        }
 115        //if (opt & OPT_r)
 116        //      policy = SCHED_RR; - default, already set
 117        if (opt & OPT_f)
 118                policy = SCHED_FIFO;
 119        if (opt & OPT_o)
 120                policy = SCHED_OTHER;
 121        if (opt & OPT_b)
 122                policy = SCHED_BATCH;
 123        if (opt & OPT_i)
 124                policy = SCHED_IDLE;
 125
 126        argv += optind;
 127        if (!argv[0])
 128                bb_show_usage();
 129        if (opt & OPT_p) {
 130                pid_str = *argv++;
 131                if (*argv) { /* "-p PRIO PID [...]" */
 132                        priority = pid_str;
 133                        pid_str = *argv;
 134                }
 135                /* else "-p PID", and *argv == NULL */
 136                pid = xatoul_range(pid_str, 1, ((unsigned)(pid_t)ULONG_MAX) >> 1);
 137        } else {
 138                priority = *argv++;
 139                if (!*argv)
 140                        bb_show_usage();
 141        }
 142
 143        current_new = "current\0new";
 144        if (opt & OPT_p) {
 145                int pol;
 146 print_rt_info:
 147#if LIBC_IS_MUSL
 148                /* musl libc returns ENOSYS for its sched_getscheduler library
 149                 * function, because the sched_getscheduler Linux kernel system call
 150                 * does not conform to Posix; so we use the system call directly
 151                 */
 152                pol = syscall(SYS_sched_getscheduler, pid);
 153#else
 154                pol = sched_getscheduler(pid);
 155#endif
 156                if (pol < 0)
 157                        bb_perror_msg_and_die("can't %cet pid %u's policy", 'g', (int)pid);
 158#ifdef SCHED_RESET_ON_FORK
 159                /* "Since Linux 2.6.32, the SCHED_RESET_ON_FORK flag
 160                 * can be ORed in policy when calling sched_setscheduler().
 161                 * As a result of including this flag, children created by
 162                 * fork(2) do not inherit privileged scheduling policies"
 163                 *
 164                 * This bit is also returned by sched_getscheduler()!
 165                 * (TODO: do we want to show it?)
 166                 */
 167                pol &= ~SCHED_RESET_ON_FORK;
 168#endif
 169                printf("pid %u's %s scheduling policy: SCHED_%s\n",
 170                        pid, current_new, policy_name(pol)
 171                );
 172#if LIBC_IS_MUSL
 173                ret = syscall(SYS_sched_getparam, pid, &sp);
 174#else
 175                ret = sched_getparam(pid, &sp);
 176#endif
 177                if (ret)
 178                        bb_perror_msg_and_die("can't get pid %u's attributes", (int)pid);
 179                printf("pid %u's %s scheduling priority: %d\n",
 180                        (int)pid, current_new, sp.sched_priority
 181                );
 182                if (!*argv) {
 183                        /* Either it was just "-p PID",
 184                         * or it was "-p PRIO PID" and we came here
 185                         * for the second time (see goto below) */
 186                        return EXIT_SUCCESS;
 187                }
 188                *argv = NULL;
 189                current_new += 8;
 190        }
 191
 192        sp.sched_priority = xstrtou_range(priority, 0,
 193                sched_get_priority_min(policy), sched_get_priority_max(policy)
 194        );
 195
 196#if LIBC_IS_MUSL
 197        ret = syscall(SYS_sched_setscheduler, pid, policy, &sp);
 198#else
 199        ret = sched_setscheduler(pid, policy, &sp);
 200#endif
 201        if (ret)
 202                bb_perror_msg_and_die("can't %cet pid %u's policy", 's', (int)pid);
 203
 204        if (!argv[0]) /* "-p PRIO PID [...]" */
 205                goto print_rt_info;
 206
 207        BB_EXECVP_or_die(argv);
 208}
 209