systemd-machine-tag@.service - Man Page

Add a machine tag to the host

Synopsis

systemd-machine-tag@​.service

Description

systemd-machine-tag@TAG​.service is a service template that adds the machine tag TAG (taken from the instance name) to the host's list of machine tags​. Whenever an instance of this template is pulled in, the corresponding tag is added; the operation is idempotent, so pulling it in repeatedly has no further effect​.

The primary use of this template is automatic, hardware-driven tagging: the SYSTEMD_MACHINE_TAG udev property, when set on a device, causes the matching instance of this template to be pulled in (via SYSTEMD_WANTS=), so that plugging in or detecting a specific device automatically tags the host​. See systemd.device(5) for details on the SYSTEMD_WANTS= mechanism​.

Machine tags may be inspected and edited with the tags verb of hostnamectl(1), and are stored in the TAGS= field of machine-info(5)​. Each tag must be 1​...255 characters long and consist only of ASCII alphanumeric characters, "-" and "​."​.

Added in version 262​.

See Also

systemd(1), hostnamectl(1), systemd-hostnamed.service(8), machine-info(5), udev(7)

Referenced By

systemd.directives(7), systemd.index(7).

systemd 262~rc2