Compare commits
No commits in common. 'master' and 'wiki' have entirely different histories.
@ -1,5 +0,0 @@
|
||||
set nocompatible
|
||||
set hlsearch
|
||||
set ai
|
||||
set sw=4
|
||||
set expandtab
|
@ -1,18 +0,0 @@
|
||||
Lead:
|
||||
|
||||
Alex Tsariounov <tsariounov@gmail.com>
|
||||
http://www.novell.com
|
||||
|
||||
Credits (in alphabetical order):
|
||||
|
||||
Thomas Grohmann <Thomas.Grohmann@gmx.net>
|
||||
- Bug#26.
|
||||
|
||||
Christopher Johnston <chjohnst@gmail.com>
|
||||
- Fix for case-sensitive set search (issue#1)
|
||||
|
||||
Mostroski
|
||||
- Fix for issue#2
|
||||
|
||||
Alex Piavka <piavka@cs.bgu.ac.il>
|
||||
- Gentoo ebuild script.
|
@ -0,0 +1,8 @@
|
||||
# Linux Man Pages #
|
||||
|
||||
Add your content here.
|
||||
|
||||
|
||||
# In-Depth Tutorial #
|
||||
|
||||
Add your content here.
|
@ -1,31 +0,0 @@
|
||||
Building Cpuset from Source
|
||||
===========================
|
||||
This is a distutils-based package and as such, it contains
|
||||
a number of differnet installation methods. By far the most
|
||||
convenient is to create an rpm. This rpm can then be later
|
||||
updated or removed by the rpm packaging utility (rpm).
|
||||
|
||||
To create an rpm, use the following command:
|
||||
|
||||
python setup.py bdist_rpm
|
||||
|
||||
For basic installation:
|
||||
|
||||
python setup.py install
|
||||
|
||||
By default, the above command installs cpuset in the
|
||||
/usr/local/{bin,lib,share} directories. For a different location,
|
||||
use the --prefix option:
|
||||
|
||||
python setup.py install --prefix=/usr
|
||||
|
||||
For more information:
|
||||
|
||||
http://docs.python.org/inst/inst.html
|
||||
|
||||
Prebuild Binary Packages
|
||||
========================
|
||||
Alternatively, you may download pre-built binary packages for multiple
|
||||
distributions from the Open Build Service here:
|
||||
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset
|
@ -1,43 +0,0 @@
|
||||
AUTHORS
|
||||
COPYING
|
||||
INSTALL
|
||||
MANIFEST
|
||||
MANIFEST.in
|
||||
Makefile
|
||||
NEWS
|
||||
README
|
||||
cset
|
||||
cset.init.d
|
||||
setup.cfg
|
||||
setup.py
|
||||
cpuset/__init__.py
|
||||
cpuset/config.py
|
||||
cpuset/cset.py
|
||||
cpuset/main.py
|
||||
cpuset/util.py
|
||||
cpuset/version.py
|
||||
cpuset/commands/__init__.py
|
||||
cpuset/commands/common.py
|
||||
cpuset/commands/mem.py
|
||||
cpuset/commands/proc.py
|
||||
cpuset/commands/set.py
|
||||
cpuset/commands/shield.py
|
||||
doc/Makefile
|
||||
doc/asciidoc.conf
|
||||
doc/callouts.xsl
|
||||
doc/cset-proc.1
|
||||
doc/cset-proc.html
|
||||
doc/cset-proc.txt
|
||||
doc/cset-set.1
|
||||
doc/cset-set.html
|
||||
doc/cset-set.txt
|
||||
doc/cset-shield.1
|
||||
doc/cset-shield.html
|
||||
doc/cset-shield.txt
|
||||
doc/cset.1
|
||||
doc/cset.html
|
||||
doc/cset.txt
|
||||
doc/tutorial.conf
|
||||
doc/tutorial.html
|
||||
doc/tutorial.txt
|
||||
t/README
|
@ -1,3 +0,0 @@
|
||||
include README Makefile MANIFEST MANIFEST.in AUTHORS COPYING INSTALL NEWS ChangeLog cset.init.d
|
||||
include t/README
|
||||
include doc/*.txt doc/Makefile doc/*.conf doc/callouts.xsl doc/*.1 doc/*.html
|
@ -1,41 +0,0 @@
|
||||
PREFIX ?= $(HOME)
|
||||
DESTDIR ?= /
|
||||
PYTHON ?= python
|
||||
|
||||
all:
|
||||
$(PYTHON) setup.py build
|
||||
|
||||
rpm:
|
||||
$(PYTHON) setup.py bdist_rpm
|
||||
|
||||
srcrpm:
|
||||
$(PYTHON) setup.py bdist_rpm
|
||||
|
||||
srcdist:
|
||||
$(PYTHON) setup.py sdist
|
||||
|
||||
install:
|
||||
$(PYTHON) setup.py install --prefix=$(PREFIX) --root=$(DESTDIR)
|
||||
|
||||
test:
|
||||
cd t && $(MAKE) all
|
||||
|
||||
doc:
|
||||
cd doc && $(MAKE) all
|
||||
|
||||
clean:
|
||||
for dir in doc t; do \
|
||||
(cd $$dir && $(MAKE) clean); \
|
||||
done
|
||||
rm -rf build
|
||||
rm -f cpuset/*.pyc
|
||||
rm -f cpuset/commands/*.pyc
|
||||
rm -f TAGS
|
||||
|
||||
clobber: clean
|
||||
rm -rf dist
|
||||
|
||||
tags:
|
||||
ctags -e -R cpuset/*
|
||||
|
||||
.PHONY: all install doc test clean
|
@ -1,182 +0,0 @@
|
||||
============================================================
|
||||
Cpuset 1.6pre1 (February 8, 2018)
|
||||
https://github.com/lpechacek/cpuset
|
||||
http://download.opensuse.org/repositories/home:/LPechacek:/cpuset-release/
|
||||
|
||||
Update to 1.6pre1 includes following changes:
|
||||
|
||||
* Make cpuset compatible with both Python 2 and 3
|
||||
* Update package meta information
|
||||
|
||||
============================================================
|
||||
Cpuset 1.5.8 (March 7, 2016)
|
||||
https://github.com/lpechacek/cpuset
|
||||
http://download.opensuse.org/repositories/home:/LPechacek:/cpuset-release/
|
||||
|
||||
Maintenance update to 1.5.8 includes following fixes:
|
||||
|
||||
* Fix version string at multiple places
|
||||
|
||||
============================================================
|
||||
Cpuset 1.5.7 (January 13, 2016)
|
||||
https://github.com/lpechacek/cpuset
|
||||
http://download.opensuse.org/repositories/home:/LPechacek:/cpuset-release/
|
||||
|
||||
Maintenance update to 1.5.7 includes following fixes:
|
||||
|
||||
* Adapt to cpuset cgroup controller mount type.
|
||||
* Handle both new and unknown priority policy codes gracefully.
|
||||
* Deal with process names containing whitespace.
|
||||
* URLs updated after project repository migration.
|
||||
* Various typo fixes.
|
||||
|
||||
============================================================
|
||||
Cpuset 1.5.6 (June 9, 2011)
|
||||
http://code.google.com/p/cpuset
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Maintenance update to 1.5.5 includes fixes as follows.
|
||||
|
||||
* Fix for Issue#5: LOGNAME environment variable set incorrectly...
|
||||
Set LOGNAME and USERNAME env variables when execing new process
|
||||
to match --user option, if given.
|
||||
|
||||
============================================================
|
||||
Cpuset 1.5.5 (August 3, 2010)
|
||||
http://code.google.com/p/cpuset
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Maintenance update to 1.5.4 includes fixes as follows.
|
||||
|
||||
* Fix for Issue#3: cset fails to create cpu sets if some cpus are offline
|
||||
Problem in cset.rescan() for maxcpu if root cpuset cpus are complex
|
||||
pattern due to offlining cpus.
|
||||
|
||||
============================================================
|
||||
Cpuset 1.5.4 (May 7, 2010)
|
||||
http://code.google.com/p/cpuset
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Maintenace update to 1.5.3 includes fixes as follows.
|
||||
|
||||
* Fix for Issue#2: Apply patch by mostroski to avoid exception
|
||||
if running tasks with non-existent uids
|
||||
|
||||
============================================================
|
||||
Cpuset 1.5.3 (February 11, 2010)
|
||||
http://code.google.com/p/cpuset
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Maintenace update to 1.5.2 includes fixes as follows.
|
||||
|
||||
* Code repository and project hosting to Google Code Hosting.
|
||||
* Apply patch submitted by Christopher Johnston to fix failure of
|
||||
finding cpusets in a case-sensitive manner.
|
||||
|
||||
============================================================
|
||||
Cpuset 1.5.2 (December 2, 2009)
|
||||
https://forgesvn1.novell.com/viewsvn/cpuset/tags/rel_1.5.2/
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Maintenance update to 1.5.1 includes bug fixes as follows.
|
||||
|
||||
Fixed Bugs:
|
||||
* BNC#558395 - cset couldn't delete cpu set
|
||||
* BNC#558399 - cset unable to move thread
|
||||
|
||||
Other fixes:
|
||||
* Fixed failure to delete cpuset if tasks preset, cset now
|
||||
waits a little bit for tardy tasks to disappear
|
||||
* Removed output noise from popened taskset command
|
||||
* Added example init.d cset script in documentation directory
|
||||
|
||||
============================================================
|
||||
|
||||
Cpuset 1.5.1 (June 17, 2009)
|
||||
https://forgesvn1.novell.com/viewsvn/cpuset/tags/rel_1.5.1/
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Maintenance update to 1.5.0 includes bug fixes as follows.
|
||||
|
||||
Fixed Bugs:
|
||||
* Fix bug #26: Cpuset does not function on machines with greater than 16 CPUs
|
||||
|
||||
============================================================
|
||||
|
||||
Cpuset 1.5.0 (February 7, 2009)
|
||||
https://forgesvn1.novell.com/viewsvn/cpuset/tags/rel_1.5.0/
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Major upgrade since 1.04. This release includes a number of bug fixes and
|
||||
enhancements as outlined below. The release number also has transitioned to a
|
||||
three-digit number. This release has many usability enhancements from the
|
||||
past months experience. It also includes a lengthy tutorial to introduce
|
||||
users to the tool.
|
||||
|
||||
The bug numbers refer to cpuset's bugzilla instance which can be found
|
||||
here: http://devzilla.novell.com/cpuset
|
||||
|
||||
Fixed Bugs:
|
||||
* Fix bug #1: Origination cpuset not accepted for process move...
|
||||
* Fix bug #2: Proc move from set to set does not recognize...
|
||||
* Fix bug #3: Interspersed arguments do not work
|
||||
* Fix bug #4: Add policy and priority to proc output list
|
||||
* Fix bug #5: Add ability to move all threads in a process container wi.
|
||||
* Fix bug #6: The -a option for set listing should be the default
|
||||
* Fix bug #7: Add destination cpuset for the proc move command
|
||||
* Fix bug #8: Let leading slash for nested cpuset spec be optional
|
||||
* Fix bug #9: Rearrange info output some, include machine readable output
|
||||
* Fix bug #10: Add a recursive cpuset delete with option
|
||||
* Fix bug #11: Add a configuration file
|
||||
* Fix bug #12: Add hex mask output for cpuset definition spec (cpuspec)
|
||||
* Fix bug #13: Add cpuset rename option to set command
|
||||
* Fix bug #21: Create shield shortcuts
|
||||
|
||||
Other fixes:
|
||||
* Changed behavior of shield command, now it behaves more like the proc move
|
||||
command: -s or -u needs a -p to shield or unshield, however, the shortcut of
|
||||
shield pidspec still works.
|
||||
* Fixed exception when using cset with pipes
|
||||
* Fixed set list behavior if --set was specified but not --list
|
||||
* Added error message if proc list command does not specify a set
|
||||
* Fixed exception if proc is used with -l and -s
|
||||
* Location for cpuset filesystem mount can be specified in config file
|
||||
* Changed proc option -a/--all to --force only
|
||||
* Updated copyrights, URLs and documentation
|
||||
* Added spec file to svn which is used in build service
|
||||
* Cleaned up status output for clarity and consistency
|
||||
* Additional minor corner case bug fixes included
|
||||
|
||||
============================================================
|
||||
|
||||
Cpuset 1.04 (September 2, 2008)
|
||||
https://forgesvn1.novell.com/viewsvn/cpuset/tags/rel_1.04/
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Minor bug fixes and inclusion in SLERT10SP2 and slotted for SLES11.
|
||||
|
||||
============================================================
|
||||
|
||||
Cpuset 1.03 (July 18, 2008)
|
||||
https://forgesvn1.novell.com/viewsvn/cpuset/tags/rel_1.03/
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Fixed class variables that made import of cset.as python library possible.
|
||||
|
||||
============================================================
|
||||
|
||||
Cpuset 1.02 (June 10, 2008)
|
||||
https://forgesvn1.novell.com/viewsvn/cpuset/tags/rel_1.02/
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
Minor fixes.
|
||||
|
||||
============================================================
|
||||
|
||||
Cpuset 1.0 (May 30, 2008)
|
||||
https://forgesvn1.novell.com/viewsvn/cpuset/tags/rel_1.0/
|
||||
http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/
|
||||
|
||||
First full-featured public release complete with man pages and html docs.
|
||||
|
||||
============================================================
|
@ -0,0 +1,19 @@
|
||||
Cpuset 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.
|
||||
|
||||
The latest version is: **1.5.6** And the associated [NEWS file is here.](http://code.google.com/p/cpuset/source/browse/NEWS?r=rel_1.5.6)
|
||||
|
||||
Cpuset comes with man pages and a tutorial. You can also read [the tutorial on the RT Linux Wiki here.](https://rt.wiki.kernel.org/index.php/Cpuset_management_utility/tutorial)
|
||||
|
||||
Binary packages for the latest release are available on my [cpuset project at the openSUSE Build Service.](http://download.opensuse.org/repositories/home:/tsariounov:/cpuset/) This site hosts packages that can be used in many distributions including: openSUSE, Fedora, SLES, RHEL, CentOS, Mandriva.
|
||||
|
||||
Also, [this Gentoo ebuild script for 1.5.5](http://cpuset.googlecode.com/files/cpuset-1.5.5.ebuild) has been contributed by Joerg Neikes.
|
||||
|
||||
If building from source, cset uses the python distutils to manage installation. It is recommended to create an rpm rather than using the install command since it is far easier to remove and upgrade with rpm. To create an rpm, use the following command:
|
||||
```
|
||||
$ python setup.py bdist_rpm
|
||||
```
|
||||
|
||||
To build a source distribution tarball from the source, use this command:
|
||||
```
|
||||
$ python setup.py sdist
|
||||
```
|
@ -1,34 +0,0 @@
|
||||
Cpuset is a Python application that forms a wrapper around the
|
||||
standard Linux filesystem calls to make using the cpusets facilities
|
||||
in the Linux kernel easier.
|
||||
|
||||
For the latest version see:
|
||||
https://github.com/lpechacek/cpuset
|
||||
|
||||
For packages, see the OpenSUSE build service:
|
||||
https://build.opensuse.org/package/show/hardware/cpuset
|
||||
http://download.opensuse.org/repositories/hardware/
|
||||
|
||||
Bugs or feature requests should be sent to:
|
||||
https://github.com/lpechacek/cpuset/issues
|
||||
or for supported products, SUSE Bugzilla at:
|
||||
https://bugzilla.suse.com
|
||||
|
||||
-----
|
||||
|
||||
Copyright (C) 2008-2011 Novell Inc.
|
||||
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
@ -1,82 +0,0 @@
|
||||
#
|
||||
# Spec file for package cpuset
|
||||
#
|
||||
# Copyright (c) 2008-2010 Novell, Inc. Waltham, MA, USA
|
||||
# This file and all modifications and additions to the pristine
|
||||
# package are under the same license as the package itself.
|
||||
#
|
||||
# Please submit bugfixes or comments via
|
||||
# https://github.com/lpechacek/cpuset/issues
|
||||
# Or
|
||||
# https://bugzilla.opensuse.org
|
||||
#
|
||||
# For supported products, via https://bugzilla.suse.com
|
||||
#
|
||||
|
||||
# norootforbuild
|
||||
|
||||
Name: cpuset
|
||||
Version: 1.6pre1
|
||||
Release: 1
|
||||
License: GPL-2.0
|
||||
BuildRoot: %{_tmppath}/%{name}-%{version}-build
|
||||
Url: https://github.com/lpechacek/cpuset
|
||||
Group: System/Management
|
||||
Summary: Allows manipulation of cpusets on system and provides higher level functions
|
||||
Source: %{name}-%{version}.tar.gz
|
||||
BuildRequires: python-devel
|
||||
|
||||
%if 0%{?suse_version} > 0
|
||||
%py_requires
|
||||
%endif
|
||||
|
||||
%{!?python_sitelib: %define python_sitelib %(python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()")}
|
||||
|
||||
%description
|
||||
|
||||
Cpuset 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.
|
||||
|
||||
%prep
|
||||
%setup
|
||||
|
||||
|
||||
%build
|
||||
CFLAGS="%{optflags}" \
|
||||
%{__python} setup.py build
|
||||
#make doc ->not yet, asciidoc is missing...
|
||||
|
||||
|
||||
%install
|
||||
# Install binaries, but do not install docs via setup.py
|
||||
%{__python} setup.py install --root=%{buildroot} --prefix=%{_prefix} --install-data=/eraseme
|
||||
%{__rm} -rf %{buildroot}/eraseme
|
||||
|
||||
# Install documentation
|
||||
%{__mkdir_p} %{buildroot}/%{_defaultdocdir}/cpuset
|
||||
%{__cp} NEWS README INSTALL AUTHORS COPYING cset.init.d %{buildroot}/%{_defaultdocdir}/cpuset/
|
||||
%{__mkdir_p} %{buildroot}/%{_mandir}/man1
|
||||
cd doc
|
||||
%{__gzip} *.1
|
||||
%{__cp} *.1.gz %{buildroot}/%{_mandir}/man1
|
||||
%{__cp} *.txt %{buildroot}/%{_defaultdocdir}/cpuset/
|
||||
%{__mkdir} %{buildroot}/%{_defaultdocdir}/cpuset/html
|
||||
%{__cp} *.html %{buildroot}/%{_defaultdocdir}/cpuset/html/
|
||||
|
||||
|
||||
%clean
|
||||
%{__rm} -rf %{buildroot}
|
||||
|
||||
|
||||
%files
|
||||
%defattr(-,root,root)
|
||||
%{_bindir}/cset
|
||||
%{python_sitelib}/*
|
||||
%{_mandir}/man1/*
|
||||
%{_defaultdocdir}/*
|
||||
|
||||
|
||||
%changelog
|
@ -1,5 +0,0 @@
|
||||
set nocompatible
|
||||
set hlsearch
|
||||
set ai
|
||||
set sw=4
|
||||
set expandtab
|
@ -1,23 +0,0 @@
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
|
||||
---------------------------------------------------------------------
|
||||
Substrate code and ideas taken from the excellent stgit 0.13, see
|
||||
https://gna.org/projects/stgit and http://www.procode.org/stgit/
|
||||
Stacked GIT is under GPL V2 or later.
|
||||
---------------------------------------------------------------------
|
||||
"""
|
@ -1,5 +0,0 @@
|
||||
set nocompatible
|
||||
set hlsearch
|
||||
set ai
|
||||
set sw=4
|
||||
set expandtab
|
@ -1,23 +0,0 @@
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
|
||||
---------------------------------------------------------------------
|
||||
Substrate code and ideas taken from the excellent stgit 0.13, see
|
||||
https://gna.org/projects/stgit and http://www.procode.org/stgit/
|
||||
Stacked GIT is under GPL V2 or later.
|
||||
---------------------------------------------------------------------
|
||||
"""
|
@ -1,25 +0,0 @@
|
||||
"""Common functions and variables for all commands
|
||||
"""
|
||||
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
# Command exception class
|
||||
class CmdException(Exception):
|
||||
pass
|
||||
|
@ -1,63 +0,0 @@
|
||||
"""Memory node manipulation command
|
||||
"""
|
||||
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
import sys, os, logging
|
||||
from optparse import OptionParser, make_option
|
||||
|
||||
from cpuset.commands.common import *
|
||||
from cpuset import cset
|
||||
from cpuset.util import *
|
||||
|
||||
global log
|
||||
log = logging.getLogger('mem')
|
||||
|
||||
help = 'create and destroy memory nodes within cpusets'
|
||||
usage = """%prog [options] [cpuset name]
|
||||
|
||||
Create and manage memory node assignments to cpusets. Note that for
|
||||
non-NUMA machines, the memory node assignment will always be 0 (zero)
|
||||
and is so set by default. Thus this command only needs to be used
|
||||
for NUMA machines.
|
||||
"""
|
||||
|
||||
options = [make_option('-l', '--list',
|
||||
help = 'list memory nodes in specified cpuset',
|
||||
action = 'store_true'),
|
||||
make_option('-c', '--create',
|
||||
metavar = 'NODESPEC',
|
||||
help = 'create a memory node in specified cpuset'),
|
||||
make_option('-d', '--destroy',
|
||||
help = 'destroy specified memory node in specified cpuset',
|
||||
action = 'store_true'),
|
||||
make_option('-m', '--move',
|
||||
help = 'move specified memory node to specified cpuset',
|
||||
action = 'store_true'),
|
||||
make_option('-s', '--set',
|
||||
metavar = 'CPUSET',
|
||||
help = 'specify immediate cpuset'),
|
||||
make_option('-t', '--toset',
|
||||
help = 'specify destination cpuset'),
|
||||
make_option('-f', '--fromset',
|
||||
help = 'specify origination cpuset')
|
||||
]
|
||||
|
||||
def func(parser, options, args):
|
||||
log.debug("entering mem, options=%s, args=%s", options, args)
|
@ -1,807 +0,0 @@
|
||||
"""Process manipulation command
|
||||
"""
|
||||
|
||||
from builtins import str
|
||||
from builtins import range
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Copyright (C) 2013-2017 SUSE
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
import sys, os, io, re, logging, pwd, grp
|
||||
from optparse import OptionParser, make_option
|
||||
|
||||
from cpuset import config
|
||||
from cpuset import cset
|
||||
from cpuset.util import *
|
||||
from cpuset.commands.common import *
|
||||
try: from cpuset.commands import set
|
||||
except SyntaxError:
|
||||
raise
|
||||
except:
|
||||
pass
|
||||
|
||||
global log
|
||||
log = logging.getLogger('proc')
|
||||
|
||||
help = 'create and manage processes within cpusets'
|
||||
usage = """%prog [options] [path/program [args]]
|
||||
|
||||
This command is used to run and manage arbitrary processes on
|
||||
specified cpusets. It is also used to move pre-existing processes
|
||||
and threads to specified cpusets. You may note there is no
|
||||
"kill" or "destroy" option -- use the standard OS ^C or kill
|
||||
commands for that.
|
||||
|
||||
To list which tasks are running in a particular cpuset, use the
|
||||
--list command.
|
||||
|
||||
For example:
|
||||
# cset proc --list --set myset
|
||||
This command will list all the tasks running in the
|
||||
cpuset called "myset".
|
||||
|
||||
Processes are created by specifying the path to the executable
|
||||
and specifying the cpuset that the process is to be created in.
|
||||
|
||||
For example:
|
||||
# cset proc --set=blazing_cpuset --exec /usr/bin/fast_code
|
||||
This command will execute the /usr/bin/fast_code program
|
||||
on the "blazing_cpuset" cpuset.
|
||||
|
||||
Note that if your command takes options, then use the traditional
|
||||
"--" marker to separate cset's options from your command's
|
||||
options.
|
||||
|
||||
For example:
|
||||
# cset proc --set myset --exec -- ls -l
|
||||
This command will execute "ls -l" on the cpuset called
|
||||
"myset".
|
||||
|
||||
The PIDSPEC argument taken for the move command is a comma
|
||||
separated list of PIDs or TIDs. The list can also include
|
||||
brackets of PIDs or TIDs (i.e. tasks) that are inclusive of the
|
||||
endpoints.
|
||||
|
||||
For example:
|
||||
1,2,5 Means processes 1, 2 and 5
|
||||
1,2,600-700 Means processes 1, 2 and from 600 to 700
|
||||
|
||||
Note that the range of PIDs or TIDs does not need to have every
|
||||
position populated. In other words, for the example above, if
|
||||
there is only one process, say PID 57, in the range of 50-65,
|
||||
then only that process will be moved.
|
||||
|
||||
To move a PIDSPEC to a specific cpuset, you can either specify
|
||||
the PIDSPEC with --pid and the destination cpuset with --toset,
|
||||
or use the short hand and list the cpuset name after the PIDSPEC
|
||||
for the --move arguments.
|
||||
|
||||
The move command accepts multiple common calling methods.
|
||||
For example, the following commands are equivalent:
|
||||
# cset proc --move 2442,3000-3200 reserved_set
|
||||
# cset proc --move --pid=2442,3000-3200 --toset=reserved_set
|
||||
These commands move the tasks defined as 2442 and any
|
||||
running task between 3000 and 3200 inclusive of the ends
|
||||
to the cpuset called "reserved_set".
|
||||
|
||||
Specifying the --fromset is not necessary since the tasks will be
|
||||
moved to the destination cpuset no matter which cpuset they are
|
||||
currently running on.
|
||||
|
||||
Note however that if you do specify a cpuset with the --fromset
|
||||
option, then only those tasks that are both in the PIDSPEC *and*
|
||||
are running in the cpuset specified by --fromset will be moved.
|
||||
I.e., if there is a task running on the system but not in
|
||||
--fromset that is in PIDSPEC, it will not be moved.
|
||||
|
||||
If the --threads switch is used, then the proc command will
|
||||
gather any threads of belonging to any processes or threads that
|
||||
are specified in the PIDSPEC and move them. This provides an easy
|
||||
way to move all related threads: just pick one TID from the set
|
||||
and use the --threads option.
|
||||
|
||||
To move all userspace tasks from one cpuset to another, you need
|
||||
to specify the source and destination cpuset by name.
|
||||
|
||||
For example:
|
||||
# cset proc --move --fromset=comp1 --toset=comp42
|
||||
This command specifies that all processes and threads
|
||||
running on cpuset "comp1" be moved to cpuset "comp42".
|
||||
|
||||
Note that the move command will not move kernel threads unless
|
||||
the -k/--kthread switch is specified. If it is, then all unbound
|
||||
kernel threads will be added to the move. Unbound kernel threads
|
||||
are those that can run on any CPU. If you also specify the
|
||||
--force switch, then all tasks, kernel or not, bound or not,
|
||||
will be moved.
|
||||
|
||||
CAUTION: Please be cautious with the --force switch, since moving
|
||||
a kernel thread that is bound to a specific CPU to a cpuset that
|
||||
does not include that CPU can cause a system hang.
|
||||
|
||||
You must specify unique cpuset names for the both exec and move
|
||||
commands. If a simple name passed to the --fromset, --toset and
|
||||
--set parameters is unique on the system then that command
|
||||
executes. However, if there are multiple cpusets by that name,
|
||||
then you will need to specify which one you mean with a full path
|
||||
rooted at the base cpuset tree.
|
||||
|
||||
For example, suppose you have the following cpuset tree:
|
||||
/group1
|
||||
/myset
|
||||
/yourset
|
||||
/group2
|
||||
/myset
|
||||
/yourset
|
||||
|
||||
Then, to move a process from myset in group1 to yourset in
|
||||
group2, you would have to issue the following command:
|
||||
# cset proc --move --pid=50 --fromset=/group1/myset \\
|
||||
--toset=/group2/yourset
|
||||
"""
|
||||
|
||||
verbose = 0
|
||||
options = [make_option('-l', '--list',
|
||||
help = 'list processes in the specified cpuset',
|
||||
action = 'store_true'),
|
||||
make_option('-e', '--exec',
|
||||
help = 'execute arguments in the specified cpuset; '
|
||||
'use the "--" option separator to separate '
|
||||
'cset options from your exec\'ed command options',
|
||||
dest = 'exc',
|
||||
action = 'store_true'),
|
||||
make_option('-u', '--user',
|
||||
help = 'use this USER to --exec (id or name)'),
|
||||
make_option('-g', '--group',
|
||||
help = 'use this GROUP to --exec (id or name)'),
|
||||
make_option('-m', '--move',
|
||||
help = 'move specified tasks to specified cpuset; '
|
||||
'to move a PIDSPEC to a cpuset, use -m PIDSPEC cpuset; '
|
||||
'to move all tasks only specify --fromset and --toset',
|
||||
action = 'store_true'),
|
||||
make_option('-p', '--pid',
|
||||
metavar = 'PIDSPEC',
|
||||
help = 'specify pid or tid specification for move'),
|
||||
make_option("--threads",
|
||||
help = 'if specified, any processes found in the PIDSPEC to have '
|
||||
'multiple threads will automatically have all their threads '
|
||||
'added to the PIDSPEC; use to move all related threads to a '
|
||||
'cpuset',
|
||||
action = 'store_true'),
|
||||
make_option('-s', '--set',
|
||||
metavar = 'CPUSET',
|
||||
help = 'specify name of immediate cpuset'),
|
||||
make_option('-t', '--toset',
|
||||
help = 'specify name of destination cpuset'),
|
||||
make_option('-f', '--fromset',
|
||||
help = 'specify name of origination cpuset'),
|
||||
make_option('-k', '--kthread',
|
||||
help = 'move, or include moving, unbound kernel threads',
|
||||
action = 'store_true'),
|
||||
make_option('--force',
|
||||
help = 'force all processes and threads to be moved',
|
||||
action = 'store_true'),
|
||||
make_option('-v', '--verbose',
|
||||
help = 'prints more detailed output, additive',
|
||||
action = 'count')
|
||||
]
|
||||
|
||||
def func(parser, options, args):
|
||||
log.debug("entering func, options=%s, args=%s", options, args)
|
||||
|
||||
global verbose
|
||||
if options.verbose: verbose = options.verbose
|
||||
|
||||
cset.rescan()
|
||||
|
||||
tset = None
|
||||
if options.list or options.exc:
|
||||
if options.set:
|
||||
tset = cset.unique_set(options.set)
|
||||
elif options.toset:
|
||||
tset = cset.unique_set(options.toset)
|
||||
elif len(args) > 0:
|
||||
if options.exc:
|
||||
tset = cset.unique_set(args[0])
|
||||
del args[0]
|
||||
else:
|
||||
tset = args
|
||||
else:
|
||||
raise CpusetException("cpuset not specified")
|
||||
try:
|
||||
log.debug("operating on set %s", tset.path)
|
||||
except:
|
||||
log.debug("operating on sets %s", tset)
|
||||
|
||||
if options.exc: run(tset, args, options.user, options.group)
|
||||
|
||||
if options.list:
|
||||
list_sets(tset)
|
||||
return
|
||||
|
||||
if options.move or options.kthread:
|
||||
fset = None
|
||||
tset = None
|
||||
# first, we need to know the destination
|
||||
if options.toset:
|
||||
tset = cset.unique_set(options.toset)
|
||||
elif options.set and options.pid:
|
||||
tset = cset.unique_set(options.set)
|
||||
elif options.set and options.fromset:
|
||||
tset = cset.unique_set(options.set)
|
||||
elif len(args) > 0:
|
||||
if len(args) > 1 and options.pid == None:
|
||||
options.pid = args[0]
|
||||
if len(args) < 3:
|
||||
tset = cset.unique_set(args[1])
|
||||
else:
|
||||
# "-m 123 set1 set2" shortcut
|
||||
fset = cset.unique_set(args[1])
|
||||
tset = cset.unique_set(args[2])
|
||||
# take care of set1->set2 shortcut
|
||||
pids = pidspec_to_list(options.pid, threads=options.threads)
|
||||
if len(pids) == 1:
|
||||
try:
|
||||
fset = cset.unique_set(pids[0])
|
||||
options.pid = None
|
||||
except:
|
||||
pass # must be real pidspec
|
||||
else:
|
||||
if len(args) < 2:
|
||||
tset = cset.unique_set(args[0])
|
||||
else:
|
||||
fset = cset.unique_set(args[0])
|
||||
tset = cset.unique_set(args[1])
|
||||
else:
|
||||
raise CpusetException("destination cpuset not specified")
|
||||
set.active(tset)
|
||||
# next, if there is a pidspec, move just that
|
||||
if options.pid:
|
||||
if options.fromset and not options.force:
|
||||
fset = cset.unique_set(options.fromset)
|
||||
elif options.toset and options.set:
|
||||
fset = cset.unique_set(options.set)
|
||||
pids = pidspec_to_list(options.pid, fset, options.threads)
|
||||
if len(pids):
|
||||
log.info('moving following pidspec: %s' % ','.join(pids))
|
||||
selective_move(None, tset, pids, options.kthread, options.force)
|
||||
else:
|
||||
log.info('**> no tasks moved')
|
||||
log.info('done')
|
||||
else:
|
||||
fset = None
|
||||
# here we assume move everything from fromset to toset
|
||||
if options.fromset:
|
||||
fset = cset.unique_set(options.fromset)
|
||||
elif options.set:
|
||||
fset = cset.unique_set(options.set)
|
||||
elif len(args) > 0:
|
||||
# this must be the fromset, then...
|
||||
fset = cset.unique_set(args[0])
|
||||
if fset == None:
|
||||
raise CpusetException("origination cpuset not specified")
|
||||
nt = len(fset.tasks)
|
||||
if nt == 0:
|
||||
raise CpusetException('no tasks to move from cpuset "%s"'
|
||||
% fset.path)
|
||||
if options.move:
|
||||
log.info('moving all tasks from %s to %s',
|
||||
fset.name, tset.path)
|
||||
selective_move(fset, tset, None, options.kthread, options.force,
|
||||
options.threads)
|
||||
else:
|
||||
log.info('moving all kernel threads from %s to %s',
|
||||
fset.path, tset.path)
|
||||
# this is a -k "move", so only move kernel threads
|
||||
pids = []
|
||||
for task in fset.tasks:
|
||||
try: os.readlink('/proc/'+task+'/exe')
|
||||
except: pids.append(task)
|
||||
selective_move(fset, tset, pids, options.kthread, options.force)
|
||||
log.info('done')
|
||||
return
|
||||
|
||||
# default no options is list
|
||||
list_sets(args)
|
||||
|
||||
def list_sets(args):
|
||||
log.debug("entering list_sets, args=%s", args)
|
||||
l = []
|
||||
if isinstance(args, list):
|
||||
for s in args:
|
||||
if isinstance(s, str):
|
||||
l.extend(cset.find_sets(s))
|
||||
elif not isinstance(s, cset.CpuSet):
|
||||
raise CpusetException(
|
||||
'list_sets() args=%s, of which "%s" not a string or CpuSet'
|
||||
% (args, s))
|
||||
else:
|
||||
l.append(s)
|
||||
else:
|
||||
if isinstance(args, str):
|
||||
l.extend(cset.find_sets(args))
|
||||
elif not isinstance(args, cset.CpuSet):
|
||||
raise CpusetException(
|
||||
"list_sets() passed args=%s, which is not a string or CpuSet" % args)
|
||||
else:
|
||||
l.append(args)
|
||||
if len(l) == 0:
|
||||
raise CpusetException("cpuset(s) to list not specified");
|
||||
for s in l:
|
||||
if len(s.tasks) > 0:
|
||||
if verbose:
|
||||
log_detailed_task_table(s, ' ')
|
||||
else:
|
||||
log_detailed_task_table(s, ' ', 78)
|
||||
else:
|
||||
log.info(cset.summary(s))
|
||||
|
||||
def move(fromset, toset, plist=None, verb=None, force=None):
|
||||
log.debug('entering move, fromset=%s toset=%s list=%s force=%s verb=%s',
|
||||
fromset, toset, plist, force, verb)
|
||||
if isinstance(fromset, str):
|
||||
fset = cset.unique_set(fromset)
|
||||
elif not isinstance(fromset, cset.CpuSet) and plist == None:
|
||||
raise CpusetException(
|
||||
"passed fromset=%s, which is not a string or CpuSet" % fromset)
|
||||
else:
|
||||
fset = fromset
|
||||
if isinstance(toset, str):
|
||||
tset = cset.unique_set(toset)
|
||||
elif not isinstance(toset, cset.CpuSet):
|
||||
raise CpusetException(
|
||||
"passed toset=%s, which is not a string or CpuSet" % toset)
|
||||
else:
|
||||
tset = toset
|
||||
if plist == None:
|
||||
log.debug('moving default of all processes')
|
||||
if tset != fset and not force:
|
||||
plist = fset.tasks
|
||||
else:
|
||||
raise CpusetException(
|
||||
"cannot move tasks into their origination cpuset")
|
||||
output = 0
|
||||
if verb:
|
||||
output = verb
|
||||
elif verbose:
|
||||
output = verbose
|
||||
if output:
|
||||
l = []
|
||||
if config.mread:
|
||||
l.append('move_tasks_start')
|
||||
l.extend(task_detail_table(plist))
|
||||
l.append('move_tasks_stop')
|
||||
else:
|
||||
l.append(' ')
|
||||
l.extend(task_detail_header(' '))
|
||||
if output > 1:
|
||||
l.extend(task_detail_table(plist, ' '))
|
||||
else:
|
||||
l.extend(task_detail_table(plist, ' ', 76))
|
||||
log.info("\n".join(l))
|
||||
# do the move...
|
||||
tset.tasks = plist
|
||||
|
||||
def selective_move(fset, tset, plist=None, kthread=None, force=None, threads=None):
|
||||
log.debug('entering selective_move, fset=%s tset=%s plist=%s kthread=%s force=%s',
|
||||
fset, tset, plist, kthread, force)
|
||||
task_check = []
|
||||
tasks = []
|
||||
task_heap = []
|
||||
utsk = 0
|
||||
ktsk = 0
|
||||
autsk = 0
|
||||
aktsk = 0
|
||||
utsknr = 0
|
||||
ktsknr = 0
|
||||
ktskb = 0
|
||||
sstsk = 0
|
||||
target = cset.unique_set(tset)
|
||||
if fset:
|
||||
fset = cset.unique_set(fset)
|
||||
if fset == target and not force:
|
||||
raise CpusetException(
|
||||
"error, same source/destination cpuset, use --force if ok")
|
||||
task_check = fset.tasks
|
||||
if plist:
|
||||
task_heap = plist
|
||||
else:
|
||||
task_heap = cset.unique_set(fset).tasks
|
||||
log.debug('processing task heap')
|
||||
for task in task_heap:
|
||||
try:
|
||||
# kernel threads do not have an excutable image
|
||||
os.readlink('/proc/'+task+'/exe')
|
||||
autsk += 1
|
||||
if fset and not force:
|
||||
try:
|
||||
task_check.index(task)
|
||||
tasks.append(task)
|
||||
log.debug(' added task %s', task)
|
||||
utsk += 1
|
||||
if threads:
|
||||
log.debug(' thread matching, looking for threads for task %s', task)
|
||||
dirs = os.listdir('/proc/'+task+'/task')
|
||||
if len(dirs) > 1:
|
||||
for thread in dirs:
|
||||
if thread != task:
|
||||
log.debug(' adding thread %s', thread)
|
||||
tasks.append(thread)
|
||||
utsk += 1
|
||||
except ValueError:
|
||||
log.debug(' task %s not running in %s, skipped',
|
||||
task, fset.name)
|
||||
utsknr += 1
|
||||
else:
|
||||
if not force and cset.lookup_task_from_cpusets(task) == target.path:
|
||||
log.debug(' task %s moving to orgination set %s, skipped',
|
||||
task, target.path)
|
||||
sstsk += 1
|
||||
else:
|
||||
tasks.append(task)
|
||||
utsk += 1
|
||||
except OSError:
|
||||
aktsk += 1
|
||||
try:
|
||||
# this is in try because the task may not exist by the
|
||||
# time we do this, in that case, just ignore it
|
||||
if kthread:
|
||||
if force:
|
||||
tasks.append(task)
|
||||
ktsk += 1
|
||||
else:
|
||||
if is_unbound(task):
|
||||
tasks.append(task)
|
||||
ktsk += 1
|
||||
elif cset.lookup_task_from_cpusets(task) == target.path:
|
||||
log.debug(' task %s moving to orgination set %s, skipped',
|
||||
task, target.path)
|
||||
sstsk += 1
|
||||
else:
|
||||
log.debug(' kernel thread %s is bound, not adding',
|
||||
task)
|
||||
ktskb += 1
|
||||
except:
|
||||
log.debug(' kernel thread %s not found , perhaps it went away',
|
||||
task)
|
||||
ktsknr += 1
|
||||
# ok, move 'em
|
||||
log.debug('moving %d tasks to %s ...', len(tasks), tset.name)
|
||||
if len(tasks) == 0:
|
||||
log.info('**> no task matched move criteria')
|
||||
if sstsk > 0:
|
||||
raise CpusetException('same source/destination cpuset, use --force if ok')
|
||||
elif len(task_heap) > 0 and not kthread:
|
||||
raise CpusetException('if you want to move kernel threads, use -k')
|
||||
elif ktskb > 0:
|
||||
raise CpusetException('kernel tasks are bound, use --force if ok')
|
||||
return
|
||||
if utsk > 0:
|
||||
l = []
|
||||
l.append('moving')
|
||||
l.append(str(utsk))
|
||||
l.append('userspace tasks to')
|
||||
l.append(tset.path)
|
||||
log.info(' '.join(l))
|
||||
if utsknr > 0:
|
||||
l = []
|
||||
l.append('--> not moving')
|
||||
l.append(str(utsknr))
|
||||
l.append('tasks (not in fromset, use --force)')
|
||||
log.info(' '.join(l))
|
||||
if ktsk > 0 or kthread:
|
||||
l = []
|
||||
l.append('moving')
|
||||
l.append(str(ktsk))
|
||||
l.append('kernel threads to:')
|
||||
l.append(tset.path)
|
||||
log.info(' '.join(l))
|
||||
if ktskb > 0:
|
||||
l = []
|
||||
l.append('--> not moving')
|
||||
l.append(str(ktskb))
|
||||
l.append('threads (not unbound, use --force)')
|
||||
log.info(' '.join(l))
|
||||
if aktsk > 0 and force and not kthread and autsk == 0:
|
||||
log.info('*** not moving kernel threads, need both --force and --kthread')
|
||||
if ktsknr > 0:
|
||||
l = []
|
||||
l.append('--> not moving')
|
||||
l.append(str(ktsknr))
|
||||
l.append('tasks because they are missing (race)')
|
||||
move(None, target, tasks)
|
||||
|
||||
def run(tset, args, usr_par=None, grp_par=None):
|
||||
if isinstance(tset, str):
|
||||
s = cset.unique_set(tset)
|
||||
elif not isinstance(tset, cset.CpuSet):
|
||||
raise CpusetException(
|
||||
"passed set=%s, which is not a string or CpuSet" % tset)
|
||||
else:
|
||||
s = tset
|
||||
log.debug('entering run, set=%s args=%s ', s.path, args)
|
||||
set.active(s)
|
||||
# check user
|
||||
if usr_par:
|
||||
try:
|
||||
user = pwd.getpwnam(usr_par)[2]
|
||||
except KeyError:
|
||||
try:
|
||||
user = pwd.getpwuid(int(usr_par))[2]
|
||||
except:
|
||||
raise CpusetException('unknown user: "%s"' % usr_par)
|
||||
if grp_par:
|
||||
try:
|
||||
group = grp.getgrnam(grp_par)[2]
|
||||
except KeyError:
|
||||
try:
|
||||
group = grp.getgrgid(int(grp_par))[2]
|
||||
except:
|
||||
raise CpusetException('unknown group: "%s"' % grp_par)
|
||||
elif usr_par:
|
||||
# if user is specified but group is not, and user is not root,
|
||||
# then use the users group
|
||||
if user != 0:
|
||||
try:
|
||||
group = grp.getgrnam('users')[2]
|
||||
grp_par = True
|
||||
except:
|
||||
pass # just forget it
|
||||
# move myself into target cpuset and exec child
|
||||
move_pidspec(str(os.getpid()), s)
|
||||
log.info('--> last message, executed args into cpuset "%s", new pid is: %s',
|
||||
s.path, os.getpid())
|
||||
# change user and group before exec
|
||||
if grp_par: os.setgid(group)
|
||||
if usr_par:
|
||||
os.setuid(user)
|
||||
os.environ["LOGNAME"] = usr_par
|
||||
os.environ["USERNAME"] = usr_par
|
||||
os.environ["USER"] = usr_par
|
||||
os.execvp(args[0], args)
|
||||
|
||||
def is_unbound(proc):
|
||||
# FIXME: popen is slow...
|
||||
# --> use /proc/<pid>/status -> Cpus_allowed
|
||||
# int(line.replace(',',''), 16)
|
||||
# note: delete leading zeros to compare to allcpumask
|
||||
line = os.popen('/usr/bin/taskset -p ' + str(proc) +' 2>/dev/null', 'r').readline()
|
||||
aff = line.split()[-1]
|
||||
log.debug('is_unbound, proc=%s aff=%s allcpumask=%s',
|
||||
proc, aff, cset.allcpumask)
|
||||
if aff == cset.allcpumask: return True
|
||||
return False
|
||||
|
||||
def pidspec_to_list(pidspec, fset=None, threads=False):
|
||||
"""create a list of process ids out of a pidspec"""
|
||||
log.debug('entering pidspecToList, pidspec=%s fset=%s threads=%s',
|
||||
pidspec, fset, threads)
|
||||
if fset:
|
||||
if isinstance(fset, str): fset = cset.unique_set(fset)
|
||||
elif not isinstance(fset, cset.CpuSet):
|
||||
raise CpusetException("passed fset=%s, which is not a string or CpuSet" % fset)
|
||||
log.debug('from-set specified as: %s', fset.path)
|
||||
if not isinstance(pidspec, str):
|
||||
raise CpusetException('pidspec=%s is not a string' % pidspec)
|
||||
groups = pidspec.split(',')
|
||||
plist = []
|
||||
nifs = 0
|
||||
if fset: chktsk = fset.tasks
|
||||
log.debug('parsing groups: %s', groups)
|
||||
for sub in groups:
|
||||
items = sub.split('-')
|
||||
if len(items) == 1:
|
||||
if not len(items[0]):
|
||||
# two consecutive commas in pidspec, just continue processing
|
||||
continue
|
||||
# one pid in this group
|
||||
if fset:
|
||||
try:
|
||||
chktsk.index(items[0])
|
||||
plist.append(items[0])
|
||||
log.debug(' added single pid: %s', items[0])
|
||||
except:
|
||||
log.debug(' task %s not running in %s, skipped', items[0], fset.name)
|
||||
nifs += 1
|
||||
else:
|
||||
plist.append(items[0])
|
||||
log.debug(' added single pid: %s', items[0])
|
||||
elif len(items) == 2:
|
||||
# a range of pids, only include those that exist
|
||||
rng = [str(x) for x in range(int(items[0]), int(items[1])+1)
|
||||
if os.access('/proc/'+str(x), os.F_OK)]
|
||||
if fset:
|
||||
for tsk in rng:
|
||||
try:
|
||||
chktsk.index(tsk)
|
||||
plist.append(tsk)
|
||||
log.debug(' added task from range: %s', tsk)
|
||||
except:
|
||||
log.debug(' task %s not running in %s, skipped', tsk, fset.name)
|
||||
nifs += 1
|
||||
else:
|
||||
plist.extend(rng)
|
||||
log.debug(' added range of pids from %s-%s: %s', items[0], items[1], rng)
|
||||
else:
|
||||
raise CpusetException('pidspec=%s has bad group=%s' % (pidspec, items))
|
||||
log.debug('raw parsed pid list of %s tasks: %s', len(plist), plist)
|
||||
if nifs > 0:
|
||||
if nifs > 1: nmsg = "tasks"
|
||||
else: nmsg = "task"
|
||||
log.info('**> skipped %s %s, not in origination set "%s"', nifs, nmsg, fset.name)
|
||||
log.debug('checking for duplicates...')
|
||||
pdict = {}
|
||||
dups = 0
|
||||
for task in plist:
|
||||
if task in pdict:
|
||||
dups += 1
|
||||
continue
|
||||
pdict[task] = True
|
||||
log.debug('found %s duplicates', dups)
|
||||
if threads:
|
||||
log.debug('thread matching activated, looking for threads...')
|
||||
dups = 0
|
||||
hits = 0
|
||||
for task in list(pdict.keys()):
|
||||
dirs = os.listdir('/proc/'+str(task)+'/task')
|
||||
if len(dirs) > 1:
|
||||
hits += 1
|
||||
for thread in dirs:
|
||||
if thread in pdict:
|
||||
dups += 1
|
||||
continue
|
||||
pdict[thread] = True
|
||||
log.debug('found %s multithreaded containers and %s duplicates', hits, dups)
|
||||
plist = list(pdict.keys())
|
||||
log.debug('returning parsed pid list of %s tasks: %s', len(plist), plist)
|
||||
return plist
|
||||
|
||||
def move_pidspec(pidspec, toset, fset=None, threads=False):
|
||||
log.debug('entering move_pidspec, pidspec=%s toset=%s threads=%s', pidspec, toset,
|
||||
threads)
|
||||
if not fset:
|
||||
pids = pidspec_to_list(pidspec, None, threads)
|
||||
else:
|
||||
# if fromset is specified, only move tasks that are in pidspec
|
||||
# and are running in fromset
|
||||
log.debug('specified fset=%s', fset)
|
||||
pids = pidspec_to_list(pidspec, fset, threads)
|
||||
if len(pids) == 0:
|
||||
raise CpusetException('tasks do not match all criteria, none moved')
|
||||
move(None, toset, pids)
|
||||
|
||||
def task_detail(pid, width=70):
|
||||
# scheduler policy definitions
|
||||
policy = ['o', 'f', 'r', 'b', '?', 'i', 'd']
|
||||
# stat location definitions
|
||||
statdef = {
|
||||
'pid': 0,
|
||||
'name': 1,
|
||||
'state': 2,
|
||||
'ppid': 3,
|
||||
'pgid': 4,
|
||||
'sid': 5,
|
||||
'priority': 17,
|
||||
'nice': 18,
|
||||
'numthreads': 19,
|
||||
'rtpriority': 39,
|
||||
'rtpolicy': 40,
|
||||
}
|
||||
# get task details from /proc, stat has rtprio/policy but not uid...
|
||||
pid = str(pid)
|
||||
if not os.access('/proc/'+pid, os.F_OK):
|
||||
raise CpusetException('task "%s" does not exist' % pid)
|
||||
status = io.open('/proc/'+pid+'/status', 'r', encoding="ascii").readlines()
|
||||
stdict = {}
|
||||
for line in status:
|
||||
try:
|
||||
stdict[line.split()[0][:-1]] = line.split(':')[1].strip()
|
||||
except:
|
||||
pass # sometimes, we get an extra \n out of this file...
|
||||
stat = io.open('/proc/'+pid+'/stat', 'r', encoding="ascii").readline()
|
||||
# we assume parentheses appear only around the name
|
||||
stat_right_paren = stat.rfind(')')
|
||||
stat_left_paren = stat.find('(')
|
||||
stat = [stat[:stat_left_paren-1]] + \
|
||||
[stat[stat_left_paren:stat_right_paren+1]] + \
|
||||
stat[stat_right_paren+2:].split()
|
||||
cmdline = io.open('/proc/'+pid+'/cmdline', encoding="ascii").readline()
|
||||
# assume that a zero delimits the cmdline (it does now...)
|
||||
cmdline = cmdline.replace('\0', ' ')
|
||||
|
||||
out = []
|
||||
try:
|
||||
uid=pwd.getpwuid(int(stdict['Uid'].split()[0]))[0][:8].ljust(8)
|
||||
except:
|
||||
uid=stdict['Uid'].split()[0][:8].ljust(8)
|
||||
out.append(uid)
|
||||
out.append(stdict['Pid'].rjust(5))
|
||||
out.append(stdict['PPid'].rjust(5))
|
||||
|
||||
out2 = []
|
||||
out2.append(stdict['State'].split()[0])
|
||||
policy_code=int(stat[statdef['rtpolicy']])
|
||||
out2.append(policy[policy_code] if policy_code<len(policy) else '?')
|
||||
if stat[statdef['rtpolicy']] == '0':
|
||||
out2.append('th')
|
||||
elif stat[statdef['rtpolicy']] == '3':
|
||||
out2.append('at')
|
||||
# SCHED_ISO is reserved but not yet implemented as of Linux v4.4
|
||||
elif stat[statdef['rtpolicy']] == '4':
|
||||
out2.append('??')
|
||||
elif stat[statdef['rtpolicy']] == '5':
|
||||
out2.append('dl')
|
||||
else:
|
||||
if int(stat[statdef['rtpriority']]) < 10:
|
||||
out2.append('_')
|
||||
out2.append(stat[statdef['rtpriority']])
|
||||
else:
|
||||
out2.append(stat[statdef['rtpriority']].rjust(2))
|
||||
out.append(''.join(out2))
|
||||
|
||||
try:
|
||||
os.readlink('/proc/'+pid+'/exe')
|
||||
#prog = stdict['Name'] + ' '.join(cmdline.split()[1:])
|
||||
prog = cmdline
|
||||
except:
|
||||
prog = '['+stdict['Name']+']'
|
||||
out.append(prog)
|
||||
|
||||
if config.mread:
|
||||
l2 = []
|
||||
for line in out:
|
||||
l2.append(line.strip())
|
||||
return ';'.join(l2)
|
||||
|
||||
out = ' '.join(out)
|
||||
if width != 0 and len(out) >= width:
|
||||
out = out[:width-3] + "..."
|
||||
|
||||
return out
|
||||
|
||||
def task_detail_header(indent=None):
|
||||
if indent == None: istr = ""
|
||||
else: istr = indent
|
||||
l = []
|
||||
l.append(istr + 'USER PID PPID SPPr TASK NAME')
|
||||
l.append(istr + '-------- ----- ----- ---- ---------')
|
||||
return l
|
||||
|
||||
def task_detail_table(pids, indent=None, width=None):
|
||||
l = []
|
||||
if indent == None: istr = ""
|
||||
else: istr = indent
|
||||
for task in pids:
|
||||
if width: l.append(istr + task_detail(task, width))
|
||||
else: l.append(istr + task_detail(task, 0))
|
||||
return l
|
||||
|
||||
def log_detailed_task_table(set, indent=None, width=None):
|
||||
log.debug("entering print_detailed_task_table, set=%s indent=%s width=%s",
|
||||
set.path, indent, width)
|
||||
l = []
|
||||
if not config.mread:
|
||||
l.append(cset.summary(set))
|
||||
l.extend(task_detail_header(indent))
|
||||
l.extend(task_detail_table(set.tasks, indent, width))
|
||||
else:
|
||||
l.append('proc_list_start-' + set.name)
|
||||
l.extend(task_detail_table(set.tasks))
|
||||
l.append('proc_list_stop-' + set.name)
|
||||
log.info("\n".join(l))
|
||||
|
@ -1,495 +0,0 @@
|
||||
"""Cpuset manipulation command
|
||||
"""
|
||||
|
||||
from builtins import str
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Copyright (C) 2013-2017 SUSE
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
import sys, os, logging, time
|
||||
from optparse import OptionParser, make_option
|
||||
|
||||
from cpuset import config
|
||||
from cpuset import cset
|
||||
from cpuset.util import *
|
||||
from cpuset.commands.common import *
|
||||
try: from cpuset.commands import proc
|
||||
except SyntaxError:
|
||||
raise
|
||||
except:
|
||||
pass
|
||||
|
||||
global log
|
||||
log = logging.getLogger('set')
|
||||
|
||||
help = 'create, modify and destroy cpusets'
|
||||
usage = """%prog [options] [cpuset name]
|
||||
|
||||
This command is used to create, modify, and destroy cpusets.
|
||||
Cpusets form a tree-like structure rooted at the root cpuset
|
||||
which always includes all system CPUs and all system memory
|
||||
nodes.
|
||||
|
||||
A cpuset is an organizational unit that defines a group of CPUs
|
||||
and a group of memory nodes where a process or thread (i.e. task)
|
||||
is allowed to run on. For non-NUMA machines, the memory node is
|
||||
always 0 (zero) and cannot be set to anything else. For NUMA
|
||||
machines, the memory node can be set to a similar specification
|
||||
as the CPU definition and will tie those memory nodes to that
|
||||
cpuset. You will usually want the memory nodes that belong to
|
||||
the CPUs defined to be in the same cpuset.
|
||||
|
||||
A cpuset can have exclusive right to the CPUs defined in it.
|
||||
This means that only this cpuset can own these CPUs. Similarly,
|
||||
a cpuset can have exclusive right to the memory nodes defined in
|
||||
it. This means that only this cpuset can own these memory
|
||||
nodes.
|
||||
|
||||
Cpusets can be specified by name or by path; however, care
|
||||
should be taken when specifying by name if the name is not
|
||||
unique. This tool will generally not let you do destructive
|
||||
things to non-unique cpuset names.
|
||||
|
||||
Cpusets are uniquely specified by path. The path starts at where
|
||||
the cpusets filesystem is mounted so you generally do not have to
|
||||
know where that is. For example, so specify a cpuset that is
|
||||
called "two" which is a subset of "one" which in turn is a subset
|
||||
of the root cpuset, use the path "/one/two" regardless of where
|
||||
the cpusets filesystem is mounted.
|
||||
|
||||
When specifying CPUs, a so-called CPUSPEC is used. The CPUSPEC
|
||||
will accept a comma-separated list of CPUs and inclusive range
|
||||
specifications. For example, --cpu=1,3,5-7 will assign CPU1,
|
||||
CPU3, CPU5, CPU6, and CPU7 to the specified cpuset.
|
||||
|
||||
Note that cpusets follow certain rules. For example, children
|
||||
can only include CPUs that the parents already have. If you do
|
||||
not follow those rules, the kernel cpuset subsystem will not let
|
||||
you create that cpuset. For example, if you create a cpuset that
|
||||
contains CPU3, and then attempt to create a child of that cpuset
|
||||
with a CPU other than 3, you will get an error, and the cpuset
|
||||
will not be active. The error is somewhat cryptic in that it is
|
||||
usually a "Permission denied" error.
|
||||
|
||||
Memory nodes are specified with a MEMSPEC in a similar way to
|
||||
the CPUSPEC. For example, --mem=1,3-6 will assign MEM1, MEM3,
|
||||
MEM4, MEM5, and MEM6 to the specified cpuset.
|
||||
|
||||
Note that if you attempt to create or modify a cpuset with a
|
||||
memory node specification that is not valid, you may get a
|
||||
cryptic error message, "No space left on device", and the
|
||||
modification will not be allowed.
|
||||
|
||||
When you destroy a cpuset, then the tasks running in that set are
|
||||
moved to the parent of that cpuset. If this is not what you
|
||||
want, then manually move those tasks to the cpuset of your choice
|
||||
with the 'cset proc' command (see 'cset proc --help' for more
|
||||
information).
|
||||
|
||||
EXAMPLES
|
||||
|
||||
Create a cpuset with the default memory specification:
|
||||
|
||||
# cset set --cpu=2,4,6-8 --set=new_set
|
||||
|
||||
This command creates a cpuset called "new_set" located
|
||||
off the root cpuset which holds CPUS 2,4,6,7,8 and node 0
|
||||
(interleaved) memory. Note that --set is optional, and
|
||||
you can just specify the name for the new cpuset after
|
||||
all arguments.
|
||||
|
||||
Create a cpuset that specifies both CPUs and memory nodes:
|
||||
|
||||
# cset set --cpu=3 --mem=3 /rad/set_one
|
||||
|
||||
Note that this command uses the full path method to
|
||||
specify the name of the new cpuset "/rad/set_one". It
|
||||
also names the new cpuset implicitly (i.e. no --set
|
||||
option, although you can use that if you want to). If
|
||||
the "set_one" name is unique, you can subsequently refer
|
||||
to is just by that. Memory node 3 is assigned to this
|
||||
cpuset as well as CPU 3.
|
||||
|
||||
The above commands will create the new cpusets, or if they
|
||||
already exist, they will modify them to the new specifications."""
|
||||
|
||||
verbose = 0
|
||||
options = [make_option('-l', '--list',
|
||||
help = 'list the named cpuset(s); recursive list if also -r',
|
||||
action = 'store_true'),
|
||||
make_option('-c', '--cpu',
|
||||
help = 'create or modify cpuset in the specified '
|
||||
'cpuset with CPUSPEC specification',
|
||||
metavar = 'CPUSPEC'),
|
||||
make_option('-m', '--mem',
|
||||
help = 'specify which memory nodes to assign '
|
||||
'to the created or modified cpuset (optional)',
|
||||
metavar = 'MEMSPEC'),
|
||||
make_option('-n', '--newname',
|
||||
help = 'rename cpuset specified with --set to NEWNAME'),
|
||||
make_option('-d', '--destroy',
|
||||
help = 'destroy specified cpuset',
|
||||
action = 'store_true'),
|
||||
make_option('-s', '--set',
|
||||
metavar = 'CPUSET',
|
||||
help = 'specify cpuset'),
|
||||
make_option('-r', '--recurse',
|
||||
help = 'do things recursively, use with --list and --destroy',
|
||||
action = 'store_true'),
|
||||
make_option('--force',
|
||||
help = 'force recursive deletion even if processes are running '
|
||||
'in those cpusets (they will be moved to parent cpusets)',
|
||||
action = 'store_true'),
|
||||
make_option('-x', '--usehex',
|
||||
help = 'use hexadecimal value for CPUSPEC and MEMSPEC when '
|
||||
'listing cpusets',
|
||||
action = 'store_true'),
|
||||
make_option('-v', '--verbose',
|
||||
help = 'prints more detailed output, additive',
|
||||
action = 'count'),
|
||||
make_option('--cpu_exclusive',
|
||||
help = 'mark this cpuset as owning its CPUs exclusively',
|
||||
action = 'store_true'),
|
||||
make_option('--mem_exclusive',
|
||||
help = 'mark this cpuset as owning its MEMs exclusively',
|
||||
action = 'store_true'),
|
||||
]
|
||||
|
||||
def func(parser, options, args):
|
||||
log.debug("entering func, options=%s, args=%s", options, args)
|
||||
global verbose
|
||||
if options.verbose: verbose = options.verbose
|
||||
|
||||
cset.rescan()
|
||||
|
||||
if options.list:
|
||||
if options.set:
|
||||
list_sets(options.set, options.recurse, options.usehex)
|
||||
return
|
||||
if len(args): list_sets(args, options.recurse, options.usehex)
|
||||
else: list_sets('root', options.recurse, options.usehex)
|
||||
return
|
||||
|
||||
if options.cpu or options.mem:
|
||||
# create or modify cpuset
|
||||
create_from_options(options, args)
|
||||
return
|
||||
|
||||
if options.newname:
|
||||
rename_set(options, args)
|
||||
return
|
||||
|
||||
if options.destroy:
|
||||
if options.set: destroy_sets(options.set, options.recurse, options.force)
|
||||
else: destroy_sets(args, options.recurse, options.force)
|
||||
return
|
||||
|
||||
if options.cpu_exclusive or options.mem_exclusive:
|
||||
# FIXME: modification of existing cpusets for exclusivity
|
||||
log.info("Modification of cpu_exclusive and mem_exclusive not implemented.")
|
||||
return
|
||||
|
||||
# default behavior if no options specified is list
|
||||
log.debug('no options set, default is listing cpusets')
|
||||
if options.set: list_sets(options.set, options.recurse, options.usehex)
|
||||
elif len(args): list_sets(args, options.recurse, options.usehex)
|
||||
else: list_sets('root', options.recurse, options.usehex)
|
||||
|
||||
def list_sets(tset, recurse=None, usehex=False):
|
||||
"""list cpusets specified in tset as cpuset or list of cpusets, recurse if true"""
|
||||
log.debug('entering list_sets, tset=%s recurse=%s', tset, recurse)
|
||||
sl = []
|
||||
if isinstance(tset, list):
|
||||
for s in tset: sl.extend(cset.find_sets(s))
|
||||
else:
|
||||
sl.extend(cset.find_sets(tset))
|
||||
log.debug('total unique sets in passed tset: %d', len(sl))
|
||||
sl2 = []
|
||||
for s in sl:
|
||||
sl2.append(s)
|
||||
if len(s.subsets) > 0:
|
||||
sl2.extend(s.subsets)
|
||||
if recurse:
|
||||
for node in s.subsets:
|
||||
for nd in cset.walk_set(node):
|
||||
sl2.append(nd)
|
||||
sl = sl2
|
||||
if config.mread:
|
||||
pl = ['cpuset_list_start']
|
||||
else:
|
||||
pl = ['']
|
||||
pl.extend(set_header(' '))
|
||||
|
||||
for s in sl:
|
||||
if verbose:
|
||||
pl.append(set_details(s,' ', None, usehex))
|
||||
else:
|
||||
pl.append(set_details(s,' ', 78, usehex))
|
||||
|
||||
if config.mread:
|
||||
pl.append('cpuset_list_end')
|
||||
log.info("\n".join(pl))
|
||||
|
||||
def destroy_sets(sets, recurse=False, force=False):
|
||||
"""destroy cpusets in list of sets, recurse if true, if force destroy if tasks running"""
|
||||
log.debug('enter destroy_sets, sets=%s, force=%s', sets, force)
|
||||
nl = []
|
||||
if isinstance(sets, list):
|
||||
nl.extend(sets)
|
||||
else:
|
||||
nl.append(sets)
|
||||
# check that sets passed are ok, will raise if one is bad
|
||||
sl2 = []
|
||||
for s in nl:
|
||||
st = cset.unique_set(s)
|
||||
sl2.append(st)
|
||||
if len(st.subsets) > 0:
|
||||
if not recurse:
|
||||
raise CpusetException(
|
||||
'cpuset "%s" has subsets, delete them first, or use --recurse'
|
||||
% st.path)
|
||||
elif not force:
|
||||
raise CpusetException(
|
||||
'cpuset "%s" has subsets, use --force to destroy'
|
||||
% st.path)
|
||||
sl2.extend(st.subsets)
|
||||
for node in st.subsets:
|
||||
for nd in cset.walk_set(node):
|
||||
sl2.append(nd)
|
||||
|
||||
# ok, good to go
|
||||
if recurse: sl2.reverse()
|
||||
for s in sl2:
|
||||
s = cset.unique_set(s)
|
||||
# skip the root set!!! or you'll have problems...
|
||||
if s.path == '/': continue
|
||||
log.info('--> processing cpuset "%s", moving %s tasks to parent "%s"...',
|
||||
s.name, len(s.tasks), s.parent.path)
|
||||
proc.move(s, s.parent)
|
||||
log.info('--> deleting cpuset "%s"', s.path)
|
||||
destroy(s)
|
||||
log.info('done')
|
||||
|
||||
def destroy(name):
|
||||
"""destroy one cpuset by name as cset or string"""
|
||||
log.debug('entering destroy, name=%s', name)
|
||||
if isinstance(name, str):
|
||||
set = cset.unique_set(name)
|
||||
elif not isinstance(name, cset.CpuSet):
|
||||
raise CpusetException(
|
||||
"passed name=%s, which is not a string or CpuSet" % name)
|
||||
else:
|
||||
set = name
|
||||
tsks = set.tasks
|
||||
if len(tsks) > 0:
|
||||
# wait for tasks, sometimes it takes a little while to
|
||||
# have them leave the set
|
||||
ii = 0
|
||||
while len(tsks)>0:
|
||||
log.debug('%i tasks still running in set %s, waiting interval %s...',
|
||||
len(tsks), set.name, ii+1)
|
||||
time.sleep(0.5)
|
||||
tsks = set.tasks
|
||||
ii += 1
|
||||
if (ii) > 6:
|
||||
# try it for 3 seconds, bail if tasks still there
|
||||
raise CpusetException(
|
||||
"trying to destroy cpuset %s with tasks running: %s" %
|
||||
(set.path, set.tasks))
|
||||
log.debug("tasks expired, deleting set %s" % set.path)
|
||||
os.rmdir(cset.CpuSet.basepath+set.path)
|
||||
# fixme: perhaps reparsing the all the sets is not so efficient...
|
||||
cset.rescan()
|
||||
|
||||
def rename_set(options, args):
|
||||
"""rename cpuset as specified in options and args lists"""
|
||||
log.debug('entering rename_set, options=%s args=%s', options, args)
|
||||
# figure out target cpuset name, if --set not used, use first arg
|
||||
name = options.newname
|
||||
if options.set:
|
||||
tset = cset.unique_set(options.set)
|
||||
elif len(args) > 0:
|
||||
tset = cset.unique_set(args[0])
|
||||
else:
|
||||
raise CpusetException('desired cpuset not specified')
|
||||
path = tset.path[0:tset.path.rfind('/')+1]
|
||||
log.debug('target set="%s", path="%s", name="%s"', tset.path, path, name)
|
||||
try:
|
||||
if name.find('/') == -1:
|
||||
chk = cset.unique_set(path+name)
|
||||
else:
|
||||
if name[0:name.rfind('/')+1] != path:
|
||||
raise CpusetException('desired name cannot have different path')
|
||||
chk = cset.unique_set(name)
|
||||
raise CpusetException('cpuset "'+chk.path+'" already exists')
|
||||
except CpusetNotFound:
|
||||
pass
|
||||
except:
|
||||
raise
|
||||
|
||||
if name.rfind('/') != -1:
|
||||
name = name[name.rfind('/')+1:]
|
||||
log.info('--> renaming "%s" to "%s"', cset.CpuSet.basepath+tset.path, name)
|
||||
os.rename(cset.CpuSet.basepath+tset.path, cset.CpuSet.basepath+path+name)
|
||||
cset.rescan()
|
||||
|
||||
def create_from_options(options, args):
|
||||
"""create cpuset as specified by options and args lists"""
|
||||
log.debug('entering create_from_options, options=%s args=%s', options, args)
|
||||
# figure out target cpuset name, if --set not used, use first arg
|
||||
if options.set:
|
||||
tset = options.set
|
||||
elif len(args) > 0:
|
||||
tset = args[0]
|
||||
else:
|
||||
raise CpusetException('cpuset not specified')
|
||||
cspec = None
|
||||
mspec = None
|
||||
cx = None
|
||||
mx = None
|
||||
if options.cpu:
|
||||
cset.cpuspec_check(options.cpu)
|
||||
cspec = options.cpu
|
||||
if options.mem:
|
||||
cset.memspec_check(options.mem)
|
||||
mspec = options.mem
|
||||
if options.cpu_exclusive: cx = options.cpu_exclusive
|
||||
if options.mem_exclusive: mx = options.mem_exclusive
|
||||
try:
|
||||
create(tset, cspec, mspec, cx, mx)
|
||||
if not mspec: modify(tset, memspec='0') # always need at least this
|
||||
log.info('--> created cpuset "%s"', tset)
|
||||
except CpusetExists:
|
||||
modify(tset, cspec, mspec, cx, mx)
|
||||
log.info('--> modified cpuset "%s"', tset)
|
||||
active(tset)
|
||||
|
||||
def create(name, cpuspec, memspec, cx, mx):
|
||||
"""create one cpuset by name, cpuspec, memspec, cpu and mem exclusive flags"""
|
||||
log.debug('entering create, name=%s cpuspec=%s memspec=%s cx=%s mx=%s',
|
||||
name, cpuspec, memspec, cx, mx)
|
||||
try:
|
||||
cset.unique_set(name)
|
||||
except CpusetNotFound:
|
||||
pass
|
||||
except:
|
||||
raise CpusetException('cpuset "%s" not unique, please specify by path' % name)
|
||||
else:
|
||||
raise CpusetExists('attempt to create already existing set: "%s"' % name)
|
||||
# FIXME: check if name is a path here
|
||||
os.mkdir(cset.CpuSet.basepath+'/'+name)
|
||||
# fixme: perhaps reparsing the all the sets is not so efficient...
|
||||
cset.rescan()
|
||||
log.debug('created new cpuset "%s"', name)
|
||||
modify(name, cpuspec, memspec, cx, mx)
|
||||
|
||||
def modify(name, cpuspec=None, memspec=None, cx=None, mx=None):
|
||||
"""modify one cpuset by name, cpuspec, memspec, cpu and mem exclusive flags"""
|
||||
log.debug('entering modify, name=%s cpuspec=%s memspec=%s cx=%s mx=%s',
|
||||
name, cpuspec, memspec, cx, mx)
|
||||
if isinstance(name, str):
|
||||
nset = cset.unique_set(name)
|
||||
elif not isinstance(name, cset.CpuSet):
|
||||
raise CpusetException(
|
||||
"passed name=%s, which is not a string or CpuSet" % name)
|
||||
else:
|
||||
nset = name
|
||||
log.debug('modifying cpuset "%s"', nset.name)
|
||||
if cpuspec: nset.cpus = cpuspec
|
||||
if memspec: nset.mems = memspec
|
||||
if cx: nset.cpu_exclusive = cx
|
||||
if mx: nset.mem_exclusive = mx
|
||||
|
||||
def active(name):
|
||||
"""check that cpuset by name or cset is ready to be used"""
|
||||
log.debug("entering active, name=%s", name)
|
||||
if isinstance(name, str):
|
||||
set = cset.unique_set(name)
|
||||
elif not isinstance(name, cset.CpuSet):
|
||||
raise CpusetException("passing bogus name=%s" % name)
|
||||
else:
|
||||
set = name
|
||||
if set.cpus == '':
|
||||
raise CpusetException('"%s" cpuset not active, no cpus defined' % set.path)
|
||||
if set.mems == '':
|
||||
raise CpusetException('"%s" cpuset not active, no mems defined' % set.path)
|
||||
|
||||
def set_header(indent=None):
|
||||
"""return list of cpuset output header"""
|
||||
if indent: istr = indent
|
||||
else: istr = ''
|
||||
l = []
|
||||
# '123456789-123456789-123456789-123456789-123456789-123456789-'
|
||||
l.append(istr + ' Name CPUs-X MEMs-X Tasks Subs Path')
|
||||
l.append(istr + '------------ ---------- - ------- - ----- ---- ----------')
|
||||
return l
|
||||
|
||||
def set_details(name, indent=None, width=None, usehex=False):
|
||||
"""return string of cpuset details"""
|
||||
if width == None: width = 0
|
||||
if isinstance(name, str):
|
||||
set = cset.unique_set(name)
|
||||
elif not isinstance(name, cset.CpuSet):
|
||||
raise CpusetException("passing bogus set=%s" % name)
|
||||
else:
|
||||
set = name
|
||||
|
||||
l = []
|
||||
l.append(set.name.rjust(12))
|
||||
cs = set.cpus
|
||||
if cs == '': cs = '*****'
|
||||
elif usehex: cs = cset.cpuspec_to_hex(cs)
|
||||
l.append(cs.rjust(10))
|
||||
if set.cpu_exclusive:
|
||||
l.append('y')
|
||||
else:
|
||||
l.append('n')
|
||||
cs = set.mems
|
||||
if cs == '': cs = '*****'
|
||||
elif usehex: cs = cset.cpuspec_to_hex(cs)
|
||||
l.append(cs.rjust(7))
|
||||
if set.mem_exclusive:
|
||||
l.append('y')
|
||||
else:
|
||||
l.append('n')
|
||||
l.append(str(len(set.tasks)).rjust(5))
|
||||
l.append(str(len(set.subsets)).rjust(4))
|
||||
|
||||
if config.mread:
|
||||
l.append(set.path)
|
||||
l2 = []
|
||||
for line in l:
|
||||
l2.append(line.strip())
|
||||
return ';'.join(l2)
|
||||
|
||||
out = ' '.join(l) + ' '
|
||||
tst = out + set.path
|
||||
|
||||
if width != 0 and len(tst) > width:
|
||||
target = width - len(out)
|
||||
patha = set.path[:len(set.path)//2-3]
|
||||
pathb = set.path[len(set.path//2):]
|
||||
patha = patha[:target//2-3]
|
||||
pathb = pathb[-target//2:]
|
||||
out += patha + '...' + pathb
|
||||
else:
|
||||
out = tst
|
||||
|
||||
if indent: istr = indent
|
||||
else: istr = ''
|
||||
return istr + out
|
@ -1,469 +0,0 @@
|
||||
"""Shield supercommand
|
||||
"""
|
||||
|
||||
from builtins import str
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Copyright (C) 2013-2017 SUSE
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
import sys, os, logging
|
||||
from optparse import OptionParser, make_option
|
||||
|
||||
from cpuset.commands.common import *
|
||||
from cpuset.commands import proc
|
||||
from cpuset.commands import set
|
||||
from cpuset import cset
|
||||
from cpuset.util import *
|
||||
from cpuset import config
|
||||
|
||||
global log
|
||||
log = logging.getLogger('shield')
|
||||
|
||||
help = 'supercommand to set up and manage basic shielding'
|
||||
usage = """%prog [options] [path/program]
|
||||
|
||||
This is a supercommand that creates basic cpu shielding. The
|
||||
normal cset commands can of course be used to create this basic
|
||||
shield, but the shield command combines many such commands to
|
||||
create and manage a common type of cpu shielding setup.
|
||||
|
||||
The concept of shielding implies at minimum three cpusets, for
|
||||
example: root, user and system. The root cpuset always exists in
|
||||
all implementations of cpusets and contains all available CPUs on
|
||||
the machine. The system cpuset is so named because normal system
|
||||
tasks are made to run on it. The user cpuset is so named because
|
||||
that is the "shielded" cpuset on which you would run your tasks
|
||||
of interest.
|
||||
|
||||
Usually, CPU zero would be in the system set and the rest of the
|
||||
CPUs would be in the user set. After creation of the cpusets,
|
||||
all processes running in the root cpuset are moved to the system
|
||||
cpuset. Thus any new processes or threads spawned from these
|
||||
processes will also run the system cpuset.
|
||||
|
||||
If the optional --kthread=on option is given to the shield
|
||||
command, then all kernel threads (with exception of the per-CPU
|
||||
bound interrupt kernel threads) are also moved to the system set.
|
||||
|
||||
One executes processes on the shielded user cpuset with the
|
||||
--exec subcommand or moves processes or threads to the shielded
|
||||
cpuset with the --shield subcommand. Note that you do not need to
|
||||
specify which cpuset a process or thread is running in initially
|
||||
when using the --shield subcommand.
|
||||
|
||||
To create a shield, you would execute the shield command with the
|
||||
--cpu option that specifies CPUSPEC argument that assigns CPUs to
|
||||
be under the shield (this means assigned to the user cpuset, all
|
||||
other cpus will be assigned to the system set).
|
||||
|
||||
For example:
|
||||
# cset shield --cpu=3
|
||||
On a 4-way machine, this command will dedicate the first
|
||||
3 processors, CPU0-CPU2, for the system set (unshielded)
|
||||
and only the last processor, CPU3, for the user set
|
||||
(shielded).
|
||||
|
||||
The CPUSPEC will accept a comma separated list of CPUs and
|
||||
inclusive range specifications. For example, --cpu=1,3,5-7 will
|
||||
assign CPU1, CPU3, CPU5, CPU6, and CPU7 to the user (or shielded)
|
||||
cpuset.
|
||||
|
||||
If you do not like the names "system" and "user" for the
|
||||
unshielded and shielded sets respectively, or if those names are
|
||||
used already, then use the --sysset and --userset options.
|
||||
|
||||
For example:
|
||||
|
||||
# cset shield --sysset=free --userset=cage --cpu=2,3 --kthread=on
|
||||
|
||||
The above command will use the name "free" for the unshielded
|
||||
system cpuset, the name "cage" for the shielded user cpuset,
|
||||
initialize these cpusets and dedicate CPU0 and CPU1 to the "free"
|
||||
set and (on a 4-way machine) dedicate CPU2 and CPU3 to the "cage"
|
||||
set. Further, the command moves all processes and threads,
|
||||
including kernel threads from the root cpuset to the "free"
|
||||
cpuset. Note however that if you do use the --syset/--userset
|
||||
options, then you must continue to use those for every invocation
|
||||
of the shield supercommand.
|
||||
|
||||
After initialization, you can run the process of interest on the
|
||||
shielded cpuset with the --exec subcommand, or move processes or
|
||||
threads already running to the shielded cpuset with the --shield
|
||||
subcommand.
|
||||
|
||||
The PIDSPEC argument taken for the --pid (or -p) option (used in
|
||||
conjunction with a --shield or --unshield command) is a comma
|
||||
separated list of PIDs or TIDs. The list can also include
|
||||
brackets of PIDs or TIDs that are inclusive of the endpoints.
|
||||
|
||||
For example:
|
||||
1,2,5 Means processes 1, 2 and 5
|
||||
1,2,600-700 Means processes 1, 2 and from 600 to 700
|
||||
|
||||
# cset shield --shield --pid=50-65
|
||||
This command moves all processes and threads with PID or
|
||||
TID in the range 50-65 inclusive, from any cpuset they may
|
||||
be running in into the shielded user cpuset.
|
||||
|
||||
Note that the range of PIDs or TIDs does not need to have every
|
||||
position populated. In other words, for the example above, if
|
||||
there is only one process, say PID 57, in the range of 50-65,
|
||||
then only that process will be moved.
|
||||
|
||||
The --unshield (or -u) subcommand will remove the specified
|
||||
processes or threads from the shielded cpuset and move them into
|
||||
the unshielded (or system) cpuset. This option is use with a
|
||||
--pid and a PIDSPEC argument, the same as for the --shield
|
||||
subcommand.
|
||||
|
||||
Both the --shield and the --unshield commands will also finally
|
||||
output the number of tasks running in the shield and out of the
|
||||
shield if you do not specify a PIDSPEC with -p. By specifying
|
||||
also a --verbose in addition, then you will get a listing of
|
||||
every task that is running in either the shield or out of the
|
||||
shield.
|
||||
|
||||
Using no subcommand, ie. only "cset shield", will output the
|
||||
status of both shield and non-shield. Tasks will be listed if
|
||||
--verbose is used.
|
||||
|
||||
You can adjust which CPUs are in the shielded cpuset by issuing
|
||||
the --cpu subcommand again anytime after the shield has been
|
||||
initialized.
|
||||
|
||||
For example if the original shield contained CPU0 and CPU1 in the
|
||||
system set and CPU2 and CPU3 in the user set, if you then issue
|
||||
the following command:
|
||||
|
||||
# cset shield --cpu=1,2,3
|
||||
|
||||
then that command will move CPU1 into the shielded "user" cpuset.
|
||||
Any processes or threads that were running on CPU1 that belonged
|
||||
to the unshielded "system" cpuset are migrated to CPU0 by the
|
||||
system.
|
||||
|
||||
The --reset subcommand will in essence destroy the shield. For
|
||||
example, if there was a shield on a 4-way machine with CPU0 in
|
||||
system and CPUs 1-3 in user with processes running on the user
|
||||
cpuset (i.e. in the shield), and a --reset subcommand was issued,
|
||||
then all processes running in both system and user cpusets would
|
||||
be migrated to the root cpuset (which has access to all CPUs and
|
||||
never goes away), after which both system and user cpusets would
|
||||
be destroyed.
|
||||
|
||||
Note that even though you can mix general usage of cpusets with
|
||||
the shielding concepts described here, you generally will not
|
||||
want to. For more complex shielding or usage scenarios, one
|
||||
would generally use the normal cpuset commands (i.e. cset set
|
||||
and proc) directly."""
|
||||
|
||||
USR_SET = '/user'
|
||||
SYS_SET = '/system'
|
||||
verbose = 0
|
||||
|
||||
options = [make_option('-c', '--cpu',
|
||||
metavar = 'CPUSPEC',
|
||||
help = 'modifies or initializes the shield cpusets'),
|
||||
make_option('-r', '--reset',
|
||||
help = 'destroys the shield',
|
||||
action = 'store_true'),
|
||||
make_option('-e', '--exec',
|
||||
help = 'executes args in the shield',
|
||||
dest = 'exc',
|
||||
action = 'store_true'),
|
||||
make_option('--user',
|
||||
help = 'use this USER for --exec (id or name)'),
|
||||
make_option('--group',
|
||||
help = 'use this GROUP for --exec (id or name)'),
|
||||
make_option('-s', '--shield',
|
||||
help = 'shield specified PIDSPEC of processes or threads',
|
||||
action = 'store_true'),
|
||||
make_option('-u', '--unshield',
|
||||
help = 'remove specified PIDSPEC of processes or threads from shield',
|
||||
action = 'store_true'),
|
||||
make_option('-p', '--pid',
|
||||
metavar = 'PIDSPEC',
|
||||
help = 'specify pid or tid specification for shield/unshield'),
|
||||
make_option("--threads",
|
||||
help = 'if specified, any processes found in the PIDSPEC to have '
|
||||
'multiple threads will automatically have all their threads '
|
||||
'added to the PIDSPEC; use to affect all related threads',
|
||||
action = 'store_true'),
|
||||
make_option('-k', '--kthread',
|
||||
metavar = 'on|off',
|
||||
choices = ['on', 'off'],
|
||||
help = 'shield from unbound interrupt threads as well'),
|
||||
make_option('-f', '--force',
|
||||
help = 'force operation, use with care',
|
||||
action = 'store_true'),
|
||||
make_option('-v', '--verbose',
|
||||
help = 'prints more detailed output, additive',
|
||||
action = 'count'),
|
||||
make_option('--sysset',
|
||||
help = 'optionally specify system cpuset name'),
|
||||
make_option('--userset',
|
||||
help = 'optionally specify user cpuset name')
|
||||
]
|
||||
|
||||
def func(parser, options, args):
|
||||
log.debug("entering shield, options=%s, args=%s", options, args)
|
||||
global verbose
|
||||
if options.verbose: verbose = options.verbose
|
||||
cset.rescan()
|
||||
|
||||
if options.sysset:
|
||||
global SYS_SET
|
||||
SYS_SET = options.sysset
|
||||
if options.userset:
|
||||
global USR_SET
|
||||
USR_SET = options.userset
|
||||
|
||||
if (not options.cpu and not options.reset and not options.exc and
|
||||
not options.shield and not options.unshield and not options.kthread):
|
||||
shield_exists()
|
||||
doshield = False
|
||||
if len(args) == 0:
|
||||
log.info("--> shielding system active with")
|
||||
print_all_stats()
|
||||
else:
|
||||
# shortcut: first assume that arg is a pidspec, if not, then exec it
|
||||
try:
|
||||
plist = proc.pidspec_to_list(args[0])
|
||||
for pid in plist: int(pid)
|
||||
doshield = True
|
||||
# ok, if we're here, then it's probably a pidspec, shield it
|
||||
except:
|
||||
exec_args(args, options.user, options.group)
|
||||
if doshield:
|
||||
# drop through to shield section below
|
||||
options.pid = args[0]
|
||||
options.shield = True
|
||||
else:
|
||||
return
|
||||
|
||||
if options.reset:
|
||||
reset_shield()
|
||||
return
|
||||
|
||||
if options.cpu:
|
||||
make_shield(options.cpu, options.kthread)
|
||||
return
|
||||
|
||||
if options.kthread:
|
||||
make_kthread(options.kthread)
|
||||
return
|
||||
|
||||
if options.exc:
|
||||
exec_args(args, options.user, options.group)
|
||||
# exec_args does not return...
|
||||
|
||||
if options.shield or options.unshield:
|
||||
shield_exists()
|
||||
if options.shield:
|
||||
smsg = 'shielding'
|
||||
to_set = USR_SET
|
||||
from_set = SYS_SET
|
||||
print_stats = print_usr_stats
|
||||
else:
|
||||
smsg = 'unshielding'
|
||||
to_set = SYS_SET
|
||||
from_set = USR_SET
|
||||
print_stats = print_sys_stats
|
||||
if options.pid == None:
|
||||
if len(args) > 0:
|
||||
# shortcut, assumes arg[0] is a pidspec
|
||||
options.pid = args[0]
|
||||
else:
|
||||
# no pidspec so output shield state
|
||||
print_stats()
|
||||
if options.pid:
|
||||
if options.threads: tmsg = '(with threads)'
|
||||
else: tmsg = ''
|
||||
log.info('--> %s following pidspec: %s %s', smsg, options.pid, tmsg)
|
||||
if options.force:
|
||||
proc.move_pidspec(options.pid, to_set, None, options.threads)
|
||||
else:
|
||||
try:
|
||||
proc.move_pidspec(options.pid, to_set, from_set, options.threads)
|
||||
except CpusetException as err:
|
||||
if str(err).find('do not match all criteria') != -1:
|
||||
log.info("--> hint: perhaps use --force if sure of command")
|
||||
raise
|
||||
log.info('done')
|
||||
return
|
||||
|
||||
def print_all_stats():
|
||||
print_sys_stats()
|
||||
print_usr_stats()
|
||||
|
||||
def print_sys_stats():
|
||||
if verbose and len(cset.unique_set(SYS_SET).tasks) > 0:
|
||||
if verbose == 1:
|
||||
proc.log_detailed_task_table(cset.unique_set(SYS_SET), ' ', 76)
|
||||
else:
|
||||
proc.log_detailed_task_table(cset.unique_set(SYS_SET), ' ')
|
||||
else:
|
||||
if config.mread:
|
||||
str = SYS_SET
|
||||
if str[0] == '/': str = str[1:]
|
||||
log.info('proc_list_no_tasks-' + str)
|
||||
else:
|
||||
log.info(cset.summary(cset.unique_set(SYS_SET)))
|
||||
|
||||
def print_usr_stats():
|
||||
if verbose and len(cset.unique_set(USR_SET).tasks) > 0:
|
||||
if verbose == 1:
|
||||
proc.log_detailed_task_table(cset.unique_set(USR_SET), ' ', 76)
|
||||
else:
|
||||
proc.log_detailed_task_table(cset.unique_set(USR_SET), ' ')
|
||||
else:
|
||||
if config.mread:
|
||||
str = USR_SET
|
||||
if str[0] == '/': str = str[1:]
|
||||
log.info('proc_list_no_tasks-' + str)
|
||||
else:
|
||||
log.info(cset.summary(cset.unique_set(USR_SET)))
|
||||
|
||||
def shield_exists():
|
||||
try:
|
||||
cset.unique_set(USR_SET)
|
||||
cset.unique_set(SYS_SET)
|
||||
return True
|
||||
except CpusetNotFound:
|
||||
log.debug('can\'t find "%s" and "%s" cpusets on system...', SYS_SET, USR_SET)
|
||||
raise CpusetException('shielding not active on system')
|
||||
|
||||
def reset_shield():
|
||||
log.info("--> deactivating/reseting shielding")
|
||||
shield_exists()
|
||||
tasks = cset.unique_set(USR_SET).tasks
|
||||
log.info('moving %s tasks from "%s" user set to root set...',
|
||||
len(tasks), USR_SET)
|
||||
proc.move(USR_SET, 'root', None, verbose)
|
||||
tasks = cset.unique_set(SYS_SET).tasks
|
||||
log.info('moving %s tasks from "%s" system set to root set...',
|
||||
len(tasks), SYS_SET)
|
||||
proc.move(SYS_SET, 'root', None, verbose)
|
||||
log.info('deleting "%s" and "%s" sets', USR_SET, SYS_SET)
|
||||
set.destroy(USR_SET)
|
||||
set.destroy(SYS_SET)
|
||||
log.info('done')
|
||||
|
||||
def make_shield(cpuspec, kthread):
|
||||
memspec = '0' # FIXME: for numa, we probably want a more intelligent scheme
|
||||
log.debug("entering make_shield, cpuspec=%s kthread=%s", cpuspec, kthread)
|
||||
# create base cpusets for shield
|
||||
cset.cpuspec_check(cpuspec)
|
||||
cpuspec_inv = cset.cpuspec_inverse(cpuspec)
|
||||
try:
|
||||
shield_exists()
|
||||
except:
|
||||
log.debug("shielding does not exist, creating")
|
||||
try:
|
||||
set.create(USR_SET, cpuspec, memspec, True, False)
|
||||
set.create(SYS_SET, cpuspec_inv, memspec, True, False)
|
||||
except Exception as instance:
|
||||
# unroll
|
||||
try: set.destroy(USR_SET)
|
||||
except: pass
|
||||
try: set.destroy(SYS_SET)
|
||||
except: pass
|
||||
log.critical('--> failed to create shield, hint: do other cpusets exist?')
|
||||
raise instance
|
||||
log.info('--> activating shielding:')
|
||||
else:
|
||||
log.debug("shielding exists, modifying cpuspec")
|
||||
# note, since we're going to modify the cpu assigments to these sets,
|
||||
# they cannot be exclusive, the following modify() calls will make
|
||||
# them exclusive again
|
||||
cset.unique_set(USR_SET).cpu_exclusive = False
|
||||
cset.unique_set(SYS_SET).cpu_exclusive = False
|
||||
set.modify(USR_SET, cpuspec, memspec, False, False)
|
||||
set.modify(SYS_SET, cpuspec_inv, memspec, False, False)
|
||||
# reset cpu exlusivity
|
||||
cset.unique_set(USR_SET).cpu_exclusive = True
|
||||
cset.unique_set(SYS_SET).cpu_exclusive = True
|
||||
log.info('--> shielding modified with:')
|
||||
# move root tasks into system set
|
||||
root_tasks = cset.unique_set('/').tasks
|
||||
log.debug("number of root tasks are: %s", len(root_tasks))
|
||||
# figure out what in root set is not a kernel thread
|
||||
tasks = []
|
||||
for task in root_tasks:
|
||||
try:
|
||||
os.readlink('/proc/'+task+'/exe')
|
||||
tasks.append(task)
|
||||
except:
|
||||
pass
|
||||
if len(tasks) != 0:
|
||||
log.info("moving %s tasks from root into system cpuset...", len(tasks))
|
||||
proc.move('root', SYS_SET, tasks, verbose)
|
||||
# move kernel theads into system set if asked for
|
||||
if kthread == 'on':
|
||||
root_tasks = cset.unique_set('/').tasks
|
||||
tasks = []
|
||||
for task in root_tasks:
|
||||
try:
|
||||
if proc.is_unbound(task): tasks.append(task)
|
||||
except:
|
||||
pass
|
||||
if len(tasks) != 0:
|
||||
log.info("kthread shield activated, moving %s tasks into system cpuset...",
|
||||
len(tasks))
|
||||
proc.move('root', SYS_SET, tasks, verbose)
|
||||
# print out stats
|
||||
print_all_stats()
|
||||
|
||||
def make_kthread(state):
|
||||
log.debug("entering make_kthread, state=%s", state)
|
||||
shield_exists()
|
||||
if state == 'on':
|
||||
log.info('--> activating kthread shielding')
|
||||
root_tasks = cset.unique_set('/').tasks
|
||||
log.debug('root set has %d tasks, checking for unbound',
|
||||
len(root_tasks))
|
||||
tasks = []
|
||||
for task in root_tasks:
|
||||
try:
|
||||
if proc.is_unbound(task): tasks.append(task)
|
||||
except:
|
||||
pass
|
||||
if len(tasks) != 0:
|
||||
log.debug("total root tasks %s", len(root_tasks))
|
||||
log.info("kthread shield activated, moving %s tasks into system cpuset...",
|
||||
len(tasks))
|
||||
proc.move('root', SYS_SET, tasks, verbose)
|
||||
else:
|
||||
log.info('--> deactivating kthread shielding')
|
||||
usr_tasks = cset.unique_set(SYS_SET).tasks
|
||||
tasks = []
|
||||
for task in usr_tasks:
|
||||
try:
|
||||
os.readlink('/proc/'+task+'/exe')
|
||||
except:
|
||||
tasks.append(task)
|
||||
if len(tasks) != 0:
|
||||
log.info("moving %s tasks into root cpuset...", len(tasks))
|
||||
proc.move(SYS_SET, '/', tasks, verbose)
|
||||
log.info('done')
|
||||
|
||||
def exec_args(args, upar, gpar):
|
||||
log.debug("entering exec_args, args=%s", args)
|
||||
shield_exists()
|
||||
proc.run(USR_SET, args, upar, gpar)
|
||||
|
@ -1,80 +0,0 @@
|
||||
""" Cpuset Configuration Module
|
||||
|
||||
The config module maintains global (class) variables of the various
|
||||
configuration parameters for the cpuset application. These are filled in from
|
||||
applicable configuration file passed as a path to the ReadConfigFile() method,
|
||||
if desired. The class variables are given default values in the module source.
|
||||
Anything found in the configuration files in the list of paths will override
|
||||
these defaults.
|
||||
"""
|
||||
from __future__ import print_function
|
||||
|
||||
from future import standard_library
|
||||
standard_library.install_aliases()
|
||||
__copyright__ = """
|
||||
Copyright (C) 2009-2010 Novell Inc.
|
||||
Copyright (C) 2013-2017 SUSE
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
import sys
|
||||
import types
|
||||
import configparser
|
||||
|
||||
############################################################################
|
||||
# Default configuration variable values
|
||||
############################################################################
|
||||
defloc = '/etc/cset.conf' # default config file location
|
||||
mread = False # machine readable output, usually set
|
||||
# via option -m/--machine
|
||||
mountpoint = '/cpusets' # cpuset filessytem mount point
|
||||
############################################################################
|
||||
|
||||
def ReadConfigFiles(path=None):
|
||||
if path == None: path = defloc
|
||||
cf = configparser.ConfigParser()
|
||||
try:
|
||||
fr = cf.read(path)
|
||||
if len(fr) == 0: return
|
||||
# can't use logging, too early...
|
||||
if len(cf.sections()) != 1:
|
||||
print("cset: warning, more than one section found in config file:", cf.sections())
|
||||
if 'default' not in cf.sections():
|
||||
print('cset: [default] section not found in config file "%s"' % path)
|
||||
sys.exit(3)
|
||||
|
||||
except configparser.MissingSectionHeaderError:
|
||||
f = open(path)
|
||||
cstr = f.read()
|
||||
f.close()
|
||||
import io
|
||||
cf.readfp(io.StringIO('[default]\n' + cstr))
|
||||
|
||||
# override our globals...
|
||||
for opt in cf.options('default'):
|
||||
typ = type(globals()[opt])
|
||||
if typ == bool:
|
||||
globals()[opt] = cf.getboolean('default', opt)
|
||||
elif typ == int:
|
||||
globals()[opt] = cf.getint('default', opt)
|
||||
else:
|
||||
globals()[opt] = cf.get('default', opt)
|
||||
|
||||
# Importing module autoinitializes it
|
||||
def __init():
|
||||
ReadConfigFiles()
|
||||
|
||||
__init()
|
@ -1,546 +0,0 @@
|
||||
"""Cpuset class and cpuset graph, importing module will create model
|
||||
"""
|
||||
from __future__ import print_function
|
||||
|
||||
import io
|
||||
from builtins import str
|
||||
from builtins import range
|
||||
from builtins import object
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Copyright (C) 2013-2017 SUSE
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
import os, re, sys, logging
|
||||
|
||||
if __name__ == '__main__':
|
||||
sys.path.insert(0, "..")
|
||||
logging.basicConfig()
|
||||
|
||||
from cpuset.util import *
|
||||
log = logging.getLogger('cset')
|
||||
RootSet = None
|
||||
|
||||
class CpuSet(object):
|
||||
# sets is a class variable dict that keeps track of all
|
||||
# cpusets discovered such that we can link them in properly.
|
||||
# The basepath is it's base path, the sets are indexed via
|
||||
# a relative path from this basepath.
|
||||
sets = {}
|
||||
basepath = ''
|
||||
cpus_path = '/cpus'
|
||||
mems_path = '/mems'
|
||||
cpu_exclusive_path = '/cpu_exclusive'
|
||||
mem_exclusive_path = '/mem_exclusive'
|
||||
tasks_path = '/tasks'
|
||||
|
||||
def __init__(self, path=None):
|
||||
log.debug("initializing CpuSet")
|
||||
if (path == None):
|
||||
# recursively find all cpusets and link together
|
||||
# note: a breadth-first search could do this in one
|
||||
# pass, but there are never many cpusets, so
|
||||
# that optimization is left for the future
|
||||
log.debug("finding all cpusets")
|
||||
path = self.locate_cpusets()
|
||||
CpuSet.basepath = path
|
||||
log.debug("creating root node at %s", path)
|
||||
self.__root = True
|
||||
self.name = 'root'
|
||||
self.path = '/'
|
||||
self.parent = self
|
||||
if (CpuSet.sets):
|
||||
del CpuSet.sets
|
||||
CpuSet.sets = {}
|
||||
CpuSet.sets[self.path] = self
|
||||
|
||||
# if mounted as a cgroup controller, switch file name format
|
||||
if not os.access(path + CpuSet.cpus_path, os.F_OK):
|
||||
CpuSet.cpus_path = '/cpuset.cpus'
|
||||
CpuSet.mems_path = '/cpuset.mems'
|
||||
CpuSet.cpu_exclusive_path = '/cpuset.cpu_exclusive'
|
||||
CpuSet.mem_exclusive_path = '/cpuset.mem_exclusive'
|
||||
|
||||
# bottom-up search otherwise links will not exist
|
||||
log.debug("starting bottom-up discovery walk...")
|
||||
for dir, dirs, files in os.walk(path, topdown=False):
|
||||
log.debug("*** walking %s", dir)
|
||||
if dir != CpuSet.basepath:
|
||||
node = CpuSet(dir)
|
||||
else:
|
||||
node = self
|
||||
node.subsets = []
|
||||
for sub in dirs:
|
||||
if len(sub) > 0:
|
||||
relpath = os.path.join(dir,sub).replace(CpuSet.basepath, '')
|
||||
else:
|
||||
relpath = '/'
|
||||
node.subsets.append(CpuSet.sets[relpath])
|
||||
log.debug("%s has %i subsets: [%s]", dir,
|
||||
len(node.subsets), '|'.join(dirs))
|
||||
|
||||
log.debug("staring top-down parenting walk...")
|
||||
for dir, dirs, files in os.walk(path):
|
||||
dir = dir.replace(CpuSet.basepath, '')
|
||||
if len(dir) == 0: dir = '/'
|
||||
node = CpuSet.sets[dir]
|
||||
log.debug("~~~ walking %s", node.path)
|
||||
if dir == '/':
|
||||
log.debug("parent is self (root cpuset), skipping")
|
||||
else:
|
||||
parpath = dir[0:dir.rfind('/')]
|
||||
log.debug('parpath decodes to: %s from dir of: %s', parpath, dir)
|
||||
if parpath in CpuSet.sets:
|
||||
log.debug("parent is %s", parpath)
|
||||
node.parent = CpuSet.sets[parpath]
|
||||
else:
|
||||
log.debug("parent is root cpuset")
|
||||
node.parent = CpuSet.sets['/']
|
||||
log.debug("found %i cpusets", len(CpuSet.sets))
|
||||
else:
|
||||
# one new cpuset node
|
||||
log.debug("new cpuset node absolute: %s", path)
|
||||
if len(path) > len(CpuSet.basepath):
|
||||
path = path.replace(CpuSet.basepath, '')
|
||||
else:
|
||||
path = '/'
|
||||
log.debug(" relative: %s", path)
|
||||
if path in CpuSet.sets:
|
||||
log.debug("the cpuset %s already exists, skipping", path)
|
||||
self = CpuSet.sets[path] # questionable....
|
||||
return
|
||||
cpus = CpuSet.basepath + path + CpuSet.cpus_path
|
||||
if not os.access(cpus, os.F_OK):
|
||||
# not a cpuset directory
|
||||
str = '%s is not a cpuset directory' % (CpuSet.basepath + path)
|
||||
log.error(str)
|
||||
raise CpusetException(str)
|
||||
self.__root = False
|
||||
self.read_cpuset(path)
|
||||
CpuSet.sets[path] = self
|
||||
|
||||
def locate_cpusets(self):
|
||||
log.debug("locating cpuset filesystem...")
|
||||
cpuset = re.compile(r"none (/.+) cpuset .+")
|
||||
cgroup = re.compile(r"none (/.+) cgroup .+")
|
||||
cpuset1 = re.compile(r"cpuset (/.+) cpuset .+")
|
||||
cgroup1 = re.compile(r"cgroup (/.+) cgroup .+")
|
||||
path = None
|
||||
f = io.open("/proc/mounts", encoding="ascii")
|
||||
for line in f:
|
||||
res = cpuset.search(line)
|
||||
if res:
|
||||
path = res.group(1)
|
||||
break
|
||||
res = cpuset1.search(line)
|
||||
if res:
|
||||
path = res.group(1)
|
||||
break
|
||||
else:
|
||||
if cgroup.search(line):
|
||||
groups = line.split()
|
||||
if re.search("cpuset", groups[3]):
|
||||
path = groups[1]
|
||||
break
|
||||
if cgroup1.search(line):
|
||||
groups = line.split()
|
||||
if re.search("cpuset", groups[3]):
|
||||
path = groups[1]
|
||||
break
|
||||
f.close()
|
||||
|
||||
if not path:
|
||||
# mounted cpusets not found, so mount them
|
||||
|
||||
if not os.access(config.mountpoint, os.F_OK):
|
||||
os.mkdir(config.mountpoint)
|
||||
ret = os.system("mount -t cpuset none " + config.mountpoint)
|
||||
if ret:
|
||||
raise CpusetException(
|
||||
'mount of cpuset filesystem failed, do you have permission?')
|
||||
path = config.mountpoint
|
||||
log.debug("cpusets mounted at: " + path)
|
||||
return path
|
||||
|
||||
def read_cpuset(self, path):
|
||||
log.debug("reading cpuset passed relpath: %s", path)
|
||||
self.path = path
|
||||
log.debug("...path=%s", path)
|
||||
self.name = path[path.rfind('/')+1:]
|
||||
log.debug("...name=%s", self.name)
|
||||
|
||||
# Properties of cpuset node
|
||||
def delprop(self):
|
||||
raise AttributeError("deletion of properties not allowed")
|
||||
|
||||
def getcpus(self):
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.cpus_path, encoding="ascii")
|
||||
return f.readline()[:-1]
|
||||
def setcpus(self, newval):
|
||||
cpuspec_check(newval)
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.cpus_path,'w', encoding="ascii")
|
||||
f.write(str(newval))
|
||||
f.close()
|
||||
log.debug("-> prop_set %s.cpus = %s", self.path, newval)
|
||||
cpus = property(fget=getcpus, fset=setcpus, fdel=delprop, doc="CPU specifier")
|
||||
|
||||
def getmems(self):
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.mems_path, encoding="ascii")
|
||||
return f.readline()[:-1]
|
||||
def setmems(self, newval):
|
||||
# FIXME: check format for correctness
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.mems_path,'w', encoding="ascii")
|
||||
f.write(str(newval))
|
||||
f.close()
|
||||
log.debug("-> prop_set %s.mems = %s", self.path, newval)
|
||||
mems = property(getmems, setmems, delprop, "Mem node specifier")
|
||||
|
||||
def getcpuxlsv(self):
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.cpu_exclusive_path, encoding="ascii")
|
||||
if f.readline()[:-1] == '1':
|
||||
return True
|
||||
else:
|
||||
return False
|
||||
def setcpuxlsv(self, newval):
|
||||
log.debug("-> prop_set %s.cpu_exclusive = %s", self.path, newval)
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.cpu_exclusive_path,'w', encoding="ascii")
|
||||
if newval:
|
||||
f.write('1')
|
||||
else:
|
||||
f.write('0')
|
||||
f.close()
|
||||
cpu_exclusive = property(getcpuxlsv, setcpuxlsv, delprop,
|
||||
"CPU exclusive flag")
|
||||
|
||||
def getmemxlsv(self):
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.mem_exclusive_path, encoding="ascii")
|
||||
if f.readline()[:-1] == '1':
|
||||
return True
|
||||
else:
|
||||
return False
|
||||
def setmemxlsv(self, newval):
|
||||
log.debug("-> prop_set %s.mem_exclusive = %s", self.path, newval)
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.mem_exclusive_path,'w', encoding="ascii")
|
||||
if newval:
|
||||
f.write('1')
|
||||
else:
|
||||
f.write('0')
|
||||
f.close()
|
||||
mem_exclusive = property(getmemxlsv, setmemxlsv, delprop,
|
||||
"Memory exclusive flag")
|
||||
|
||||
def gettasks(self):
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.tasks_path, encoding="ascii")
|
||||
lst = []
|
||||
for task in f: lst.append(task[:-1])
|
||||
return lst
|
||||
def settasks(self, tasklist):
|
||||
notfound = []
|
||||
unmovable = []
|
||||
if len(tasklist) > 3:
|
||||
pb = ProgressBar(len(tasklist), '=')
|
||||
tick = 0
|
||||
prog = True
|
||||
else:
|
||||
prog = False
|
||||
for task in tasklist:
|
||||
try:
|
||||
f = io.open(CpuSet.basepath+self.path+CpuSet.tasks_path,'w', encoding="ascii")
|
||||
f.write(task)
|
||||
f.close()
|
||||
except Exception as err:
|
||||
if str(err).find('No such process') != -1:
|
||||
notfound.append(task)
|
||||
elif str(err).find('Invalid argument'):
|
||||
unmovable.append(task)
|
||||
else:
|
||||
raise
|
||||
if prog:
|
||||
tick += 1
|
||||
pb.progress(tick)
|
||||
if len(notfound) > 0:
|
||||
log.info('**> %s tasks were not found, so were not moved', len(notfound))
|
||||
log.debug(' not found: %s', notfound)
|
||||
if len(unmovable) > 0:
|
||||
log.info('**> %s tasks are not movable, impossible to move', len(unmovable))
|
||||
log.debug(' not movable: %s', unmovable)
|
||||
log.debug("-> prop_set %s.tasks set with %s tasks", self.path,
|
||||
len(tasklist))
|
||||
tasks = property(gettasks, settasks, delprop, "Task list")
|
||||
|
||||
#
|
||||
# Helper functions
|
||||
#
|
||||
|
||||
def lookup_task_from_proc(pid):
|
||||
"""lookup the cpuset of the specified pid from proc filesystem"""
|
||||
log.debug("entering lookup_task_from_proc, pid = %s", str(pid))
|
||||
path = "/proc/"+str(pid)+"/cpuset"
|
||||
if os.access(path, os.F_OK):
|
||||
set = io.open(path, encoding="ascii").readline()[:-1]
|
||||
log.debug('lookup_task_from_proc: found task %s cpuset: %s', str(pid), set)
|
||||
return set
|
||||
# FIXME: add search for threads here...
|
||||
raise CpusetException("task ID %s not found, i.e. not running" % str(pid))
|
||||
|
||||
def lookup_task_from_cpusets(pid):
|
||||
"""lookup the cpuset of the specified pid from cpuset filesystem"""
|
||||
log.debug("entering lookup_task_from_cpusets, pid = %s", str(pid))
|
||||
global RootSet
|
||||
if RootSet == None: rescan()
|
||||
gotit = None
|
||||
if pid in RootSet.tasks:
|
||||
gotit = RootSet
|
||||
else:
|
||||
for node in walk_set(RootSet):
|
||||
if pid in node.tasks:
|
||||
gotit = node
|
||||
break
|
||||
if gotit:
|
||||
log.debug('lookup_task_from_cpusets: found task %s cpuset: %s', str(pid),
|
||||
gotit.path)
|
||||
return gotit.path
|
||||
raise CpusetException("task ID %s not found, i.e. not running" % str(pid))
|
||||
|
||||
def unique_set(name):
|
||||
"""find a unique cpuset by name or path, raise if multiple sets found"""
|
||||
log.debug("entering unique_set, name=%s", name)
|
||||
if name == None:
|
||||
raise CpusetException('unique_set() passed None as arg')
|
||||
if isinstance(name, CpuSet): return name
|
||||
nl = find_sets(name)
|
||||
if len(nl) > 1:
|
||||
raise CpusetNotUnique('cpuset name "%s" not unique: %s' % (name,
|
||||
[x.path for x in nl]) )
|
||||
return nl[0]
|
||||
|
||||
def find_sets(name):
|
||||
"""find cpusets by name or path, raise CpusetNotFound if not found"""
|
||||
log = logging.getLogger("cset.find_sets")
|
||||
log.debug('finding "%s" in cpusets', name)
|
||||
nodelist = []
|
||||
if name.find('/') == -1:
|
||||
log.debug("find by name")
|
||||
if name == 'root':
|
||||
log.debug("returning root set")
|
||||
nodelist.append(RootSet)
|
||||
else:
|
||||
log.debug("walking from: %s", RootSet.path)
|
||||
for node in walk_set(RootSet):
|
||||
if node.name == name:
|
||||
log.debug('... found node "%s"', name)
|
||||
nodelist.append(node)
|
||||
else:
|
||||
log.debug("find by path")
|
||||
# make sure that leading slash is used if searching by path
|
||||
if name[0] != '/': name = '/' + name
|
||||
if name in CpuSet.sets:
|
||||
log.debug('... found node "%s"', CpuSet.sets[name].name)
|
||||
nodelist.append(CpuSet.sets[name])
|
||||
if len(nodelist) == 0:
|
||||
raise CpusetNotFound('cpuset "%s" not found in cpusets' % name)
|
||||
return nodelist
|
||||
|
||||
def walk_set(set):
|
||||
""" generator for walking cpuset graph, breadth-first, more or less... """
|
||||
log = logging.getLogger("cset.walk_set")
|
||||
for node in set.subsets:
|
||||
log.debug("+++ yield %s", node.name)
|
||||
yield node
|
||||
|
||||
for node in set.subsets:
|
||||
for result in walk_set(node):
|
||||
log.debug("++++++ yield %s", node.name)
|
||||
yield result
|
||||
|
||||
def rescan():
|
||||
"""re-read the cpuset directory to sync system with data structs"""
|
||||
log.debug("entering rescan")
|
||||
global RootSet, maxcpu, allcpumask
|
||||
RootSet = CpuSet()
|
||||
# figure out system properties
|
||||
log.debug("rescan: all cpus = %s", RootSet.cpus)
|
||||
maxcpu = int(RootSet.cpus.split('-')[-1].split(',')[-1])
|
||||
log.debug(" max cpu = %s", maxcpu)
|
||||
allcpumask = calc_cpumask(maxcpu)
|
||||
log.debug(" allcpumask = %s", allcpumask)
|
||||
|
||||
def cpuspec_check(cpuspec, usemax=True):
|
||||
"""check format of cpuspec for validity"""
|
||||
log.debug("cpuspec_check(%s)", cpuspec)
|
||||
mo = re.search("[^0-9,\-]", cpuspec)
|
||||
if mo:
|
||||
str = 'CPUSPEC "%s" contains invalid charaters: %s' % (cpuspec, mo.group())
|
||||
log.debug(str)
|
||||
raise CpusetException(str)
|
||||
groups = cpuspec.split(',')
|
||||
if usemax and int(groups[-1].split('-')[-1]) > int(maxcpu):
|
||||
str = 'CPUSPEC "%s" specifies higher max(%s) than available(%s)' % \
|
||||
(cpuspec, groups[-1].split('-')[-1], maxcpu)
|
||||
log.debug(str)
|
||||
raise CpusetException(str)
|
||||
for sub in groups:
|
||||
it = sub.split('-')
|
||||
if len(it) == 2:
|
||||
if len(it[0]) == 0 or len(it[1]) == 0:
|
||||
# catches negative numbers
|
||||
raise CpusetException('CPUSPEC "%s" has bad group "%s"' % (cpuspec, sub))
|
||||
if len(it) > 2:
|
||||
raise CpusetException('CPUSPEC "%s" has bad group "%s"' % (cpuspec, sub))
|
||||
|
||||
def cpuspec_to_hex(cpuspec):
|
||||
"""convert a cpuspec to the hexadecimal string representation"""
|
||||
log.debug('cpuspec_to_string(%s)', cpuspec)
|
||||
cpuspec_check(cpuspec, usemax=False)
|
||||
groups = cpuspec.split(',')
|
||||
number = 0
|
||||
for sub in groups:
|
||||
items = sub.split('-')
|
||||
if len(items) == 1:
|
||||
if not len(items[0]):
|
||||
# two consecutive commas in cpuspec
|
||||
continue
|
||||
# one cpu in this group
|
||||
log.debug(" adding cpu %s to result", items[0])
|
||||
number |= 1 << int(items[0])
|
||||
elif len(items) == 2:
|
||||
il = [int(ii) for ii in items]
|
||||
if il[1] >= il[0]: rng = list(range(il[0], il[1]+1))
|
||||
else: rng = list(range(il[1], il[0]+1))
|
||||
log.debug(' group=%s has cpu range of %s', sub, rng)
|
||||
for num in rng: number |= 1 << num
|
||||
else:
|
||||
raise CpusetException('CPUSPEC "%s" has bad group "%s"' % (cpuspec, sub))
|
||||
log.debug(' final int number=%s in hex=%x', number, number)
|
||||
return '%x' % number
|
||||
|
||||
def memspec_check(memspec):
|
||||
"""check format of memspec for validity"""
|
||||
# FIXME: look under /sys/devices/system/node for numa memory node
|
||||
# information and check the memspec that way, currently we only do
|
||||
# a basic check
|
||||
log.debug("memspec_check(%s)", memspec)
|
||||
mo = re.search("[^0-9,\-]", memspec)
|
||||
if mo:
|
||||
str = 'MEMSPEC "%s" contains invalid charaters: %s' % (memspec, mo.group())
|
||||
log.debug(str)
|
||||
raise CpusetException(str)
|
||||
|
||||
def cpuspec_inverse(cpuspec):
|
||||
"""calculate inverse of cpu specification"""
|
||||
cpus = [0 for x in range(maxcpu+1)]
|
||||
groups = cpuspec.split(',')
|
||||
log.debug("cpuspec_inverse(%s) maxcpu=%d groups=%d",
|
||||
cpuspec, maxcpu, len(groups))
|
||||
for set in groups:
|
||||
items = set.split('-')
|
||||
if len(items) == 1:
|
||||
if not len(items[0]):
|
||||
# common error of two consecutive commas in cpuspec,
|
||||
# just ignore it and keep going
|
||||
continue
|
||||
cpus[int(items[0])] = 1
|
||||
elif len(items) == 2:
|
||||
for x in range(int(items[0]), int(items[1])+1):
|
||||
cpus[x] = 1
|
||||
else:
|
||||
raise CpusetException("cpuspec(%s) has bad group %s" % (cpuspec, set))
|
||||
log.debug("cpuspec array: %s", cpus)
|
||||
# calculate inverse of array
|
||||
for x in range(0, len(cpus)):
|
||||
if cpus[x] == 0:
|
||||
cpus[x] = 1
|
||||
else:
|
||||
cpus[x] = 0
|
||||
log.debug(" inverse: %s", cpus)
|
||||
# build cpuspec expression
|
||||
nspec = ""
|
||||
ingrp = False
|
||||
for x in range(0, len(cpus)):
|
||||
if cpus[x] == 0 and ingrp:
|
||||
nspec += str(begin)
|
||||
if x > begin+1:
|
||||
if cpus[x] == 1:
|
||||
nspec += '-' + str(x)
|
||||
else:
|
||||
nspec += '-' + str(x-1)
|
||||
ingrp = False
|
||||
if cpus[x] == 1:
|
||||
if not ingrp:
|
||||
if len(nspec): nspec += ','
|
||||
begin = x
|
||||
ingrp = True
|
||||
if x == len(cpus)-1:
|
||||
nspec += str(begin)
|
||||
if x > begin:
|
||||
nspec += '-' + str(x)
|
||||
log.debug("inverse cpuspec: %s", nspec)
|
||||
return nspec
|
||||
|
||||
def summary(set):
|
||||
"""return summary of cpuset with number of tasks running"""
|
||||
log.debug("entering summary, set=%s", set.path)
|
||||
if len(set.tasks) == 1: msg = 'task'
|
||||
else: msg = 'tasks'
|
||||
return ('"%s" cpuset of CPUSPEC(%s) with %s %s running' %
|
||||
(set.name, set.cpus, len(set.tasks), msg) )
|
||||
|
||||
def calc_cpumask(max):
|
||||
all = 1
|
||||
ii = 1
|
||||
while ii < max+1:
|
||||
all |= 1 << ii
|
||||
ii += 1
|
||||
return "%x" % all
|
||||
|
||||
|
||||
# Test if stand-alone execution
|
||||
if __name__ == '__main__':
|
||||
rescan()
|
||||
|
||||
# first create them, then find them
|
||||
try:
|
||||
os.makedirs(CpuSet.basepath+'/csettest/one/x')
|
||||
os.mkdir(CpuSet.basepath+'/csettest/one/y')
|
||||
os.makedirs(CpuSet.basepath+'/csettest/two/x')
|
||||
os.mkdir(CpuSet.basepath+'/csettest/two/y')
|
||||
except:
|
||||
pass
|
||||
|
||||
print('Max cpu on system:', maxcpu)
|
||||
print('All cpu mask: 0x%s' % allcpumask)
|
||||
|
||||
print('------- find_sets tests --------')
|
||||
print('Find by root of "root" -> ', find_sets("root"))
|
||||
print('Find by path of "/" -> ', find_sets("/"))
|
||||
|
||||
print('Find by path of "/csettest/one" -> ', find_sets("/csettest/one"))
|
||||
print('Find by name of "one" -> ', find_sets("one"))
|
||||
print('Find by path of "/csettest/two" -> ', find_sets("/csettest/two"))
|
||||
print('Find by name of "two" -> ', find_sets("two"))
|
||||
|
||||
print('Find by path of "/csettest/one/x" -> ', find_sets("/csettest/one/x"))
|
||||
print('Find by name of "x" -> ', find_sets("x"))
|
||||
print('Find by path of "/csettest/two/y" -> ', find_sets("/csettest/two/y"))
|
||||
print('Find by name of "y" -> ', find_sets("y"))
|
||||
|
||||
try:
|
||||
node = find_sets("cantfindmenoway")
|
||||
print('Found "cantfindmenoway??!? -> ', node)
|
||||
except CpusetException as err:
|
||||
print('Caught exeption for non-existant set (correctly)-> ', err)
|
||||
|
@ -1,247 +0,0 @@
|
||||
"""Front end command line tool for Linux cpusets
|
||||
"""
|
||||
from __future__ import print_function
|
||||
from __future__ import absolute_import
|
||||
|
||||
from future import standard_library
|
||||
standard_library.install_aliases()
|
||||
from builtins import str
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Copyright (C) 2013-2017 SUSE
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
import sys, os
|
||||
from optparse import OptionParser
|
||||
from cpuset import config
|
||||
import cpuset.commands
|
||||
from cpuset.commands.common import CmdException
|
||||
from cpuset.util import CpusetException
|
||||
|
||||
#
|
||||
# The commands map
|
||||
#
|
||||
class Commands(dict):
|
||||
"""Commands class. It performs on-demand module loading
|
||||
"""
|
||||
def canonical_cmd(self, key):
|
||||
"""Return the canonical name for a possibly-shortenned
|
||||
command name.
|
||||
"""
|
||||
candidates = [cmd for cmd in list(self.keys()) if cmd.startswith(key)]
|
||||
|
||||
if not candidates:
|
||||
log.error('Unknown command: %s', key)
|
||||
log.error('Try "%s help" for a list of supported commands', prog)
|
||||
sys.exit(1)
|
||||
elif len(candidates) > 1:
|
||||
log.error('Ambiguous command: %s', key)
|
||||
log.error('Candidates are: %s', ', '.join(candidates))
|
||||
sys.exit(1)
|
||||
|
||||
return candidates[0]
|
||||
|
||||
def __getitem__(self, key):
|
||||
"""Return the command python module name based.
|
||||
"""
|
||||
global prog
|
||||
|
||||
cmd_mod = self.get(key) or self.get(self.canonical_cmd(key))
|
||||
|
||||
__import__('cpuset.commands.' + cmd_mod)
|
||||
return getattr(cpuset.commands, cmd_mod)
|
||||
|
||||
commands = Commands({
|
||||
'shield': 'shield',
|
||||
'set': 'set',
|
||||
# 'mem': 'mem',
|
||||
'proc': 'proc',
|
||||
})
|
||||
|
||||
supercommands = (
|
||||
'shield',
|
||||
)
|
||||
|
||||
def _print_helpstring(cmd):
|
||||
print(' ' + cmd + ' ' * (12 - len(cmd)) + commands[cmd].help)
|
||||
|
||||
def print_help():
|
||||
print('Usage: %s [global options] <command> [command options]' % os.path.basename(sys.argv[0]))
|
||||
print()
|
||||
print('Global options:')
|
||||
print(' -l/--log <fname> output debugging log in fname')
|
||||
print(' -m/--machine print machine readable output')
|
||||
print(' -x/--tohex <CPUSPEC> convert a CPUSPEC to hex')
|
||||
print()
|
||||
print('Generic commands:')
|
||||
print(' help print the detailed command usage')
|
||||
print(' version display version information')
|
||||
print(' copyright display copyright information')
|
||||
|
||||
cmds = list(commands.keys())
|
||||
cmds.sort()
|
||||
print()
|
||||
print('Super commands (high-level and multi-function):')
|
||||
for cmd in supercommands:
|
||||
_print_helpstring(cmd)
|
||||
print()
|
||||
print('Regular commands:')
|
||||
for cmd in cmds:
|
||||
if not cmd in supercommands:
|
||||
_print_helpstring(cmd)
|
||||
|
||||
def main():
|
||||
|
||||
# handle pipes better
|
||||
import signal
|
||||
signal.signal(signal.SIGPIPE, signal.SIG_DFL)
|
||||
|
||||
global prog
|
||||
prog = os.path.basename(sys.argv[0])
|
||||
|
||||
global logfile
|
||||
logfile = None
|
||||
|
||||
if len(sys.argv) < 2:
|
||||
print('usage: %s <command>' % prog, file=sys.stderr)
|
||||
print(' Try "%s --help" for a list of supported commands' % prog, file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
# configure logging
|
||||
import logging
|
||||
console = logging.StreamHandler(sys.stdout)
|
||||
console.setLevel(logging.INFO)
|
||||
formatter = logging.Formatter(prog + ': %(message)s')
|
||||
console.setFormatter(formatter)
|
||||
logging.getLogger('').addHandler(console)
|
||||
global log
|
||||
log = logging.getLogger('')
|
||||
log.setLevel(logging.DEBUG)
|
||||
|
||||
try:
|
||||
debug_level = int(os.environ['CSET_DEBUG_LEVEL'])
|
||||
except KeyError:
|
||||
debug_level = 0
|
||||
except ValueError:
|
||||
log.error('Invalid CSET_DEBUG_LEVEL environment variable')
|
||||
sys.exit(1)
|
||||
|
||||
while True:
|
||||
if len(sys.argv) == 1:
|
||||
log.error('no arguments, nothing to do!')
|
||||
sys.exit(2)
|
||||
cmd = sys.argv[1]
|
||||
if cmd in ['-l', '--log']:
|
||||
if len(sys.argv) < 3:
|
||||
log.critical('not enough arguments')
|
||||
sys.exit(1)
|
||||
# FIXME: very fragile
|
||||
logfile = sys.argv[2]
|
||||
#trace = logging.FileHandler('/var/log/cset.log', 'w')
|
||||
trace = logging.FileHandler(logfile, 'a')
|
||||
trace.setLevel(logging.DEBUG)
|
||||
formatter = logging.Formatter('%(asctime)s %(name)-6s %(levelname)-8s %(message)s',
|
||||
'%y%m%d-%H:%M:%S')
|
||||
trace.setFormatter(formatter)
|
||||
logging.getLogger('').addHandler(trace)
|
||||
log.debug("---------- STARTING ----------")
|
||||
from cpuset.version import version
|
||||
log.debug('Cpuset (cset) %s' % version)
|
||||
del(sys.argv[2])
|
||||
del(sys.argv[1])
|
||||
continue
|
||||
if cmd in ['-h', '--help']:
|
||||
if len(sys.argv) >= 3:
|
||||
cmd = commands.canonical_cmd(sys.argv[2])
|
||||
sys.argv[2] = '--help'
|
||||
else:
|
||||
print_help()
|
||||
sys.exit(0)
|
||||
if cmd == 'help':
|
||||
if len(sys.argv) == 3 and not sys.argv[2] in ['-h', '--help']:
|
||||
cmd = commands.canonical_cmd(sys.argv[2])
|
||||
if not cmd in commands:
|
||||
log.error('help: "%s" command unknown' % cmd)
|
||||
sys.exit(1)
|
||||
|
||||
sys.argv[0] += ' %s' % cmd
|
||||
command = commands[cmd]
|
||||
parser = OptionParser(usage = command.usage,
|
||||
option_list = command.options)
|
||||
from pydoc import pager
|
||||
pager(parser.format_help())
|
||||
else:
|
||||
print_help()
|
||||
sys.exit(0)
|
||||
if cmd in ['-v', '--version', 'version']:
|
||||
from cpuset.version import version
|
||||
log.info('Cpuset (cset) %s' % version)
|
||||
sys.exit(0)
|
||||
if cmd in ['-c', 'copyright', 'copying']:
|
||||
log.info(__copyright__)
|
||||
sys.exit(0)
|
||||
if cmd in ['-m', '--machine']:
|
||||
config.mread = True
|
||||
del(sys.argv[1])
|
||||
continue
|
||||
if cmd in ['-x', '--tohex']:
|
||||
if len(sys.argv) < 3:
|
||||
log.critical('not enough arguments')
|
||||
sys.exit(1)
|
||||
cpuspec = sys.argv[2]
|
||||
from . import cset
|
||||
try:
|
||||
print(cset.cpuspec_to_hex(cpuspec))
|
||||
except (ValueError, OSError, IOError, CpusetException, CmdException) as err:
|
||||
log.critical('**> ' + str(err))
|
||||
if debug_level:
|
||||
raise
|
||||
else:
|
||||
sys.exit(2)
|
||||
sys.exit(0)
|
||||
|
||||
break
|
||||
|
||||
# re-build the command line arguments
|
||||
cmd = commands.canonical_cmd(cmd)
|
||||
sys.argv[0] += ' %s' % cmd
|
||||
del(sys.argv[1])
|
||||
log.debug('cmdline: ' + ' '.join(sys.argv))
|
||||
|
||||
try:
|
||||
# importing the cset class creates the model
|
||||
log.debug("creating cpuset model")
|
||||
import cpuset.cset
|
||||
command = commands[cmd]
|
||||
usage = command.usage.split('\n')[0].strip()
|
||||
parser = OptionParser(usage = usage, option_list = command.options)
|
||||
options, args = parser.parse_args()
|
||||
command.func(parser, options, args)
|
||||
except (ValueError, OSError, IOError, CpusetException, CmdException) as err:
|
||||
log.critical('**> ' + str(err))
|
||||
if str(err).find('Permission denied') != -1:
|
||||
log.critical('insufficient permissions, you probably need to be root')
|
||||
if str(err).find('invalid literal') != -1:
|
||||
log.critical('option not understood')
|
||||
if debug_level:
|
||||
raise
|
||||
else:
|
||||
sys.exit(2)
|
||||
except KeyboardInterrupt:
|
||||
sys.exit(1)
|
||||
|
||||
sys.exit(0)
|
@ -1,102 +0,0 @@
|
||||
"""Utility functions
|
||||
"""
|
||||
from __future__ import print_function
|
||||
|
||||
from builtins import chr
|
||||
from builtins import range
|
||||
from builtins import object
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Copyright (C) 2013-2017 SUSE
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
import sys, time
|
||||
from cpuset import config
|
||||
|
||||
class CpusetException(Exception):
|
||||
pass
|
||||
|
||||
class CpusetAbort(CpusetException):
|
||||
pass
|
||||
|
||||
class CpusetNotFound(CpusetException):
|
||||
pass
|
||||
|
||||
class CpusetNotUnique(CpusetException):
|
||||
pass
|
||||
|
||||
class CpusetExists(CpusetException):
|
||||
pass
|
||||
|
||||
# a twirling bar progress indicator
|
||||
class TwirlyBar(object):
|
||||
def __init__(self):
|
||||
import sys
|
||||
self.__dict__['__call__'] = self.tick
|
||||
self.__state = 0
|
||||
self.__bar = ('|', '/', '-', '\\')
|
||||
|
||||
def tick(self):
|
||||
if not config.mread:
|
||||
print('\b' + self.__bar[self.__state] + '\b', end=' ')
|
||||
self.__state = self.__state + 1
|
||||
if self.__state > 3: self.__state = 0
|
||||
|
||||
def fastick(self):
|
||||
for x in range(10):
|
||||
self.tick()
|
||||
time.sleep(0.04)
|
||||
|
||||
# a progress bar indicator
|
||||
class ProgressBar(object):
|
||||
def __init__(self, finalcount, progresschar=None):
|
||||
self.__dict__['__call__'] = self.progress
|
||||
self.finalcount=finalcount
|
||||
self.blockcount=0
|
||||
# Use ascii block char for progress if none passed
|
||||
if not progresschar:
|
||||
self.block=chr(178)
|
||||
else:
|
||||
self.block=progresschar
|
||||
if config.mread:
|
||||
return
|
||||
self.f=sys.stdout
|
||||
if not self.finalcount: return
|
||||
self.f.write('[')
|
||||
for i in range(50): self.f.write(' ')
|
||||
self.f.write(']%')
|
||||
for i in range(52): self.f.write('\b')
|
||||
|
||||
def progress(self, count):
|
||||
count=min(count, self.finalcount)
|
||||
|
||||
if self.finalcount:
|
||||
percentcomplete=int(round(100*count/self.finalcount))
|
||||
if percentcomplete < 1: percentcomplete=1
|
||||
else:
|
||||
percentcomplete=100
|
||||
|
||||
blockcount=percentcomplete//2
|
||||
if not config.mread:
|
||||
if blockcount > self.blockcount:
|
||||
for i in range(self.blockcount,blockcount):
|
||||
self.f.write(self.block)
|
||||
self.f.flush()
|
||||
|
||||
if percentcomplete == 100: self.f.write("]\n")
|
||||
self.blockcount=blockcount
|
||||
|
@ -1,19 +0,0 @@
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
"""
|
||||
|
||||
version = '1.6pre1'
|
@ -1,47 +0,0 @@
|
||||
#!/usr/bin/env python
|
||||
|
||||
__copyright__ = """
|
||||
Copyright (C) 2007-2010 Novell Inc.
|
||||
Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
|
||||
---------------------------------------------------------------------
|
||||
Substrate code and ideas taken from the excellent stgit 0.13, see
|
||||
https://gna.org/projects/stgit and http://www.procode.org/stgit/
|
||||
Stacked GIT is under GPL V2 or later.
|
||||
---------------------------------------------------------------------
|
||||
"""
|
||||
|
||||
import sys, os
|
||||
|
||||
# Try to detect where it is run from and set prefix and the search path.
|
||||
# It is assumed that the user installed cpuset using the --prefix= option
|
||||
prefix, bin = os.path.split(sys.path[0])
|
||||
|
||||
if bin == 'bin' and prefix != sys.prefix:
|
||||
sys.prefix = prefix
|
||||
sys.exec_prefix = prefix
|
||||
|
||||
major, minor = sys.version_info[0:2]
|
||||
local_path = [os.path.join(prefix, 'lib', 'python'),
|
||||
os.path.join(prefix, 'lib', 'python%s.%s' % (major, minor)),
|
||||
os.path.join(prefix, 'lib', 'python%s.%s' % (major, minor),
|
||||
'site-packages')]
|
||||
sys.path = local_path + sys.path
|
||||
|
||||
from cpuset.main import main
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
@ -1,168 +0,0 @@
|
||||
#!/bin/sh
|
||||
#
|
||||
# Example system startup script for setting up presistent cpusets with the
|
||||
# cset tool from package cpuset. Copy this script to /etc/init.d/cset and
|
||||
# uncomment out the commands in start() and stop() below, or add your own.
|
||||
# Based on /etc/init.d/skeleton template.
|
||||
#
|
||||
# Copyright (C) 2009 Novell, Inc.
|
||||
#
|
||||
# This library is free software; you can redistribute it and/or modify it
|
||||
# under the terms of the GNU Lesser General Public License as published by
|
||||
# the Free Software Foundation; either version 2.1 of the License, or (at
|
||||
# your option) any later version.
|
||||
#
|
||||
# This library is distributed in the hope that it will be useful, but
|
||||
# WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
# Lesser General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU Lesser General Public
|
||||
# License along with this library; if not, write to the Free Software
|
||||
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,
|
||||
# USA.
|
||||
#
|
||||
#
|
||||
# LSB compatible service control script; see http://www.linuxbase.org/spec/
|
||||
#
|
||||
# Note: This template uses functions rc_XXX defined in /etc/rc.status on
|
||||
# UnitedLinux/SUSE/Novell based Linux distributions. If you want to base your
|
||||
# script on this template and ensure that it works on non UL based LSB
|
||||
# compliant Linux distributions, you either have to provide the rc.status
|
||||
# functions from UL or change the script to work without them.
|
||||
# See skeleton.compat for a template that works with other distros as well.
|
||||
#
|
||||
### BEGIN INIT INFO
|
||||
# Provides: cset
|
||||
# Required-Start: $local_fs $remote_fs
|
||||
# Required-Stop: $local_fs
|
||||
# Default-Start: 2 3 5
|
||||
# Default-Stop: 0 1 6
|
||||
# Short-Description: Make cpuset setup persistent across boots
|
||||
# Description: Configure desired cpuset setup with the
|
||||
# cset tool for persistent cpusets across boots.
|
||||
### END INIT INFO
|
||||
#
|
||||
|
||||
# Check for missing binaries (stale symlinks should not happen)
|
||||
# Note: Special treatment of stop for LSB conformance
|
||||
CSET_BIN=/usr/bin/cset
|
||||
test -x $CSET_BIN || { echo "$CSET_BIN not installed";
|
||||
if [ "$1" = "stop" ]; then exit 0;
|
||||
else exit 5; fi; }
|
||||
|
||||
# cset variables (EDIT apropriately for your situation)
|
||||
CSET_SYSTEM=0
|
||||
CSET_USER=1-7
|
||||
|
||||
# Check for existence of cset config file and read it
|
||||
# This is not used in this example, but you can create one for
|
||||
# your setup if you wish.
|
||||
#CSET_CONFIG=/etc/sysconfig/cset
|
||||
#test -r $CSET_CONFIG || { echo "$CSET_CONFIG not existing";
|
||||
# if [ "$1" = "stop" ]; then exit 0;
|
||||
# else exit 6; fi; }
|
||||
|
||||
# Read config
|
||||
#. $CSET_CONFIG
|
||||
|
||||
# Source LSB init functions
|
||||
. /etc/rc.status
|
||||
|
||||
# Reset status of this service
|
||||
rc_reset
|
||||
|
||||
case "$1" in
|
||||
start)
|
||||
echo -n "Starting cpuset "
|
||||
|
||||
# For a simple shield, we can use the shield subcommand as follows;
|
||||
# however, for any setup more comples it is not recommended to use
|
||||
# shield, but instead to use the set and proc subcommands. The reason
|
||||
# is that the shield command has certain side effects which may complicate
|
||||
# the setup. For example, shield marks the cpusets as exclusive.
|
||||
|
||||
##
|
||||
#### Example 1: using the shield subcommand
|
||||
##
|
||||
|
||||
#$CSET_BIN shield --cpu=1-3
|
||||
|
||||
# Note that this creates CPU 0 as the general processor that runs
|
||||
# everything and all other CPUs (assuming this is a 4-CPU system) are assigned
|
||||
# to the shield. This is a typical simple shielding setup. Adjust if your
|
||||
# needs are different.
|
||||
|
||||
# For shielding kernel threads as well, use the -k switch below instead
|
||||
# of the shield command above.
|
||||
#$CSET_BIN shield --cpu=1-3 -k
|
||||
|
||||
##
|
||||
#### Example 2: using the set and proc subcommands
|
||||
##
|
||||
|
||||
# To set up the exact same with the set and proc commands, use the
|
||||
# following commands.
|
||||
|
||||
# Note that the CPUs are defined in the CSET_SYSTEM and
|
||||
# CSET_USER variables defined at the begining of this file.
|
||||
# Also you are not limited to call these cpusets "system" and
|
||||
# "user", you can call them anything, just be sure to be
|
||||
# consistent with the names in this script.
|
||||
|
||||
#$CSET_BIN set --set=system --cpu=$CSET_SYSTEM
|
||||
#$CSET_BIN set --set=user --cpu=$CSET_USER
|
||||
|
||||
# And to shield kernel threads, add the following command.
|
||||
|
||||
#$CSET_BIN proc --move --kthread --fromset=root --toset=system
|
||||
|
||||
# Remember status and be verbose
|
||||
rc_status -v
|
||||
;;
|
||||
stop)
|
||||
echo -n "Shutting down cpuset "
|
||||
|
||||
##
|
||||
#### Example 1: using the shield command
|
||||
##
|
||||
|
||||
# To turn the shield off, we use the reset switch to shield. This
|
||||
# will move all tasks to the root cpuset and then remove both user
|
||||
# and system cpusets.
|
||||
|
||||
#CSET_BIN shield --reset
|
||||
|
||||
##
|
||||
#### Example 2: using the set and proc subcommands
|
||||
##
|
||||
|
||||
# Note that we can simply remove the cpusets which will automatically
|
||||
# move the tasks in those cpusets to their parents; however, manually
|
||||
# moving tasks first gives more flexibility to more complex cpuset
|
||||
# configurations.
|
||||
|
||||
#$CSET_BIN proc --move --kthread --force --fromset=system --toset=root
|
||||
#$CSET_BIN proc --move --kthread --force --fromset=user --toset=root
|
||||
|
||||
# And now, destroy the cpusets
|
||||
|
||||
#$CSET_BIN set --set=system --destroy
|
||||
#$CSET_BIN set --set=user --destroy
|
||||
|
||||
# Remember status and be verbose
|
||||
rc_status -v
|
||||
;;
|
||||
status)
|
||||
echo -n "Checking for service cpuset "
|
||||
# This command simply shows which cpusets are set up and how many
|
||||
# tasks are running in them.
|
||||
$CSET_BIN set --recurse
|
||||
rc_status -v
|
||||
;;
|
||||
*)
|
||||
echo "Usage: $0 {start|stop|status}"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
rc_exit
|
@ -1,70 +0,0 @@
|
||||
MAN1_TXT=$(wildcard cset*.txt)
|
||||
|
||||
DOC_HTML=$(patsubst %.txt,%.html,$(MAN1_TXT) $(MAN7_TXT))
|
||||
|
||||
ARTICLES =
|
||||
# with their own formatting rules.
|
||||
SP_ARTICLES = tutorial
|
||||
|
||||
DOC_HTML += $(patsubst %,%.html,$(ARTICLES) $(SP_ARTICLES))
|
||||
DOC_PDF += $(patsubst %,%.pdf,$(ARTICLES) $(SP_ARTICLES))
|
||||
|
||||
DOC_MAN1=$(patsubst %.txt,%.1,$(MAN1_TXT))
|
||||
DOC_MAN7=$(patsubst %.txt,%.7,$(MAN7_TXT))
|
||||
|
||||
prefix?=$(HOME)/man
|
||||
mandir?=$(prefix)
|
||||
man1dir=$(mandir)/man1
|
||||
# DESTDIR=
|
||||
|
||||
ASCIIDOC=asciidoc --unsafe
|
||||
ASCIIDOC_EXTRA =
|
||||
INSTALL?=install
|
||||
|
||||
#
|
||||
# Please note that there is a minor bug in asciidoc.
|
||||
# The version after 6.0.3 _will_ include the patch found here:
|
||||
# http://marc.theaimsgroup.com/?l=git&m=111558757202243&w=2
|
||||
#
|
||||
# Until that version is released you may have to apply the patch
|
||||
# yourself - yes, all 6 characters of it!
|
||||
#
|
||||
|
||||
all: html man
|
||||
|
||||
html: $(DOC_HTML)
|
||||
pdf: $(DOC_PDF)
|
||||
|
||||
$(DOC_HTML) $(DOC_MAN1) $(DOC_MAN7): asciidoc.conf
|
||||
|
||||
man: man1
|
||||
man1: $(DOC_MAN1)
|
||||
|
||||
install: man
|
||||
$(INSTALL) -d -m755 $(DESTDIR)$(man1dir)
|
||||
$(INSTALL) -m644 $(DOC_MAN1) $(DESTDIR)$(man1dir)
|
||||
cd $(DESTDIR)$(man1dir); gzip *.1
|
||||
|
||||
-include doc.dep
|
||||
|
||||
clean:
|
||||
rm -f *.xml *.pdf doc.dep
|
||||
#rm -f *.xml *.html *.pdf *.1 *.7 doc.dep
|
||||
|
||||
%.html : %.txt
|
||||
$(ASCIIDOC) -b xhtml11 -d manpage -f asciidoc.conf $(ASCIIDOC_EXTRA) $<
|
||||
|
||||
%.1 %.7 : %.xml
|
||||
xmlto -m callouts.xsl man $<
|
||||
|
||||
%.xml : %.txt
|
||||
$(ASCIIDOC) -b docbook -d manpage -f asciidoc.conf $<
|
||||
|
||||
%.pdf: %.xml
|
||||
xmlto pdf $<
|
||||
|
||||
#special formatting rules
|
||||
tutorial.html : %.html : %.txt
|
||||
$(ASCIIDOC) -b xhtml11 -d article -f tutorial.conf -a toc -a numbered -a toclevels=4 $(ASCIIDOC_EXTRA) $<
|
||||
tutorial.xml : %.xml : %.txt
|
||||
$(ASCIIDOC) -b docbook -d article -f tutorial.conf $<
|
@ -1,59 +0,0 @@
|
||||
## csetlink: macro
|
||||
#
|
||||
# Usage: csetlink:command[manpage-section]
|
||||
#
|
||||
# Note, {0} is the manpage section, while {target} is the command.
|
||||
#
|
||||
# Show cset link as: <command>(<section>); if section is defined, else just show
|
||||
# the command.
|
||||
|
||||
[attributes]
|
||||
caret=^
|
||||
startsb=[
|
||||
endsb=]
|
||||
tilde=~
|
||||
|
||||
ifdef::backend-docbook[]
|
||||
[manlink-inlinemacro]
|
||||
{0%{target}}
|
||||
{0#<citerefentry>}
|
||||
{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
|
||||
{0#</citerefentry>}
|
||||
endif::backend-docbook[]
|
||||
|
||||
ifdef::backend-docbook[]
|
||||
# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
|
||||
[listingblock]
|
||||
<example><title>{title}</title>
|
||||
<literallayout>
|
||||
|
|
||||
</literallayout>
|
||||
{title#}</example>
|
||||
endif::backend-docbook[]
|
||||
|
||||
ifdef::backend-xhtml11[]
|
||||
[manlink-inlinemacro]
|
||||
<a href="{target}.html">{target}{0?({0})}</a>
|
||||
endif::backend-xhtml11[]
|
||||
|
||||
# csetlink
|
||||
|
||||
ifdef::backend-docbook[]
|
||||
[csetlink-inlinemacro]
|
||||
<citerefentry>
|
||||
<refentrytitle>cset-{target}</refentrytitle><manvolnum>1</manvolnum>
|
||||
</citerefentry>
|
||||
endif::backend-docbook[]
|
||||
|
||||
ifdef::backend-xhtml11[]
|
||||
[csetlink-inlinemacro]
|
||||
<a href="cset-{target}.html">cset {target}(1)</a>
|
||||
endif::backend-xhtml11[]
|
||||
|
||||
# csetdesc
|
||||
[csetdesc-inlinemacro]
|
||||
{sys:../cset help|grep " {target}" | tr -s ' '| cut -d' ' -f3-}
|
||||
|
||||
[csetdesc-blockmacro]
|
||||
csetlink:{target}[]::
|
||||
csetdesc:{target}[]
|
@ -1,30 +0,0 @@
|
||||
<!-- callout.xsl: converts asciidoc callouts to man page format -->
|
||||
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
|
||||
<xsl:template match="co">
|
||||
<xsl:value-of select="concat('\fB(',substring-after(@id,'-'),')\fR')"/>
|
||||
</xsl:template>
|
||||
<xsl:template match="calloutlist">
|
||||
<xsl:text>.sp </xsl:text>
|
||||
<xsl:apply-templates/>
|
||||
<xsl:text> </xsl:text>
|
||||
</xsl:template>
|
||||
<xsl:template match="callout">
|
||||
<xsl:value-of select="concat('\fB',substring-after(@arearefs,'-'),'. \fR')"/>
|
||||
<xsl:apply-templates/>
|
||||
<xsl:text>.br </xsl:text>
|
||||
</xsl:template>
|
||||
|
||||
<!-- sorry, this is not about callouts, but attempts to work around
|
||||
spurious .sp at the tail of the line docbook stylesheets seem to add -->
|
||||
<xsl:template match="simpara">
|
||||
<xsl:variable name="content">
|
||||
<xsl:apply-templates/>
|
||||
</xsl:variable>
|
||||
<xsl:value-of select="normalize-space($content)"/>
|
||||
<xsl:if test="not(ancestor::authorblurb) and
|
||||
not(ancestor::personblurb)">
|
||||
<xsl:text> </xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:template>
|
||||
|
||||
</xsl:stylesheet>
|
@ -1,286 +0,0 @@
|
||||
'\" t
|
||||
.\" Title: cset-proc
|
||||
.\" Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||
.\" Date: March 2016
|
||||
.\" Manual: \ \&
|
||||
.\" Source: \ \& 1.5.8
|
||||
.\" Language: English
|
||||
.\"
|
||||
.TH "CSET\-PROC" "1" "March 2016" "\ \& 1\&.5\&.8" "\ \&"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "NAME"
|
||||
cset-proc \- manage processes running in cpusets
|
||||
.SH "SYNOPSIS"
|
||||
.sp
|
||||
.nf
|
||||
\fIcset\fR [cset options] \fIproc\fR [proc options] [args]
|
||||
\fIcset\fR proc \-\-help
|
||||
\fIcset\fR proc
|
||||
\fIcset\fR proc my_set my_other_set
|
||||
\fIcset\fR proc \-\-list \-\-set my_set
|
||||
\fIcset\fR proc \-\-exec my_set /opt/software/my_code \-\-my_opt_1
|
||||
\fIcset\fR proc \-\-set my_set \-\-exec /opt/software/my_code \-\-my_opt_1
|
||||
\fIcset\fR proc \-\-move 2442,3000\-3200 my_set
|
||||
\fIcset\fR proc \-\-move \-\-pid=2442,3000\-3200 \-\-toset=my_set
|
||||
\fIcset\fR proc \-\-move \-\-fromset=my_set_1 \-\-toset=my_set_2
|
||||
\fIcset\fR proc \-\-move \-\-pid=42 \-\-fromset=/group1/myset \-\-toset=/group2/yourset
|
||||
.fi
|
||||
.SH "OPTIONS"
|
||||
.PP
|
||||
\-h, \-\-help
|
||||
.RS 4
|
||||
prints the list of options for this command
|
||||
.RE
|
||||
.PP
|
||||
\-l, \-\-list
|
||||
.RS 4
|
||||
list processes in the specified cpuset
|
||||
.RE
|
||||
.PP
|
||||
\-e, \-\-exec
|
||||
.RS 4
|
||||
execute arguments in the specified cpuset
|
||||
.RE
|
||||
.PP
|
||||
\-u USER, \-\-user=USER
|
||||
.RS 4
|
||||
use this USER to \-\-exec (id or name)
|
||||
.RE
|
||||
.PP
|
||||
\-g GROUP, \-\-group=GROUP
|
||||
.RS 4
|
||||
use this GROUP to \-\-exec (id or name)
|
||||
.RE
|
||||
.PP
|
||||
\-m, \-\-move
|
||||
.RS 4
|
||||
move specified tasks to specified cpuset; to move a PIDSPEC to a cpuset, use \-m PIDSPEC cpuset; to move all tasks specify \-\-fromset and \-\-toset
|
||||
.RE
|
||||
.PP
|
||||
\-p PIDSPEC, \-\-pid=PIDSPEC
|
||||
.RS 4
|
||||
specify pid or tid specification
|
||||
.RE
|
||||
.PP
|
||||
\-\-threads
|
||||
.RS 4
|
||||
if specified, any processes found in the PIDSPEC to have multiple threads will automatically have all their threads added to the PIDSPEC (use to move all related threads to a cpuset)
|
||||
.RE
|
||||
.PP
|
||||
\-s CPUSET, \-\-set=CPUSET
|
||||
.RS 4
|
||||
specify name of immediate cpuset
|
||||
.RE
|
||||
.PP
|
||||
\-t TOSET, \-\-toset=TOSET
|
||||
.RS 4
|
||||
specify name of destination cpuset
|
||||
.RE
|
||||
.PP
|
||||
\-f FROMSET, \-\-fromset=FROMSET
|
||||
.RS 4
|
||||
specify name of origination cpuset
|
||||
.RE
|
||||
.PP
|
||||
\-k, \-\-kthread
|
||||
.RS 4
|
||||
move, or include moving, unbound kernel threads
|
||||
.RE
|
||||
.PP
|
||||
\-\-force
|
||||
.RS 4
|
||||
force all processes and threads to be moved
|
||||
.RE
|
||||
.PP
|
||||
\-v, \-\-verbose
|
||||
.RS 4
|
||||
prints more detailed output, additive
|
||||
.RE
|
||||
.SH "DESCRIPTION"
|
||||
This command is used to run and manage arbitrary processes on specified cpusets\&. It is also used to move pre\-existing processes and threads to specified cpusets\&. You may note there is no "kill" or "destroy" option \(em use the standard OS ^C or kill commands for that\&.
|
||||
|
||||
To list which tasks are running in a particular cpuset, use the \-\-list command\&.
|
||||
|
||||
For example:
|
||||
|
||||
\fB# cset proc \-\-list \-\-set myset\fR
|
||||
|
||||
This command will list all the tasks running in the cpuset called "myset"\&.
|
||||
|
||||
Processes are created by specifying the path to the executable and specifying the cpuset that the process is to be created in\&.
|
||||
|
||||
For example:
|
||||
|
||||
\fB# cset proc \-\-set=blazing_cpuset \-\-exec /usr/bin/fast_code\fR
|
||||
|
||||
This command will execute the /usr/bin/fast_code program on the "blazing_cpuset" cpuset\&.
|
||||
|
||||
Note that if your command takes options, then use the traditional "\-\-" marker to separate cset\(cqs options from your command\(cqs options\&.
|
||||
|
||||
For example:
|
||||
|
||||
\fB# cset proc \-\-set myset \-\-exec \(em ls \-l\fR
|
||||
|
||||
This command will execute "ls \-l" on the cpuset called "myset"\&.
|
||||
|
||||
The PIDSPEC argument taken for the move command is a comma separated list of PIDs or TIDs\&. The list can also include brackets of PIDs or TIDs (i\&.e\&. tasks) that are inclusive of the endpoints\&.
|
||||
|
||||
For example:
|
||||
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
1,2,5 Means processes 1, 2 and 5
|
||||
1,2,600\-700 Means processes 1, 2 and from 600 to 700
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.sp
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
The range of PIDs or TIDs does not need to have every position populated\&. In other words, for the example above, if there is only one process, say PID 57, in the range of 50\-65, then only that process will be moved\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
To move a PIDSPEC to a specific cpuset, you can either specify the PIDSPEC with \-\-pid and the destination cpuset with \-\-toset, or use the short hand and list the cpuset name after the PIDSPEC for the \-\-move arguments\&.
|
||||
|
||||
The move command accepts multiple common calling methods\&. For example, the following commands are equivalent:
|
||||
|
||||
\fB# cset proc \-\-move 2442,3000\-3200 reserved_set\fR
|
||||
|
||||
\fB# cset proc \-\-move \-\-pid=2442,3000\-3200 \-\-toset=reserved_set\fR
|
||||
|
||||
These commands move the tasks defined as 2442 and any running task between 3000 and 3200 inclusive of the ends to the cpuset called "reserved_set"\&.
|
||||
|
||||
Specifying the \-\-fromset is not necessary since the tasks will be moved to the destination cpuset no matter which cpuset they are currently running on\&.
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
However, if you do specify a cpuset with the \-\-fromset option, then only those tasks that are both in the PIDSPEC \fBand\fR are running in the cpuset specified by \-\-fromset will be moved\&. I\&.e\&., if there is a task running on the system but not in \-\-fromset that is in PIDSPEC, it will not be moved\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
If the \-\-threads switch is used, then the proc command will gather any threads of belonging to any processes or threads that are specified in the PIDSPEC and move them\&. This provides an easy way to move all related threads: just pick one TID from the set and use the \-\-threads option\&.
|
||||
|
||||
To move all userspace tasks from one cpuset to another, you need to specify the source and destination cpuset by name\&.
|
||||
|
||||
For example:
|
||||
|
||||
\fB# cset proc \-\-move \-\-fromset=comp1 \-\-toset=comp42\fR
|
||||
|
||||
This command specifies that all processes and threads running on cpuset "comp1" be moved to cpuset "comp42"\&.
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
This move command will not move kernel threads unless the \-k/\-\-kthread switch is specified\&. If it is, then all unbound kernel threads will be added to the move\&. Unbound kernel threads are those that can run on any CPU\&. If you \fBalso specify\fR the \-\-force switch, then all tasks, kernel or not, bound or not, will be moved\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBCaution\fR
|
||||
.ps -1
|
||||
.br
|
||||
Please be cautious with the \-\-force switch, since moving a kernel thread that is bound to a specific CPU to a cpuset that does not include that CPU can cause a system hang\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
You must specify unique cpuset names for the both exec and move commands\&. If a simple name passed to the \-\-fromset, \-\-toset and \-\-set parameters is unique on the system then that command executes\&. However, if there are multiple cpusets by that name, then you will need to specify which one you mean with a full path rooted at the base cpuset tree\&.
|
||||
|
||||
For example, suppose you have the following cpuset tree:
|
||||
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
/cpusets
|
||||
/group1
|
||||
/myset
|
||||
/yourset
|
||||
/group2
|
||||
/myset
|
||||
/yourset
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.sp
|
||||
Then, to move a process from myset in group1 to yourset in group2, you would have to issue the following command:
|
||||
|
||||
# cset proc \-\-move \-\-pid=50 \-\-fromset=/group1/myset \-\-toset=/group2/yourset
|
||||
|
||||
You do not have to worry about where in the Linux filesystem the cpuset filesystem is mounted\&. The cset command takes care of that\&. Any cpusets that are specified by path (such as above), are done with respect to the root of the cpuset filesystem\&.
|
||||
.SH "LICENSE"
|
||||
Cpuset is licensed under the GNU GPL V2 only\&.
|
||||
.SH "COPYRIGHT"
|
||||
Copyright (c) 2008\-2011 Novell Inc\&.
|
||||
.SH "AUTHOR"
|
||||
Written by Alex Tsariounov <tsariounov@gmail\&.com>\&.
|
||||
.SH "SEE ALSO"
|
||||
cset(1), cset\-set(1), cset\-shield(1)
|
||||
|
||||
/usr/share/doc/packages/cpuset/html/tutorial\&.html
|
||||
|
||||
taskset(1), chrt(1)
|
||||
|
||||
/usr/src/linux/Documentation/cpusets\&.txt
|
||||
.SH "AUTHOR"
|
||||
.PP
|
||||
\fBAlex Tsariounov\fR <\&tsariounov@gmail\&.com\&>
|
||||
.RS 4
|
||||
Author.
|
||||
.RE
|
File diff suppressed because it is too large
Load Diff
@ -1,224 +0,0 @@
|
||||
cset-proc(1)
|
||||
============
|
||||
Alex Tsariounov <tsariounov@gmail.com>
|
||||
v1.6pre1, February 2018
|
||||
|
||||
NAME
|
||||
----
|
||||
cset-proc - manage processes running in cpusets
|
||||
|
||||
SYNOPSIS
|
||||
--------
|
||||
[verse]
|
||||
'cset' [cset options] 'proc' [proc options] [args]
|
||||
'cset' proc --help
|
||||
'cset' proc
|
||||
'cset' proc my_set my_other_set
|
||||
'cset' proc --list --set my_set
|
||||
'cset' proc --exec my_set /opt/software/my_code --my_opt_1
|
||||
'cset' proc --set my_set --exec /opt/software/my_code --my_opt_1
|
||||
'cset' proc --move 2442,3000-3200 my_set
|
||||
'cset' proc --move --pid=2442,3000-3200 --toset=my_set
|
||||
'cset' proc --move --fromset=my_set_1 --toset=my_set_2
|
||||
'cset' proc --move --pid=42 --fromset=/group1/myset --toset=/group2/yourset
|
||||
|
||||
OPTIONS
|
||||
-------
|
||||
-h, --help::
|
||||
prints the list of options for this command
|
||||
|
||||
-l, --list::
|
||||
list processes in the specified cpuset
|
||||
|
||||
-e, --exec::
|
||||
execute arguments in the specified cpuset
|
||||
|
||||
-u USER, --user=USER::
|
||||
use this USER to --exec (id or name)
|
||||
|
||||
-g GROUP, --group=GROUP::
|
||||
use this GROUP to --exec (id or name)
|
||||
|
||||
-m, --move::
|
||||
move specified tasks to specified cpuset; to move a PIDSPEC to a
|
||||
cpuset, use -m PIDSPEC cpuset; to move all tasks specify --fromset
|
||||
and --toset
|
||||
|
||||
-p PIDSPEC, --pid=PIDSPEC::
|
||||
specify pid or tid specification
|
||||
|
||||
--threads::
|
||||
if specified, any processes found in the PIDSPEC to have multiple
|
||||
threads will automatically have all their threads added to the
|
||||
PIDSPEC (use to move all related threads to a cpuset)
|
||||
|
||||
-s CPUSET, --set=CPUSET::
|
||||
specify name of immediate cpuset
|
||||
|
||||
-t TOSET, --toset=TOSET::
|
||||
specify name of destination cpuset
|
||||
|
||||
-f FROMSET, --fromset=FROMSET::
|
||||
specify name of origination cpuset
|
||||
|
||||
-k, --kthread::
|
||||
move, or include moving, unbound kernel threads
|
||||
|
||||
--force::
|
||||
force all processes and threads to be moved
|
||||
|
||||
-v, --verbose::
|
||||
prints more detailed output, additive
|
||||
|
||||
DESCRIPTION
|
||||
-----------
|
||||
This command is used to run and manage arbitrary processes on
|
||||
specified cpusets. It is also used to move pre-existing processes and
|
||||
threads to specified cpusets. You may note there is no "kill" or
|
||||
"destroy" option -- use the standard OS ^C or kill commands for that.
|
||||
|
||||
To list which tasks are running in a particular cpuset, use the --list
|
||||
command.
|
||||
|
||||
For example:
|
||||
|
||||
*+# cset proc --list --set myset+*
|
||||
|
||||
This command will list all the tasks running in the cpuset called
|
||||
"myset".
|
||||
|
||||
Processes are created by specifying the path to the executable
|
||||
and specifying the cpuset that the process is to be created in.
|
||||
|
||||
For example:
|
||||
|
||||
*+# cset proc --set=blazing_cpuset --exec /usr/bin/fast_code+*
|
||||
|
||||
This command will execute the /usr/bin/fast_code program on the
|
||||
"blazing_cpuset" cpuset.
|
||||
|
||||
Note that if your command takes options, then use the traditional
|
||||
"--" marker to separate cset's options from your command's options.
|
||||
|
||||
For example:
|
||||
|
||||
*+# cset proc --set myset --exec -- ls -l+*
|
||||
|
||||
This command will execute "ls -l" on the cpuset called "myset".
|
||||
|
||||
The PIDSPEC argument taken for the move command is a comma
|
||||
separated list of PIDs or TIDs. The list can also include
|
||||
brackets of PIDs or TIDs (i.e. tasks) that are inclusive of the
|
||||
endpoints.
|
||||
|
||||
For example:
|
||||
|
||||
1,2,5 Means processes 1, 2 and 5
|
||||
1,2,600-700 Means processes 1, 2 and from 600 to 700
|
||||
|
||||
NOTE: The range of PIDs or TIDs does not need to have every
|
||||
position populated. In other words, for the example above, if
|
||||
there is only one process, say PID 57, in the range of 50-65,
|
||||
then only that process will be moved.
|
||||
|
||||
To move a PIDSPEC to a specific cpuset, you can either specify
|
||||
the PIDSPEC with --pid and the destination cpuset with --toset,
|
||||
or use the short hand and list the cpuset name after the PIDSPEC
|
||||
for the --move arguments.
|
||||
|
||||
The move command accepts multiple common calling methods.
|
||||
For example, the following commands are equivalent:
|
||||
|
||||
*+# cset proc --move 2442,3000-3200 reserved_set+*
|
||||
|
||||
*+# cset proc --move --pid=2442,3000-3200 --toset=reserved_set+*
|
||||
|
||||
These commands move the tasks defined as 2442 and any running task
|
||||
between 3000 and 3200 inclusive of the ends to the cpuset called
|
||||
"reserved_set".
|
||||
|
||||
Specifying the --fromset is not necessary since the tasks will be
|
||||
moved to the destination cpuset no matter which cpuset they are
|
||||
currently running on.
|
||||
|
||||
NOTE: However, if you do specify a cpuset with the --fromset
|
||||
option, then only those tasks that are both in the PIDSPEC *and*
|
||||
are running in the cpuset specified by --fromset will be moved.
|
||||
I.e., if there is a task running on the system but not in
|
||||
--fromset that is in PIDSPEC, it will not be moved.
|
||||
|
||||
If the --threads switch is used, then the proc command will
|
||||
gather any threads of belonging to any processes or threads that
|
||||
are specified in the PIDSPEC and move them. This provides an easy
|
||||
way to move all related threads: just pick one TID from the set
|
||||
and use the --threads option.
|
||||
|
||||
To move all userspace tasks from one cpuset to another, you need
|
||||
to specify the source and destination cpuset by name.
|
||||
|
||||
For example:
|
||||
|
||||
*+# cset proc --move --fromset=comp1 --toset=comp42+*
|
||||
|
||||
This command specifies that all processes and threads
|
||||
running on cpuset "comp1" be moved to cpuset "comp42".
|
||||
|
||||
NOTE: This move command will not move kernel threads unless
|
||||
the -k/--kthread switch is specified. If it is, then all unbound
|
||||
kernel threads will be added to the move. Unbound kernel threads
|
||||
are those that can run on any CPU. If you *also specify* the
|
||||
--force switch, then all tasks, kernel or not, bound or not,
|
||||
will be moved.
|
||||
|
||||
CAUTION: Please be cautious with the --force switch, since moving
|
||||
a kernel thread that is bound to a specific CPU to a cpuset that
|
||||
does not include that CPU can cause a system hang.
|
||||
|
||||
You must specify unique cpuset names for the both exec and move
|
||||
commands. If a simple name passed to the --fromset, --toset and
|
||||
--set parameters is unique on the system then that command
|
||||
executes. However, if there are multiple cpusets by that name,
|
||||
then you will need to specify which one you mean with a full path
|
||||
rooted at the base cpuset tree.
|
||||
|
||||
For example, suppose you have the following cpuset tree:
|
||||
|
||||
/cpusets
|
||||
/group1
|
||||
/myset
|
||||
/yourset
|
||||
/group2
|
||||
/myset
|
||||
/yourset
|
||||
|
||||
Then, to move a process from myset in group1 to yourset in
|
||||
group2, you would have to issue the following command:
|
||||
|
||||
+# cset proc --move --pid=50 --fromset=/group1/myset --toset=/group2/yourset+
|
||||
|
||||
You do not have to worry about where in the Linux filesystem the
|
||||
cpuset filesystem is mounted. The cset command takes care of that.
|
||||
Any cpusets that are specified by path (such as above), are done with
|
||||
respect to the root of the cpuset filesystem.
|
||||
|
||||
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>.
|
||||
|
||||
SEE ALSO
|
||||
--------
|
||||
cset(1), cset-set(1), cset-shield(1)
|
||||
|
||||
/usr/share/doc/packages/cpuset/html/tutorial.html
|
||||
|
||||
taskset(1), chrt(1)
|
||||
|
||||
/usr/src/linux/Documentation/cpusets.txt
|
@ -1,154 +0,0 @@
|
||||
'\" t
|
||||
.\" Title: cset-set
|
||||
.\" Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||
.\" Date: March 2016
|
||||
.\" Manual: \ \&
|
||||
.\" Source: \ \& 1.5.8
|
||||
.\" Language: English
|
||||
.\"
|
||||
.TH "CSET\-SET" "1" "March 2016" "\ \& 1\&.5\&.8" "\ \&"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "NAME"
|
||||
cset-set \- manage sets of cpus
|
||||
.SH "SYNOPSIS"
|
||||
.sp
|
||||
.nf
|
||||
\fIcset\fR [cset options] \fIset\fR [set options] [args]
|
||||
\fIcset\fR set \-\-help
|
||||
\fIcset\fR set
|
||||
\fIcset\fR set \-\-recurse
|
||||
\fIcset\fR set \-\-list myset
|
||||
\fIcset\fR set myset
|
||||
\fIcset\fR set \-\-recurse \-\-list myset
|
||||
\fIcset\fR set \-\-cpu 2\-5 \-\-mem 0 \-\-set newset
|
||||
\fIcset\fR set \-\-cpu 2\-5 newset
|
||||
\fIcset\fR set \-\-cpu 1,2,5\-7 another_set
|
||||
\fIcset\fR set \-\-destroy newset
|
||||
\fIcset\fR set \-\-destroy /mygroup_sets/my_set
|
||||
.fi
|
||||
.SH "OPTIONS"
|
||||
.PP
|
||||
\-h, \-\-help
|
||||
.RS 4
|
||||
prints the list of options for this command
|
||||
.RE
|
||||
.PP
|
||||
\-l, \-\-list
|
||||
.RS 4
|
||||
list the named cpuset(s); if \-r is used, will list recursively
|
||||
.RE
|
||||
.PP
|
||||
\-c CPUSPEC, \-\-cpu=CPUSPEC
|
||||
.RS 4
|
||||
create or modify cpuset in the specified cpuset with CPUSPEC specification
|
||||
.RE
|
||||
.PP
|
||||
\-m MEMSPEC, \-\-mem=MEMSPEC
|
||||
.RS 4
|
||||
specify which memory nodes to assign to the created or modified cpuset
|
||||
.RE
|
||||
.PP
|
||||
\-d, \-\-destroy
|
||||
.RS 4
|
||||
destroy specified cpuset
|
||||
.RE
|
||||
.PP
|
||||
\-s CPUSET, \-\-set=CPUSET
|
||||
.RS 4
|
||||
specify cpuset name to be acted on
|
||||
.RE
|
||||
.PP
|
||||
\-r, \-\-recurse
|
||||
.RS 4
|
||||
do recursive listing, for use with \-\-list
|
||||
.RE
|
||||
.PP
|
||||
\-v, \-\-verbose
|
||||
.RS 4
|
||||
prints more detailed output, for the set command, using this flag will not chop listing to fit in 80 columns
|
||||
.RE
|
||||
.PP
|
||||
\-\-cpu_exclusive
|
||||
.RS 4
|
||||
mark this cpuset as owning its CPUs exclusively
|
||||
.RE
|
||||
.PP
|
||||
\-\-mem_exclusive
|
||||
.RS 4
|
||||
mark this cpuset as owning its MEMs exclusively
|
||||
.RE
|
||||
.SH "DESCRIPTION"
|
||||
This command is used to create, modify, and destroy cpusets\&. Cpusets form a tree\-like structure rooted at the root cpuset which always includes all system CPUs and all system memory nodes\&.
|
||||
|
||||
A cpuset is an organizational unit that defines a group of CPUs and a group of memory nodes where a process or thread (i\&.e\&. task) is allowed to run on\&. For non\-NUMA machines, the memory node is always 0 (zero) and cannot be set to anything else\&. For NUMA machines, the memory node can be set to a similar specification as the CPU definition and will tie those memory nodes to that cpuset\&. You will usually want the memory nodes that belong to the CPUs defined to be in the same cpuset\&.
|
||||
|
||||
A cpuset can have exclusive right to the CPUs defined in it\&. This means that only this cpuset can own these CPUs\&. Similarly, a cpuset can have exclusive right to the memory nodes defined in it\&. This means that only this cpuset can own these memory nodes\&.
|
||||
|
||||
Cpusets can be specified by name or by path; however, care should be taken when specifying by name if the name is not unique\&. This tool will generally not let you do destructive things to non\-unique cpuset names\&.
|
||||
|
||||
Cpusets are uniquely specified by path\&. The path starts at where the cpusets filesystem is mounted so you generally do not have to know where that is\&. For example, so specify a cpuset that is called "two" which is a subset of "one" which in turn is a subset of the root cpuset, use the path "/one/two" regardless of where the cpusets filesystem is mounted\&.
|
||||
|
||||
When specifying CPUs, a so\-called CPUSPEC is used\&. The CPUSPEC will accept a comma\-separated list of CPUs and inclusive range specifications\&. For example, \-\-cpu=1,3,5\-7 will assign CPU1, CPU3, CPU5, CPU6, and CPU7 to the specified cpuset\&.
|
||||
|
||||
Note that cpusets follow certain rules\&. For example, children can only include CPUs that the parents already have\&. If you do not follow those rules, the kernel cpuset subsystem will not let you create that cpuset\&. For example, if you create a cpuset that contains CPU3, and then attempt to create a child of that cpuset with a CPU other than 3, you will get an error, and the cpuset will not be active\&. The error is somewhat cryptic in that it is usually a "Permission denied" error\&.
|
||||
|
||||
Memory nodes are specified with a MEMSPEC in a similar way to the CPUSPEC\&. For example, \-\-mem=1,3\-6 will assign MEM1, MEM3, MEM4, MEM5, and MEM6 to the specified cpuset\&.
|
||||
|
||||
Note that if you attempt to create or modify a cpuset with a memory node specification that is not valid, you may get a cryptic error message, "No space left on device", and the modification will not be allowed\&.
|
||||
|
||||
When you destroy a cpuset, then the tasks running in that set are moved to the parent of that cpuset\&. If this is not what you want, then manually move those tasks to the cpuset of your choice with the \fIcset proc\fR command (see \fIcset proc \-\-help\fR for more information)\&.
|
||||
.SS "EXAMPLES"
|
||||
.PP
|
||||
Create a cpuset with the default memory specification
|
||||
.RS 4
|
||||
\fB# cset set \-\-cpu=2,4,6\-8 \-\-set=new_set\fR
|
||||
.RE
|
||||
This command creates a cpuset called "new_set" located off the root cpuset which holds CPUS 2,4,6,7,8 and node 0 (interleaved) memory\&. Note that \-\-set is optional, and you can just specify the name for the new cpuset after all arguments\&.
|
||||
|
||||
.PP
|
||||
Create a cpuset that specifies both CPUs and memory nodes
|
||||
.RS 4
|
||||
\fB# cset set \-\-cpu=3 \-\-mem=3 /rad/set_one\fR
|
||||
.RE
|
||||
Note that this command uses the full path method to specify the name of the new cpuset "/rad/set_one"\&. It also names the new cpuset implicitly (i\&.e\&. no \-\-set option, although you can use that if you want to)\&. If the "set_one" name is unique, you can subsequently refer to is just by that\&. Memory node 3 is assigned to this cpuset as well as CPU 3\&.
|
||||
|
||||
The above commands will create the new cpusets, or if they already exist, they will modify them to the new specifications\&.
|
||||
.SH "LICENSE"
|
||||
Cpuset is licensed under the GNU GPL V2 only\&.
|
||||
.SH "COPYRIGHT"
|
||||
Copyright (c) 2008\-2011 Novell Inc\&.
|
||||
.SH "AUTHOR"
|
||||
Written by Alex Tsariounov <tsariounov@gmail\&.com>\&.
|
||||
.SH "SEE ALSO"
|
||||
cset(1), cset\-proc(1), cset\-shield(1)
|
||||
|
||||
/usr/share/doc/packages/cpuset/html/tutorial\&.html
|
||||
|
||||
taskset(1), chrt(1)
|
||||
|
||||
/usr/src/linux/Documentation/cpusets\&.txt
|
||||
.SH "AUTHOR"
|
||||
.PP
|
||||
\fBAlex Tsariounov\fR <\&tsariounov@gmail\&.com\&>
|
||||
.RS 4
|
||||
Author.
|
||||
.RE
|
@ -1,987 +0,0 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
|
||||
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
|
||||
<meta name="generator" content="AsciiDoc 8.6.9" />
|
||||
<title>cset-set(1)</title>
|
||||
<style type="text/css">
|
||||
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
|
||||
|
||||
/* Default font. */
|
||||
body {
|
||||
font-family: Georgia,serif;
|
||||
}
|
||||
|
||||
/* Title font. */
|
||||
h1, h2, h3, h4, h5, h6,
|
||||
div.title, caption.title,
|
||||
thead, p.table.header,
|
||||
#toctitle,
|
||||
#author, #revnumber, #revdate, #revremark,
|
||||
#footer {
|
||||
font-family: Arial,Helvetica,sans-serif;
|
||||
}
|
||||
|
||||
body {
|
||||
margin: 1em 5% 1em 5%;
|
||||
}
|
||||
|
||||
a {
|
||||
color: blue;
|
||||
text-decoration: underline;
|
||||
}
|
||||
a:visited {
|
||||
color: fuchsia;
|
||||
}
|
||||
|
||||
em {
|
||||
font-style: italic;
|
||||
color: navy;
|
||||
}
|
||||
|
||||
strong {
|
||||
font-weight: bold;
|
||||
color: #083194;
|
||||
}
|
||||
|
||||
h1, h2, h3, h4, h5, h6 {
|
||||
color: #527bbd;
|
||||
margin-top: 1.2em;
|
||||
margin-bottom: 0.5em;
|
||||
line-height: 1.3;
|
||||
}
|
||||
|
||||
h1, h2, h3 {
|
||||
border-bottom: 2px solid silver;
|
||||
}
|
||||
h2 {
|
||||
padding-top: 0.5em;
|
||||
}
|
||||
h3 {
|
||||
float: left;
|
||||
}
|
||||
h3 + * {
|
||||
clear: left;
|
||||
}
|
||||
h5 {
|
||||
font-size: 1.0em;
|
||||
}
|
||||
|
||||
div.sectionbody {
|
||||
margin-left: 0;
|
||||
}
|
||||
|
||||
hr {
|
||||
border: 1px solid silver;
|
||||
}
|
||||
|
||||
p {
|
||||
margin-top: 0.5em;
|
||||
margin-bottom: 0.5em;
|
||||
}
|
||||
|
||||
ul, ol, li > p {
|
||||
margin-top: 0;
|
||||
}
|
||||
ul > li { color: #aaa; }
|
||||
ul > li > * { color: black; }
|
||||
|
||||
.monospaced, code, pre {
|
||||
font-family: "Courier New", Courier, monospace;
|
||||
font-size: inherit;
|
||||
color: navy;
|
||||
padding: 0;
|
||||
margin: 0;
|
||||
}
|
||||
pre {
|
||||
white-space: pre-wrap;
|
||||
}
|
||||
|
||||
#author {
|
||||
color: #527bbd;
|
||||
font-weight: bold;
|
||||
font-size: 1.1em;
|
||||
}
|
||||
#email {
|
||||
}
|
||||
#revnumber, #revdate, #revremark {
|
||||
}
|
||||
|
||||
#footer {
|
||||
font-size: small;
|
||||
border-top: 2px solid silver;
|
||||
padding-top: 0.5em;
|
||||
margin-top: 4.0em;
|
||||
}
|
||||
#footer-text {
|
||||
float: left;
|
||||
padding-bottom: 0.5em;
|
||||
}
|
||||
#footer-badges {
|
||||
float: right;
|
||||
padding-bottom: 0.5em;
|
||||
}
|
||||
|
||||
#preamble {
|
||||
margin-top: 1.5em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
div.imageblock, div.exampleblock, div.verseblock,
|
||||
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
||||
div.admonitionblock {
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
div.admonitionblock {
|
||||
margin-top: 2.0em;
|
||||
margin-bottom: 2.0em;
|
||||
margin-right: 10%;
|
||||
color: #606060;
|
||||
}
|
||||
|
||||
div.content { /* Block element content. */
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
/* Block element titles. */
|
||||
div.title, caption.title {
|
||||
color: #527bbd;
|
||||
font-weight: bold;
|
||||
text-align: left;
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 0.5em;
|
||||
}
|
||||
div.title + * {
|
||||
margin-top: 0;
|
||||
}
|
||||
|
||||
td div.title:first-child {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
div.content div.title:first-child {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
div.content + div.title {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
|
||||
div.sidebarblock > div.content {
|
||||
background: #ffffee;
|
||||
border: 1px solid #dddddd;
|
||||
border-left: 4px solid #f0f0f0;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
||||
div.listingblock > div.content {
|
||||
border: 1px solid #dddddd;
|
||||
border-left: 5px solid #f0f0f0;
|
||||
background: #f8f8f8;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
||||
div.quoteblock, div.verseblock {
|
||||
padding-left: 1.0em;
|
||||
margin-left: 1.0em;
|
||||
margin-right: 10%;
|
||||
border-left: 5px solid #f0f0f0;
|
||||
color: #888;
|
||||
}
|
||||
|
||||
div.quoteblock > div.attribution {
|
||||
padding-top: 0.5em;
|
||||
text-align: right;
|
||||
}
|
||||
|
||||
div.verseblock > pre.content {
|
||||
font-family: inherit;
|
||||
font-size: inherit;
|
||||
}
|
||||
div.verseblock > div.attribution {
|
||||
padding-top: 0.75em;
|
||||
text-align: left;
|
||||
}
|
||||
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
|
||||
div.verseblock + div.attribution {
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
div.admonitionblock .icon {
|
||||
vertical-align: top;
|
||||
font-size: 1.1em;
|
||||
font-weight: bold;
|
||||
text-decoration: underline;
|
||||
color: #527bbd;
|
||||
padding-right: 0.5em;
|
||||
}
|
||||
div.admonitionblock td.content {
|
||||
padding-left: 0.5em;
|
||||
border-left: 3px solid #dddddd;
|
||||
}
|
||||
|
||||
div.exampleblock > div.content {
|
||||
border-left: 3px solid #dddddd;
|
||||
padding-left: 0.5em;
|
||||
}
|
||||
|
||||
div.imageblock div.content { padding-left: 0; }
|
||||
span.image img { border-style: none; vertical-align: text-bottom; }
|
||||
a.image:visited { color: white; }
|
||||
|
||||
dl {
|
||||
margin-top: 0.8em;
|
||||
margin-bottom: 0.8em;
|
||||
}
|
||||
dt {
|
||||
margin-top: 0.5em;
|
||||
margin-bottom: 0;
|
||||
font-style: normal;
|
||||
color: navy;
|
||||
}
|
||||
dd > *:first-child {
|
||||
margin-top: 0.1em;
|
||||
}
|
||||
|
||||
ul, ol {
|
||||
list-style-position: outside;
|
||||
}
|
||||
ol.arabic {
|
||||
list-style-type: decimal;
|
||||
}
|
||||
ol.loweralpha {
|
||||
list-style-type: lower-alpha;
|
||||
}
|
||||
ol.upperalpha {
|
||||
list-style-type: upper-alpha;
|
||||
}
|
||||
ol.lowerroman {
|
||||
list-style-type: lower-roman;
|
||||
}
|
||||
ol.upperroman {
|
||||
list-style-type: upper-roman;
|
||||
}
|
||||
|
||||
div.compact ul, div.compact ol,
|
||||
div.compact p, div.compact p,
|
||||
div.compact div, div.compact div {
|
||||
margin-top: 0.1em;
|
||||
margin-bottom: 0.1em;
|
||||
}
|
||||
|
||||
tfoot {
|
||||
font-weight: bold;
|
||||
}
|
||||
td > div.verse {
|
||||
white-space: pre;
|
||||
}
|
||||
|
||||
div.hdlist {
|
||||
margin-top: 0.8em;
|
||||
margin-bottom: 0.8em;
|
||||
}
|
||||
div.hdlist tr {
|
||||
padding-bottom: 15px;
|
||||
}
|
||||
dt.hdlist1.strong, td.hdlist1.strong {
|
||||
font-weight: bold;
|
||||
}
|
||||
td.hdlist1 {
|
||||
vertical-align: top;
|
||||
font-style: normal;
|
||||
padding-right: 0.8em;
|
||||
color: navy;
|
||||
}
|
||||
td.hdlist2 {
|
||||
vertical-align: top;
|
||||
}
|
||||
div.hdlist.compact tr {
|
||||
margin: 0;
|
||||
padding-bottom: 0;
|
||||
}
|
||||
|
||||
.comment {
|
||||
background: yellow;
|
||||
}
|
||||
|
||||
.footnote, .footnoteref {
|
||||
font-size: 0.8em;
|
||||
}
|
||||
|
||||
span.footnote, span.footnoteref {
|
||||
vertical-align: super;
|
||||
}
|
||||
|
||||
#footnotes {
|
||||
margin: 20px 0 20px 0;
|
||||
padding: 7px 0 0 0;
|
||||
}
|
||||
|
||||
#footnotes div.footnote {
|
||||
margin: 0 0 5px 0;
|
||||
}
|
||||
|
||||
#footnotes hr {
|
||||
border: none;
|
||||
border-top: 1px solid silver;
|
||||
height: 1px;
|
||||
text-align: left;
|
||||
margin-left: 0;
|
||||
width: 20%;
|
||||
min-width: 100px;
|
||||
}
|
||||
|
||||
div.colist td {
|
||||
padding-right: 0.5em;
|
||||
padding-bottom: 0.3em;
|
||||
vertical-align: top;
|
||||
}
|
||||
div.colist td img {
|
||||
margin-top: 0.3em;
|
||||
}
|
||||
|
||||
@media print {
|
||||
#footer-badges { display: none; }
|
||||
}
|
||||
|
||||
#toc {
|
||||
margin-bottom: 2.5em;
|
||||
}
|
||||
|
||||
#toctitle {
|
||||
color: #527bbd;
|
||||
font-size: 1.1em;
|
||||
font-weight: bold;
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 0.1em;
|
||||
}
|
||||
|
||||
div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
|
||||
margin-top: 0;
|
||||
margin-bottom: 0;
|
||||
}
|
||||
div.toclevel2 {
|
||||
margin-left: 2em;
|
||||
font-size: 0.9em;
|
||||
}
|
||||
div.toclevel3 {
|
||||
margin-left: 4em;
|
||||
font-size: 0.9em;
|
||||
}
|
||||
div.toclevel4 {
|
||||
margin-left: 6em;
|
||||
font-size: 0.9em;
|
||||
}
|
||||
|
||||
span.aqua { color: aqua; }
|
||||
span.black { color: black; }
|
||||
span.blue { color: blue; }
|
||||
span.fuchsia { color: fuchsia; }
|
||||
span.gray { color: gray; }
|
||||
span.green { color: green; }
|
||||
span.lime { color: lime; }
|
||||
span.maroon { color: maroon; }
|
||||
span.navy { color: navy; }
|
||||
span.olive { color: olive; }
|
||||
span.purple { color: purple; }
|
||||
span.red { color: red; }
|
||||
span.silver { color: silver; }
|
||||
span.teal { color: teal; }
|
||||
span.white { color: white; }
|
||||
span.yellow { color: yellow; }
|
||||
|
||||
span.aqua-background { background: aqua; }
|
||||
span.black-background { background: black; }
|
||||
span.blue-background { background: blue; }
|
||||
span.fuchsia-background { background: fuchsia; }
|
||||
span.gray-background { background: gray; }
|
||||
span.green-background { background: green; }
|
||||
span.lime-background { background: lime; }
|
||||
span.maroon-background { background: maroon; }
|
||||
span.navy-background { background: navy; }
|
||||
span.olive-background { background: olive; }
|
||||
span.purple-background { background: purple; }
|
||||
span.red-background { background: red; }
|
||||
span.silver-background { background: silver; }
|
||||
span.teal-background { background: teal; }
|
||||
span.white-background { background: white; }
|
||||
span.yellow-background { background: yellow; }
|
||||
|
||||
span.big { font-size: 2em; }
|
||||
span.small { font-size: 0.6em; }
|
||||
|
||||
span.underline { text-decoration: underline; }
|
||||
span.overline { text-decoration: overline; }
|
||||
span.line-through { text-decoration: line-through; }
|
||||
|
||||
div.unbreakable { page-break-inside: avoid; }
|
||||
|
||||
|
||||
/*
|
||||
* xhtml11 specific
|
||||
*
|
||||
* */
|
||||
|
||||
div.tableblock {
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
div.tableblock > table {
|
||||
border: 3px solid #527bbd;
|
||||
}
|
||||
thead, p.table.header {
|
||||
font-weight: bold;
|
||||
color: #527bbd;
|
||||
}
|
||||
p.table {
|
||||
margin-top: 0;
|
||||
}
|
||||
/* Because the table frame attribute is overriden by CSS in most browsers. */
|
||||
div.tableblock > table[frame="void"] {
|
||||
border-style: none;
|
||||
}
|
||||
div.tableblock > table[frame="hsides"] {
|
||||
border-left-style: none;
|
||||
border-right-style: none;
|
||||
}
|
||||
div.tableblock > table[frame="vsides"] {
|
||||
border-top-style: none;
|
||||
border-bottom-style: none;
|
||||
}
|
||||
|
||||
|
||||
/*
|
||||
* html5 specific
|
||||
*
|
||||
* */
|
||||
|
||||
table.tableblock {
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
thead, p.tableblock.header {
|
||||
font-weight: bold;
|
||||
color: #527bbd;
|
||||
}
|
||||
p.tableblock {
|
||||
margin-top: 0;
|
||||
}
|
||||
table.tableblock {
|
||||
border-width: 3px;
|
||||
border-spacing: 0px;
|
||||
border-style: solid;
|
||||
border-color: #527bbd;
|
||||
border-collapse: collapse;
|
||||
}
|
||||
th.tableblock, td.tableblock {
|
||||
border-width: 1px;
|
||||
padding: 4px;
|
||||
border-style: solid;
|
||||
border-color: #527bbd;
|
||||
}
|
||||
|
||||
table.tableblock.frame-topbot {
|
||||
border-left-style: hidden;
|
||||
border-right-style: hidden;
|
||||
}
|
||||
table.tableblock.frame-sides {
|
||||
border-top-style: hidden;
|
||||
border-bottom-style: hidden;
|
||||
}
|
||||
table.tableblock.frame-none {
|
||||
border-style: hidden;
|
||||
}
|
||||
|
||||
th.tableblock.halign-left, td.tableblock.halign-left {
|
||||
text-align: left;
|
||||
}
|
||||
th.tableblock.halign-center, td.tableblock.halign-center {
|
||||
text-align: center;
|
||||
}
|
||||
th.tableblock.halign-right, td.tableblock.halign-right {
|
||||
text-align: right;
|
||||
}
|
||||
|
||||
th.tableblock.valign-top, td.tableblock.valign-top {
|
||||
vertical-align: top;
|
||||
}
|
||||
th.tableblock.valign-middle, td.tableblock.valign-middle {
|
||||
vertical-align: middle;
|
||||
}
|
||||
th.tableblock.valign-bottom, td.tableblock.valign-bottom {
|
||||
vertical-align: bottom;
|
||||
}
|
||||
|
||||
|
||||
/*
|
||||
* manpage specific
|
||||
*
|
||||
* */
|
||||
|
||||
body.manpage h1 {
|
||||
padding-top: 0.5em;
|
||||
padding-bottom: 0.5em;
|
||||
border-top: 2px solid silver;
|
||||
border-bottom: 2px solid silver;
|
||||
}
|
||||
body.manpage h2 {
|
||||
border-style: none;
|
||||
}
|
||||
body.manpage div.sectionbody {
|
||||
margin-left: 3em;
|
||||
}
|
||||
|
||||
@media print {
|
||||
body.manpage div#toc { display: none; }
|
||||
}
|
||||
|
||||
|
||||
</style>
|
||||
<script type="text/javascript">
|
||||
/*<![CDATA[*/
|
||||
var asciidoc = { // Namespace.
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// Table Of Contents generator
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/* Author: Mihai Bazon, September 2002
|
||||
* http://students.infoiasi.ro/~mishoo
|
||||
*
|
||||
* Table Of Content generator
|
||||
* Version: 0.4
|
||||
*
|
||||
* Feel free to use this script under the terms of the GNU General Public
|
||||
* License, as long as you do not remove or alter this notice.
|
||||
*/
|
||||
|
||||
/* modified by Troy D. Hanson, September 2006. License: GPL */
|
||||
/* modified by Stuart Rackham, 2006, 2009. License: GPL */
|
||||
|
||||
// toclevels = 1..4.
|
||||
toc: function (toclevels) {
|
||||
|
||||
function getText(el) {
|
||||
var text = "";
|
||||
for (var i = el.firstChild; i != null; i = i.nextSibling) {
|
||||
if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
|
||||
text += i.data;
|
||||
else if (i.firstChild != null)
|
||||
text += getText(i);
|
||||
}
|
||||
return text;
|
||||
}
|
||||
|
||||
function TocEntry(el, text, toclevel) {
|
||||
this.element = el;
|
||||
this.text = text;
|
||||
this.toclevel = toclevel;
|
||||
}
|
||||
|
||||
function tocEntries(el, toclevels) {
|
||||
var result = new Array;
|
||||
var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
|
||||
// Function that scans the DOM tree for header elements (the DOM2
|
||||
// nodeIterator API would be a better technique but not supported by all
|
||||
// browsers).
|
||||
var iterate = function (el) {
|
||||
for (var i = el.firstChild; i != null; i = i.nextSibling) {
|
||||
if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
|
||||
var mo = re.exec(i.tagName);
|
||||
if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
|
||||
result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
|
||||
}
|
||||
iterate(i);
|
||||
}
|
||||
}
|
||||
}
|
||||
iterate(el);
|
||||
return result;
|
||||
}
|
||||
|
||||
var toc = document.getElementById("toc");
|
||||
if (!toc) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Delete existing TOC entries in case we're reloading the TOC.
|
||||
var tocEntriesToRemove = [];
|
||||
var i;
|
||||
for (i = 0; i < toc.childNodes.length; i++) {
|
||||
var entry = toc.childNodes[i];
|
||||
if (entry.nodeName.toLowerCase() == 'div'
|
||||
&& entry.getAttribute("class")
|
||||
&& entry.getAttribute("class").match(/^toclevel/))
|
||||
tocEntriesToRemove.push(entry);
|
||||
}
|
||||
for (i = 0; i < tocEntriesToRemove.length; i++) {
|
||||
toc.removeChild(tocEntriesToRemove[i]);
|
||||
}
|
||||
|
||||
// Rebuild TOC entries.
|
||||
var entries = tocEntries(document.getElementById("content"), toclevels);
|
||||
for (var i = 0; i < entries.length; ++i) {
|
||||
var entry = entries[i];
|
||||
if (entry.element.id == "")
|
||||
entry.element.id = "_toc_" + i;
|
||||
var a = document.createElement("a");
|
||||
a.href = "#" + entry.element.id;
|
||||
a.appendChild(document.createTextNode(entry.text));
|
||||
var div = document.createElement("div");
|
||||
div.appendChild(a);
|
||||
div.className = "toclevel" + entry.toclevel;
|
||||
toc.appendChild(div);
|
||||
}
|
||||
if (entries.length == 0)
|
||||
toc.parentNode.removeChild(toc);
|
||||
},
|
||||
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// Footnotes generator
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/* Based on footnote generation code from:
|
||||
* http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
|
||||
*/
|
||||
|
||||
footnotes: function () {
|
||||
// Delete existing footnote entries in case we're reloading the footnodes.
|
||||
var i;
|
||||
var noteholder = document.getElementById("footnotes");
|
||||
if (!noteholder) {
|
||||
return;
|
||||
}
|
||||
var entriesToRemove = [];
|
||||
for (i = 0; i < noteholder.childNodes.length; i++) {
|
||||
var entry = noteholder.childNodes[i];
|
||||
if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
|
||||
entriesToRemove.push(entry);
|
||||
}
|
||||
for (i = 0; i < entriesToRemove.length; i++) {
|
||||
noteholder.removeChild(entriesToRemove[i]);
|
||||
}
|
||||
|
||||
// Rebuild footnote entries.
|
||||
var cont = document.getElementById("content");
|
||||
var spans = cont.getElementsByTagName("span");
|
||||
var refs = {};
|
||||
var n = 0;
|
||||
for (i=0; i<spans.length; i++) {
|
||||
if (spans[i].className == "footnote") {
|
||||
n++;
|
||||
var note = spans[i].getAttribute("data-note");
|
||||
if (!note) {
|
||||
// Use [\s\S] in place of . so multi-line matches work.
|
||||
// Because JavaScript has no s (dotall) regex flag.
|
||||
note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
|
||||
spans[i].innerHTML =
|
||||
"[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
|
||||
"' title='View footnote' class='footnote'>" + n + "</a>]";
|
||||
spans[i].setAttribute("data-note", note);
|
||||
}
|
||||
noteholder.innerHTML +=
|
||||
"<div class='footnote' id='_footnote_" + n + "'>" +
|
||||
"<a href='#_footnoteref_" + n + "' title='Return to text'>" +
|
||||
n + "</a>. " + note + "</div>";
|
||||
var id =spans[i].getAttribute("id");
|
||||
if (id != null) refs["#"+id] = n;
|
||||
}
|
||||
}
|
||||
if (n == 0)
|
||||
noteholder.parentNode.removeChild(noteholder);
|
||||
else {
|
||||
// Process footnoterefs.
|
||||
for (i=0; i<spans.length; i++) {
|
||||
if (spans[i].className == "footnoteref") {
|
||||
var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
|
||||
href = href.match(/#.*/)[0]; // Because IE return full URL.
|
||||
n = refs[href];
|
||||
spans[i].innerHTML =
|
||||
"[<a href='#_footnote_" + n +
|
||||
"' title='View footnote' class='footnote'>" + n + "</a>]";
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
install: function(toclevels) {
|
||||
var timerId;
|
||||
|
||||
function reinstall() {
|
||||
asciidoc.footnotes();
|
||||
if (toclevels) {
|
||||
asciidoc.toc(toclevels);
|
||||
}
|
||||
}
|
||||
|
||||
function reinstallAndRemoveTimer() {
|
||||
clearInterval(timerId);
|
||||
reinstall();
|
||||
}
|
||||
|
||||
timerId = setInterval(reinstall, 500);
|
||||
if (document.addEventListener)
|
||||
document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
|
||||
else
|
||||
window.onload = reinstallAndRemoveTimer;
|
||||
}
|
||||
|
||||
}
|
||||
asciidoc.install();
|
||||
/*]]>*/
|
||||
</script>
|
||||
</head>
|
||||
<body class="manpage">
|
||||
<div id="header">
|
||||
<h1>
|
||||
cset-set(1) Manual Page
|
||||
</h1>
|
||||
<h2>NAME</h2>
|
||||
<div class="sectionbody">
|
||||
<p>cset-set -
|
||||
manage sets of cpus
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="content">
|
||||
<div class="sect1">
|
||||
<h2 id="_synopsis">SYNOPSIS</h2>
|
||||
<div class="sectionbody">
|
||||
<div class="verseblock">
|
||||
<pre class="content"><em>cset</em> [cset options] <em>set</em> [set options] [args]
|
||||
<em>cset</em> set --help
|
||||
<em>cset</em> set
|
||||
<em>cset</em> set --recurse
|
||||
<em>cset</em> set --list myset
|
||||
<em>cset</em> set myset
|
||||
<em>cset</em> set --recurse --list myset
|
||||
<em>cset</em> set --cpu 2-5 --mem 0 --set newset
|
||||
<em>cset</em> set --cpu 2-5 newset
|
||||
<em>cset</em> set --cpu 1,2,5-7 another_set
|
||||
<em>cset</em> set --destroy newset
|
||||
<em>cset</em> set --destroy /mygroup_sets/my_set</pre>
|
||||
<div class="attribution">
|
||||
</div></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_options">OPTIONS</h2>
|
||||
<div class="sectionbody">
|
||||
<div class="dlist"><dl>
|
||||
<dt class="hdlist1">
|
||||
-h, --help
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
prints the list of options for this command
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
-l, --list
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
list the named cpuset(s); if -r is used, will list recursively
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
-c CPUSPEC, --cpu=CPUSPEC
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
create or modify cpuset in the specified cpuset with CPUSPEC
|
||||
specification
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
-m MEMSPEC, --mem=MEMSPEC
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
specify which memory nodes to assign to the created or modified
|
||||
cpuset
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
-d, --destroy
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
destroy specified cpuset
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
-s CPUSET, --set=CPUSET
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
specify cpuset name to be acted on
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
-r, --recurse
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
do recursive listing, for use with --list
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
-v, --verbose
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
prints more detailed output, for the set command, using this flag
|
||||
will not chop listing to fit in 80 columns
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
--cpu_exclusive
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
mark this cpuset as owning its CPUs exclusively
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
--mem_exclusive
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
mark this cpuset as owning its MEMs exclusively
|
||||
</p>
|
||||
</dd>
|
||||
</dl></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_description">DESCRIPTION</h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph"><p>This command is used to create, modify, and destroy cpusets.
|
||||
Cpusets form a tree-like structure rooted at the root cpuset
|
||||
which always includes all system CPUs and all system memory
|
||||
nodes.</p></div>
|
||||
<div class="paragraph"><p>A cpuset is an organizational unit that defines a group of CPUs
|
||||
and a group of memory nodes where a process or thread (i.e. task)
|
||||
is allowed to run on. For non-NUMA machines, the memory node is
|
||||
always 0 (zero) and cannot be set to anything else. For NUMA
|
||||
machines, the memory node can be set to a similar specification
|
||||
as the CPU definition and will tie those memory nodes to that
|
||||
cpuset. You will usually want the memory nodes that belong to
|
||||
the CPUs defined to be in the same cpuset.</p></div>
|
||||
<div class="paragraph"><p>A cpuset can have exclusive right to the CPUs defined in it.
|
||||
This means that only this cpuset can own these CPUs. Similarly,
|
||||
a cpuset can have exclusive right to the memory nodes defined in
|
||||
it. This means that only this cpuset can own these memory
|
||||
nodes.</p></div>
|
||||
<div class="paragraph"><p>Cpusets can be specified by name or by path; however, care
|
||||
should be taken when specifying by name if the name is not
|
||||
unique. This tool will generally not let you do destructive
|
||||
things to non-unique cpuset names.</p></div>
|
||||
<div class="paragraph"><p>Cpusets are uniquely specified by path. The path starts at where
|
||||
the cpusets filesystem is mounted so you generally do not have to
|
||||
know where that is. For example, so specify a cpuset that is
|
||||
called "two" which is a subset of "one" which in turn is a subset
|
||||
of the root cpuset, use the path "/one/two" regardless of where
|
||||
the cpusets filesystem is mounted.</p></div>
|
||||
<div class="paragraph"><p>When specifying CPUs, a so-called CPUSPEC is used. The CPUSPEC
|
||||
will accept a comma-separated list of CPUs and inclusive range
|
||||
specifications. For example, --cpu=1,3,5-7 will assign CPU1,
|
||||
CPU3, CPU5, CPU6, and CPU7 to the specified cpuset.</p></div>
|
||||
<div class="paragraph"><p>Note that cpusets follow certain rules. For example, children
|
||||
can only include CPUs that the parents already have. If you do
|
||||
not follow those rules, the kernel cpuset subsystem will not let
|
||||
you create that cpuset. For example, if you create a cpuset that
|
||||
contains CPU3, and then attempt to create a child of that cpuset
|
||||
with a CPU other than 3, you will get an error, and the cpuset
|
||||
will not be active. The error is somewhat cryptic in that it is
|
||||
usually a "Permission denied" error.</p></div>
|
||||
<div class="paragraph"><p>Memory nodes are specified with a MEMSPEC in a similar way to
|
||||
the CPUSPEC. For example, --mem=1,3-6 will assign MEM1, MEM3,
|
||||
MEM4, MEM5, and MEM6 to the specified cpuset.</p></div>
|
||||
<div class="paragraph"><p>Note that if you attempt to create or modify a cpuset with a
|
||||
memory node specification that is not valid, you may get a
|
||||
cryptic error message, "No space left on device", and the
|
||||
modification will not be allowed.</p></div>
|
||||
<div class="paragraph"><p>When you destroy a cpuset, then the tasks running in that set are
|
||||
moved to the parent of that cpuset. If this is not what you
|
||||
want, then manually move those tasks to the cpuset of your choice
|
||||
with the <em>cset proc</em> command (see <em>cset proc --help</em> for more
|
||||
information).</p></div>
|
||||
<div class="sect2">
|
||||
<h3 id="_examples">EXAMPLES</h3>
|
||||
<div class="dlist"><dl>
|
||||
<dt class="hdlist1">
|
||||
Create a cpuset with the default memory specification
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
<strong><code># cset set --cpu=2,4,6-8 --set=new_set</code></strong>
|
||||
</p>
|
||||
</dd>
|
||||
</dl></div>
|
||||
<div class="paragraph"><p>This command creates a cpuset called "new_set" located
|
||||
off the root cpuset which holds CPUS 2,4,6,7,8 and node 0
|
||||
(interleaved) memory. Note that --set is optional, and
|
||||
you can just specify the name for the new cpuset after
|
||||
all arguments.</p></div>
|
||||
<div class="dlist"><dl>
|
||||
<dt class="hdlist1">
|
||||
Create a cpuset that specifies both CPUs and memory nodes
|
||||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
<strong><code># cset set --cpu=3 --mem=3 /rad/set_one</code></strong>
|
||||
</p>
|
||||
</dd>
|
||||
</dl></div>
|
||||
<div class="paragraph"><p>Note that this command uses the full path method to
|
||||
specify the name of the new cpuset "/rad/set_one". It
|
||||
also names the new cpuset implicitly (i.e. no --set
|
||||
option, although you can use that if you want to). If
|
||||
the "set_one" name is unique, you can subsequently refer
|
||||
to is just by that. Memory node 3 is assigned to this
|
||||
cpuset as well as CPU 3.</p></div>
|
||||
<div class="paragraph"><p>The above commands will create the new cpusets, or if they
|
||||
already exist, they will modify them to the new specifications.</p></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_license">LICENSE</h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph"><p>Cpuset is licensed under the GNU GPL V2 only.</p></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_copyright">COPYRIGHT</h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph"><p>Copyright (c) 2008-2011 Novell Inc.</p></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_author">AUTHOR</h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph"><p>Written by Alex Tsariounov <tsariounov@gmail.com>.</p></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_see_also">SEE ALSO</h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph"><p>cset(1), cset-proc(1), cset-shield(1)</p></div>
|
||||
<div class="paragraph"><p>/usr/share/doc/packages/cpuset/html/tutorial.html</p></div>
|
||||
<div class="paragraph"><p>taskset(1), chrt(1)</p></div>
|
||||
<div class="paragraph"><p>/usr/src/linux/Documentation/cpusets.txt</p></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="footnotes"><hr /></div>
|
||||
<div id="footer">
|
||||
<div id="footer-text">
|
||||
Version 1.5.8<br />
|
||||
Last updated
|
||||
2017-12-06 10:59:31 CET
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
@ -1,172 +0,0 @@
|
||||
cset-set(1)
|
||||
===========
|
||||
Alex Tsariounov <tsariounov@gmail.com>
|
||||
v1.6pre1, February 2018
|
||||
|
||||
NAME
|
||||
----
|
||||
cset-set - manage sets of cpus
|
||||
|
||||
SYNOPSIS
|
||||
--------
|
||||
[verse]
|
||||
'cset' [cset options] 'set' [set options] [args]
|
||||
'cset' set --help
|
||||
'cset' set
|
||||
'cset' set --recurse
|
||||
'cset' set --list myset
|
||||
'cset' set myset
|
||||
'cset' set --recurse --list myset
|
||||
'cset' set --cpu 2-5 --mem 0 --set newset
|
||||
'cset' set --cpu 2-5 newset
|
||||
'cset' set --cpu 1,2,5-7 another_set
|
||||
'cset' set --destroy newset
|
||||
'cset' set --destroy /mygroup_sets/my_set
|
||||
|
||||
OPTIONS
|
||||
-------
|
||||
-h, --help::
|
||||
prints the list of options for this command
|
||||
|
||||
-l, --list::
|
||||
list the named cpuset(s); if -r is used, will list recursively
|
||||
|
||||
-c CPUSPEC, --cpu=CPUSPEC::
|
||||
create or modify cpuset in the specified cpuset with CPUSPEC
|
||||
specification
|
||||
|
||||
-m MEMSPEC, --mem=MEMSPEC::
|
||||
specify which memory nodes to assign to the created or modified
|
||||
cpuset
|
||||
|
||||
-d, --destroy::
|
||||
destroy specified cpuset
|
||||
|
||||
-s CPUSET, --set=CPUSET::
|
||||
specify cpuset name to be acted on
|
||||
|
||||
-r, --recurse::
|
||||
do recursive listing, for use with --list
|
||||
|
||||
-v, --verbose::
|
||||
prints more detailed output, for the set command, using this flag
|
||||
will not chop listing to fit in 80 columns
|
||||
|
||||
--cpu_exclusive::
|
||||
mark this cpuset as owning its CPUs exclusively
|
||||
|
||||
--mem_exclusive::
|
||||
mark this cpuset as owning its MEMs exclusively
|
||||
|
||||
DESCRIPTION
|
||||
-----------
|
||||
This command is used to create, modify, and destroy cpusets.
|
||||
Cpusets form a tree-like structure rooted at the root cpuset
|
||||
which always includes all system CPUs and all system memory
|
||||
nodes.
|
||||
|
||||
A cpuset is an organizational unit that defines a group of CPUs
|
||||
and a group of memory nodes where a process or thread (i.e. task)
|
||||
is allowed to run on. For non-NUMA machines, the memory node is
|
||||
always 0 (zero) and cannot be set to anything else. For NUMA
|
||||
machines, the memory node can be set to a similar specification
|
||||
as the CPU definition and will tie those memory nodes to that
|
||||
cpuset. You will usually want the memory nodes that belong to
|
||||
the CPUs defined to be in the same cpuset.
|
||||
|
||||
A cpuset can have exclusive right to the CPUs defined in it.
|
||||
This means that only this cpuset can own these CPUs. Similarly,
|
||||
a cpuset can have exclusive right to the memory nodes defined in
|
||||
it. This means that only this cpuset can own these memory
|
||||
nodes.
|
||||
|
||||
Cpusets can be specified by name or by path; however, care
|
||||
should be taken when specifying by name if the name is not
|
||||
unique. This tool will generally not let you do destructive
|
||||
things to non-unique cpuset names.
|
||||
|
||||
Cpusets are uniquely specified by path. The path starts at where
|
||||
the cpusets filesystem is mounted so you generally do not have to
|
||||
know where that is. For example, so specify a cpuset that is
|
||||
called "two" which is a subset of "one" which in turn is a subset
|
||||
of the root cpuset, use the path "/one/two" regardless of where
|
||||
the cpusets filesystem is mounted.
|
||||
|
||||
When specifying CPUs, a so-called CPUSPEC is used. The CPUSPEC
|
||||
will accept a comma-separated list of CPUs and inclusive range
|
||||
specifications. For example, --cpu=1,3,5-7 will assign CPU1,
|
||||
CPU3, CPU5, CPU6, and CPU7 to the specified cpuset.
|
||||
|
||||
Note that cpusets follow certain rules. For example, children
|
||||
can only include CPUs that the parents already have. If you do
|
||||
not follow those rules, the kernel cpuset subsystem will not let
|
||||
you create that cpuset. For example, if you create a cpuset that
|
||||
contains CPU3, and then attempt to create a child of that cpuset
|
||||
with a CPU other than 3, you will get an error, and the cpuset
|
||||
will not be active. The error is somewhat cryptic in that it is
|
||||
usually a "Permission denied" error.
|
||||
|
||||
Memory nodes are specified with a MEMSPEC in a similar way to
|
||||
the CPUSPEC. For example, --mem=1,3-6 will assign MEM1, MEM3,
|
||||
MEM4, MEM5, and MEM6 to the specified cpuset.
|
||||
|
||||
Note that if you attempt to create or modify a cpuset with a
|
||||
memory node specification that is not valid, you may get a
|
||||
cryptic error message, "No space left on device", and the
|
||||
modification will not be allowed.
|
||||
|
||||
When you destroy a cpuset, then the tasks running in that set are
|
||||
moved to the parent of that cpuset. If this is not what you
|
||||
want, then manually move those tasks to the cpuset of your choice
|
||||
with the 'cset proc' command (see 'cset proc --help' for more
|
||||
information).
|
||||
|
||||
EXAMPLES
|
||||
~~~~~~~~
|
||||
|
||||
Create a cpuset with the default memory specification::
|
||||
|
||||
*+# cset set --cpu=2,4,6-8 --set=new_set+*
|
||||
|
||||
This command creates a cpuset called "new_set" located
|
||||
off the root cpuset which holds CPUS 2,4,6,7,8 and node 0
|
||||
(interleaved) memory. Note that --set is optional, and
|
||||
you can just specify the name for the new cpuset after
|
||||
all arguments.
|
||||
|
||||
Create a cpuset that specifies both CPUs and memory nodes::
|
||||
|
||||
*+# cset set --cpu=3 --mem=3 /rad/set_one+*
|
||||
|
||||
Note that this command uses the full path method to
|
||||
specify the name of the new cpuset "/rad/set_one". It
|
||||
also names the new cpuset implicitly (i.e. no --set
|
||||
option, although you can use that if you want to). If
|
||||
the "set_one" name is unique, you can subsequently refer
|
||||
to is just by that. Memory node 3 is assigned to this
|
||||
cpuset as well as CPU 3.
|
||||
|
||||
The above commands will create the new cpusets, or if they
|
||||
already exist, they will modify them to the new specifications.
|
||||
|
||||
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>.
|
||||
|
||||
SEE ALSO
|
||||
--------
|
||||
cset(1), cset-proc(1), cset-shield(1)
|
||||
|
||||
/usr/share/doc/packages/cpuset/html/tutorial.html
|
||||
|
||||
taskset(1), chrt(1)
|
||||
|
||||
/usr/src/linux/Documentation/cpusets.txt
|
@ -1,269 +0,0 @@
|
||||
'\" t
|
||||
.\" Title: cset-shield
|
||||
.\" Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||
.\" Date: March 2016
|
||||
.\" Manual: \ \&
|
||||
.\" Source: \ \& 1.5.8
|
||||
.\" Language: English
|
||||
.\"
|
||||
.TH "CSET\-SHIELD" "1" "March 2016" "\ \& 1\&.5\&.8" "\ \&"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "NAME"
|
||||
cset-shield \- cpuset supercommand which implements cpu shielding
|
||||
.SH "SYNOPSIS"
|
||||
.sp
|
||||
.nf
|
||||
\fIcset\fR [cset options] \fIshield\fR [shield options] [args]
|
||||
\fIcset\fR shield \-\-help
|
||||
\fIcset\fR shield
|
||||
\fIcset\fR shield \-\-cpu 1\-7
|
||||
\fIcset\fR shield \-\-cpu 1\-7 \-\-kthread=on
|
||||
\fIcset\fR shield \-\-exec /opt/software/myapp/doit \-\-my_opt1 \-\-my_opt2
|
||||
\fIcset\fR shield \-\-user appuser \-\-exec run_benchmark\&.sh
|
||||
\fIcset\fR shield \-\-shield \-\-pid 1024,2048,5000\-1000
|
||||
\fIcset\fR shield \-\-unshield \-\-pid 6000\-8500
|
||||
\fIcset\fR shield \-\-kthread=off
|
||||
\fIcset\fR shield \-\-kthread=on
|
||||
\fIcset\fR shield \-\-shield bash
|
||||
.fi
|
||||
.SH "OPTIONS"
|
||||
.PP
|
||||
\-h, \-\-help
|
||||
.RS 4
|
||||
prints the list of options for this command
|
||||
.RE
|
||||
.PP
|
||||
\-c CPUSPEC, \-\-cpu=CPUSPEC
|
||||
.RS 4
|
||||
modifies or initializes the shield cpusets
|
||||
.RE
|
||||
.PP
|
||||
\-r, \-\-reset
|
||||
.RS 4
|
||||
destroys the shield
|
||||
.RE
|
||||
.PP
|
||||
\-e, \-\-exec
|
||||
.RS 4
|
||||
executes args in the shield
|
||||
.RE
|
||||
.PP
|
||||
\-\-user=USER
|
||||
.RS 4
|
||||
use this USER for \-\-exec (id or name)
|
||||
.RE
|
||||
.PP
|
||||
\-\-group=GROUP
|
||||
.RS 4
|
||||
use this GROUP for \-\-exec (id or name)
|
||||
.RE
|
||||
.PP
|
||||
\-s, \-\-shield
|
||||
.RS 4
|
||||
shield PIDSPEC specified with \-p/\-\-pid of processes or threads
|
||||
.RE
|
||||
.PP
|
||||
\-u, \-\-unshield
|
||||
.RS 4
|
||||
remove PIDSPEC specified with \-p/\-\-pid of processes or threads from the shield, the tasks keep running in the unshielded cpuset
|
||||
.RE
|
||||
.PP
|
||||
\-\-threads
|
||||
.RS 4
|
||||
if specified, any processes found in the PIDSPEC to have multiple threads will automatically have all their threads added to the PIDSPEC (use to shield or unshield all related threads)
|
||||
.RE
|
||||
.PP
|
||||
\-k on|off, \-\-kthread=on|off
|
||||
.RS 4
|
||||
shield from unbound interrupt threads as well
|
||||
.RE
|
||||
.PP
|
||||
\-f, \-\-force
|
||||
.RS 4
|
||||
force operation, use with care
|
||||
.RE
|
||||
.PP
|
||||
\-v, \-\-verbose
|
||||
.RS 4
|
||||
prints more detailed output, additive
|
||||
.RE
|
||||
.PP
|
||||
\-\-sysset=SYSSET
|
||||
.RS 4
|
||||
optionally specify system cpuset name
|
||||
.RE
|
||||
.PP
|
||||
\-\-userset=USERSET
|
||||
.RS 4
|
||||
optionally specify user cpuset name
|
||||
.RE
|
||||
.SH "DESCRIPTION"
|
||||
This is a supercommand that creates basic cpu shielding\&. The normal cset commands can of course be used to create this basic shield, but the shield command combines many such commands to create and manage a common type of cpu shielding setup\&.
|
||||
|
||||
The concept of shielding implies at minimum three cpusets, for example: root, user and system\&. The root cpuset always exists in all implementations of cpusets and contains all available CPUs on the machine\&. The system cpuset is so named because normal system tasks are made to run on it\&. The user cpuset is so named because that is the "shielded" cpuset on which you would run your tasks of interest\&.
|
||||
|
||||
Usually, CPU zero would be in the system set and the rest of the CPUs would be in the user set\&. After creation of the cpusets, all processes running in the root cpuset are moved to the system cpuset\&. Thus any new processes or threads spawned from these processes will also run the system cpuset\&.
|
||||
|
||||
If the optional \-\-kthread=on option is given to the shield command, then all kernel threads (with exception of the per\-CPU bound interrupt kernel threads) are also moved to the system set\&.
|
||||
|
||||
One executes processes on the shielded user cpuset with the \-\-exec subcommand or moves processes or threads to the shielded cpuset with the \-\-shield subcommand with a \-\-pid option\&.
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
You do not need to specify which cpuset a process or thread is running in initially when using the \-\-shield subcommand\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
To create a shield, you would execute the shield command with the \-\-cpu option that specifies CPUSPEC argument that assigns CPUs to be under the shield (this means assigned to the user cpuset, all other cpus will be assigned to the system set)\&.
|
||||
|
||||
For example:
|
||||
|
||||
\fB# cset shield \-\-cpu=1\-3\fR
|
||||
|
||||
On a 4\-way machine, this command will dedicate the first processor, CPU0, for the system set (unshielded) and the last three processors, CPU1, CPU2, CPU3, for the user set (shielded)\&.
|
||||
|
||||
The CPUSPEC will accept a comma separated list of CPUs and inclusive range specifications\&. For example, \-\-cpu=1,3,5\-7 will assign CPU1, CPU3, CPU5, CPU6, and CPU7 to the user (or shielded) cpuset and the inverse of that to the system (or unshielded) cpuset\&.
|
||||
|
||||
If you do not like the names "system" and "user" for the unshielded and shielded sets respectively, or if those names are used already, then use the \-\-sysset and \-\-userset options\&.
|
||||
|
||||
For example:
|
||||
|
||||
\fB# cset shield \-\-sysset=free \-\-userset=cage \-\-cpu=2,3 \-\-kthread=on\fR
|
||||
|
||||
The above command will use the name "free" for the unshielded system cpuset, the name "cage" for the shielded user cpuset, initialize these cpusets and dedicate CPU0 and CPU1 to the "free" set and (on a 4\-way machine) dedicate CPU2 and CPU3 to the "cage" set\&. Further, the command moves all processes and threads, including kernel threads from the root cpuset to the "free" cpuset\&.
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
If you do use the \-\-syset/\-\-userset options, then you must continue to use those for every invocation of the shield supercommand\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
After initialization, you can run the process of interest on the shielded cpuset with the \-\-exec subcommand, or move processes or threads already running to the shielded cpuset with the \-\-shield subcommand and the \-\-pid option\&.
|
||||
|
||||
Note that if your execed command takes options, then use the traditional "\-\-" marker to separate cset\(cqs options from your command\(cqs options\&.
|
||||
|
||||
For example:
|
||||
|
||||
\fB# cset shield \-\-exec \(em ls \-l\fR
|
||||
|
||||
This command will execute "ls \-l" inside the shield\&.
|
||||
|
||||
The PIDSPEC argument taken for the \-\-pid (or \-p) option is a comma separated list of PIDs or TIDs\&. The list can also include brackets of PIDs or TIDs that are inclusive of the endpoints\&.
|
||||
|
||||
For example:
|
||||
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
1,2,5 Means processes 1, 2 and 5
|
||||
1,2,600\-700 Means processes 1, 2 and from 600 to 700
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.sp
|
||||
\fB# cset shield \-\-shield \-\-pid=50\-65\fR
|
||||
|
||||
The above command moves all processes and threads with PID or TID in the range 50\-65 inclusive, from the system cpuset into the shielded user cpuset\&. If they are running in the root cpuset, you must use the \-\-force option to actually move them into the shield\&.
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
The range of PIDs or TIDs does not need to have every position populated\&. In other words, for the example above, if there is only one process, say PID 57, in the range of 50\-65, then only that process will be moved\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
The \-\-unshield (or \-u) subcommand will remove the specified processes or threads from the shielded cpuset and move them into the unshielded (or system) cpuset\&. This command is also used in conjunction with a \-p/\-\-pid option that specifies a PIDSPEC argument, the same as for the \-\-shield subcommand\&.
|
||||
|
||||
Both the \-\-shield and the \-\-unshield commands will also finally output the number of tasks running in the shield and out of the shield if you do not specify a PIDSPEC with \-\-pid\&. By specifying also a \-\-verbose in addition, then you will get a listing of every task that is running in either the shield or out of the shield\&.
|
||||
|
||||
Using no subcommand, ie\&. only "cset shield", will output the status of both shield and non\-shield\&. Tasks will be listed if \-\-verbose is used\&.
|
||||
|
||||
You can adjust which CPUs are in the shielded cpuset by issuing the \-\-cpu subcommand again anytime after the shield has been initialized\&.
|
||||
|
||||
For example if the original shield contained CPU0 and CPU1 in the system set and CPU2 and CPU3 in the user set, if you then issue the following command:
|
||||
|
||||
\fB# cset shield \-\-cpu=1,2,3\fR
|
||||
|
||||
then that command will move CPU1 into the shielded "user" cpuset\&. Any processes or threads that were running on CPU1 that belonged to the unshielded "system" cpuset are migrated to CPU0 by the system\&.
|
||||
|
||||
The \-\-reset subcommand will in essence destroy the shield\&. For example, if there was a shield on a 4\-way machine with CPU0 in system and CPUs 1\-3 in user with processes running on the user cpuset (i\&.e\&. in the shield), and a \-\-reset subcommand was issued, then all processes running in both system and user cpusets would be migrated to the root cpuset (which has access to all CPUs and never goes away), after which both system and user cpusets would be destroyed\&.
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
Even though you can mix general usage of cpusets with the shielding concepts described here, you generally will not want to\&. For more complex shielding or usage scenarios, one would generally use the normal cpuset commands (i\&.e\&. cset set and proc) directly\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
.SH "LICENSE"
|
||||
Cpuset is licensed under the GNU GPL V2 only\&.
|
||||
.SH "COPYRIGHT"
|
||||
Copyright (c) 2008\-2011 Novell Inc\&.
|
||||
.SH "AUTHOR"
|
||||
Written by Alex Tsariounov <tsariounov@gmail\&.com>\&.
|
||||
.SH "SEE ALSO"
|
||||
cset(1), cset\-set(1), cset\-proc(1)
|
||||
|
||||
/usr/share/doc/packages/cpuset/html/tutorial\&.html
|
||||
|
||||
taskset(1), chrt(1)
|
||||
|
||||
/usr/src/linux/Documentation/cpusets\&.txt
|
||||
.SH "AUTHOR"
|
||||
.PP
|
||||
\fBAlex Tsariounov\fR <\&tsariounov@gmail\&.com\&>
|
||||
.RS 4
|
||||
Author.
|
||||
.RE
|
File diff suppressed because it is too large
Load Diff
@ -1,247 +0,0 @@
|
||||
cset-shield(1)
|
||||
==============
|
||||
Alex Tsariounov <tsariounov@gmail.com>
|
||||
v1.6pre1, February 2018
|
||||
|
||||
NAME
|
||||
----
|
||||
cset-shield - cpuset supercommand which implements cpu shielding
|
||||
|
||||
SYNOPSIS
|
||||
--------
|
||||
[verse]
|
||||
'cset' [cset options] 'shield' [shield options] [args]
|
||||
'cset' shield --help
|
||||
'cset' shield
|
||||
'cset' shield --cpu 1-7
|
||||
'cset' shield --cpu 1-7 --kthread=on
|
||||
'cset' shield --exec /opt/software/myapp/doit --my_opt1 --my_opt2
|
||||
'cset' shield --user appuser --exec run_benchmark.sh
|
||||
'cset' shield --shield --pid 1024,2048,5000-1000
|
||||
'cset' shield --unshield --pid 6000-8500
|
||||
'cset' shield --kthread=off
|
||||
'cset' shield --kthread=on
|
||||
'cset' shield --shield bash
|
||||
|
||||
OPTIONS
|
||||
-------
|
||||
-h, --help::
|
||||
prints the list of options for this command
|
||||
|
||||
-c CPUSPEC, --cpu=CPUSPEC::
|
||||
modifies or initializes the shield cpusets
|
||||
|
||||
-r, --reset::
|
||||
destroys the shield
|
||||
|
||||
-e, --exec::
|
||||
executes args in the shield
|
||||
|
||||
--user=USER::
|
||||
use this USER for --exec (id or name)
|
||||
|
||||
--group=GROUP::
|
||||
use this GROUP for --exec (id or name)
|
||||
|
||||
-s, --shield::
|
||||
shield PIDSPEC specified with -p/--pid of processes or threads
|
||||
|
||||
-u, --unshield::
|
||||
remove PIDSPEC specified with -p/--pid of processes or threads from
|
||||
the shield, the tasks keep running in the unshielded cpuset
|
||||
|
||||
--threads::
|
||||
if specified, any processes found in the PIDSPEC to have multiple
|
||||
threads will automatically have all their threads added to the
|
||||
PIDSPEC (use to shield or unshield all related threads)
|
||||
|
||||
-k on|off, --kthread=on|off::
|
||||
shield from unbound interrupt threads as well
|
||||
|
||||
-f, --force::
|
||||
force operation, use with care
|
||||
|
||||
-v, --verbose::
|
||||
prints more detailed output, additive
|
||||
|
||||
--sysset=SYSSET::
|
||||
optionally specify system cpuset name
|
||||
|
||||
--userset=USERSET::
|
||||
optionally specify user cpuset name
|
||||
|
||||
DESCRIPTION
|
||||
-----------
|
||||
This is a supercommand that creates basic cpu shielding. The
|
||||
normal cset commands can of course be used to create this basic
|
||||
shield, but the shield command combines many such commands to
|
||||
create and manage a common type of cpu shielding setup.
|
||||
|
||||
The concept of shielding implies at minimum three cpusets, for
|
||||
example: root, user and system. The root cpuset always exists in
|
||||
all implementations of cpusets and contains all available CPUs on
|
||||
the machine. The system cpuset is so named because normal system
|
||||
tasks are made to run on it. The user cpuset is so named because
|
||||
that is the "shielded" cpuset on which you would run your tasks
|
||||
of interest.
|
||||
|
||||
Usually, CPU zero would be in the system set and the rest of the
|
||||
CPUs would be in the user set. After creation of the cpusets,
|
||||
all processes running in the root cpuset are moved to the system
|
||||
cpuset. Thus any new processes or threads spawned from these
|
||||
processes will also run the system cpuset.
|
||||
|
||||
If the optional --kthread=on option is given to the shield
|
||||
command, then all kernel threads (with exception of the per-CPU
|
||||
bound interrupt kernel threads) are also moved to the system set.
|
||||
|
||||
One executes processes on the shielded user cpuset with the
|
||||
--exec subcommand or moves processes or threads to the shielded
|
||||
cpuset with the --shield subcommand with a --pid option.
|
||||
|
||||
NOTE: You do not need to specify which cpuset a process or thread
|
||||
is running in initially when using the --shield subcommand.
|
||||
|
||||
To create a shield, you would execute the shield command with the
|
||||
--cpu option that specifies CPUSPEC argument that assigns CPUs to
|
||||
be under the shield (this means assigned to the user cpuset, all
|
||||
other cpus will be assigned to the system set).
|
||||
|
||||
For example:
|
||||
|
||||
*+# cset shield --cpu=1-3+*
|
||||
|
||||
On a 4-way machine, this command will dedicate the first
|
||||
processor, CPU0, for the system set (unshielded) and the last
|
||||
three processors, CPU1, CPU2, CPU3, for the user set (shielded).
|
||||
|
||||
The CPUSPEC will accept a comma separated list of CPUs and
|
||||
inclusive range specifications. For example, --cpu=1,3,5-7 will
|
||||
assign CPU1, CPU3, CPU5, CPU6, and CPU7 to the user (or shielded)
|
||||
cpuset and the inverse of that to the system (or unshielded)
|
||||
cpuset.
|
||||
|
||||
If you do not like the names "system" and "user" for the
|
||||
unshielded and shielded sets respectively, or if those names are
|
||||
used already, then use the --sysset and --userset options.
|
||||
|
||||
For example:
|
||||
|
||||
*+# cset shield --sysset=free --userset=cage --cpu=2,3 --kthread=on+*
|
||||
|
||||
The above command will use the name "free" for the unshielded
|
||||
system cpuset, the name "cage" for the shielded user cpuset,
|
||||
initialize these cpusets and dedicate CPU0 and CPU1 to the "free"
|
||||
set and (on a 4-way machine) dedicate CPU2 and CPU3 to the "cage"
|
||||
set. Further, the command moves all processes and threads,
|
||||
including kernel threads from the root cpuset to the "free"
|
||||
cpuset.
|
||||
|
||||
NOTE: If you do use the --syset/--userset options, then you must
|
||||
continue to use those for every invocation of the shield supercommand.
|
||||
|
||||
After initialization, you can run the process of interest on the
|
||||
shielded cpuset with the --exec subcommand, or move processes or
|
||||
threads already running to the shielded cpuset with the --shield
|
||||
subcommand and the --pid option.
|
||||
|
||||
Note that if your execed command takes options, then use the
|
||||
traditional "--" marker to separate cset's options from your
|
||||
command's options.
|
||||
|
||||
For example:
|
||||
|
||||
*+# cset shield --exec -- ls -l+*
|
||||
|
||||
This command will execute "ls -l" inside the shield.
|
||||
|
||||
The PIDSPEC argument taken for the --pid (or -p) option is a
|
||||
comma separated list of PIDs or TIDs. The list can also include
|
||||
brackets of PIDs or TIDs that are inclusive of the endpoints.
|
||||
|
||||
For example:
|
||||
|
||||
1,2,5 Means processes 1, 2 and 5
|
||||
1,2,600-700 Means processes 1, 2 and from 600 to 700
|
||||
|
||||
*+# cset shield --shield --pid=50-65+*
|
||||
|
||||
The above command moves all processes and threads with PID or TID
|
||||
in the range 50-65 inclusive, from the system cpuset into the
|
||||
shielded user cpuset. If they are running in the root cpuset,
|
||||
you must use the --force option to actually move them into the
|
||||
shield.
|
||||
|
||||
NOTE: The range of PIDs or TIDs does not need to have every
|
||||
position populated. In other words, for the example above, if
|
||||
there is only one process, say PID 57, in the range of 50-65,
|
||||
then only that process will be moved.
|
||||
|
||||
The --unshield (or -u) subcommand will remove the specified
|
||||
processes or threads from the shielded cpuset and move them into
|
||||
the unshielded (or system) cpuset. This command is also used in
|
||||
conjunction with a -p/--pid option that specifies a PIDSPEC
|
||||
argument, the same as for the --shield subcommand.
|
||||
|
||||
Both the --shield and the --unshield commands will also finally
|
||||
output the number of tasks running in the shield and out of the
|
||||
shield if you do not specify a PIDSPEC with --pid. By specifying
|
||||
also a --verbose in addition, then you will get a listing of
|
||||
every task that is running in either the shield or out of the
|
||||
shield.
|
||||
|
||||
Using no subcommand, ie. only "cset shield", will output the
|
||||
status of both shield and non-shield. Tasks will be listed if
|
||||
--verbose is used.
|
||||
|
||||
You can adjust which CPUs are in the shielded cpuset by issuing
|
||||
the --cpu subcommand again anytime after the shield has been
|
||||
initialized.
|
||||
|
||||
For example if the original shield contained CPU0 and CPU1 in the
|
||||
system set and CPU2 and CPU3 in the user set, if you then issue
|
||||
the following command:
|
||||
|
||||
*+# cset shield --cpu=1,2,3+*
|
||||
|
||||
then that command will move CPU1 into the shielded "user" cpuset.
|
||||
Any processes or threads that were running on CPU1 that belonged
|
||||
to the unshielded "system" cpuset are migrated to CPU0 by the
|
||||
system.
|
||||
|
||||
The --reset subcommand will in essence destroy the shield. For
|
||||
example, if there was a shield on a 4-way machine with CPU0 in
|
||||
system and CPUs 1-3 in user with processes running on the user
|
||||
cpuset (i.e. in the shield), and a --reset subcommand was issued,
|
||||
then all processes running in both system and user cpusets would
|
||||
be migrated to the root cpuset (which has access to all CPUs and
|
||||
never goes away), after which both system and user cpusets would
|
||||
be destroyed.
|
||||
|
||||
NOTE: Even though you can mix general usage of cpusets with
|
||||
the shielding concepts described here, you generally will not
|
||||
want to. For more complex shielding or usage scenarios, one
|
||||
would generally use the normal cpuset commands (i.e. cset set
|
||||
and proc) directly.
|
||||
|
||||
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>.
|
||||
|
||||
SEE ALSO
|
||||
--------
|
||||
cset(1), cset-set(1), cset-proc(1)
|
||||
|
||||
/usr/share/doc/packages/cpuset/html/tutorial.html
|
||||
|
||||
taskset(1), chrt(1)
|
||||
|
||||
/usr/src/linux/Documentation/cpusets.txt
|
@ -1,170 +0,0 @@
|
||||
'\" t
|
||||
.\" Title: cset
|
||||
.\" Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||
.\" Date: March 2016
|
||||
.\" Manual: \ \&
|
||||
.\" Source: \ \& 1.5.8
|
||||
.\" Language: English
|
||||
.\"
|
||||
.TH "CSET" "1" "March 2016" "\ \& 1\&.5\&.8" "\ \&"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "NAME"
|
||||
cset \- manage cpusets functions in the Linux kernel
|
||||
.SH "SYNOPSIS"
|
||||
.sp
|
||||
.nf
|
||||
\fIcset\fR [\-\-version | \-\-help | \-\-tohex]
|
||||
\fIcset\fR [help <command> | <command> \-\-help]
|
||||
\fIcset\fR [cset options] <command> [command options] [args]
|
||||
.fi
|
||||
.SH "DESCRIPTION"
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
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\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
Cset is a Python application to make using the cpusets facilities in the Linux kernel easier\&. The actual included command is called \fIcset\fR 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\&.
|
||||
.SS "Typical uses of cset include"
|
||||
.PP
|
||||
Setting up and managing a simple shielded CPU environment
|
||||
.RS 4
|
||||
The concept of \fIshielded\fR cpus is that a certain number of cpus are partitioned off on the system and only processes that are of interest are run on these cpus (i\&.e\&., inside the shield)\&.
|
||||
|
||||
For a simple shielded configuration, one typically uses three cpusets: the root set, a system set and a user set\&. \fICset\fR includes a super command that implements this strategy and lets you easily manage it\&. See \fIcset\-shield(1)\fR for more details\&.
|
||||
.RE
|
||||
.PP
|
||||
Setting up and managing a complex shielding environment
|
||||
.RS 4
|
||||
Shielding can be more complex of course where concepts such as priority cpusets and intersecting cpuset can be used\&. You can use \fIcset\fR to help manage this type of shielding as well\&. You will need to use the \fIcset\-set(1)\fR and \fIcset\-proc(1)\fR subcommands directly to do that\&.
|
||||
.RE
|
||||
.PP
|
||||
Managing cpusets on the system
|
||||
.RS 4
|
||||
The cset subcommand \fIcset\-set(1)\fR allows you to create and destroy arbitrary cpusets on the system and assign arbitrary cpus and memory nodes to them\&. The cpusets so created have to follow the Linux kernel cpuset rules\&. See the \fIcset\-set(1)\fR subcommand for more details\&.
|
||||
.RE
|
||||
.PP
|
||||
Managing processes that run on various system cpusets
|
||||
.RS 4
|
||||
The cset subcommand \fIcset\-proc(1)\fR allows you to manage processes running on various cpusets created on the system\&. You can exec new processes in specific cpusets and move tasks around existing cpusets\&. See the \fIcset\-proc(1)\fR subcommand for more details\&.
|
||||
.RE
|
||||
.SH "OPTIONS"
|
||||
The following generic option flags are available\&. Additional options are available per\-command, and documented in the command\-specific documentation\&.
|
||||
|
||||
.PP
|
||||
\fIcset\fR \-\-version
|
||||
.RS 4
|
||||
Display version information and exits\&.
|
||||
.RE
|
||||
.PP
|
||||
\fIcset\fR \-\-help
|
||||
.RS 4
|
||||
Prints the synopsis and a list of all commands\&.
|
||||
.RE
|
||||
.PP
|
||||
\fIcset\fR \-\-log <filename>
|
||||
.RS 4
|
||||
Creates a log file for the current run\&. All manner of useful information is stored in this file\&. This is usually used to debug cset when things don\(cqt go as planned\&.
|
||||
.RE
|
||||
.PP
|
||||
\fIcset\fR \-\-machine
|
||||
.RS 4
|
||||
Makes cset output information for all operations in a format that is machine readable (i\&.e\&. easy to parse)\&.
|
||||
.RE
|
||||
.PP
|
||||
\fIcset\fR \-\-tohex <CPUSPEC>
|
||||
.RS 4
|
||||
Converts a CPUSPEC (see \fIcset\-set(1)\fR for definition) to a hexadecimal number and outputs it\&. Useful for setting IRQ stub affinity to a cpuset definition\&.
|
||||
.RE
|
||||
.SH "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 \fIcset\-<command>(1)\fR\&. The first command, \fIhelp\fR, is especially useful as it prints out a long summary of what a particular command does\&.
|
||||
|
||||
.PP
|
||||
\fIcset help command\fR
|
||||
.RS 4
|
||||
print out a lengthy summary of how the specified subcommand works
|
||||
.RE
|
||||
.PP
|
||||
\fIcset command \-\-help\fR
|
||||
.RS 4
|
||||
print out an extended synopsis of the specified subcommand
|
||||
.RE
|
||||
.PP
|
||||
\fIcset shield\fR
|
||||
.RS 4
|
||||
supercommand to set up and manage basic shielding (see \fIcset\-shield(1)\fR)
|
||||
.RE
|
||||
.PP
|
||||
\fIcset set\fR
|
||||
.RS 4
|
||||
create, modify and destroy cpusets (see \fIcset\-set(1)\fR)
|
||||
.RE
|
||||
.PP
|
||||
\fIcset proc\fR
|
||||
.RS 4
|
||||
create and manage processes within cpusets (see \fIcset\-proc(1)\fR)
|
||||
.RE
|
||||
.SH "PERSISTENT CPUSETS"
|
||||
To create a persistent cpuset setup, i\&.e\&. one that survives a reboot, you need to create the file \fI/etc/init\&.d/cset\fR\&. This distribuition of cset includes an example cset init\&.d file found in \fI/usr/share/doc/pacakges/cpuset\fR which is called \fIcset\&.init\&.d\fR\&. You will need to alter the file to your specifications and copy it to be the file \fI/etc/init\&.d/cset\fR\&. See the comments in that file for more details\&.
|
||||
.SH "FILES"
|
||||
If used, the init\&.d script \fI/etc/init\&.d/cset\fR starts and stops a cpuset configuration on boot and poweroff\&.
|
||||
|
||||
Cpuset uses a configuration file if present on the system\&. The file is \fI/etc/cset\&.conf\fR and may contain the following options\&.
|
||||
|
||||
.PP
|
||||
mountpoint = <directory_name>
|
||||
.RS 4
|
||||
Specify the mountpoint where the cpuset filesystem is to be mounted\&. By default this is \fI/cpusets\fR; however, some people prefer to mount this in the more traditional \fI/dev/cpusets\fR\&.
|
||||
.RE
|
||||
.SH "LICENSE"
|
||||
Cpuset is licensed under the GNU GPL V2 only\&.
|
||||
.SH "COPYRIGHT"
|
||||
Copyright (c) 2008\-2011 Novell Inc\&.
|
||||
.SH "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\&.
|
||||
.SH "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
|
||||
|
||||
taskset(1), chrt(1)
|
||||
|
||||
/usr/src/linux/Documentation/cpusets\&.txt
|
||||
.SH "AUTHOR"
|
||||
.PP
|
||||
\fBAlex Tsariounov\fR <\&tsariounov@gmail\&.com\&>
|
||||
.RS 4
|
||||
Author.
|
||||
.RE
|
File diff suppressed because it is too large
Load Diff
@ -1,162 +0,0 @@
|
||||
cset(1)
|
||||
======
|
||||
Alex Tsariounov <tsariounov@gmail.com>
|
||||
v1.6pre1, February 2018
|
||||
|
||||
NAME
|
||||
----
|
||||
cset - manage cpusets functions in the Linux kernel
|
||||
|
||||
SYNOPSIS
|
||||
--------
|
||||
[verse]
|
||||
'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::
|
||||
The concept of 'shielded' cpus is that a certain number of
|
||||
cpus are partitioned off on the system and only processes that
|
||||
are of interest are run on these cpus (i.e., inside the shield).
|
||||
+
|
||||
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::
|
||||
Shielding can be more complex of course where concepts such as
|
||||
priority cpusets and intersecting cpuset can be used. You can
|
||||
use 'cset' to help manage this type of shielding as well. You
|
||||
will need to use the 'cset-set(1)' and 'cset-proc(1)'
|
||||
subcommands directly to do that.
|
||||
|
||||
Managing cpusets on the system::
|
||||
The cset subcommand 'cset-set(1)' allows you to create and
|
||||
destroy arbitrary cpusets on the system and assign arbitrary
|
||||
cpus and memory nodes to them. The cpusets so created have to
|
||||
follow the Linux kernel cpuset rules. See the 'cset-set(1)'
|
||||
subcommand for more details.
|
||||
|
||||
Managing processes that run on various system cpusets::
|
||||
The cset subcommand 'cset-proc(1)' allows you to manage
|
||||
processes running on various cpusets created on the system.
|
||||
You can exec new processes in specific cpusets and move tasks
|
||||
around existing cpusets. See the 'cset-proc(1)' subcommand
|
||||
for more details.
|
||||
|
||||
OPTIONS
|
||||
-------
|
||||
The following generic option flags are available. Additional options
|
||||
are available per-command, and documented in the command-specific
|
||||
documentation.
|
||||
|
||||
'cset' --version::
|
||||
Display version information and exits.
|
||||
|
||||
'cset' --help::
|
||||
Prints the synopsis and a list of all commands.
|
||||
|
||||
'cset' --log <filename>::
|
||||
Creates a log file for the current run. All manner of useful
|
||||
information is stored in this file. This is usually used to
|
||||
debug cset when things don't go as planned.
|
||||
|
||||
'cset' --machine::
|
||||
Makes cset output information for all operations in a format
|
||||
that is machine readable (i.e. easy to parse).
|
||||
|
||||
'cset' --tohex <CPUSPEC>::
|
||||
Converts a CPUSPEC (see 'cset-set(1)' for definition) to a
|
||||
hexadecimal number and outputs it. Useful for setting IRQ
|
||||
stub affinity to a cpuset definition.
|
||||
|
||||
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'::
|
||||
print out a lengthy summary of how the specified subcommand
|
||||
works
|
||||
'cset command --help'::
|
||||
print out an extended synopsis of the specified subcommand
|
||||
|
||||
'cset shield'::
|
||||
supercommand to set up and manage basic shielding (see
|
||||
'cset-shield(1)')
|
||||
'cset set'::
|
||||
create, modify and destroy cpusets (see 'cset-set(1)')
|
||||
'cset proc'::
|
||||
create and manage processes within cpusets (see
|
||||
'cset-proc(1)')
|
||||
|
||||
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 distribuition 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>::
|
||||
Specify the mountpoint where the cpuset filesystem is to be
|
||||
mounted. By default this is '/cpusets'; however, some people
|
||||
prefer to mount this in the more traditional '/dev/cpusets'.
|
||||
|
||||
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
|
||||
|
||||
taskset(1), chrt(1)
|
||||
|
||||
/usr/src/linux/Documentation/cpusets.txt
|
@ -1,3 +0,0 @@
|
||||
[titles]
|
||||
underlines="##","==","--","~~","^^"
|
||||
|
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -1,24 +0,0 @@
|
||||
#!/bin/bash
|
||||
|
||||
VER=${1:?Provide version sring on command line}
|
||||
DATE=$(TZ=UTC LOCALE=C date '+%B %e, %Y')
|
||||
DATE_SHORT=$(TZ=UTC LOCALE=C date '+%B %Y')
|
||||
|
||||
sed -i "4s/.*/v$VER, $DATE_SHORT/" doc/cset{,-proc,-set,-shield}.txt
|
||||
sed -i "s/cset v\([[:digit:]]\+\.\)\+[[:digit:]]\+ /cset v$VER /" doc/tutorial.txt
|
||||
sed -i "s/^\(Version:[[:space:]]*\).*/\1$VER/" cpuset.spec
|
||||
sed -i "s/^\(version = '*\).*\('[[:space:]]*$\)/\1$VER\2/" cpuset/version.py
|
||||
sed -i "1i \
|
||||
============================================================\n\
|
||||
Cpuset $VER ($DATE)\n\
|
||||
https://github.com/lpechacek/cpuset\n\
|
||||
http://download.opensuse.org/repositories/home:/LPechacek:/cpuset-release/\n\
|
||||
\n
|
||||
" NEWS
|
||||
${EDITOR:-vi} NEWS
|
||||
TEMP=$(mktemp)
|
||||
sed '6,/^===/{/^=/d;p};d' NEWS > $TEMP
|
||||
git commit -s -t $TEMP cpuset.spec cpuset/version.py NEWS \
|
||||
doc/cset{,-proc,-set,-shield}.txt doc/tutorial.txt
|
||||
rm -f $TEMP
|
||||
git tag v$VER
|
@ -1,7 +0,0 @@
|
||||
[install]
|
||||
prefix: /usr
|
||||
|
||||
[bdist_rpm]
|
||||
group=System/Management
|
||||
build_requires=python python-devel asciidoc xmlto
|
||||
requires=python
|
@ -1,38 +0,0 @@
|
||||
#!/usr/bin/env python
|
||||
|
||||
import glob
|
||||
from distutils.core import setup
|
||||
|
||||
from cpuset.version import version
|
||||
|
||||
setup(name = 'cpuset',
|
||||
version = version,
|
||||
license = 'GPLv2',
|
||||
author = 'Alex Tsariounov',
|
||||
author_email = 'tsariounov@gmail.com',
|
||||
maintainer = 'Libor Pechacek',
|
||||
maintainer_email = 'lpechacek@suse.com',
|
||||
url = 'https://github.com/lpechacek/cpuset',
|
||||
description = 'Allows manipulation of cpusets and provides higher level functions.',
|
||||
long_description = \
|
||||
'Cpuset is a Python application to make using the cpusets facilities in the Linux\n'
|
||||
'kernel easier. The actual included command is called cset and it allows\n'
|
||||
'manipulation of cpusets on the system and provides higher level functions such as\n'
|
||||
'implementation and control of a basic cpu shielding setup.',
|
||||
classifiers=[
|
||||
'Development Status :: 5 - Production/Stable',
|
||||
'Environment :: Console',
|
||||
'Intended Audience :: System Administrators',
|
||||
'License :: OSI Approved :: GNU General Public License v2 (GPLv2)',
|
||||
'Operating System :: POSIX :: Linux',
|
||||
'Programming Language :: Python :: 3.4',
|
||||
'Topic :: System :: Systems Administration',
|
||||
],
|
||||
scripts = ['cset'],
|
||||
packages = ['cpuset', 'cpuset.commands'],
|
||||
data_files = [
|
||||
('share/doc/packages/cpuset', ['README', 'COPYING', 'AUTHORS', 'NEWS', 'INSTALL']),
|
||||
('share/doc/packages/cpuset', glob.glob('doc/*.html')),
|
||||
('share/doc/packages/cpuset', glob.glob('doc/*.txt')),
|
||||
]
|
||||
)
|
@ -1,27 +0,0 @@
|
||||
# Run cpuset tests
|
||||
# Suite design taken from git which is Copyright (c) 2005 Junio C Hamano
|
||||
#
|
||||
# Copyright (C) 2007 Novell Inc.
|
||||
# Author: Alex Tsariounov <tsariounov@gmail.com>
|
||||
#
|
||||
|
||||
#CSET_TEST_OPTS=--verbose --debug
|
||||
SHELL_PATH ?= $(SHELL)
|
||||
TAR ?= $(TAR)
|
||||
|
||||
# Shell quote;
|
||||
SHELL_PATH_SQ = $(subst ','\'',$(SHELL_PATH))
|
||||
|
||||
T = $(wildcard t[0-9][0-9][0-9][0-9]-*.sh)
|
||||
|
||||
all: $(T) clean
|
||||
|
||||
$(T):
|
||||
@echo "*** $@ ***"; '$(SHELL_PATH_SQ)' $@ $(GIT_TEST_OPTS)
|
||||
|
||||
clean:
|
||||
rm -fr trash
|
||||
|
||||
.PHONY: $(T) clean
|
||||
.NOPARALLEL:
|
||||
|
Loading…
Reference in New Issue