.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Config::Model::models::Systemd::Section::Install 3pm"
.TH Config::Model::models::Systemd::Section::Install 3pm "2023-11-26" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Config::Model::models::Systemd::Section::Install \- Configuration class Systemd::Section::Install
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Configuration classes used by Config::Model
.SH "Elements"
.IX Header "Elements"
.SS "Alias"
.IX Subsection "Alias"
A space-separated list of additional names this unit shall be installed under. The names listed
here must have the same suffix (i.e. type) as the unit filename. This option may be specified more than once,
in which case all listed names are used. At installation time, systemctl enable will create
symlinks from these names to the unit filename. Note that not all unit types support such alias names, and this
setting is not supported for them. Specifically, mount, slice, swap, and automount units do not support
aliasing. \fI Optional. Type list of uniline.  \fR
.SS "WantedBy"
.IX Subsection "WantedBy"
This option may be used more than once, or a space-separated list of unit names may
be given. A symbolic link is created in the \f(CW\*(C`.wants/\*(C'\fR, \f(CW\*(C`.requires/\*(C'\fR,
or \f(CW\*(C`.upholds/\*(C'\fR directory of each of the listed units when this unit is installed
by systemctl enable. This has the effect of a dependency of type
\&\f(CW\*(C`Wants\*(C'\fR, \f(CW\*(C`Requires\*(C'\fR, or \f(CW\*(C`Upholds\*(C'\fR being added
from the listed unit to the current unit. See the description of the mentioned dependency types
in the [Unit] section for details.
.PP
In case of template units listing non template units, the listing unit must have
\&\f(CW\*(C`DefaultInstance\*(C'\fR set, or systemctl enable must be called with
an instance name. The instance (default or specified) will be added to the
\&\f(CW\*(C`.wants/\*(C'\fR, \f(CW\*(C`.requires/\*(C'\fR, or \f(CW\*(C`.upholds/\*(C'\fR
list of the listed unit. For example, WantedBy=getty.target in a service
\&\f(CW\*(C`getty@.service\*(C'\fR will result in systemctl enable getty@tty2.service
creating a \f(CW\*(C`getty.target.wants/getty@tty2.service\*(C'\fR link to
\&\f(CW\*(C`getty@.service\*(C'\fR. This also applies to listing specific instances of templated
units: this specific instance will gain the dependency. A template unit may also list a template
unit, in which case a generic dependency will be added where each instance of the listing unit will
have a dependency on an instance of the listed template with the same instance value. For example,
WantedBy=container@.target in a service \f(CW\*(C`monitor@.service\*(C'\fR will
result in systemctl enable monitor@.service creating a
\&\f(CW\*(C`container@.target.wants/monitor@.service\*(C'\fR link to
\&\f(CW\*(C`monitor@.service\*(C'\fR, which applies to all instances of
\&\f(CW\*(C`container@.target\*(C'\fR. \fI Optional. Type list of uniline.  \fR
.SS "RequiredBy"
.IX Subsection "RequiredBy"
This option may be used more than once, or a space-separated list of unit names may
be given. A symbolic link is created in the \f(CW\*(C`.wants/\*(C'\fR, \f(CW\*(C`.requires/\*(C'\fR,
or \f(CW\*(C`.upholds/\*(C'\fR directory of each of the listed units when this unit is installed
by systemctl enable. This has the effect of a dependency of type
\&\f(CW\*(C`Wants\*(C'\fR, \f(CW\*(C`Requires\*(C'\fR, or \f(CW\*(C`Upholds\*(C'\fR being added
from the listed unit to the current unit. See the description of the mentioned dependency types
in the [Unit] section for details.
.PP
In case of template units listing non template units, the listing unit must have
\&\f(CW\*(C`DefaultInstance\*(C'\fR set, or systemctl enable must be called with
an instance name. The instance (default or specified) will be added to the
\&\f(CW\*(C`.wants/\*(C'\fR, \f(CW\*(C`.requires/\*(C'\fR, or \f(CW\*(C`.upholds/\*(C'\fR
list of the listed unit. For example, WantedBy=getty.target in a service
\&\f(CW\*(C`getty@.service\*(C'\fR will result in systemctl enable getty@tty2.service
creating a \f(CW\*(C`getty.target.wants/getty@tty2.service\*(C'\fR link to
\&\f(CW\*(C`getty@.service\*(C'\fR. This also applies to listing specific instances of templated
units: this specific instance will gain the dependency. A template unit may also list a template
unit, in which case a generic dependency will be added where each instance of the listing unit will
have a dependency on an instance of the listed template with the same instance value. For example,
WantedBy=container@.target in a service \f(CW\*(C`monitor@.service\*(C'\fR will
result in systemctl enable monitor@.service creating a
\&\f(CW\*(C`container@.target.wants/monitor@.service\*(C'\fR link to
\&\f(CW\*(C`monitor@.service\*(C'\fR, which applies to all instances of
\&\f(CW\*(C`container@.target\*(C'\fR. \fI Optional. Type list of uniline.  \fR
.SS "UpheldBy"
.IX Subsection "UpheldBy"
This option may be used more than once, or a space-separated list of unit names may
be given. A symbolic link is created in the \f(CW\*(C`.wants/\*(C'\fR, \f(CW\*(C`.requires/\*(C'\fR,
or \f(CW\*(C`.upholds/\*(C'\fR directory of each of the listed units when this unit is installed
by systemctl enable. This has the effect of a dependency of type
\&\f(CW\*(C`Wants\*(C'\fR, \f(CW\*(C`Requires\*(C'\fR, or \f(CW\*(C`Upholds\*(C'\fR being added
from the listed unit to the current unit. See the description of the mentioned dependency types
in the [Unit] section for details.
.PP
In case of template units listing non template units, the listing unit must have
\&\f(CW\*(C`DefaultInstance\*(C'\fR set, or systemctl enable must be called with
an instance name. The instance (default or specified) will be added to the
\&\f(CW\*(C`.wants/\*(C'\fR, \f(CW\*(C`.requires/\*(C'\fR, or \f(CW\*(C`.upholds/\*(C'\fR
list of the listed unit. For example, WantedBy=getty.target in a service
\&\f(CW\*(C`getty@.service\*(C'\fR will result in systemctl enable getty@tty2.service
creating a \f(CW\*(C`getty.target.wants/getty@tty2.service\*(C'\fR link to
\&\f(CW\*(C`getty@.service\*(C'\fR. This also applies to listing specific instances of templated
units: this specific instance will gain the dependency. A template unit may also list a template
unit, in which case a generic dependency will be added where each instance of the listing unit will
have a dependency on an instance of the listed template with the same instance value. For example,
WantedBy=container@.target in a service \f(CW\*(C`monitor@.service\*(C'\fR will
result in systemctl enable monitor@.service creating a
\&\f(CW\*(C`container@.target.wants/monitor@.service\*(C'\fR link to
\&\f(CW\*(C`monitor@.service\*(C'\fR, which applies to all instances of
\&\f(CW\*(C`container@.target\*(C'\fR. \fI Optional. Type list of uniline.  \fR
.SS "Also"
.IX Subsection "Also"
Additional units to install/deinstall when
this unit is installed/deinstalled. If the user requests
installation/deinstallation of a unit with this option
configured, systemctl enable and
systemctl disable will automatically
install/uninstall units listed in this option as well.
.PP
This option may be used more than once, or a
space-separated list of unit names may be
given. \fI Optional. Type list of uniline.  \fR
.SS "DefaultInstance"
.IX Subsection "DefaultInstance"
In template unit files, this specifies for
which instance the unit shall be enabled if the template is
enabled without any explicitly set instance. This option has
no effect in non-template unit files. The specified string
must be usable as instance identifier. \fI Optional. Type uniline.  \fR
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IP "\(bu" 4
cme