Ubuntu Manpage: tuned-adm - command line tool for switching between different tuning profiles

NAME

       tuned-adm - command line tool for switching between different tuning profiles

SYNOPSIS

       tuned-adm  [list  |  active  |  profile  [profile]...  | profile_info [profile]... | off | auto_profile |
       profile_mode | verify [-i | --ignore-missing] | recommend | instance_acquire_devices devices  instance  |
       get_instances [plugin] | instance_get_devices instance]

DESCRIPTION

       This command line utility allows you to switch between user definable tuning profiles. Several predefined
       profiles are already included. You can even create your own profile, either based on one of the  existing
       ones  by  copying  it  or  make  a  completely  new one. The distribution provided profiles are stored in
       subdirectories below /usr/lib/tuned and the user defined profiles in subdirectories below /etc/tuned.  If
       there are profiles with the same name in both places, user defined profiles have precedence.

OPTIONS

list List all available profiles.

profiles List all available profiles.

plugins List all available plugins.

-v, --verbose List plugin's configuration options and their hints.

active Show current active profile.

profile [PROFILE_NAME]...
Switches to the given profile. If more than one profile is given, the profiles are merged (in case
of conflicting settings, the setting from the last profile is used) and the resulting profile is
applied. If no profile is given, then all available profiles are listed. If the profile given is
not valid, the command gracefully exits without performing any operation.

profile_info [PROFILE_NAME]...
Show information/description of given profile or current profile if no profile is specified.

verify [-i | --ignore-missing]
Verifies current profile against system settings. Outputs information whether system settings
match current profile or not (e.g. somebody modified a sysfs/sysctl value by hand). Detailed
information about what is checked, what value is set and what value is expected can be found in
the log. With the -i or --ignore-missing it does not treat missing tuning (tuning unsupported by
the platform) as error.

recommend
Recommend a profile suitable for your system. Currently only static detection is implemented - it
decides according to data in /etc/system-release-cpe and virt-what output. The rules for
autodetection are defined in the file /usr/lib/tuned/recommend.d/50-tuned.conf. The default rules
recommend profiles targeted to the best performance, or the balanced profile if unsure.

The default rules can be overridden by the user by putting a file named recommend.conf into
/etc/tuned, or by creating a file in the /etc/tuned/recommend.d directory. The file
/etc/tuned/recommend.conf is evaluated first. If no match is found, the files in the
/etc/tuned/recommend.d directory are merged with the files in the /usr/lib/tuned/recommend.d
directory (if there is a file with the same name in both directories, the one from
/etc/tuned/recommend.d is used) and the files are evaluated in alphabetical order. The first
matching entry is used.

auto_profile
Enable automatic profile selection mode, switch to the recommended profile.

profile_mode
Show current profile selection mode.

instance_acquire_devices devices instance
Move all provided devices under the given plugin instance. The plugin instance is identified using
its name from the TuneD profile.

The devices are specified using a comma-separated list. When moving a set of CPUs, it is possible
to use the cpulist syntax by including the 'cpulist:' prefix. For instance, 'cpulist:0,2-4' will
move the devices cpu0, cpu1, cpu2, and cpu4.

get_instances [plugin]
List active instances of a given plugin or all active instances if no plugin is specified.

instance_get_devices instance
List devices currently assigned to a given instance.

off Unload tunings.

FILES

       /etc/tuned/*
       /usr/lib/tuned/*

AUTHOR