blob: ca817bae61502176500d183e290a26d3d1af91db (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
rts
===
rts - as in `*r*eal-*t*ime *s*settings` is a script used by a |systemd| |systemd.service|, allowing to set pre-defined real-time related scheduling settings.
This software and all of its components are licensed under the GPLv3.
Requirements
------------
* |linux-rt|
* |tuna|
"REALTIME" kernel parameter
---------------------------
| *rts.service* and *rts@.service* are dependant on the |kernel_parameter| *"systemd.setenv=REALTIME=true"*. The option itself sets nothing but an Environment for systemd.
| This enables the services to by using *ConditionKernelCommandLine* in their *[Unit]* sections, if running a |real-time_kernel|.
| Simply add this to your kernel parameters (for |linux-rt|), using |grub|, |syslinux|, or |systemd-boot|:
.. code:: bash
systemd.setenv=REALTIME=true
Usage
-----
| When starting the systemd service *rts.service*, the general settings file */etc/rts/rts* will be sourced.
| Using *rts@.service* a configuration file (by the name of the word following the *@*) below `/etc/rts/` will be used.
| Some examples can be found in `/etc/rts/examples`. For further settings and a general overview, please have a look at the |tuna_documentation|
.. |systemd| raw:: html
<a href="https://en.wikipedia.org/wiki/Systemd" target="_blank">systemd</a>
.. |systemd.service| raw:: html
<a href="http://www.freedesktop.org/software/systemd/man/systemd.service.html" target="_blank">service</a>
.. |real-time_kernel| raw:: html
<a href="https://www.kernel.org/pub/linux/kernel/projects/rt/" target="_blank">real-time kernel</a>
.. |linux-rt| raw:: html
<a href="https://aur.archlinux.org/packages/linux-rt/" target="_blank">linux-rt</a>
.. |kernel_parameter| raw:: html
<a href="https://www.kernel.org/doc/Documentation/kernel-parameters.txt" target="_blank">kernel parameter</a>
.. |grub| raw:: html
<a href="https://wiki.archlinux.org/index.php/Kernel_parameters#GRUB" target="_blank">GRUB</a>
.. |syslinux| raw:: html
<a href="https://wiki.archlinux.org/index.php/Kernel_parameters#Syslinux" target="_blank">syslinux</a>
.. |systemd-boot| raw:: html
<a href="https://wiki.archlinux.org/index.php/Kernel_parameters#systemd-boot" target="_blank">systemd-boot</a>
.. |tuna| raw:: html
<a href="https://rt.wiki.kernel.org/index.php/Tuna" target="_blank">tuna</a>
.. |tuna_documentation| raw:: html
<a href="https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_MRG/1.3/html-single/Tuna_User_Guide/index.html" target="_blank">tuna documentation</a>
|