diff --git a/man/directives-template.xml b/man/directives-template.xml index 5038061467..e0063e051d 100644 --- a/man/directives-template.xml +++ b/man/directives-template.xml @@ -1,6 +1,6 @@ - + systemd.directives systemd diff --git a/man/rules/meson.build b/man/rules/meson.build index b04ae1c67c..e6083004ea 100644 --- a/man/rules/meson.build +++ b/man/rules/meson.build @@ -18,7 +18,7 @@ manpages = [ ['file-hierarchy', '7', [], ''], ['halt', '8', ['poweroff', 'reboot'], ''], ['homectl', '1', [], 'ENABLE_HOMED'], - ['homed.conf', '5', ['homed.conf.d'], 'ENABLE_RESOLVE'], + ['homed.conf', '5', ['homed.conf.d'], 'ENABLE_HOMED'], ['hostname', '5', [], ''], ['hostnamectl', '1', [], 'ENABLE_HOSTNAMED'], ['hwdb', '7', [], 'ENABLE_HWDB'], @@ -1096,7 +1096,10 @@ manpages = [ ''], ['udev_new', '3', ['udev_ref', 'udev_unref'], ''], ['udevadm', '8', [], ''], - ['user@.service', '5', ['user-runtime-dir@.service'], ''], + ['user@.service', + '5', + ['systemd-user-runtime-dir', 'user-runtime-dir@.service'], + ''], ['userdbctl', '1', [], 'ENABLE_USERDB'], ['vconsole.conf', '5', [], 'ENABLE_VCONSOLE'] ] diff --git a/man/user@.service.xml b/man/user@.service.xml index f4603df073..cb95d04392 100644 --- a/man/user@.service.xml +++ b/man/user@.service.xml @@ -17,34 +17,37 @@ user@.service user-runtime-dir@.service - System units to manage user processes + systemd-user-runtime-dir + System units to start the user manager user@UID.service user-runtime-dir@UID.service + /usr/lib/systemd/systemd-user-runtime-dir user-UID.slice Description - The - systemd1 + The systemd1 system manager (PID 1) starts user manager instances as - user@UID.service, where the user's numerical UID - is used as the instance identifier. Each systemd --user instance manages a - hierarchy of its own units. See - systemd1 for - a discussion of systemd units and - systemd.special1 - for a list of units that form the basis of the unit hierarchies of system and user units. + user@UID.service, with the user's numerical UID used as + the instance identifier. These instances use the same executable as the system manager, but running in a + mode where it starts a different set of units. Each systemd --user instance manages a + hierarchy of units specific to that user. See + systemd1 for a + discussion of units and + systemd.special1 for a + list of units that form the basis of the unit hierarchies of system and user units. user@UID.service is accompanied by the system unit user-runtime-dir@UID.service, which creates the user's runtime directory /run/user/UID, and then removes it when this - unit is stopped. + unit is stopped. user-runtime-dir@UID.service + executes the systemd-user-runtime-dir binary to do the actual work. User processes may be started by the user@.service instance, in which case they will be part of that unit in the system hierarchy. They may also be started elsewhere, @@ -53,7 +56,7 @@ display manager like gdm, in which case they form a .scope unit (see systemd.scope5). Both user@UID.service and the scope units are - collected under a user-UID.slice. + collected under the user-UID.slice. Individual user-UID.slice slices are collected under user.slice, see diff --git a/tools/make-man-index.py b/tools/make-man-index.py index 66027af02e..4d206ca0b6 100755 --- a/tools/make-man-index.py +++ b/tools/make-man-index.py @@ -9,7 +9,7 @@ from xml_helper import xml_parse, xml_print, tree MDASH = ' — ' if sys.version_info.major >= 3 else ' -- ' TEMPLATE = '''\ - + systemd.index diff --git a/tools/update-man-rules.py b/tools/update-man-rules.py index c404579a2a..f5db691f3e 100755 --- a/tools/update-man-rules.py +++ b/tools/update-man-rules.py @@ -4,16 +4,13 @@ from __future__ import print_function import collections import sys -import os.path import pprint +from os.path import basename from xml_helper import xml_parse def man(page, number): return '{}.{}'.format(page, number) -def xml(file): - return os.path.basename(file) - def add_rules(rules, name): xml = xml_parse(name) # print('parsing {}'.format(name), file=sys.stderr) @@ -78,9 +75,12 @@ def make_mesonfile(rules, dist_files): if __name__ == '__main__': pages = sys.argv[1:] + pages = (p for p in pages + if basename(p) not in { + 'systemd.directives.xml', + 'systemd.index.xml', + 'directives-template.xml'}) rules = create_rules(pages) - dist_files = (xml(file) for file in pages - if not file.endswith(".directives.xml") and - not file.endswith(".index.xml")) + dist_files = (basename(p) for p in pages) print(make_mesonfile(rules, dist_files))