README


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

openrc-settingsd provides an implementation of the the hostnamed, localed,
and timedated DBus services for OpenRC-based systems - in particular, for
typical installations of Gentoo Linux.

Bugs should be reported (for the moment) to gnome@gentoo.org

Hostnamed:

 See http://www.freedesktop.org/wiki/Software/systemd/hostnamed for the DBus
 protocol description.

 The static hostname is stored in /etc/conf.d/hostname as
 hostname="foo"

 The pretty hostname and icon name are stored in /etc/machine-info as
 PRETTY_HOSTNAME="Foo !"
 ICON_NAME="computer-desktop"

Localed:

 See http://www.freedesktop.org/wiki/Software/systemd/localed for the DBus
 protocol description.

 The system locale variables are set in /etc/env.d/02locale.

 Virtual console keymap is set in /etc/conf.d/keymaps as
 keymap="foo"
 The virtual console keymap toggle is not supported.

/*
 Not implemented yet.

 X11 keyboard options are set in /etc/X11/xorg.conf.d/30-keyboard.conf
 (falling back to 00-keyboard.conf if it exists and 30-keyboard.conf does
 not) in an InputClass section.
 Localed will attempt to detect if multiple InputClass sections with
 keyboard options exist in /etc/X11/xorg.conf and /etc/X11/xorg.conf.d/,
 and if that is the case, will refuse to modify X11 keyboard settings.
*/

Note that openrc-settingsd expects any shell-syntax settings files that it
modifies to be in UTF-8 encoding, and to consist only of comments and simple
scalar assignments, i.e. something like

# a comment
foo="bar"
baz='Let'\''s go!'

If openrc-settingsd fails to parse a settings file, it will refuse to modify
it.