---
name: "cpuctl"
section: "8"
platform: "macos"
package: "system_cmds"
version: "1042.120.1"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/cpuctl"
---

# cpuctl(8)

program to control CPUs

## NAME

**cpuctl** – program to control CPUs

## SYNOPSIS

**cpuctl** *command* \[*arguments*\]

## DESCRIPTION

The **cpuctl** command can be used to control and inspect the state of CPUs in the system.

The first argument, *command*, specifies the action to take. Valid commands are:

- list

  For each CPU in the system, display the current state and time of the last state change.

- offline *cpu* \[*cpu* *...*\]

  Set the specified CPUs off line.

  At least one CPU in the system must remain on line.

- online *cpu* \[*cpu* *...*\]

  Set the specified CPUs on line.

## EXAMPLES

Run

```
cpuctl offline 2
```

and then

```
cpuctl list
```

The output should reflect the fact that CPU#2 was taken offline.