Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 26 additions & 12 deletions xml/MAIN.SLERT.xml
Original file line number Diff line number Diff line change
@@ -1,19 +1,15 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="urn:x-suse:xslt:profiling:docbook51-profile.xsl"
type="text/xml"
title="Profiling step"?>
<!DOCTYPE set
[
<?xml version="1.0"?>
<!DOCTYPE set [
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>
<!-- Converted by suse-upgrade version 1.1 -->
<set version="5.0" xml:lang="en" xml:id="set-slert"
xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink">

<?xml-stylesheet href="urn:x-suse:xslt:profiling:docbook51-profile.xsl"
type="text/xml"
title="Profiling step"?><!-- Converted by suse-upgrade version 1.1 -->
<set xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="set-slert">
<title>&slert; Documentation</title>
<info>
<info xmlns:d="http://docbook.org/ns/docbook">
<productname>&productname;</productname>
<productname role="abbrev">&productnameshort;</productname>
<productnumber>&productnumber;</productnumber>
Expand All @@ -26,12 +22,30 @@
</dm:bugtracker>
<dm:translation>no</dm:translation>
</dm:docmanager>
<revhistory xml:id="rh-book-slert-qs">
<revision>
<date>2020-02-04</date>
<revdescription>
<para/>
</revdescription>
</revision>
</revhistory>
</info>

<xi:include href="book_slert_shielding.xml"/>

<book version="5.0" xml:lang="en" xml:id="book-slert-qs">
<title>Quick Start Manuals</title>
<info xmlns:d="http://docbook.org/ns/docbook">
<revhistory xml:id="rh-set-slert">
<revision>
<date>2020-02-04</date>
<revdescription>
<para/>
</revdescription>
</revision>
</revhistory>
</info>
<xi:include href="art_slert_quickstart.xml"/>
<xi:include href="art_slert_hw_testing.xml"/>
<xi:include href="art_slert_virtguide.xml"/>
Expand Down
15 changes: 12 additions & 3 deletions xml/common_copyright_gfdl.xml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE legalnotice
[
<?xml version="1.0"?>
<!DOCTYPE legalnotice [
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>

<!-- Converted by suse-upgrade version 1.1 -->
<!--
Please keep this document neatly formatted, because a text version
Expand All @@ -12,6 +12,15 @@
in the txt file as is.
-->
<legalnotice xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink">
<info xmlns:d="http://docbook.org/ns/docbook"><revhistory>
<revision>
<date>2016-12-23</date>
<revdescription>
<para/>
</revdescription>
</revision>
</revhistory>
</info>
<para>
Copyright &copy; 2006&ndash;<?dbtimestamp format="Y"?>
SUSE LLC and contributors. All rights reserved.
Expand Down
16 changes: 12 additions & 4 deletions xml/common_legal.xml
Original file line number Diff line number Diff line change
@@ -1,13 +1,21 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE appendix
[
<?xml version="1.0"?>
<!DOCTYPE appendix [
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>

<!-- Converted by suse-upgrade version 1.1 -->
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" role="legal">
<title>GNU Licenses</title>
<info/>
<info xmlns:d="http://docbook.org/ns/docbook"><revhistory>
<revision>
<date>2015-12-15</date>
<revdescription>
<para/>
</revdescription>
</revision>
</revhistory>
</info>
<para>
This appendix contains the GNU Free Documentation License version 1.2.
</para>
Expand Down
60 changes: 34 additions & 26 deletions xml/slert_cpuset_manipulation.xml
Original file line number Diff line number Diff line change
@@ -1,13 +1,21 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter
[
<?xml version="1.0"?>
<!DOCTYPE chapter [
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>

<!-- Converted by suse-upgrade version 1.1 -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="cha-shielding-cpuset">
<title>Full Featured Cpuset Manipulation Commands</title>
<info/>
<info xmlns:d="http://docbook.org/ns/docbook"><revhistory xml:id="rh-cha-shielding-cpuset">
<revision>
<date>2019-07-30</date>
<revdescription>
<para/>
</revdescription>
</revision>
</revhistory>
</info>
<para>
While basic shielding as described above is useful and a common use model
for <command>cset</command>, there comes a time when more functionality
Expand All @@ -31,7 +39,7 @@
The basic syntax of <command>set</command> for cpuset creation is:
</para>
<screen>&prompt.user;<command>cset</command> set -c 1-3 -s my_cpuset1
cset: --> created cpuset "my_cpuset1"</screen>
cset: --&gt; created cpuset "my_cpuset1"</screen>
<para>
This creates a cpuset named <literal>my_cpuset1</literal> with a CPUSPEC
of CPU1, CPU2 and CPU3. The CPUSPEC is the same concept as described in
Expand All @@ -50,7 +58,7 @@ cset: --> created cpuset "my_cpuset1"</screen>
omit CPU2), then issue the following command.
</para>
<screen>&prompt.user;<command>cset</command> set -c 1,3 -s my_cpuset1
cset: --> modified cpuset "my_cpuset</screen>
cset: --&gt; modified cpuset "my_cpuset</screen>
<para>
<command>cset</command> will then adjust the CPUs that are assigned to
the <literal>my_cpuset1</literal> set to only use CPU1 and CPU3.
Expand All @@ -60,7 +68,7 @@ cset: --> modified cpuset "my_cpuset</screen>
example:
</para>
<screen>&prompt.user;<command>cset</command> set -s my_cpuset1 -n super_set
cset: --> renaming "/cpusets/my_cpuset1" to "super_set"</screen>
cset: --&gt; renaming "/cpusets/my_cpuset1" to "super_set"</screen>
<para>
Renames the cpuset called <literal>my_cpuset1</literal> to
<literal>super_set</literal>.
Expand All @@ -70,8 +78,8 @@ cset: --> renaming "/cpusets/my_cpuset1" to "super_set"</screen>
follows.
</para>
<screen>&prompt.user;<command>cset</command> set -d super_set
cset: --> processing cpuset "super_set", moving 0 tasks to parent "/"...
cset: --> deleting cpuset "/super_set"
cset: --&gt; processing cpuset "super_set", moving 0 tasks to parent "/"...
cset: --&gt; deleting cpuset "/super_set"
cset: done</screen>
<para>
This command destroys the newly created cpuset called
Expand Down Expand Up @@ -99,11 +107,11 @@ cset: done</screen>
example:
</para>
<screen>&prompt.user;<command>cset</command> set -c 1,3 -s top_set
cset: --> created cpuset "top_set"
cset: --&gt; created cpuset "top_set"


&prompt.user;<command>cset</command> set -c 3 -s /top_set/sub_set
cset: --> created cpuset "/top_set/sub_set"</screen>
cset: --&gt; created cpuset "/top_set/sub_set"</screen>
<para>
These commands created two cpusets: <literal>top_set</literal> and
<literal>sub_set</literal>. The <literal>top_set</literal> uses CPU1 and
Expand All @@ -114,7 +122,7 @@ cset: --> created cpuset "/top_set/sub_set"</screen>
ask you to use the path. For example:
</para>
<screen>&prompt.user;<command>cset</command> set -c 1,3 -s sub_set
cset: --> modified cpuset "sub_set</screen>
cset: --&gt; modified cpuset "sub_set</screen>
<para>
This command adds CPU1 to the <literal>sub_set</literal> cpuset for its
use. Note that using the path in this case is optional.
Expand Down Expand Up @@ -312,7 +320,7 @@ alext 16165 1 Soth beagled /usr/lib64/beagle/BeagleDaemon.exe --bg --auto
cset: "two" cpuset of CPUSPEC(2) with 0 tasks running

&prompt.user;<command>cset</command> proc -s two -e bash
cset: --> last message, executed args into cpuset "/two", new pid is: 20955
cset: --&gt; last message, executed args into cpuset "/two", new pid is: 20955

&prompt.user;<command>cset</command> proc -l -s two
cset: "two" cpuset of CPUSPEC(2) with 2 tasks running
Expand Down Expand Up @@ -372,8 +380,8 @@ root 21147 21118 Roth python ./cset proc -l two</screen>
</para>
</tip>
<screen>&prompt.user;<command>cset</command> proc -s two -e blah-blah
cset: --> last message, executed args into cpuset "/two", new pid is: 21655
cset: **> [Errno 2] No such file or directory</screen>
cset: --&gt; last message, executed args into cpuset "/two", new pid is: 21655
cset: **&gt; [Errno 2] No such file or directory</screen>
<para>
The result is no new process even though a new PID is output. The reason
for the message is of course that the <command>cset</command> process
Expand Down Expand Up @@ -609,7 +617,7 @@ three 3 n 0 n 10 0 /three</screen>
<screen>&prompt.user;<command>cset</command> proc -k -f root -t two
cset: moving all kernel threads from / to /two
cset: moving 70 kernel threads to: /two
cset: --> not moving 76 threads (not unbound, use --force)
cset: --&gt; not moving 76 threads (not unbound, use --force)
[==================================================]%
cset: done</screen>
<para>
Expand All @@ -627,7 +635,7 @@ cset: done</screen>
<screen>&prompt.user;<command>cset</command> proc -k -f two -t root
cset: moving all kernel threads from /two to /
cset: ** no task matched move criteria
cset: **> kernel tasks are bound, use --force if ok
cset: **&gt; kernel tasks are bound, use --force if ok


&prompt.user;<command>cset</command> set -l -s two
Expand Down Expand Up @@ -728,11 +736,11 @@ cset: done</screen>
</para>

<screen>&prompt.user;<command>cset</command> set -c 0 -s system
cset: --> created cpuset "system"
cset: --&gt; created cpuset "system"


&prompt.user;<command>cset</command> set -c 1-3 -s user
cset: --> created cpuset "user"
cset: --&gt; created cpuset "user"


&prompt.user;<command>cset</command> set -l
Expand Down Expand Up @@ -778,7 +786,7 @@ system 0 n 0 n 187 0 /system</screen>
<screen>&prompt.user;<command>cset</command> proc -k -f root -t system
cset: moving all kernel threads from / to /system
cset: moving 70 kernel threads to: /system
cset: --> not moving 76 threads (not unbound, use --force)
cset: --&gt; not moving 76 threads (not unbound, use --force)
[==================================================]%
cset: done

Expand Down Expand Up @@ -881,23 +889,23 @@ root 0-3 y 0 y 344 0 /


&prompt.user;<command>cset</command> set -c 0-3 prio_all
cset: --> created cpuset "prio_all"
cset: --&gt; created cpuset "prio_all"


&prompt.user;<command>cset</command> set -c 1-3 /prio_all/prio_high
cset: --> created cpuset "/prio_all/prio_high"
cset: --&gt; created cpuset "/prio_all/prio_high"


&prompt.user;<command>cset</command> set -c 2-3 /prio_all/prio_high/prio_med
cset: --> created cpuset "/prio_all/prio_high/prio_med"
cset: --&gt; created cpuset "/prio_all/prio_high/prio_med"


&prompt.user;<command>cset</command> set -c 3 /prio_all/prio_high/prio_med/prio_low
cset: --> created cpuset "/prio_all/prio_high/prio_med/prio_low"
cset: --&gt; created cpuset "/prio_all/prio_high/prio_med/prio_low"


&prompt.user;<command>cset</command> set -c 0 system
cset: --> created cpuset "system"
cset: --&gt; created cpuset "system"


&prompt.user;<command>cset</command> set -l -r
Expand Down Expand Up @@ -931,7 +939,7 @@ prio_low 3 n 0 n 0 0 /prio_all/pr...rio_med/prio_low</
cset: moving all tasks from root to /system
cset: moving 198 userspace tasks to /system
cset: moving 70 kernel threads to: /system
cset: --> not moving 76 threads (not unbound, use --force)
cset: --&gt; not moving 76 threads (not unbound, use --force)
[==================================================]%
cset: done

Expand Down
16 changes: 12 additions & 4 deletions xml/slert_gettinghelp.xml
Original file line number Diff line number Diff line change
@@ -1,13 +1,21 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter
[
<?xml version="1.0"?>
<!DOCTYPE chapter [
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>

<!-- Converted by suse-upgrade version 1.1 -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="cha-shieldingt-help">
<title>What to Do If There Are Problems</title>
<info/>
<info xmlns:d="http://docbook.org/ns/docbook"><revhistory xml:id="rh-cha-shieldingt-help">
<revision>
<date>2019-08-08</date>
<revdescription>
<para/>
</revdescription>
</revision>
</revhistory>
</info>
<para>
If you encounter any issues with the <command>cset</command> application,
you can file a bug report here:
Expand Down
16 changes: 12 additions & 4 deletions xml/slert_intro.xml
Original file line number Diff line number Diff line change
@@ -1,13 +1,21 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter
[
<?xml version="1.0"?>
<!DOCTYPE chapter [
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>

<!-- Converted by suse-upgrade version 1.1 -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="cha-shielding-intro">
<title>Introduction</title>
<info/>
<info xmlns:d="http://docbook.org/ns/docbook"><revhistory xml:id="rh-cha-shielding-intro">
<revision>
<date>2019-07-30</date>
<revdescription>
<para/>
</revdescription>
</revision>
</revhistory>
</info>
<para>
In the Linux kernel, the cpuset facility provides a mechanism for creating
logical entities called <quote>cpusets</quote> that encompass definitions
Expand Down
Loading