Provided by: tuna_0.14-1build1_amd64 
NAME
tuna - program for tuning running processes
SYNOPSIS
tuna [OPTIONS]
DESCRIPTION
This manual page explains the tuna program. The program can be used to change the attributes of
application and kernel threads. tuna can operate on IRQs by name or number, and tasks or threads by
process ID or command-line. CPUs and sets of CPUs can be specified by CPU or socket number. IRQ names and
process command-lines can include wildcards.
tuna can change scheduling policy, scheduler priority and processor affinity for processes and process
threads. tuna can also change the processor affinity for interrupts. When tuna is invoked without any
options it starts up in its graphical interface mode. This manual page explains only the command-line
options for tuna
OPTIONS
tuna has both action options and modifier options. Modifier options must be specified on the command-line
before the actions they are intended to modify. Any modifier option applies to following actions on the
same command-line until it is over-ridden.
Actions
-h, --help
Print a list of options. tuna will exit after this action, ignoring the remainder of the command-
line.
-g, --gui
Start the GUI. Actions that follow this on the command-line will be processed without waiting for
the GUI to complete.
-a, --config_file_apply=profilename
Apply changes described in profile
-l, --config_file_list
List preloaded profiles
-i, --isolate
Move all threads away from CPU-LIST. Requires -c or -S.
-I, --include
Allow all threads to run on CPU-LIST. Requires -c or -S.
-m, --move
Move selected entities to CPU-LIST. Requires -c and either -t or -q.
-p, --priority=[POLICY:]RTPRIO
Set thread scheduler tunables: POLICY and RTPRIO. POLICY is one of OTHER, FIFO, RR, or BATCH. If
-t is not set, -p will act as a Modifier saving the sched tunables for future Actions, for example
-r.
-P, --show_threads
Show thread list.
-s, --save=FILENAME
Save kthreads sched tunables to FILENAME.
-r, --run="COMMAND"
Run the COMMAND. If arguments are passed, the entire command line must be provided inside
"quotes". Modifiers -c and -p can be used to set the affinity and scheduler tunables of the given
COMMAND. The arg[0] (i.e. the command) will be set in THREAD-LIST. Likewise the -t, the COMMAND
accepts the prefix + and - as wildcards in order to be appended or removed from THREAD-LIST,
respectively.
-v, --version
Show version
-W, --what_is
Provides help about selected entities. Requires -t.
-x, --spread
Spread selected entities over CPU-LIST. Requires at least one of -t or -q. The specified threads
and IRQs are each assigned to one cpu in CPU-LIST.
Modifiers
-c, --cpus=CPU-LIST
CPU-LIST affected by commands. Requires a CPU number or a comma-separated list of CPU numbers.
-C, --affect_children
Operation will affect children threads.
-f, --filter
Disable display of selected CPUs in --gui. Requires -c.
-G, --cgroup
Display the processes with the type of cgroups they are in. Requires -P.
-K, --no_kthreads
Operations will not affect kernel threads.
-q, --irqs=IRQ-LIST
IRQ-LIST affected by commands. Requires an IRQ number or a comma-separated list of IRQ numbers.
-S, --sockets=CPU-SOCKET-LIST
CPU-SOCKET-LIST affected by commands. Requires a socket number or a comma-separated list of socket
numbers.
-t, --threads=THREAD-LIST
THREAD-LIST affected by commands. Requires a thread number or thread name, or a comma-separated
list of thread numbers and/or names. Thread names may contain wildcards. Be sure to quote or
escape any wildcard specifications. If only - is passed as argument, the THREAD-LIST will be
cleared.
-U, --no_uthreads
Operations will not affect user threads.
USAGE EXAMPLES
If for instance the Ethernet NICs have multiple queues for both receive and transmit, each with its own
IRQ, the Ethernet IRQs can be associated with a CPU socket:
tuna -S 2 -i -q 'eth*' -x
Move everything off the CPUs in socket 2, then spread the IRQs for the Ethernet devices across
those same CPUs.