1
0
Fork 0
Tuning Profile Delivery Mechanism for Linux
Find a file
Jan Zerdik 3e3f4678e8 Expose TuneD API to the Unix Domain Socket.
TuneD is listening on paths specified in config in option unix_socket_paths and send signals to paths in option unix_socket_signal_paths.
Example call:

printf '[{"jsonrpc": "2.0", "method": "active_profile", "id": 1}, 1]' | sudo nc -U /run/tuned/tuned.sock
printf '{"jsonrpc": "2.0", "method": "switch_profile", "params": {"profile_name": "balanced"}, "id": 1}' | sudo nc -U /run/tuned/tuned.sock

This PR also introduce possibility to disable dbus API in main TuneD config.

Resolves: rhbz#2113900

Signed-off-by: Jan Zerdik <jzerdik@redhat.com>
2023-02-08 12:21:05 +01:00
.fmf Fix packit / TMT tests. 2019-11-19 18:32:09 -02:00
.github/workflows Add CodeQL workflow for GitHub code scanning 2022-11-09 07:41:20 +00:00
contrib Fixed sysvinit path 2022-10-20 15:17:43 +02:00
doc breaking up various modules and implementing neccessary new syntax used downstream to keep docs repos synced 2021-06-09 14:10:28 +02:00
experiments Project renamed to TuneD 2021-05-17 22:09:02 +02:00
icons Added tuned icon and desktop file for GUI 2016-03-22 17:11:42 +01:00
libexec Mark defirqaffinity.py deprecated via stderr/log message 2019-11-28 10:53:36 +01:00
man correct section of the tuned-profiles-openshift manpage 2022-12-21 20:33:51 +01:00
profiles Merge pull request #491 from yarda/rhbz1998310 2023-02-08 02:05:50 +01:00
systemtap Use python3 interpreter by default 2019-11-18 11:21:33 +01:00
tests Merge pull request #417 from CZerta/rhbz1891036_striping_quotes_when_unpacking_cpu_list 2022-08-09 16:11:40 +02:00
tuned Expose TuneD API to the Unix Domain Socket. 2023-02-08 12:21:05 +01:00
.gitignore Added user-facing documentation: initial commit 2019-01-04 18:08:28 +01:00
.packit.yaml packit: s/synced_files/files_to_sync/ 2022-08-15 10:10:38 +02:00
00_tuned bootloader: add support for initrd overlays 2017-03-01 15:56:17 +01:00
92-tuned.install bootloader: on s390(x) remove TuneD variables from the BLS 2022-02-01 22:30:14 +01:00
AUTHORS Added tuned icon and desktop file for GUI 2016-03-22 17:11:42 +01:00
bootcmdline Project renamed to TuneD 2021-05-17 22:09:02 +02:00
ci.fmf ci: beakerlib tests fixes 2021-05-20 14:54:45 +02:00
com.redhat.tuned.policy Merge pull request #487 from evgeni/patch-2 2023-02-08 02:01:27 +01:00
CONTRIBUTING.md Project renamed to TuneD 2021-05-17 22:09:02 +02:00
COPYING update GPLv2 license text (new FSF address) 2012-03-12 17:53:24 +01:00
dbus.conf Implemented polkit authorization 2016-06-10 11:57:33 +02:00
DCO Add contribution guidelines 2019-01-31 11:19:16 +01:00
INSTALL Replaced python-dmidecode with reading sysfs dmi and dmidecode tool. 2020-06-15 18:30:03 +02:00
Makefile Merge pull request #490 from yarda/python312-fix 2023-02-08 02:05:18 +01:00
modules.conf Project renamed to TuneD 2021-05-17 22:09:02 +02:00
README Merge pull request #456 from uniontech-lilinjie/tuned-adm-README 2022-10-03 01:12:29 +02:00
recommend.conf Removing dependency on python-configobj. 2021-08-18 10:28:27 +02:00
TODO tuned-adm: Print log excerpt when changing profile 2018-06-11 09:56:14 +02:00
tuned-adm.bash fix a few spelling errors in the manpage 2022-08-15 18:41:24 +08:00
tuned-adm.py Use python3 interpreter by default 2019-11-18 11:21:33 +01:00
tuned-gui.desktop Project renamed to TuneD 2021-05-17 22:09:02 +02:00
tuned-gui.glade Project renamed to TuneD 2021-05-17 22:09:02 +02:00
tuned-gui.py Merge pull request #494 from uniontech-lilinjie/fix-typos 2023-02-08 11:15:42 +01:00
tuned-main.conf Expose TuneD API to the Unix Domain Socket. 2023-02-08 12:21:05 +01:00
tuned.py Expose TuneD API to the Unix Domain Socket. 2023-02-08 12:21:05 +01:00
tuned.service systemd: relax polkit requirement 2022-10-11 12:07:08 +02:00
tuned.spec Add new cpu-partitioning-powersave profile 2022-11-22 17:50:30 +01:00
tuned.tmpfiles Use /run instead of /var/run 2012-10-25 12:05:16 +02:00

