1CPU-HOTPLUG() CPU-HOTPLUG()
2
6 General options
7 -h Show a short help message and exit.
8 -q Be quiet.
10 -d Print debugging information.
12 --version
14 Print version and exit.
15 -H HOSTNAME, --host HOSTNAME
17 Name of the host to run the command on.
18 -U USERNAME, --username USERNAME
20 Name of the user to use for logging into the remote host over
21 SSH. The default user name is 'root'.
22 -K PRIVKEY, --priv-key PRIVKEY
24 Path to the private SSH key that should be used for logging into
25 the remote host. By default the key is automatically found from
26 standard paths like '$HOME/.ssh'.
27 -T TIMEOUT, --timeout TIMEOUT
29 SSH connection timeout in seconds, default is 8.
30 -D DATASET, --dataset DATASET
32 This option is for debugging and testing purposes only, it de‐
33 fines the dataset that will be used to emulate a host for run‐
34 ning the command on. This option is typically used when running
35 'pepc' from the source directory, which includes datasets for
36 many different systems.
37 The argument can be the dataset path, 'all' to specify all
39 available dataset or name in which case the following locations
40 will be searched for.
41 1. './tests/data', in the directory of the running program
43 2. '$PEPC_DATA_PATH/tests/data'
45 3. '$HOME/.local/share/pepc/tests/data'
47 4. '/usr/local/share/pepc/tests/data'
49 5. '/usr/share/pepc/tests/data'
51 --force-color
53 Force coloring of the text output.
54 Subcommand 'info'
56 List all online and offline CPUs.
57 Subcommand 'online'
59 Bring CPUs online.
60 --cpus CPUS
62 List of CPUs to online. The list can include individual CPU
63 numbers and CPU number ranges. For example,'1-4,7,8,10-12'
64 would mean CPUs 1 to 4, CPUs 7, 8, and 10 to 12. Use the spe‐
65 cial keyword 'all' to specify all CPUs.
66 Subcommand 'offline'
68 Bring CPUs offline.
69 --cpus CPUS
71 List of CPUs to offline. The list can include individual CPU
72 numbers and CPU number ranges. For example,'1-4,7,8,10-12'
73 would mean CPUs 1 to 4, CPUs 7, 8, and 10 to 12. Use the spe‐
74 cial keyword 'all' to specify all CPUs.
75 --cores CORES
77 List of cores to offline. The list can include individual core
78 numbers and core number ranges. For example, '1-4,7,8,10-12'
79 would mean cores 1 to 4, cores 7, 8, and 10 to 12. Use the spe‐
80 cial keyword 'all' to specify all cores. This option has to be
81 accompanied by '--package' option, because core numbers are per-
82 package.
83 --packages PACKAGES
85 List of packages to offline. The list can include individual
86 package numbers and package number ranges. For example, '0,2-4'
87 would mean package 0 and packages 2 to 4. Use the special key‐
88 word 'all' to specify all packages.
89 --core-siblings CORE_SIBLINGS
91 List of core sibling indices to offline. The list can include
92 individual core sibling indices or index ranges. For example,
93 core x includes CPUs 3 and 4, '0' would mean CPU 3 and '1' would
94 mean CPU 4. This option can only be used to reference online
95 CPUs, because Linux does not provide topology information for
96 offline CPUs. In the previous example if CPU 3 was offline,
97 then '0' would mean CPU 4.
98 09-03-2023 CPU-HOTPLUG()