table of contents
CSET(1) | CSET(1) |
NAME¶
cset - manage cpusets functions in the Linux kernel
SYNOPSIS¶
cset [--version | --help | --tohex] cset [help <command> | <command> --help] cset [cset options] <command> [command options] [args]
DESCRIPTION¶
Note
In general, you need to have root permissions to run cset. The tool mounts the cpusets filesystem and manipulates it. Non-root users do not have permission for these actions.
Cset is a Python application to make using the cpusets facilities in the Linux kernel easier. The actual included command is called cset and it allows manipulation of cpusets on the system and provides higher level functions such as implementation and control of a basic cpu shielding setup.
Typical uses of cset include¶
Setting up and managing a simple shielded CPU environment
For a simple shielded configuration, one typically uses three cpusets: the root set, a system set and a user set. Cset includes a super command that implements this strategy and lets you easily manage it. See cset-shield(1) for more details.
Setting up and managing a complex shielding environment
Managing cpusets on the system
Managing processes that run on various system cpusets
OPTIONS¶
The following generic option flags are available. Additional options are available per-command, and documented in the command-specific documentation.
cset --version
cset --help
cset --log <filename>
cset --machine
cset --tohex <CPUSPEC>
CSET COMMANDS¶
The cset commands are divided into groups, according to the primary purpose of those commands. Following is a short description of each command. A more detailed description is available in individual command manpages. Those manpages are named cset-<command>(1). The first command, help, is especially useful as it prints out a long summary of what a particular command does.
cset help command
cset command --help
cset shield
cset set
cset proc
PERSISTENT CPUSETS¶
To create a persistent cpuset setup, i.e. one that survives a reboot, you need to create the file /etc/init.d/cset. This distribution of cset includes an example cset init.d file found in /usr/share/doc/pacakges/cpuset which is called cset.init.d. You will need to alter the file to your specifications and copy it to be the file /etc/init.d/cset. See the comments in that file for more details.
FILES¶
If used, the init.d script /etc/init.d/cset starts and stops a cpuset configuration on boot and poweroff.
Cpuset uses a configuration file if present on the system. The file is /etc/cset.conf and may contain the following options.
mountpoint = <directory_name>
LICENSE¶
Cpuset is licensed under the GNU GPL V2 only.
COPYRIGHT¶
Copyright (c) 2008-2011 Novell Inc.
AUTHOR¶
Written by Alex Tsariounov <tsariounov@gmail.com>
Some substrate code and ideas were taken from the excellent Stacked GIT (stgit) v0.13 (see http://gna.org/projects/stgit and http://www.procode.org/stgit). Stacked GIT is under GPL V2 or later.
SEE ALSO¶
cset-set(1), cset-proc(1), cset-shield(1)
/usr/share/doc/packages/cpuset/html/tutorial.html
/usr/share/doc/packages/cpuset/cset.init.d
/usr/src/linux/Documentation/cpusets.txt
AUTHOR¶
Alex Tsariounov <tsariounov@gmail.com>
March 2016 | 1.5.8 |