systemd-escape 命令

常用示例

说明

systemd-escape converts arbitrary strings into valid systemd unit name components, or reverses that conversion. Systemd unit names have strict naming rules: only alphanumerics, `:`, `_`, and `.` are permitted; other characters are encoded as `\xNN` sequences, and `/` becomes `-`. The tool is especially useful when constructing .mount or .swap units from paths, or when instantiating template units such as `foo@.service` with a dynamic instance string.

参数

-u, --unescape

Reverse the escaping (decode). Cannot be combined with --suffix= or --mangle.

-p, --path

Treat the argument as a file system path, simplifying slashes and ".." components. Useful for generating strings that match the `%f` specifier.

--suffix=_suffix_

Append a unit type suffix such as `service` or `mount` to the escaped string. Incompatible with --template=, --unescape, and --mangle.

--template=_template_

Insert the escaped string at the `@` position of a template unit name like `foobar@.service`. With --unescape, extracts and unescapes just the instance portion.

-m, --mangle

Escape only obviously-unescaped characters and append a suitable unit suffix if missing. Incompatible with --suffix=, --template=, and --unescape.

--instance

Used with --unescape --template=: print only the instance portion of a template unit name.

-h, --help

Show help text.

--version

Show version information.