'\" t
.TH "SYSTEMD\-MACHINE\-TAG@\&.SERVICE" "8" "" "systemd 262" "systemd-machine-tag@.service"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
systemd-machine-tag@.service \- Add a machine tag to the host
.SH "SYNOPSIS"
.PP
systemd\-machine\-tag@\&.service
.SH "DESCRIPTION"
.PP
systemd\-machine\-tag@\fITAG\fR\&.service
is a service template that adds the machine tag
\fITAG\fR
(taken from the instance name) to the host\*(Aqs 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\&.
.PP
The primary use of this template is automatic, hardware\-driven tagging: the
\fISYSTEMD_MACHINE_TAG\fR
udev property, when set on a device, causes the matching instance of this template to be pulled in (via
\fISYSTEMD_WANTS=\fR), so that plugging in or detecting a specific device automatically tags the host\&. See
\fBsystemd.device\fR(5)
for details on the
\fISYSTEMD_WANTS=\fR
mechanism\&.
.PP
Machine tags may be inspected and edited with the
\fBtags\fR
verb of
\fBhostnamectl\fR(1), and are stored in the
\fITAGS=\fR
field of
\fBmachine-info\fR(5)\&. Each tag must be 1\&...255 characters long and consist only of ASCII alphanumeric characters,
"\-"
and
"\&."\&.
.PP
Added in version 262\&.
.SH "SEE ALSO"
.PP
\fBsystemd\fR(1), \fBhostnamectl\fR(1), \fBsystemd-hostnamed.service\fR(8), \fBmachine-info\fR(5), \fBudev\fR(7)