The network service file contains a [Service] section, which
specifies a discoverable network service announced in a local
network with Multicast DNS broadcasts.
Name=
An instance name of the network service as defined in the
section 4.1.1 of RFC 6763
[1], e.g. "webserver".
The option supports simple specifier expansion. The following
expansions are understood:
Table 1. Specifiers available
┌──────────┬──────────────────┬────────────────────────┐
│Specifier
│ Meaning
│ Details
│
├──────────┼──────────────────┼────────────────────────┤
│"%a" │ Architecture │ A short string │
│ │ │ identifying the │
│ │ │ architecture of │
│ │ │ the local system. │
│ │ │ A string such as │
│ │ │ x86
, x86-64
or │
│ │ │ arm64
. See the │
│ │ │ architectures │
│ │ │ defined for │
│ │ │ ConditionArchitecture= │
│ │ │ in systemd.unit(5) │
│ │ │ for a full list. │
├──────────┼──────────────────┼────────────────────────┤
│"%A" │ Operating system │ The operating system │
│ │ image version │ image version │
│ │ │ identifier of the │
│ │ │ running system, as │
│ │ │ read from the │
│ │ │ IMAGE_VERSION= field │
│ │ │ of /etc/os-release. If │
│ │ │ not set, resolves to │
│ │ │ an empty string. See │
│ │ │ os-release(5) for more │
│ │ │ information. │
├──────────┼──────────────────┼────────────────────────┤
│"%b" │ Boot ID │ The boot ID of the │
│ │ │ running system, │
│ │ │ formatted as string. │
│ │ │ See random(4) for more │
│ │ │ information. │
├──────────┼──────────────────┼────────────────────────┤
│"%B" │ Operating system │ The operating system │
│ │ build ID │ build identifier of │
│ │ │ the running system, as │
│ │ │ read from the │
│ │ │ BUILD_ID= field of │
│ │ │ /etc/os-release. If │
│ │ │ not set, resolves to │
│ │ │ an empty string. See │
│ │ │ os-release(5) for more │
│ │ │ information. │
├──────────┼──────────────────┼────────────────────────┤
│"%H" │ Host name │ The hostname of the │
│ │ │ running system. │
├──────────┼──────────────────┼────────────────────────┤
│"%m" │ Machine ID │ The machine ID of the │
│ │ │ running system, │
│ │ │ formatted as string. │
│ │ │ See machine-id(5) for │
│ │ │ more information. │
├──────────┼──────────────────┼────────────────────────┤
│"%M" │ Operating system │ The operating system │
│ │ image identifier │ image identifier of │
│ │ │ the running system, as │
│ │ │ read from the │
│ │ │ IMAGE_ID= field of │
│ │ │ /etc/os-release. If │
│ │ │ not set, resolves to │
│ │ │ an empty string. See │
│ │ │ os-release(5) for more │
│ │ │ information. │
├──────────┼──────────────────┼────────────────────────┤
│"%o" │ Operating system │ The operating system │
│ │ ID │ identifier of the │
│ │ │ running system, as │
│ │ │ read from the ID= │
│ │ │ field of │
│ │ │ /etc/os-release. See │
│ │ │ os-release(5) for more │
│ │ │ information. │
├──────────┼──────────────────┼────────────────────────┤
│"%v" │ Kernel release │ Identical to uname -r
│
│ │ │ output. │
├──────────┼──────────────────┼────────────────────────┤
│"%w" │ Operating system │ The operating system │
│ │ version ID │ version identifier of │
│ │ │ the running system, as │
│ │ │ read from the │
│ │ │ VERSION_ID= field of │
│ │ │ /etc/os-release. If │
│ │ │ not set, resolves to │
│ │ │ an empty string. See │
│ │ │ os-release(5) for more │
│ │ │ information. │
├──────────┼──────────────────┼────────────────────────┤
│"%W" │ Operating system │ The operating system │
│ │ variant ID │ variant identifier of │
│ │ │ the running system, as │
│ │ │ read from the │
│ │ │ VARIANT_ID= field of │
│ │ │ /etc/os-release. If │
│ │ │ not set, resolves to │
│ │ │ an empty string. See │
│ │ │ os-release(5) for more │
│ │ │ information. │
├──────────┼──────────────────┼────────────────────────┤
│"%%" │ Single percent │ Use "%%" in place of │
│ │ sign │ "%" to specify a │
│ │ │ single percent sign. │
└──────────┴──────────────────┴────────────────────────┘
Type=
A type of the network service as defined in the section 4.1.2
of RFC 6763
[1], e.g. "_http._tcp".
Port=
An IP port number of the network service.
Priority=
A priority number set in SRV
resource records corresponding
to the network service.
Weight=
A weight number set in SRV
resource records corresponding to
the network service.
TxtText=
A whitespace-separated list of arbitrary key/value pairs
conveying additional information about the named service in
the corresponding TXT resource record, e.g.
"path=/portal/index.html". Keys and values can contain
C-style escape sequences which get translated upon reading
configuration files.
This option together with TxtData= may be specified more than
once, in which case multiple TXT resource records will be
created for the service. If the empty string is assigned to
this option, the list is reset and all prior assignments will
have no effect.
TxtData=
A whitespace-separated list of arbitrary key/value pairs
conveying additional information about the named service in
the corresponding TXT resource record where values are
base64-encoded string representing any binary data, e.g.
"data=YW55IGJpbmFyeSBkYXRhCg==". Keys can contain C-style
escape sequences which get translated upon reading
configuration files.
This option together with TxtText= may be specified more than
once, in which case multiple TXT resource records will be
created for the service. If the empty string is assigned to
this option, the list is reset and all prior assignments will
have no effect.