--- title: Taskset date: 2023-04-07 14:25:44 background: bg-[#8bbb55] tags: - process - process manager categories: - Linux Command intro: The taskset command is used to set or retrieve the CPU affinity of a running process given its pid, or to launch a new command with a given CPU affinity. plugins: -copyCode --- Getting Started -------- ### Usage #1 The default behavior is to run a new command with a given affinity mask ```shell $ taskset [mask] [command] [arguments] ``` ### Usage #2 You can also retrieve the CPU affinity of an existing task: ```shell $ taskset -p [pid] ``` Or set it: ```shell $ taskset -p [mask] [pid] ``` ### Common Options | Command | Alternavite | Meaning | |---------|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------| | `-a` | --all-tasks | Set or retrieve the CPU affinity of all the task (threads) for a given PID. | | `-c` | --cpu-list | Interpret mask as numerical list of processors instead of a bitmask. Numbers are separated by commas and may include ranges. For example: 0,5,8-11. | | `-p` | --pid | Operate on an existing PID and do not launch a new task. | | `-h` | --help | Display help text and exit. | | `-v` | --version | Print version and exit. | {.show-header} Example -------- ### View CPU Affinity ```shell $ taskset -cp 29523 ``` Output: `pid 29523's current affinity list: 0-15` That mean process with PID `29523` is active on CPU range from `[0,1,...,15]` which means `16` total. **PID**: Process Identifier - is a unique numerical identifier given to each running process, you can view PID of processes in `top` or `htop` tools _If you run the above command but get the message `bad usage`, try with PID = 1_ ```shell $ taskset -cp 1 ``` ### Set CPU Affinity Now let's try to set process in to a specify CPU. For example, we have a process has PID = 14846 Let's see the CPU affinity list of this process first ```shell $ taskset -cp 14846 ``` Output: `pid 14846's current affinity list: 0-15` Change CPU affinity to 1 ```shell $ taskset -cp 1 14846 ``` Output: `pid 14846's current affinity list: 0-15` `pid 14846's new affinity list: 1` As we see, CPU affinity was changed ### Set CPU Affinity with muliple value ```shell $ taskset -cp 0-3 14846 ``` Output: `pid 14846's current affinity list: 1` `pid 14846's new affinity list: 0-3` **That mean new CPU affinity list is `[0,1,2,3]`** You can set single CPU with the following command: ```shell $ taskset -cp 5,8,12 14846 ``` Output: `pid 14846's current affinity list: 0-3` `pid 14846's new affinity list: 5,8,12` **That mean new CPU affinity list is `[5,8,12]`** ### Other You can set affinity by range with other like a specify CPU ```shell $ taskset -cp 1-3,12 14846 ``` Or ```shell $ taskset -cp 1-6:2 14846 ``` The suffix ":N" specifies stride in the range, for example 0-10:3 is interpreted as 0,3,6,9 list. Also see -------- [About taskset](https://man7.org/linux/man-pages/man1/taskset.1.html)