TuneD: Daemon for monitoring and adaptive tuning of system devices.

(This is tuned 2.0 with a new code base. If you are looking for the older
version, please check out branch '1.0' in our Git repository.)

How to use it
-------------

TuneD is incompatible with the cpupower and power-profiles-daemon. If you
have these services, uninstall or disable them.

In Fedora, Red Hat Enterprise Linux, and their derivates install tuned package
(optionally tuned-utils, tuned-utils-systemtap, and tuned-profiles-compat):

# dnf install tuned

After the installation, start the tuned service:

# systemctl start tuned

You might also want to run tuned whenever your machine starts:

# systemctl enable tuned

If the daemon is running you can easily control it using 'tuned-adm' command
line utility. This tool communicates with the daemon over DBus. Any user can
list the available profiles and see which one is active. But the profiles can
be switched only by root user or by any user with physical console allocated
on the machine (X11, physical tty, but no SSH).

To see the current active profile, run:

# tuned-adm active

To list all available profiles, run:

# tuned-adm list

To switch to a different profile, run:

# tuned-adm profile <profile-name>

Your profile choice is also written into /etc/tuned/active_profile and this
choice is used when the daemon is restarted (e.g. with the machine reboot).

To disable all tunings, run:
# tuned-adm off

To show information/description of given profile or current profile if no profile is specified, run:
# tuned-adm profile_info

To verify current profile against system settings, run:
# tuned-adm verify

To enable automatic profile selection mode, switch to the recommended profile, run:
# tuned-adm auto_profile

To show current profile selection mode, run:
# tuned-adm profile_mode

# tuned-adm recommend
Recommend 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. They can be overridden by the user by
putting a file to /etc/tuned/recommend.d or a file named recommend.conf into
/etc/tuned (see tuned-adm(8) for more details). The default rules recommend
profiles targeted to the best performance or the balanced profile if unsure.

Available tunings
-----------------

We are currently working on many new tuning features. Some are described in
the manual pages, some are yet undocumented.


Authors
-------

The best way to contact the authors of the project is to use our mailing list:
power-management@lists.fedoraproject.org

In case you want to contact individual author, you will find the e-mail
address in every commit message in our Git repository:
https://github.com/redhat-performance/tuned.git

You can also join #fedora-power IRC channel on Freenode.

Web page:
https://tuned-project.org/

Contributing
------------
See the file CONTRIBUTING.md for guidelines for contributing.

License
-------

Copyright (C) 2008-2021 Red Hat, Inc.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Full text of the license is enclosed in COPYING file.

The Developer Certificate of Origin, distributed in the file 'DCO' is licensed
differently, see the file for the text of the license.


The icon:

The TuneD icon was created by Mariia Leonova <mleonova@redhat.com> and it is
licensed under Creative Commons Attribution-ShareAlike 3.0 license
(http://creativecommons.org/licenses/by-sa/3.0/legalcode).