From 75f7e5e54704e643aa9b50ce03ed02a49e75333f Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 28 Mar 2023 23:25:52 +0200 Subject: [PATCH] man: correct/tweak text about unit name syntax Unit names can be 255 characters long, not 256. We first say "name prefix" and then continue with "unit prefix". Confusing. Couldn't figure out which term is better hence settled on "unit name prefix". --- man/systemd.unit.xml | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 556fcad3a4..9411ea2e03 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -110,19 +110,19 @@ Unit files are loaded from a set of paths determined during compilation, described in the next section. - Valid unit names consist of a "name prefix" and a dot and a suffix specifying the unit type. The - "unit prefix" must consist of one or more valid characters (ASCII letters, digits, :, - -, _, ., and \). The total - length of the unit name including the suffix must not exceed 256 characters. The type suffix must be one - of .service, .socket, .device, - .mount, .automount, .swap, - .target, .path, .timer, - .slice, or .scope. + Valid unit names consist of a "unit name prefix", and a suffix specifying the unit type which + begins with a dot. The "unit name prefix" must consist of one or more valid characters (ASCII letters, + digits, :, -, _, ., and + \). The total length of the unit name including the suffix must not exceed 255 + characters. The unit type suffix must be one of .service, .socket, + .device, .mount, .automount, + .swap, .target, .path, + .timer, .slice, or .scope. - Units names can be parameterized by a single argument called the "instance name". The unit is then + Unit names can be parameterized by a single argument called the "instance name". The unit is then constructed based on a "template file" which serves as the definition of multiple services or other - units. A template unit must have a single @ at the end of the name (right before the - type suffix). The name of the full unit is formed by inserting the instance name between + units. A template unit must have a single @ at the end of the unit name prefix (right + before the type suffix). The name of the full unit is formed by inserting the instance name between @ and the unit type suffix. In the unit file itself, the instance parameter may be referred to using %i and other specifiers, see below.