data

package
v0.7.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 23, 2026 License: GPL-3.0 Imports: 1 Imported by: 0

Documentation

Overview

Package data

This package does not contains any functions or logic just data that can be used by other packages like completion, syntax, etc.

Index

Constants

View Source
const ProgramVersion = "0.7.3"

Variables

View Source
var (
	CategoryProperty = map[string]CategoryPropertyItem{
		"newContainer": {
			Details: utils.ReturnAsStringPtr("define a new container"),
			InsertText: utils.ReturnAsStringPtr(`[Unit]
Description=${1:description}
StartLimitBurst=5
StartLimitIntervalSec=90

[Container]
Image=${2:image}
AutoUpdate=registry
$0

[Service]
Restart=on-failure
RestartSec=2

[Install]
WantedBy=default.target
`),
		},
		"newVolume": {
			Details: utils.ReturnAsStringPtr("define new volume"),
			InsertText: utils.ReturnAsStringPtr(`[Unit]
Description=${1:description}

[Volume]
$0
`),
		},
		"newPod": {
			Details: utils.ReturnAsStringPtr("define new pod"),
			InsertText: utils.ReturnAsStringPtr(`[Unit]
Description=${1:description}

[Pod]
$0
`),
		},
		"newNetwork": {
			Details: utils.ReturnAsStringPtr("define new network"),
			InsertText: utils.ReturnAsStringPtr(`[Unit]
Description=${1:description}

[Network]
$0
`),
		},
		"newImage": {
			Details: utils.ReturnAsStringPtr("define new image"),
			InsertText: utils.ReturnAsStringPtr(`[Unit]
Description=${1:description}

[Image]
Image=${2:image}
$0
`),
		},
		"newBuild": {
			Details: utils.ReturnAsStringPtr("define new build"),
			InsertText: utils.ReturnAsStringPtr(`[Unit]
Description=${1:description}

[Build]
File=${2:file}
$0
`),
		},
		"newArtifacet": {
			Details: utils.ReturnAsStringPtr("define new build"),
			InsertText: utils.ReturnAsStringPtr(`[Unit]
Description=${1:description}

[Artifact]
Artifact=${2:file}
$0
`),
		},
	}

	PropertiesMap = map[string][]PropertyMapItem{
		"Install": {
			{
				Label: "Alias",
				Hover: []string{
					"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.",
				},
			},
			{
				Label: "WantedBy",
				Hover: []string{
					"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 .wants/, .requires/, or .upholds/ directory of each of the listed units when this unit is installed by systemctl enable. This has the effect of a dependency of type Wants=, Requires=, or Upholds= being added from the listed unit to the current unit. See the description of the mentioned dependency types in the [Unit] section for details.",
					"",
					"In case of template units listing non template units, the listing unit must have DefaultInstance= set, or systemctl enable must be called with an instance name. The instance (default or specified) will be added to the .wants/, .requires/, or .upholds/ list of the listed unit. For example, WantedBy=getty.target in a service getty@.service will result in systemctl enable getty@tty2.service creating a getty.target.wants/getty@tty2.service link to getty@.service. 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 monitor@.service will result in systemctl enable monitor@.service creating a container@.target.wants/monitor@.service link to monitor@.service, which applies to all instances of container@.target.",
				},
			},
			{
				Label: "RequiredBy",
				Hover: []string{
					"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 .wants/, .requires/, or .upholds/ directory of each of the listed units when this unit is installed by systemctl enable. This has the effect of a dependency of type Wants=, Requires=, or Upholds= being added from the listed unit to the current unit. See the description of the mentioned dependency types in the [Unit] section for details.",
					"",
					"In case of template units listing non template units, the listing unit must have DefaultInstance= set, or systemctl enable must be called with an instance name. The instance (default or specified) will be added to the .wants/, .requires/, or .upholds/ list of the listed unit. For example, WantedBy=getty.target in a service getty@.service will result in systemctl enable getty@tty2.service creating a getty.target.wants/getty@tty2.service link to getty@.service. 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 monitor@.service will result in systemctl enable monitor@.service creating a container@.target.wants/monitor@.service link to monitor@.service, which applies to all instances of container@.target.",
				},
			},
			{
				Label: "UpheldBy",
				Hover: []string{
					"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 .wants/, .requires/, or .upholds/ directory of each of the listed units when this unit is installed by systemctl enable. This has the effect of a dependency of type Wants=, Requires=, or Upholds= being added from the listed unit to the current unit. See the description of the mentioned dependency types in the [Unit] section for details.",
					"",
					"In case of template units listing non template units, the listing unit must have DefaultInstance= set, or systemctl enable must be called with an instance name. The instance (default or specified) will be added to the .wants/, .requires/, or .upholds/ list of the listed unit. For example, WantedBy=getty.target in a service getty@.service will result in systemctl enable getty@tty2.service creating a getty.target.wants/getty@tty2.service link to getty@.service. 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 monitor@.service will result in systemctl enable monitor@.service creating a container@.target.wants/monitor@.service link to monitor@.service, which applies to all instances of container@.target.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "DefaultInstance",
				Hover: []string{
					"The default instance that is used to create an instance based on template. For example if container name is `webapp@.container` and `DefaultInstance=8080` then webapp@8081.service is created",
				},
			},
		},
		"Unit": {
			{
				Label: "Description",
				Hover: []string{
					"Description about the unit",
				},
			},
			{
				Label: "Wants",
				Hover: []string{
					"Configures (weak) requirement dependencies on other units. This option may be specified more than once or multiple space-separated units may be specified in one option in which case dependencies for all listed names will be created. Dependencies of this type may also be configured outside of the unit configuration file by adding a symlink to a .wants/ directory accompanying the unit file. For details, see above.",
					"",
					"Units listed in this option will be started if the configuring unit is. However, if the listed units fail to start or cannot be added to the transaction, this has no impact on the validity of the transaction as a whole, and this unit will still be started. This is the recommended way to hook the start-up of one unit to the start-up of another unit.",
					"",
					"Note that requirement dependencies do not influence the order in which services are started or stopped. This has to be configured independently with the After= or Before= options. If unit foo.service pulls in unit bar.service as configured with Wants= and no ordering is configured with After= or Before=, then both units will be started simultaneously and without any delay between them if foo.service is activated.",
				},
			},
			{
				Label: "Requires",
				Hover: []string{
					"imilar to Wants=, but declares a stronger requirement dependency. Dependencies of this type may also be configured by adding a symlink to a .requires/ directory accompanying the unit file.",
					"",
					"If this unit gets activated, the units listed will be activated as well. If one of the other units fails to activate, and an ordering dependency After= on the failing unit is set, this unit will not be started. Besides, with or without specifying After=, this unit will be stopped (or restarted) if one of the other units is explicitly stopped (or restarted).",
					"",
					"Often, it is a better choice to use Wants= instead of Requires= in order to achieve a system that is more robust when dealing with failing services.",
					"",
					"Note that this dependency type does not imply that the other unit always has to be in active state when this unit is running. Specifically: failing condition checks (such as ConditionPathExists=, ConditionPathIsSymbolicLink=, … — see below) do not cause the start job of a unit with a Requires= dependency on it to fail. Also, some unit types may deactivate on their own (for example, a service process may decide to exit cleanly, or a device may be unplugged by the user), which is not propagated to units having a Requires= dependency. Use the BindsTo= dependency type together with After= to ensure that a unit may never be in active state without a specific other unit also in active state (see below).",
				},
			},
			{
				Label: "Requisite",
				Hover: []string{
					"Similar to Requires=. However, if the units listed here are not started already, they will not be started and the starting of this unit will fail immediately. Requisite= does not imply an ordering dependency, even if both units are started in the same transaction. Hence this setting should usually be combined with After=, to ensure this unit is not started before the other unit.",
					"",
					"When Requisite=b.service is used on a.service, this dependency will show as RequisiteOf=a.service in property listing of b.service. RequisiteOf= dependency cannot be specified directly.",
				},
			},
			{
				Label: "BindsTo",
				Hover: []string{
					"Configures requirement dependencies, very similar in style to Requires=. However, this dependency type is stronger: in addition to the effect of Requires= it declares that if the unit bound to is stopped, this unit will be stopped too. This means a unit bound to another unit that suddenly enters inactive state will be stopped too. Units can suddenly, unexpectedly enter inactive state for different reasons: the main process of a service unit might terminate on its own choice, the backing device of a device unit might be unplugged or the mount point of a mount unit might be unmounted without involvement of the system and service manager.",
					"",
					"When used in conjunction with After= on the same unit the behaviour of BindsTo= is even stronger. In this case, the unit bound to strictly has to be in active state for this unit to also be in active state. This not only means a unit bound to another unit that suddenly enters inactive state, but also one that is bound to another unit that gets skipped due to an unmet condition check (such as ConditionPathExists=, ConditionPathIsSymbolicLink=, … — see below) will be stopped, should it be running. Hence, in many cases it is best to combine BindsTo= with After=.",
					"",
					"When BindsTo=b.service is used on a.service, this dependency will show as BoundBy=a.service in property listing of b.service. BoundBy= dependency cannot be specified directly.",
				},
			},
			{
				Label: "PartOf",
				Hover: []string{
					"Configures dependencies similar to Requires=, but limited to stopping and restarting of units. When systemd stops or restarts the units listed here, the action is propagated to this unit. Note that this is a one-way dependency — changes to this unit do not affect the listed units.",
					"",
					"When PartOf=b.service is used on a.service, this dependency will show as ConsistsOf=a.service in property listing of b.service. ConsistsOf= dependency cannot be specified directly.",
				},
			},
			{
				Label: "Upholds",
				Hover: []string{
					"Configures dependencies similar to Wants=, but as long as this unit is up, all units listed in Upholds= are started whenever found to be inactive or failed, and no job is queued for them. While a Wants= dependency on another unit has a one-time effect when this units started, a Upholds= dependency on it has a continuous effect, constantly restarting the unit if necessary. This is an alternative to the Restart= setting of service units, to ensure they are kept running whatever happens. The restart happens without delay, and usual per-unit rate-limit applies.",
					"",
					"When Upholds=b.service is used on a.service, this dependency will show as UpheldBy=a.service in the property listing of b.service.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "Conflicts",
				Hover: []string{
					"A space-separated list of unit names. Configures negative requirement dependencies. If a unit has a Conflicts= setting on another unit, starting the former will stop the latter and vice versa.",
					"",
					"Note that this setting does not imply an ordering dependency, similarly to the Wants= and Requires= dependencies described above. This means that to ensure that the conflicting unit is stopped before the other unit is started, an After= or Before= dependency must be declared. It does not matter which of the two ordering dependencies is used, because stop jobs are always ordered before start jobs, see the discussion in Before=/After= below.",
					"",
					"If unit A that conflicts with unit B is scheduled to be started at the same time as B, the transaction will either fail (in case both are required parts of the transaction) or be modified to be fixed (in case one or both jobs are not a required part of the transaction). In the latter case, the job that is not required will be removed, or in case both are not required, the unit that conflicts will be started and the unit that is conflicted is stopped.",
				},
			},
			{
				Label: "Before",
				Hover: []string{
					"Before/After",
					"",
					"These two settings expect a space-separated list of unit names. They may be specified more than once, in which case dependencies for all listed names are created.",
					"",
					"Those two settings configure ordering dependencies between units. If unit foo.service contains the setting Before=bar.service and both units are being started, bar.service's start-up is delayed until foo.service has finished starting up. After= is the inverse of Before=, i.e. while Before= ensures that the configured unit is started before the listed unit begins starting up, After= ensures the opposite, that the listed unit is fully started up before the configured unit is started.",
					"",
					"When two units with an ordering dependency between them are shut down, the inverse of the start-up order is applied. I.e. if a unit is configured with After= on another unit, the former is stopped before the latter if both are shut down. Given two units with any ordering dependency between them, if one unit is shut down and the other is started up, the shutdown is ordered before the start-up. It does not matter if the ordering dependency is After= or Before=, in this case. It also does not matter which of the two is shut down, as long as one is shut down and the other is started up; the shutdown is ordered before the start-up in all cases. If two units have no ordering dependencies between them, they are shut down or started up simultaneously, and no ordering takes place. It depends on the unit type when precisely a unit has finished starting up. Most importantly, for service units start-up is considered completed for the purpose of Before=/After= when all its configured start-up commands have been invoked and they either failed or reported start-up success. Note that this includes ExecStartPost= (or ExecStopPost= for the shutdown case).",
					"",
					"Note that those settings are independent of and orthogonal to the requirement dependencies as configured by Requires=, Wants=, Requisite=, or BindsTo=. It is a common pattern to include a unit name in both the After= and Wants= options, in which case the unit listed will be started before the unit that is configured with these options.",
					"",
					"Note that Before= dependencies on device units have no effect and are not supported. Devices generally become available as a result of an external hotplug event, and systemd creates the corresponding device unit without delay.",
				},
			},
			{
				Label: "After",
				Hover: []string{
					"Before/After",
					"",
					"These two settings expect a space-separated list of unit names. They may be specified more than once, in which case dependencies for all listed names are created.",
					"",
					"Those two settings configure ordering dependencies between units. If unit foo.service contains the setting Before=bar.service and both units are being started, bar.service's start-up is delayed until foo.service has finished starting up. After= is the inverse of Before=, i.e. while Before= ensures that the configured unit is started before the listed unit begins starting up, After= ensures the opposite, that the listed unit is fully started up before the configured unit is started.",
					"",
					"When two units with an ordering dependency between them are shut down, the inverse of the start-up order is applied. I.e. if a unit is configured with After= on another unit, the former is stopped before the latter if both are shut down. Given two units with any ordering dependency between them, if one unit is shut down and the other is started up, the shutdown is ordered before the start-up. It does not matter if the ordering dependency is After= or Before=, in this case. It also does not matter which of the two is shut down, as long as one is shut down and the other is started up; the shutdown is ordered before the start-up in all cases. If two units have no ordering dependencies between them, they are shut down or started up simultaneously, and no ordering takes place. It depends on the unit type when precisely a unit has finished starting up. Most importantly, for service units start-up is considered completed for the purpose of Before=/After= when all its configured start-up commands have been invoked and they either failed or reported start-up success. Note that this includes ExecStartPost= (or ExecStopPost= for the shutdown case).",
					"",
					"Note that those settings are independent of and orthogonal to the requirement dependencies as configured by Requires=, Wants=, Requisite=, or BindsTo=. It is a common pattern to include a unit name in both the After= and Wants= options, in which case the unit listed will be started before the unit that is configured with these options.",
					"",
					"Note that Before= dependencies on device units have no effect and are not supported. Devices generally become available as a result of an external hotplug event, and systemd creates the corresponding device unit without delay.",
				},
			},
			{
				Label: "StartLimitBurst",
				Hover: []string{
					"Configure unit start rate limiting. Units which are started more than burst times within an interval time span are not permitted to start any more. Use StartLimitIntervalSec= to configure the checking interval and StartLimitBurst= to configure how many starts per interval are allowed.",
					"",
					"interval is a time span with the default unit of seconds, but other units may be specified, see systemd.time(7). The special value \"infinity\" can be used to limit the total number of start attempts, even if they happen at large time intervals. Defaults to DefaultStartLimitIntervalSec= in manager configuration file, and may be set to 0 to disable any kind of rate limiting.  burst is a number and defaults to DefaultStartLimitBurst= in manager configuration file.",
					"",
					"These configuration options are particularly useful in conjunction with the service setting Restart= (see systemd.service(5)); however, they apply to all kinds of starts (including manual), not just those triggered by the Restart= logic.",
					"",
					"Note that units which are configured for Restart=, and which reach the start limit are not attempted to be restarted anymore; however, they may still be restarted manually or from a timer or socket at a later point, after the interval has passed. From that point on, the restart logic is activated again.  systemctl reset-failed will cause the restart rate counter for a service to be flushed, which is useful if the administrator wants to manually start a unit and the start limit interferes with that. Rate-limiting is enforced after any unit condition checks are executed, and hence unit activations with failing conditions do not count towards the rate limit.",
					"",
					"When a unit is unloaded due to the garbage collection logic (see above) its rate limit counters are flushed out too. This means that configuring start rate limiting for a unit that is not referenced continuously has no effect.",
					"",
					"This setting does not apply to slice, target, device, and scope units, since they are unit types whose activation may either never fail, or may succeed only a single time.",
				},
			},
			{
				Label: "StartLimitIntervalSec",
				Hover: []string{
					"Configure unit start rate limiting. Units which are started more than burst times within an interval time span are not permitted to start any more. Use StartLimitIntervalSec= to configure the checking interval and StartLimitBurst= to configure how many starts per interval are allowed.",
					"",
					"interval is a time span with the default unit of seconds, but other units may be specified, see systemd.time(7). The special value \"infinity\" can be used to limit the total number of start attempts, even if they happen at large time intervals. Defaults to DefaultStartLimitIntervalSec= in manager configuration file, and may be set to 0 to disable any kind of rate limiting.  burst is a number and defaults to DefaultStartLimitBurst= in manager configuration file.",
					"",
					"These configuration options are particularly useful in conjunction with the service setting Restart= (see systemd.service(5)); however, they apply to all kinds of starts (including manual), not just those triggered by the Restart= logic.",
					"",
					"Note that units which are configured for Restart=, and which reach the start limit are not attempted to be restarted anymore; however, they may still be restarted manually or from a timer or socket at a later point, after the interval has passed. From that point on, the restart logic is activated again.  systemctl reset-failed will cause the restart rate counter for a service to be flushed, which is useful if the administrator wants to manually start a unit and the start limit interferes with that. Rate-limiting is enforced after any unit condition checks are executed, and hence unit activations with failing conditions do not count towards the rate limit.",
					"",
					"When a unit is unloaded due to the garbage collection logic (see above) its rate limit counters are flushed out too. This means that configuring start rate limiting for a unit that is not referenced continuously has no effect.",
					"",
					"This setting does not apply to slice, target, device, and scope units, since they are unit types whose activation may either never fail, or may succeed only a single time.",
				},
			},
		},
		"Container": {
			{
				Label: "AddCapability",
				Hover: []string{
					"Add these capabilities, in addition to the default Podman capability set, to the container.",
					"This is a space separated list of capabilities. This key can be listed multiple times.",
					"",
					"For example:",
					"```systemd",
					"AddCapability=CAP_DAC_OVERRIDE CAP_IPC_OWNER",
					"```",
				},
				MultipleAdd: true,
				Parameters: []string{
					"CAP_DAC_OVERRIDE",
					"CAP_DAC_READ_SEARCH",
					"CAP_FOWNER",
					"CAP_FSETID",
					"CAP_KILL",
					"CAP_SETGID",
					"CAP_SETUID",
					"CAP_SETPCAP",
					"CAP_LINUX_IMMUTABLE",
					"CAP_NET_BIND_SERVICE",
					"CAP_NET_BROADCAST",
					"CAP_NET_ADMIN",
					"CAP_NET_RAW",
					"CAP_IPC_LOCK",
					"CAP_IPC_OWNER",
					"CAP_SYS_MODULE",
					"CAP_SYS_RAWIO",
					"CAP_SYS_CHROOT",
					"CAP_SYS_PTRACE",
					"CAP_SYS_PACCT",
					"CAP_SYS_ADMIN",
					"CAP_SYS_BOOT",
					"CAP_SYS_NICE",
					"CAP_SYS_RESOURCE",
					"CAP_SYS_TIME",
					"CAP_SYS_TTY_CONFIG",
					"CAP_MKNOD",
					"CAP_LEASE",
					"CAP_AUDIT_WRITE",
					"CAP_AUDIT_CONTROL",
					"CAP_SETFCAP",
					"CAP_MAC_OVERRIDE",
					"CAP_MAC_ADMIN",
					"CAP_SYSLOG",
					"CAP_WAKE_ALARM",
					"CAP_BLOCK_SUSPEND",
					"CAP_AUDIT_READ",
					"CAP_PERFMON",
					"CAP_BPF",
					"CAP_CHECKPOINT_RESTORE",
				},
			},
			{
				Label: "AddDevice",
				Hover: []string{
					"Adds a device node from the host into the container. The format of this is HOST-DEVICE[:CONTAINER-DEVICE][:PERMISSIONS], where HOST-DEVICE is the path of the device node on the host, CONTAINER-DEVICE is the path of the device node in the container, and PERMISSIONS is a list of permissions combining 'r' for read, 'w' for write, and 'm' for mknod(2). The - prefix tells Quadlet to add the device only if it exists on the host.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "AddHost",
				Hover: []string{
					"Add host-to-IP mapping to /etc/hosts. The format is hostname:ip.",
					"",
					"Equivalent to the Podman --add-host option. This key can be listed multiple times.",
				},
				Macro:       "AddHost=${1:hostname}:${2:ip}\n$0",
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "Annotation",
				Hover: []string{
					"Set one or more OCI annotations on the container. The format is a list of key=value items, similar to Environment.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "Annotation=\"${1:key}=${2:value}\"\n$0",
				MultipleAdd: true,
			},
			{
				Label: "AppArmor",
				Hover: []string{
					"Sets the apparmor confinement profile for the container. A value of `unconfined` turns off apparmor confinement.",
				},
				FormatGroup: FormatGroupBase,
				MinVersion:  utils.BuildPodmanVersion(5, 8, 0),
			},
			{
				Label: "AutoUpdate",
				Hover: []string{
					"Indicates whether the container will be auto-updated ([podman-auto-update(1)](https://docs.podman.io/en/latest/markdown/podman-auto-update.1.html)). The following values are supported:",
					"",
					"- `registry`: Requires a fully-qualified image reference (e.g., quay.io/podman/stable:latest) to be used to create the container. This enforcement is necessary to know which image to actually check and pull. If an image ID was used, Podman does not know which image to check/pull anymore.",
					"- `local`: Tells Podman to compare the image a container is using to the image with its raw name in local storage. If an image is updated locally, Podman simply restarts the systemd unit executing the container.",
				},
				Parameters:  []string{"registry", "local"},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "CgroupsMode",
				Hover: []string{
					"The cgroups mode of the Podman container. Equivalent to the Podman `--cgroups` option.",
					"",
					"By default, the cgroups mode of the container created by Quadlet is `split`, which differs from the default (`enabled`) used by the Podman CLI.",
					"",
					"If the container joins a pod (i.e. `Pod=` is specified), you may want to change this to `no-conmon` or `enabled` so that pod level cgroup resource limits can take effect.",
				},
			},
			{
				Label: "ContainerName",
				Hover: []string{
					"The (optional) name of the Podman container. If this is not specified, the default value of `systemd-%N` is used, which is the same as the service name but with a `systemd-` prefix to avoid conflicts with user-managed containers.",
				},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "ContainersConfModule",
				Hover: []string{
					"Load the specified containers.conf(5) module. Equivalent to the Podman --module option.",
					"",
					"This key can be listed multiple times",
				},
				MultipleAdd: true,
			},
			{
				Label: "DNS",
				Hover: []string{
					"Set network-scoped DNS resolver/nameserver for containers in this network.",
					"",
					"This key can be listed multiple times.",
					"",
					"For example:",
					"```systemd",
					"DNS=1.1.1.1",
					"DNS=1.0.0.1",
					"```",
				},
				Parameters: []string{
					"1.1.1.1",
					"1.0.0.1",
					"8.8.8.8",
					"8.8.4.4",
					"9.9.9.9",
					"149.112.112.112",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "DNSOption",
				Hover: []string{
					"Set custom DNS options.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "DNSSearch",
				Hover: []string{
					"Set custom DNS search domains. Use `DNSSearch=`. to remove the search domain.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "DropCapability",
				Hover: []string{
					"Drop these capabilities from the default podman capability set, or `all` to drop all capabilities.",
					"",
					"This is a space separated list of capabilities. This key can be listed multiple times.",
					"",
					"For example:",
					"```systemd",
					"DropCapability=CAP_DAC_OVERRIDE CAP_IPC_OWNER",
					"```",
				},
				MultipleAdd: true,
			},
			{
				Label: "Entrypoint",
				Hover: []string{
					"Override the default ENTRYPOINT from the image. Equivalent to the Podman --entrypoint option. Specify multi option commands in the form of a JSON string.",
				},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "Environment",
				Hover: []string{
					"Set an environment variable in the container. This uses the same format as services in systemd and can be listed multiple times.",
					"",
					"For example:",
					"```systemd",
					"Environment=APP_USERNAME=appuser",
					"```",
				},
				Macro:       "Environment=\"${1:name}=${2:value}\"\n$0",
				FormatGroup: FormatGroupEnvironment,
				MultipleAdd: true,
			},
			{
				Label: "EnvironmentFile",
				Hover: []string{
					"Use a line-delimited file to set environment variables in the container. The path may be absolute or relative to the location of the unit file. This key may be used multiple times, and the order persists when passed to `podman run`.",
				},
				FormatGroup: FormatGroupEnvironment,
			},
			{
				Label: "EnvironmentHost",
				Hover: []string{
					"Use the host environment inside of the container.",
				},
				FormatGroup: FormatGroupEnvironment,
			},
			{
				Label: "Exec",
				Hover: []string{
					"Additional arguments for the container; this has exactly the same effect as passing more arguments after a `podman run <image> <arguments>` invocation.",
					"",
					"The format is the same as for [systemd command lines](https://www.freedesktop.org/software/systemd/man/systemd.service.html#Command%20lines), However, unlike the usage scenario for similarly-named systemd `ExecStart=` verb which operates on the ambient root filesystem, it is very common for container images to have their own `ENTRYPOINT` or `CMD` metadata which this interacts with.",
					"",
					"The default expectation for many images is that the image will include an `ENTRYPOINT` with a default binary, and this field will add arguments to that entrypoint.",
					"",
					"Another way to describe this is that it works the same way as the [args field in a Kubernetes pod](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell).",
				},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "ExposeHostPort",
				Hover: []string{
					"Exposes a port, or a range of ports (e.g. `50-59`), from the host to the container. Equivalent to the Podman `--expose` option.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "GIDMap",
				Hover: []string{
					"Run the container in a new user namespace using the supplied GID mapping. Equivalent to the Podman `--gidmap` option.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "GlobalArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly between `podman` and `run` in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Group",
				Hover: []string{
					"The (numeric) GID to run as inside the container. This does not need to match the GID on the host, which can be modified with UserNS, but if that is not specified, this GID is also used on the host.",
					"",
					"Note: when both `User=` and `Group=` are specified, they are combined into a single `--user USER:GROUP` argument passed to Podman. Using `Group=` without `User=` will result in an error.",
				},
			},
			{
				Label: "GroupAdd",
				Hover: []string{
					"Assign additional groups to the primary user running within the container process. Also supports the keep-groups special flag. Equivalent to the Podman --group-add option.",
				},
			},
			{
				Label: "HealthCmd",
				Hover: []string{
					"Set or alter a healthcheck command for a container. A value of none disables existing healthchecks. Equivalent to the Podman `--health-cmd option`.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthInterval",
				Hover: []string{
					"Set an interval for the healthchecks. An interval of disable results in no automatic timer setup. Equivalent to the Podman `--health-interval` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthLogDestination",
				Hover: []string{
					"Set the destination of the HealthCheck log. Directory path, local or events_logger (local use container state file) (Default: local) Equivalent to the Podman `--health-log-destination` option.",
					"",
					"- `local`: (default) HealthCheck logs are stored in overlay containers. (For example: `$runroot/healthcheck.log`)",
					"- `directory`: creates a log file named `<container-ID>-healthcheck.log` with HealthCheck logs in the specified directory.",
					"- `events_logger`: The log will be written with logging mechanism set by events_logger. It also saves the log to a default directory, for performance on a system with a large number of logs.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthMaxLogCount",
				Hover: []string{
					"Set maximum number of attempts in the HealthCheck log file. (‘0’ value means an infinite number of attempts in the log file) (Default: 5 attempts) Equivalent to the Podman `--Health-max-log-count` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthMaxLogSize",
				Hover: []string{
					"Set maximum length in characters of stored HealthCheck log. (“0” value means an infinite log length) (Default: 500 characters) Equivalent to the Podman `--Health-max-log-size` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthOnFailure",
				Hover: []string{
					"Action to take once the container transitions to an unhealthy state. The “kill” action in combination integrates best with systemd. Once the container turns unhealthy, it gets killed, and systemd restarts the service. Equivalent to the Podman `--health-on-failure` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthRetries",
				Hover: []string{
					"The number of retries allowed before a healthcheck is considered to be unhealthy. Equivalent to the Podman `--health-retries` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthStartPeriod",
				Hover: []string{
					"The initialization time needed for a container to bootstrap. Equivalent to the Podman `--health-start-period` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthStartupCmd",
				Hover: []string{
					"Set a startup healthcheck command for a container. Equivalent to the Podman `--health-startup-cmd` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthStartupInterval",
				Hover: []string{
					"Set an interval for the startup healthcheck. An interval of disable results in no automatic timer setup. Equivalent to the Podman `--health-startup-interval` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthStartupRetries",
				Hover: []string{
					"The number of attempts allowed before the startup healthcheck restarts the container. Equivalent to the Podman `--health-startup-retries` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthStartupSuccess",
				Hover: []string{
					"The number of successful runs required before the startup healthcheck succeeds and the regular healthcheck begins. Equivalent to the Podman `--health-startup-success` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthStartupTimeout",
				Hover: []string{
					"The maximum time a startup healthcheck command has to complete before it is marked as failed. Equivalent to the Podman `--health-startup-timeout` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HealthTimeout",
				Hover: []string{
					"The maximum time allowed to complete the healthcheck before an interval is considered failed. Equivalent to the Podman `--health-timeout` option.",
				},
				FormatGroup: FormatGroupHealth,
			},
			{
				Label: "HostName",
				Hover: []string{
					"Sets the host name that is available inside the container. Equivalent to the Podman --hostname option.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "HttpProxy",
				Hover: []string{
					"Controls whether proxy environment variables (http_proxy, https_proxy, ftp_proxy, no_proxy) are passed from the Podman process into the container during image pulls and builds.",
					"",
					"Set to `true` to enable proxy inheritance (default Podman behavior) or `false` to disable it.",
					"This option is particularly useful on systems that require proxy configuration for internet access but don't want proxy settings passed to the container runtime.",
					"",
					"Equivalent to the Podman `--http-proxy` option.",
				},
				FormatGroup: FormatGroupNetwork,
				Parameters: []string{
					"true",
					"false",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "Image",
				Hover: []string{
					"The image to run in the container. It is recommended to use a fully qualified image name rather than a short name, both for performance and robustness reasons.",
					"",
					"The format of the name is the same as when passed to `podman pull`. So, it supports using `:tag` or digests to guarantee the specific image version.",
					"",
					"Special cases:",
					"- If the name of the image ends with `.image`, Quadlet will use the image pulled by the corresponding `.image` file, and the generated systemd service contains a dependency on the `$name-image.service` (or the service name set in the .image file). Note that the corresponding `.image` file must exist.",
					"- If the name of the image ends with `.build`, Quadlet will use the image built by the corresponding `.build` file, and the generated systemd service contains a dependency on the `$name-build.service`. Note: the corresponding `.build` file must exist.",
				},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "IP",
				Hover: []string{
					"Specify a static IPv4 address for the container, for example **10.88.64.128**. Equivalent to the Podman `--ip` option.",
				},
				FormatGroup: FormatGroupNetwork,
			},
			{
				Label: "IP6",
				Hover: []string{
					"Specify a static IPv6 address for the container, for example **fd46:db93:aa76:ac37::10**. Equivalent to the Podman `--ip6` option.",
				},
				FormatGroup: FormatGroupNetwork,
			},
			{
				Label: "Label",
				Hover: []string{
					"Set one or more OCI labels on the container. The format is a list of `key=value` items, similar to `Environment`.",
					"",
					"This key can be listed multiple times.",
					"",
					"For example:",
					"```systemd",
					"Label=app=myapp",
					"```",
				},
				Macro:       "Label=\"${1:key}=${2:value}\"\n$0",
				FormatGroup: FormatGroupLabel,
				MultipleAdd: true,
			},
			{
				Label: "LogDriver",
				Hover: []string{
					"Set the log-driver used by Podman when running the container. Equivalent to the Podman `--log-driver` option.",
				},
			},
			{
				Label: "LogOpt",
				Hover: []string{
					"Set the log-opt (logging options) used by Podman when running the container. Equivalent to the Podman `--log-opt` option. This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Mask",
				Hover: []string{
					"Specify the paths to mask separated by a colon. `Mask=/path/1:/path/2`. A masked path cannot be accessed inside the container.",
				},
			},
			{
				Label: "Memory",
				Hover: []string{
					"Specify the amount of memory for the container.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "Mount",
				Hover: []string{
					"Attach a filesystem mount to the container. This is equivalent to the Podman `--mount` option, and generally has the form `type=TYPE,TYPE-SPECIFIC-OPTION[,...]`.",
					"",
					"Special cases:",
					"- For `type=volume`, if source ends with `.volume`, the Podman named volume generated by the corresponding `.volume` file is used.",
					"- For `type=image`, if source ends with `.image`, the image generated by the corresponding `.image` file is used.",
					"",
					"In both cases, the generated systemd service will contain a dependency on the service generated for the corresponding unit. Note: the corresponding `.volume` or `.image` file must exist.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupStorage,
				MultipleAdd: true,
			},
			{
				Label: "Network",
				Hover: []string{
					"Specify a custom network for the container. This has the same format as the `--network` option to `podman run`. For example, use `host` to use the host network in the container, or `none` to not set up networking in the container.",
					"",
					"Special cases:",
					"",
					"- If the `name` of the network ends with `.network`, a Podman network called `systemd-$name` is used, and the generated systemd service contains a dependency on the `$name-network.service`. Such a network can be automatically created by using a `$name.network` Quadlet file. Note: the corresponding `.network` file must exist.",
					"- If the `name` ends with `.container`, the container will reuse the network stack of another container created by `$name.container`. The generated systemd service contains a dependency on `$name.service`. Note: the corresponding `.container` file must exist.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "NetworkAlias",
				Hover: []string{
					"Add a network-scoped alias for the container. This has the same format as the `--network-alias` option to `podman run`. Aliases can be used to group containers together in DNS resolution: for example, setting `NetworkAlias=web` on multiple containers will make a DNS query for `web` resolve to all the containers with that alias.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "NoNewPrivileges",
				Hover: []string{
					"If enabled, this disables the container processes from gaining additional privileges via things like setuid and file capabilities. Defaults to false.",
				},
				FormatGroup: FormatGroupNetwork,
			},
			{
				Label: "Notify",
				Hover: []string{
					"By default, Podman is run in such a way that the systemd startup notify command is handled by the container runtime. In other words, the service is deemed started when the container runtime starts the child in the container. However, if the container application supports [sd_notify](https://www.freedesktop.org/software/systemd/man/sd_notify.html), then setting `Notify` to true passes the notification details to the container allowing it to notify of startup on its own.",
					"",
					"In addition, setting `Notify` to `healthy` will postpone startup notifications until such time as the container is marked healthy, as determined by Podman healthchecks. Note that this requires setting up a container healthcheck, see the `HealthCmd` option for more.",
					"",
					"Defaults to false.",
				},
			},
			{
				Label: "PidsLimit",
				Hover: []string{
					"Tune the container's pids limit. This is equivalent to the Podman `--pids-limit` option.",
				},
			},
			{
				Label: "Pod",
				Hover: []string{
					"Specify a Quadlet `.pod` unit to link the container to. The value must take the form of `<name>.pod` and the `.pod` unit must exist.",
					"",
					"Quadlet will add all the necessary parameters to link between the container and the pod and between their corresponding services.",
				},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "PodmanArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly to the end of the `podman run` command in the generated file (right before the image name in the command line). It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupBase,
				MultipleAdd: true,
			},
			{
				Label: "PublishPort",
				Hover: []string{
					"Exposes a port, or a range of ports (e.g. `50-59`), from the container to the host. Equivalent to the Podman `--publish` option. The format is similar to the Podman options, which is of the form `ip:hostPort:containerPort`, `ip::containerPort`, `hostPort:containerPort` or `containerPort`, where the number of host and container ports must be the same (in the case of a range).",
					"",
					"If the IP is set to 0.0.0.0 or not set at all, the port is bound on all IPv4 addresses on the host; use [::] for IPv6.",
					"",
					"Note that not listing a host port means that Podman automatically selects one, and it may be different for each invocation of service. This makes that a less useful option. The allocated port can be found with the `podman port` command.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "PublishPort=${1:interface}:${2:exposed}:${3:source}\n$0",
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "Pull",
				Hover: []string{
					"Set the image pull policy. This is equivalent to the Podman `--pull` option",
				},
				Parameters: []string{
					"always",
					"missing",
					"never",
					"newer",
				},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "ReadOnly",
				Hover: []string{
					"If enabled, makes the image read-only. Defaults to false.",
				},
			},
			{
				Label: "ReadOnlyTmpfs",
				Hover: []string{
					"If ReadOnly is set to `true`, mount a read-write tmpfs on /dev, /dev/shm, /run, /tmp, and /var/tmp. Defaults to false.",
				},
			},
			{
				Label: "ReloadCmd",
				Hover: []string{
					"Add `ExecReload` line to the `Service` that runs ` podman exec` with this command in this container.",
					"",
					"In order to execute the reload run `systemctl reload <Service>`",
					"",
					"Mutually exclusive with `ReloadSignal`",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "ReloadSignal",
				Hover: []string{
					"Add `ExecReload` line to the `Service` that runs `podman kill` with this signal which sends the signal to the main container process.",
					"",
					"In order to execute the reload run `systemctl reload <Service>`",
					"",
					"Mutually exclusive with `ReloadCmd`",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "Retry",
				Hover: []string{
					"Number of times to retry the image pull when a HTTP error occurs. Equivalent to the Podman `--retry` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "RetryDelay",
				Hover: []string{
					"Delay between retries. Equivalent to the Podman `--retry-delay` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "Rootfs",
				Hover: []string{
					"The rootfs to use for the container. Rootfs points to a directory on the system that contains the content to be run within the container. This option conflicts with the `Image` option.",
					"",
					"The format of the rootfs is the same as when passed to `podman run --rootfs`, so it supports overlay mounts as well.",
					"",
					"Note: On SELinux systems, the rootfs needs the correct label, which is by default unconfined_u:object_r:container_file_t:s0.",
				},
			},
			{
				Label: "RunInit",
				Hover: []string{
					"If enabled, the container has a minimal init process inside the container that forwards signals and reaps processes.",
				},
			},
			{
				Label: "SeccompProfile",
				Hover: []string{
					"Set the seccomp profile to use in the container. If unset, the default podman profile is used. Set to either the pathname of a JSON file, or `unconfined` to disable the seccomp filters.",
				},
			},
			{
				Label: "Secret",
				Hover: []string{
					"Use a Podman secret in the container either as a file or an environment variable. This is equivalent to the Podman `--secret` option and generally has the form `secret[,opt=opt ...]`",
				},
				Macro:       "Secret=${1:secret},type=${2:type},target=${3:target}\n$0",
				FormatGroup: FormatGroupSecret,
			},
			{
				Label: "SecurityLabelDisable",
				Hover: []string{
					"Turn off label separation for the container.",
				},
			},
			{
				Label: "SecurityLabelFileType",
				Hover: []string{
					"Set the label file type for the container files.",
				},
			},
			{
				Label: "SecurityLabelLevel",
				Hover: []string{
					"Set the label process level for the container processes.",
				},
			},
			{
				Label: "SecurityLabelNested",
				Hover: []string{
					"Allow SecurityLabels to function within the container. This allows separation of containers created within the container.",
				},
			},
			{
				Label: "SecurityLabelType",
				Hover: []string{
					"Set the label process type for the container processes.",
				},
			},
			{
				Label: "ShmSize",
				Hover: []string{
					"Size of /dev/shm.",
					"",
					"This is equivalent to the Podman `--shm-size` option and generally has the form `number[unit]`",
				},
			},
			{
				Label: "StartWithPod",
				Hover: []string{
					"Start the container after the associated pod is created. Default to **true**.",
					"",
					"If `true`, container will be started/stopped/restarted alongside the pod.",
					"",
					"If `false`, the container will not be started when the pod starts. The container will be stopped with the pod. Restarting the pod will also restart the container as long as the container was also running before.",
					"",
					"Note, the container can still be started manually or through a target by configuring the `[Install]` section. The pod will be started as needed in any case.",
				},
			},
			{
				Label: "StopSignal",
				Hover: []string{
					"Signal to stop a container. Default is **SIGTERM**.",
					"",
					"This is equivalent to the Podman `--stop-signal` option",
				},
				Parameters: []string{
					"SIGTERM",
					"SIGKILL",
				},
			},
			{
				Label: "StopTimeout",
				Hover: []string{
					"Seconds to wait before forcibly stopping the container.",
					"",
					"Note, this value should be lower than the actual systemd unit timeout to make sure the podman rm command is not killed by systemd.",
					"",
					"This is equivalent to the Podman `--stop-timeout` option",
				},
			},
			{
				Label: "SubGIDMap",
				Hover: []string{
					"Run the container in a new user namespace using the map with name in the /etc/subgid file. Equivalent to the Podman `--subgidname` option.",
				},
			},
			{
				Label: "SubUIDMap",
				Hover: []string{
					"Run the container in a new user namespace using the map with name in the /etc/subuid file. Equivalent to the Podman `--subuidname` option.",
				},
			},
			{
				Label: "Sysctl",
				Hover: []string{
					"Configures namespaced kernel parameters for the container. The format is `Sysctl=name=value`.",
					"",
					"This is a space separated list of kernel parameters. This key can be listed multiple times.",
					"",
					"For example:",
					"```",
					"Sysctl=net.ipv6.conf.all.disable_ipv6=1 net.ipv6.conf.all.use_tempaddr=1",
					"```",
				},
				MultipleAdd: true,
			},
			{
				Label: "Timezone",
				Hover: []string{
					"The timezone to run the container in.",
				},
			},
			{
				Label: "Tmpfs",
				Hover: []string{
					"Mount a tmpfs in the container. This is equivalent to the Podman `--tmpfs` option, and generally has the form `CONTAINER-DIR[:OPTIONS]`.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "UIDMap",
				Hover: []string{
					"Run the container in a new user namespace using the supplied UID mapping. Equivalent to the Podman `--uidmap` option.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Ulimit",
				Hover: []string{
					"Ulimit options. Sets the ulimits values inside of the container.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Unmask",
				Hover: []string{
					"Specify the paths to unmask separated by a colon. unmask=ALL or /path/1:/path/2, or shell expanded paths (/proc/*):",
					"",
					"If set to `ALL`, Podman will unmask all the paths that are masked or made read-only by default.",
					"",
					"The default masked paths are /proc/acpi, /proc/kcore, /proc/keys, /proc/latency_stats, /proc/sched_debug, /proc/scsi, /proc/timer_list, /proc/timer_stats, /sys/firmware, and /sys/fs/selinux.",
					"",
					"The default paths that are read-only are /proc/asound, /proc/bus, /proc/fs, /proc/irq, /proc/sys, /proc/sysrq-trigger, /sys/fs/cgroup.",
				},
			},
			{
				Label: "User",
				Hover: []string{
					"The (numeric) UID to run as inside the container. This does not need to match the UID on the host, which can be modified with `UserNS`, but if that is not specified, this UID is also used on the host.",
					"",
					"Note: when both `User=` and `Group=` are specified, they are combined into a single `--user USER:GROUP` argument passed to Podman. Using `Group=` without `User=` will result in an error.",
				},
			},
			{
				Label: "UserNS",
				Hover: []string{
					"Set the user namespace mode for the container. This is equivalent to the Podman `--userns` option and generally has the form `MODE[:OPTIONS,...]`.",
				},
				Parameters: []string{
					"auto",
					"host",
					"keep-id",
					"nomap",
				},
			},
			{
				Label: "Volume",
				Hover: []string{
					"Mount a volume in the container. This is equivalent to the Podman `--volume` option, and generally has the form `[[SOURCE-VOLUME|HOST-DIR:]CONTAINER-DIR[:OPTIONS]]`.",
					"",
					"If `SOURCE-VOLUME` starts with `.`, Quadlet resolves the path relative to the location of the unit file.",
					"",
					"Special case:",
					"- If `SOURCE-VOLUME` ends with `.volume`, a Podman named volume called `systemd-$name` is used as the source, and the generated systemd service contains a dependency on the `$name-volume.service`. Note that the corresponding `.volume` file must exist.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "Volume=${1:destination}:${2:source}\n$0",
				FormatGroup: FormatGroupStorage,
				MultipleAdd: true,
			},
			{
				Label: "WorkingDir",
				Hover: []string{
					"Working directory inside the container.",
					"",
					"The default working directory for running binaries within a container is the root directory (/). The image developer can set a different default with the WORKDIR instruction. This option overrides the working directory by using the -w option.",
				},
			},
		},
		"Pod": {
			{
				Label: "AddHost",
				Hover: []string{
					"Add  host-to-IP mapping to /etc/hosts. The format is `hostname:ip`.",
					"",
					"Equivalent to the Podman `--add-host` option. This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
			},
			{
				Label: "ContainersConfModule",
				Hover: []string{
					"Load the specified containers.conf(5) module. Equivalent to the Podman `--module` option.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "DNS",
				Hover: []string{
					"Set network-scoped DNS resolver/nameserver for containers in this pod.",
					"",
					"This key can be listed multiple times.",
				},
				Parameters: []string{
					"1.1.1.1",
					"1.0.0.1",
					"8.8.8.8",
					"8.8.4.4",
					"9.9.9.9",
					"149.112.112.112",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "DNSOption",
				Hover: []string{
					"Set custom DNS options.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "DNSSearch",
				Hover: []string{
					"Set custom DNS search domains. Use **DNSSearch=.** to remove the search domain.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "ExitPolicy",
				Hover: []string{
					"Set the exit policy of the pod when the last container exits. Default for quadlets is **stop**.",
					"",
					"To keep the pod active, set `ExitPolicy=continue`.",
				},
				Parameters: []string{
					"stop",
					"continue",
				},
				MinVersion: utils.BuildPodmanVersion(5, 6, 0),
			},
			{
				Label: "GIDMap",
				Hover: []string{
					"Create the pod in a new user namespace using the supplied GID mapping. Equivalent to the Podman `--gidmap` option.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "GlobalArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly between `podman` and `pod` in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "HostName",
				Hover: []string{
					"Set the pod’s hostname inside all containers.",
					"",
					"The given hostname is also added to the /etc/hosts file using the container’s primary IP address (also see the `--add-host` option).",
					"",
					"Equivalent to the Podman `--hostname` option. This key can be listed multiple times.",
				},
				MinVersion:  utils.BuildPodmanVersion(5, 5, 0),
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "IP",
				Hover: []string{
					"Specify a static IPv4 address for the pod, for example **10.88.64.128**. Equivalent to the Podman `--ip` option.",
				},
				FormatGroup: FormatGroupNetwork,
			},
			{
				Label: "IP6",
				Hover: []string{
					"Specify a static IPv6 address for the pod, for example **fd46:db93:aa76:ac37::10**. Equivalent to the Podman `--ip6` option.",
				},
				FormatGroup: FormatGroupNetwork,
			},
			{
				Label: "Label",
				Hover: []string{
					"Set one or more OCI labels on the pod. The format is a list of `key=value` items, similar to `Environment`.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "Label=\"${1:key}=${2:value}\"\n$0",
				MinVersion:  utils.BuildPodmanVersion(5, 6, 0),
				FormatGroup: FormatGroupLabel,
				MultipleAdd: true,
			},
			{
				Label: "Network",
				Hover: []string{
					"Specify a custom network for the pod. This has the same format as the `--network` option to `podman pod create`. For example, use `host` to use the host network in the pod, or `none` to not set up networking in the pod.",
					"",
					"Special case:",
					"- If the `name` of the network ends with `.network`, Quadlet will look for the corresponding `.network` Quadlet unit. If found, Quadlet will use the name of the Network set in the Unit, otherwise, `systemd-$name` is used.",
					"",
					"The generated systemd service contains a dependency on the service unit generated for that `.network` unit. Note: the corresponding `.network` file must exist.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "NetworkAlias",
				Hover: []string{
					"Add a network-scoped alias for the pod. This has the same format as the `--network-alias` option to `podman pod create`. Aliases can be used to group containers together in DNS resolution: for example, setting `NetworkAlias=web` on multiple containers will make a DNS query for `web` resolve to all the containers with that alias.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "PodmanArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly to the end of the `podman pod create` command in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupBase,
				MultipleAdd: true,
			},
			{
				Label: "PodName",
				Hover: []string{
					"The (optional) name of the Podman pod. If this is not specified, the default value is the same name as the unit, but with a `systemd-` prefix, i.e. a `$name.pod` file creates a `systemd-$name` Podman pod to avoid conflicts with user-managed pods.",
					"",
					"Please note that pods and containers cannot have the same name. So, if PodName is set, it must not conflict with any container.",
				},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "PublishPort",
				Hover: []string{
					"Exposes a port, or a range of ports (e.g. `50-59`), from the pod to the host. Equivalent to the Podman `--publish` option. The format is similar to the Podman options, which is of the form `ip:hostPort:containerPort`, `ip::containerPort`, `hostPort:containerPort` or `containerPort`, where the number of host and container ports must be the same (in the case of a range).",
					"",
					"If the IP is set to 0.0.0.0 or not set at all, the port is bound on all IPv4 addresses on the host; use [::] for IPv6.",
					"",
					"Note that not listing a host port means that Podman automatically selects one, and it may be different for each invocation of service. This makes that a less useful option. The allocated port can be found with the `podman port` command.",
					"",
					"When using `host` networking via `Network=host`, the `PublishPort=` option cannot be used.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "PublishPort=${1:interface}:${2:exposed}:${3:source}\n$0",
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "ServiceName",
				Hover: []string{
					"By default, Quadlet will name the systemd service unit by appending `-pod` to the name of the Quadlet. Setting this key overrides this behavior by instructing Quadlet to use the provided name.",
					"",
					"Note, the name should not include the `.service` file extension",
				},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "StopTimeout",
				Hover: []string{
					"Sets the time in seconds to wait for the pod to gracefully stop.",
					"This value is equivalent to the `--time` argument in the podman `pod stop` command when the service is stopped.",
					"After this period expires, any running containers in the pod are forcibly killed.",
				},
				FormatGroup: FormatGroupBase,
				MinVersion:  utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "ShmSize",
				Hover: []string{
					"Size of /dev/shm.",
					"",
					"This is equivalent to the Podman `--shm-size` option and generally has the form `number[unit]`",
				},
				MinVersion: utils.BuildPodmanVersion(5, 4, 0),
			},
			{
				Label: "SubGIDMap",
				Hover: []string{
					"Create the pod in a new user namespace using the map with name in the /etc/subgid file. Equivalent to the Podman `--subgidname` option.",
				},
			},
			{
				Label: "SubUIDMap",
				Hover: []string{
					"Create the pod in a new user namespace using the map with name in the /etc/subuid file. Equivalent to the Podman `--subuidname` option.",
				},
			},
			{
				Label: "UIDMap",
				Hover: []string{
					"Create the pod in a new user namespace using the supplied UID mapping. Equivalent to the Podman `--uidmap` option.",
				},
				MultipleAdd: true,
			},
			{
				Label: "UserNS",
				Hover: []string{
					"Set the user namespace mode for the pod. This is equivalent to the Podman `--userns` option and generally has the form `MODE[:OPTIONS,...]`.",
				},
				Parameters: []string{
					"auto",
					"host",
					"keep-id",
					"nomap",
				},
			},
			{
				Label: "Volume",
				Hover: []string{
					"Mount a volume in the pod. This is equivalent to the Podman `--volume` option, and generally has the form `[[SOURCE-VOLUME|HOST-DIR:]CONTAINER-DIR[:OPTIONS]]`.",
					"",
					"If `SOURCE-VOLUME` starts with `.`, Quadlet resolves the path relative to the location of the unit file.",
					"",
					"Special case:",
					"- If `SOURCE-VOLUME` ends with `.volume`, Quadlet will look for the corresponding `.volume` Quadlet unit. If found, Quadlet will use the name of the Volume set in the Unit, otherwise, `systemd-$name` is used. Note: the corresponding `.volume` file must exist.",
					"",
					"The generated systemd service contains a dependency on the service unit generated for that `.volume` unit, or on `$name-volume.service` if the `.volume` unit is not found.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "Volume=${1:destination}:${2:source}\n$0",
				FormatGroup: FormatGroupStorage,
				MultipleAdd: true,
			},
		},
		"Kube": {
			{
				Label: "AutoUpdate",
				Hover: []string{
					"Indicates whether containers will be auto-updated ([podman-auto-update(1)](podman-auto-update.1.md)). AutoUpdate can be specified multiple times. The following values are supported:",
					"- `registry`: Requires a fully-qualified image reference (e.g., quay.io/podman/stable:latest) to be used to create the container. This enforcement is necessary to know which images to actually check and pull. If an image ID was used, Podman does not know which image to check/pull anymore.",
					"- `local`: Tells Podman to compare the image a container is using to the image with its raw name in local storage. If an image is updated locally, Podman simply restarts the systemd unit executing the Kubernetes Quadlet.",
					"- `name/(local|registry)`: Tells Podman to perform the `local` or `registry` autoupdate on the specified container name.",
				},
				Parameters:  []string{"registry", "local"},
				FormatGroup: FormatGroupBase,
			},
			{
				Label: "ConfigMap",
				Hover: []string{
					"Pass the Kubernetes ConfigMap YAML path to `podman kube play` via the `--configmap` argument. Unlike the `configmap` argument, the value may contain only one path but it may be absolute or relative to the location of the unit file.",
					"",
					"This key may be used multiple times",
				},
			},
			{
				Label: "ContainersConfModule",
				Hover: []string{
					"Load the specified containers.conf(5) module. Equivalent to the Podman `--module` option.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "ExitCodePropagation",
				Hover: []string{
					"Control how the main PID of the systemd service should exit. The following values are supported:",
					"- `all`: exit non-zero if all containers have failed (i.e., exited non-zero)",
					" `any`: exit non-zero if any container has failed",
					"- `none`: exit zero and ignore failed containers",
					"",
					"The current default value is `none`.",
				},
			},
			{
				Label: "GlobalArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly between `podman` and `kube` in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "KubeDownForce",
				Hover: []string{
					"Remove all resources, including volumes, when calling `podman kube down`. Equivalent to the Podman `--force` option.",
				},
			},
			{
				Label: "LogDriver",
				Hover: []string{
					"Set the log-driver Podman uses when running the container. Equivalent to the Podman `--log-driver` option.",
				},
			},
			{
				Label: "Network",
				Hover: []string{
					"Specify a custom network for the container. This has the same format as the `--network` option to `podman kube play`. For example, use `host` to use the host network in the container, or `none` to not set up networking in the container.",
					"",
					"Special case:",
					"- If the `name` of the network ends with `.network`, a Podman network called `systemd-$name` is used, and the generated systemd service contains a dependency on the `$name-network.service`. Such a network can be automatically created by using a `$name.network` Quadlet file. Note: the corresponding `.network` file must exist.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "PodmanArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly to the end of the `podman kube play` command in the generated file (right before the path to the yaml file in the command line). It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				FormatGroup: FormatGroupBase,
				MultipleAdd: true,
			},
			{
				Label: "PublishPort",
				Hover: []string{
					"Exposes a port, or a range of ports (e.g. `50-59`), from the container to the host. Equivalent to the `podman kube play`'s `--publish` option. The format is similar to the Podman options, which is of the form `ip:hostPort:containerPort`, `ip::containerPort`, `hostPort:containerPort` or `containerPort`, where the number of host and container ports must be the same (in the case of a range).",
					"",
					"If the IP is set to 0.0.0.0 or not set at all, the port is bound on all IPv4 addresses on the host; use [::] for IPv6.",
					"",
					"The list of published ports specified in the unit file is merged with the list of ports specified in the Kubernetes YAML file. If the same container port and protocol is specified in both, the entry from the unit file takes precedence",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "PublishPort=${1:interface}:${2:exposed}:${3:source}\n$0",
				FormatGroup: FormatGroupNetwork,
				MultipleAdd: true,
			},
			{
				Label: "SetWorkingDirectory",
				Hover: []string{
					"Set the `WorkingDirectory` field of the `Service` group of the Systemd service unit file. Used to allow `podman kube play` to correctly resolve relative paths. Supported values are `yaml` and `unit` to set the working directory to that of the YAML or Quadlet Unit file respectively.",
					"",
					"Alternatively, users can explicitly set the `WorkingDirectory` field of the `Service` group in the `.kube` file. Please note that if the `WorkingDirectory` field of the `Service` group is set, Quadlet will not set it even if `SetWorkingDirectory` is set",
				},
			},
			{
				Label: "UserNS",
				Hover: []string{
					"Set the user namespace mode for the container. This is equivalent to the Podman `--userns` option and generally has the form `MODE[:OPTIONS,...]`.",
				},
				Parameters: []string{
					"auto",
					"host",
					"keep-id",
					"nomap",
				},
			},
			{
				Label: "Yaml",
				Hover: []string{
					"The path, absolute or relative to the location of the unit file, to the Kubernetes YAML file to use.",
				},
				FormatGroup: FormatGroupBase,
			},
		},
		"Network": {
			{
				Label: "ContainersConfModule",
				Hover: []string{
					"Load the specified containers.conf(5) module. Equivalent to the Podman `--module` option.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "DisableDNS",
				Hover: []string{
					"If enabled, disables the DNS plugin for this network.",
					"",
					"This is equivalent to the Podman `--disable-dns` option",
				},
			},
			{
				Label: "DNS",
				Hover: []string{
					"Set network-scoped DNS resolver/nameserver for containers in this network.",
					"",
					"This key can be listed multiple times.",
				},
				Parameters:  []string{"1.1.1.1", "8.8.8.8"},
				MultipleAdd: true,
			},
			{
				Label: "Driver",
				Hover: []string{
					"Driver to manage the network. Currently `bridge`, `macvlan` and `ipvlan` are supported.",
					"",
					"This is equivalent to the Podman `--driver` option",
				},
			},
			{
				Label: "Gateway",
				Hover: []string{
					"Define a gateway for the subnet. If you want to provide a gateway address, you must also provide a subnet option.",
					"",
					"This is equivalent to the Podman `--gateway` option",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "GlobalArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly between `podman` and `network` in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "InterfaceName",
				Hover: []string{
					"This option maps the *network_interface* option in the network config, see **podman network inspect**. Depending on the driver, this can have different effects; for `bridge`, it uses the bridge interface name. For `macvlan` and `ipvlan`, it is the parent device on the host. It is the same as `--opt parent=...`.",
					"",
					"This is equivalent to the Podman `--interface-name` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 6, 0),
			},
			{
				Label: "Internal",
				Hover: []string{
					"Restrict external access of this network.",
					"",
					"This is equivalent to the Podman `--internal` option",
				},
			},
			{
				Label: "IPAMDriver",
				Hover: []string{
					"Set the ipam driver (IP Address Management Driver) for the network. Currently `host-local`, `dhcp` and `none` are supported.",
					"",
					"This is equivalent to the Podman `--ipam-driver` option",
				},
			},
			{
				Label: "IPRange",
				Hover: []string{
					"Allocate container IP from a range. The range must be a either a complete subnet in CIDR notation or be in the `<startIP>-<endIP>` syntax which allows for a more flexible range compared to the CIDR subnet. The ip-range option must be used with a subnet option.",
					"",
					"This is equivalent to the Podman `--ip-range` option",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "IPv6",
				Hover: []string{
					"Enable IPv6 (Dual Stack) networking.",
					"",
					"This is equivalent to the Podman `--ipv6` option",
				},
			},
			{
				Label: "Label",
				Hover: []string{
					"Set one or more OCI labels on the network. The format is a list of `key=value` items, similar to `Environment`.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "Label=\"${1:key}=${2:value}\"\n$0",
				MultipleAdd: true,
			},
			{
				Label: "NetworkDeleteOnStop",
				Hover: []string{
					"When set to `true` the network is deleted when the service is stopped",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "NetworkName",
				Hover: []string{
					"The (optional) name of the Podman network. If this is not specified, the default value is the same name as the unit, but with a `systemd-` prefix, i.e. a `$name.network` file creates a `systemd-$name` Podman network to avoid conflicts with user-managed network.",
				},
			},
			{
				Label: "Options",
				Hover: []string{
					"Set driver specific options.",
					"",
					"This is equivalent to the Podman `--opt` option",
				},
			},
			{
				Label: "PodmanArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly to the end of the `podman network create` command in the generated file (right before the name of the network in the command line). It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Subnet",
				Hover: []string{
					"The subnet in CIDR notation.",
					"",
					"This is equivalent to the Podman `--subnet` option",
					"",
					"This key can be listed multiple times.",
				},
			},
		},
		"Volume": {
			{
				Label: "ContainersConfModule",
				Hover: []string{
					"Load the specified containers.conf(5) module. Equivalent to the Podman `--module` option.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Copy",
				Hover: []string{
					"If enabled, the content of the image located at the mountpoint of the volume is copied into the volume on the first run.",
				},
			},
			{
				Label: "Device",
				Hover: []string{
					"The path of a device which is mounted for the volume.",
				},
			},
			{
				Label: "Driver",
				Hover: []string{
					"Specify the volume driver name. When set to `image`, the `Image` key must also be set.",
					"",
					"This is equivalent to the Podman `--driver` option.",
				},
			},
			{
				Label: "GlobalArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly between `podman` and `volume` in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Group",
				Hover: []string{
					"The host (numeric) GID, or group name to use as the group for the volume",
				},
			},
			{
				Label: "Image",
				Hover: []string{
					"Specifies the image the volume is based on when `Driver` is set to the `image`. It is recommended to use a fully qualified image name rather than a short name, both for performance and robustness reasons.",
					"",
					"The format of the name is the same as when passed to `podman pull`. So, it supports using `:tag` or digests to guarantee the specific image version.",
					"",
					"Special case:",
					"- If the `name` of the image ends with `.image`, Quadlet will use the image pulled by the corresponding `.image` file, and the generated systemd service contains a dependency on the `$name-image.service` (or the service name set in the .image file). Note: the corresponding `.image` file must exist.",
				},
			},
			{
				Label: "Label",
				Hover: []string{
					"Set one or more OCI labels on the volume. The format is a list of `key=value` items, similar to `Environment`.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "Label=\"${1:key}=${2:value}\"\n$0",
				MultipleAdd: true,
			},
			{
				Label: "Options",
				Hover: []string{
					"The mount options to use for a filesystem as used by the **mount(8)** command `-o` option.",
				},
			},
			{
				Label: "PodmanArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly to the end of the `podman volume create` command in the generated file (right before the name of the volume in the command line). It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Type",
				Hover: []string{
					"The filesystem type of `Device` as used by the **mount(8)** commands `-t` option.",
				},
			},
			{
				Label: "User",
				Hover: []string{
					"The host (numeric) UID, or user name to use as the owner for the volume",
				},
			},
			{
				Label: "VolumeName",
				Hover: []string{
					"The (optional) name of the Podman volume. If this is not specified, the default value is the same name as the unit, but with a `systemd-` prefix, i.e. a `$name.volume` file creates a `systemd-$name` Podman volume to avoid conflicts with user-managed volumes.",
				},
			},
		},
		"Image": {
			{
				Label: "AllTags",
				Hover: []string{
					"All tagged images in the repository are pulled.",
					"This is equivalent to the Podman `--all-tags` option.",
				},
			},
			{
				Label: "Arch",
				Hover: []string{
					"Override the architecture, defaults to hosts, of the image to be pulled.",
					"This is equivalent to the Podman `--arch` option.",
				},
			},
			{
				Label: "AuthFile",
				Hover: []string{
					"Path of the authentication file.",
					"This is equivalent to the Podman `--authfile` option.",
				},
			},
			{
				Label: "CertDir",
				Hover: []string{
					"Use certificates at path (*.crt, *.cert, *.key) to connect to the registry.",
					"This is equivalent to the Podman `--cert-dir` option.",
				},
			},
			{
				Label: "ContainersConfModule",
				Hover: []string{
					"Load the specified containers.conf(5) module. Equivalent to the Podman `--module` option.",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Creds",
				Hover: []string{
					"The `[username[:password]]` to use to authenticate with the registry, if required.",
					"This is equivalent to the Podman `--creds` option.",
				},
			},
			{
				Label: "DecryptionKey",
				Hover: []string{
					"This key contains a list of arguments passed directly between `podman` and `image` in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
			},
			{
				Label: "Image",
				Hover: []string{
					"The image to pull. It is recommended to use a fully qualified image name rather than a short name, both for performance and robustness reasons.",
					"",
					"The format of the name is the same as when passed to `podman pull`. So, it supports using `:tag` or digests to guarantee the specific image version.",
				},
			},
			{
				Label: "ImageTag",
				Hover: []string{
					"Actual FQIN of the referenced `Image`. Only meaningful when source is a file or directory archive.",
					"",
					"For example, an image saved into a `docker-archive` with the following Podman command:",
					"",
					"`podman image save --format docker-archive --output /tmp/archive-file.tar quay.io/podman/stable:latest`",
					"",
					"requires setting",
					"- `Image=docker-archive:/tmp/archive-file.tar`",
					"- `ImageTag=quay.io/podman/stable:latest`",
				},
				MultipleAdd: true,
			},
			{
				Label: "OS",
				Hover: []string{
					"Override the OS, defaults to hosts, of the image to be pulled.",
					"This is equivalent to the Podman `--os` option.",
				},
			},
			{
				Label: "PodmanArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly to the end of the `podman image pull` command in the generated file (right before the image name in the command line). It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Policy",
				Hover: []string{
					"The pull policy to use when pulling the image.",
					"This is equivalent to the Podman `--policy` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 6, 0),
			},
			{
				Label: "Retry",
				Hover: []string{
					"Number of times to retry the image pull when a HTTP error occurs. Equivalent to the Podman `--retry` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "RetryDelay",
				Hover: []string{
					"Delay between retries. Equivalent to the Podman `--retry-delay` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "TLSVerify",
				Hover: []string{
					"Require HTTPS and verification of certificates when contacting registries.",
					"This is equivalent to the Podman `--tls-verify` option.",
				},
			},
			{
				Label: "Variant",
				Hover: []string{
					"Override the default architecture variant of the container image.",
					"This is equivalent to the Podman `--variant` option.",
				},
			},
		},
		"Build": {
			{
				Label: "Annotation",
				Hover: []string{
					"Set one or more OCI annotations on the container. The format is a list of key=value items, similar to Environment.",
					"",
					"This key can be listed multiple times.",
				},
				Macro: "Annotation=\"${1:key}=${2:value}\"\n$0",
			},
			{
				Label: "Arch",
				Hover: []string{
					"Override the architecture, defaults to hosts', of the image to be built.",
					"",
					"This is equivalent to the `--arch` option of `podman build`.",
				},
			},
			{
				Label: "AuthFile",
				Hover: []string{
					"Path of the authentication file.",
					"",
					"This is equivalent to the `--authfile` option of `podman build`.",
				},
			},
			{
				Label: "BuildArg",
				Hover: []string{
					"Specifies a build argument and its value in the same way environment variables are",
					"(e.g., env=*value*), but it is not added to the environment variable list in the",
					"resulting image's configuration. Can be listed multiple times.",
					"",
					"This is equivalent to the `--build-arg` option of `podman build`.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "ContainersConfModule",
				Hover: []string{
					"Load the specified containers.conf(5) module. Equivalent to the Podman `--module` option.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "DNS",
				Hover: []string{
					"Set network-scoped DNS resolver/nameserver for the build container.",
					"",
					"This key can be listed multiple times.",
					"",
					"This is equivalent to the `--dns` option of `podman build`.",
				},
				Parameters:  []string{"1.1.1.1", "8.8.8.8"},
				MultipleAdd: true,
			},
			{
				Label: "DNSOption",
				Hover: []string{
					"Set custom DNS options.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "DNSSearch",
				Hover: []string{
					"Set custom DNS search domains. Use **DNSSearch=.** to remove the search domain.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Environment",
				Hover: []string{
					"Set an environment variable in the container. This uses the same format as services in systemd and can be listed multiple times.",
					"",
					"For example:",
					"```systemd",
					"Environment=APP_USERNAME=appuser",
					"```",
				},
				Macro:       "Environment=\"${1:name}=${2:value}\"\n$0",
				MultipleAdd: true,
			},
			{
				Label: "File",
				Hover: []string{
					"Specifies a Containerfile which contains instructions for building the image. A URL starting with `http(s)://` allows you to specify a remote Containerfile to be downloaded. Note that for a given relative path to a Containerfile, or when using a `http(s)://` URL, you also must set `SetWorkingDirectory=` in order for `podman build` to find a valid context directory for the resources specified in the Containerfile.",
					"",
					"Note that setting a `File=` field is mandatory for a `.build` file, unless `SetWorkingDirectory` (or a `WorkingDirectory` in the `Service` group) has also been set.",
					"",
					"This is equivalent to the `--file` option of `podman build`.",
				},
			},
			{
				Label: "ForceRM",
				Hover: []string{
					"Always remove intermediate containers after a build, even if the build fails (default true).",
					"",
					"This is equivalent to the `--force-rm` option of `podman build`.",
				},
			},
			{
				Label: "GlobalArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly between `podman` and `build` in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "GroupAdd",
				Hover: []string{
					"Assign additional groups to the primary user running within the container process. Also supports the `keep-groups` special flag.",
					"",
					"This is equivalent to the `--group-add` option of `podman build`.",
				},
			},
			{
				Label: "IgnoreFile",
				Hover: []string{
					"Path to an alternate .containerignore file to use when building the image.",
					"Note that when using a relative path you should also set `SetWorkingDirectory=`",
					"",
					"This is equivalent to the `--ignorefile` option of `podman build`.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "ImageTag",
				Hover: []string{
					"Specifies the name which is assigned to the resulting image if the build process completes successfully.",
					"",
					"This is equivalent to the `--tag` option of `podman build`.",
					"",
					"This key can be listed multiple times. The first instance will be used as the name of the created artifact when the `.build` file is referenced by another Quadlet unit.",
				},
			},
			{
				Label: "Label",
				Hover: []string{
					"Set one or more OCI labels on the volume. The format is a list of `key=value` items, similar to `Environment`.",
					"",
					"This key can be listed multiple times.",
				},
				Macro:       "Label=\"${1:key}=${2:value}\"\n$0",
				MultipleAdd: true,
			},
			{
				Label: "Network",

				Hover: []string{
					"Sets the configuration for network namespaces when handling RUN instructions. This has the same format as the `--network` option to `podman build`. For example, use `host` to use the host network, or `none` to not set up networking.",
					"",
					"Special case:",
					"",
					"* If the `name` of the network ends with `.network`, Quadlet will look for the corresponding `.network` Quadlet unit. If found, Quadlet will use the name of the Network set in the Unit, otherwise, `systemd-$name` is used. The generated systemd service contains a dependency on the service unit generated for that `.network` unit, or on `$name-network.service` if the `.network` unit is not found. Note: the corresponding `.network` file must exist.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "PodmanArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly to the end of the `podman build` command in the generated file (right before the image name in the command line). It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
			{
				Label: "Pull",
				Hover: []string{
					"Set the image pull policy.",
					"",
					"This is equivalent to the `--pull` option of `podman build`.",
				},
			},
			{
				Label: "Retry",
				Hover: []string{
					"Number of times to retry the image pull when a HTTP error occurs. Equivalent to the Podman `--retry` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "RetryDelay",
				Hover: []string{
					"Delay between retries. Equivalent to the Podman `--retry-delay` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 5, 0),
			},
			{
				Label: "Secret",
				Hover: []string{
					"Pass secret information used in Containerfile build stages in a safe way.",
					"",
					"This is equivalent to the `--secret` option of `podman build` and generally has the form `secret[,opt=opt ...]`.",
				},
			},
			{
				Label: "SetWorkingDirectory",
				Hover: []string{
					"Provide context (a working directory) to `podman build`. Supported values are a path, a URL, or the special keys `file` or `unit` to set the context directory to the parent directory of the file from the `File=` key or to that of the Quadlet `.build` unit file, respectively. This allows Quadlet to resolve relative paths.",
					"",
					"When using one of the special keys (`file` or `unit`), the `WorkingDirectory` field of the `Service` group of the Systemd service unit will also be set to accordingly. Alternatively, users can explicitly set the `WorkingDirectory` field of the `Service` group in the `.build` file. Please note that if the `WorkingDirectory` field of the `Service` group is set by the user, Quadlet will not overwrite it even if `SetWorkingDirectory` is set to `file` or `unit`.",
					"",
					"By providing a URL to `SetWorkingDirectory=` you can instruct `podman build` to clone a Git repository or download an archive file extracted to a temporary location by `podman build` as build context. Note that in this case, the `WorkingDirectory` of the Systemd service unit is left untouched by Quadlet.",
					"",
					"Note that providing context directory is mandatory for a `.build` file, unless a `File=` key has also been provided.",
				},
			},
			{
				Label: "Target",
				Hover: []string{
					"Set the target build stage to build. Commands in the Containerfile after the target stage are skipped.",
					"",
					"This is equivalent to the `--target` option of `podman build`.",
				},
			},
			{
				Label: "TLSVerify",
				Hover: []string{
					"Require HTTPS and verification of certificates when contacting registries.",
					"",
					"This is equivalent to the `--tls-verify` option of `podman build`.",
				},
			},
			{
				Label: "Variant",
				Hover: []string{
					"Override the default architecture variant of the container image to be built.",
					"",
					"This is equivalent to the `--variant` option of `podman build`.",
				},
			},
			{
				Label: "Volume",
				Hover: []string{
					"Mount a volume to containers when executing RUN instructions during the build. This is equivalent to the `--volume` option of `podman build`, and generally has the form",
					"`[[SOURCE-VOLUME|HOST-DIR:]CONTAINER-DIR[:OPTIONS]]`.",
					"",
					"If `SOURCE-VOLUME` starts with `.`, Quadlet resolves the path relative to the location of the unit file.",
					"",
					"Special case:",
					"",
					"* If `SOURCE-VOLUME` ends with `.volume`, Quadlet will look for the corresponding `.volume` Quadlet unit. If found, Quadlet will use the name of the Volume set in the Unit, otherwise, `systemd-$name` is used. The generated systemd service contains a dependency on the service unit generated for that `.volume` unit, or on `$name-volume.service` if the `.volume` unit is not found. Note: the corresponding `.volume` file must exist.",
					"",
					"This key can be listed multiple times.",
				},
				MultipleAdd: true,
			},
		},
		"Artifact": {
			{
				Label: "Artifact",
				Hover: []string{
					"The artifact to pull from a registry onto the local machine. This is the only required key for artifact units.",
					"",
					"It is required to use a fully qualified artifact name rather than a short name, both for",
					"performance and robustness reasons.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "AuthFile",
				Hover: []string{
					"Path of the authentication file.",
					"",
					"This is equivalent to the Podman `--authfile` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "CertDir",
				Hover: []string{
					"Use certificates at path (*.crt, *.cert, *.key) to connect to the registry.",
					"",
					"This is equivalent to the Podman `--cert-dir` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "ContainersConfModule",
				Hover: []string{
					"Load the specified containers.conf(5) module. Equivalent to the Podman `--module` option.",
					"",
					"This key can be listed multiple times.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "Creds",
				Hover: []string{
					"The credentials to use when contacting the registry in the format `[username[:password]]`.",
					"",
					"This is equivalent to the Podman `--creds` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "DecryptionKey",
				Hover: []string{
					"The `[key[:passphrase]]` to be used for decryption of artifacts.",
					"",
					"This is equivalent to the Podman `--decryption-key` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "GlobalArgs",
				Hover: []string{
					"",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "",
				Hover: []string{
					"This key contains a list of arguments passed directly between `podman` and `artifact` in the generated file. It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "PodmanArgs",
				Hover: []string{
					"This key contains a list of arguments passed directly to the end of the `podman artifact pull` command in the generated file (right before the artifact name in the command line). It can be used to access Podman features otherwise unsupported by the generator. Since the generator is unaware of what unexpected interactions can be caused by these arguments, it is not recommended to use this option.",
					"",
					"The format of this is a space separated list of arguments, which can optionally be individually escaped to allow inclusion of whitespace and other control characters.",
					"",
					"This key can be listed multiple times.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "Quiet",
				Hover: []string{
					"Suppress output information when pulling artifacts.",
					"",
					"This is equivalent to the Podman `--quiet` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
				Parameters: []string{
					"true",
					"false",
				},
			},
			{
				Label: "Retry",
				Hover: []string{
					"Number of times to retry the artifact pull when a HTTP error occurs. Equivalent to the Podman `--retry` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "RetryDelay",
				Hover: []string{
					"Delay between retries. Equivalent to the Podman `--retry-delay` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "ServiceName",
				Hover: []string{
					"The (optional) name of the systemd service. If this is not specified, the default value is the same name as the unit, but with a `-artifact` suffix, i.e. a `$name.artifact` file creates a `$name-artifact.service` systemd service.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
			{
				Label: "TLSVerify",
				Hover: []string{
					"Require HTTPS and verification of certificates when contacting registries.",
					"",
					"This is equivalent to the Podman `--tls-verify` option.",
				},
				MinVersion: utils.BuildPodmanVersion(5, 7, 0),
			},
		},
	}
)
View Source
var SystemdSpecifierSet = map[string]SystemdSpecifier{
	"%a": {
		ShortDescription: "Architecture",
		LongDescription: []string{
			"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=` above for a full list.",
		},
		IsDirectory: false,
	},
	"%A": {
		ShortDescription: "Operating system image version",
		LongDescription: []string{
			"The operating system 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.",
		},
		IsDirectory: false,
	},
	"%b": {
		ShortDescription: "Boot ID",
		LongDescription: []string{
			"The boot ID of the running system, formatted as string. See random(4) for more information.",
		},
		IsDirectory: false,
	},
	"%B": {
		ShortDescription: "Operating system build ID",
		LongDescription: []string{
			"The operating system 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.",
		},
	},
	"%C": {
		ShortDescription: "Cache directory",
		LongDescription: []string{
			"This is either /var/cache (for the system manager) or the path `$XDG_CACHE_HOME` resolves to (for user managers).",
		},
		IsDirectory: true,
	},
	"%d": {
		ShortDescription: "Credentials directory",
		LongDescription: []string{
			"This is the value of the `$CREDENTIALS_DIRECTORY` environment variable if available.",
			"See section `Credentials` in systemd.exec(5) for more information.",
		},
		IsDirectory: true,
	},
	"%D": {
		ShortDescription: "Shared data directory",
		LongDescription: []string{
			"This is either /usr/share/ (for the system manager) or the path `$XDG_DATA_HOME` resolves to (for user managers).",
		},
		IsDirectory: true,
	},
	"%E": {
		ShortDescription: "Configuration directory root",
		LongDescription: []string{
			"This is either /etc/ (for the system manager) or the path `$XDG_CONFIG_HOME` resolves to (for user managers).",
		},
		IsDirectory: true,
	},
	"%f": {
		ShortDescription: "Unescaped file name",
		LongDescription: []string{
			"This is either the unescaped instance name (if applicable) with / prepended (if applicable), or the unescaped prefix name prepended with /. ",
			"This implements unescaping according to the rules for escaping absolute file system paths discussed above.",
		},
		IsDirectory: false,
	},
	"%g": {
		ShortDescription: "User group",
		LongDescription: []string{
			"This is the name of the group running the service manager instance. In case of the system manager this resolves to `root`.",
		},
		IsDirectory: false,
	},
	"%G": {
		ShortDescription: "User GID",
		LongDescription: []string{
			"This is the numeric GID of the user running the service manager instance. In case of the system manager this resolves to `0`.",
		},
	},
	"%h": {
		ShortDescription: "User home directory",
		LongDescription: []string{
			"This is the home directory of the user running the service manager instance. In case of the system manager this resolves to `/root`. ",
			"Note that this setting is not influenced by the User= setting configurable in the [Service] section of the service unit.",
		},
		IsDirectory: true,
	},
	"%H": {
		ShortDescription: "Host name",
		LongDescription: []string{
			"The hostname of the running system at the point in time the unit configuration is loaded.",
		},
		IsDirectory: false,
	},
	"%i": {
		ShortDescription: "Instance name",
		LongDescription: []string{
			"For instantiated units this is the string between the first `@` character and the type suffix. Empty for non-instantiated units.",
		},
		IsDirectory: false,
	},
	"%I": {
		ShortDescription: "Unescaped instance name",
		LongDescription: []string{
			"Same as `%i`, but with escaping undone.",
		},
		IsDirectory: false,
	},
	"%j": {
		ShortDescription: "Final component of the prefix",
		LongDescription: []string{
			"This is the string between the last `-` and the end of the prefix name. If there is no `-`, this is the same as `%p`.",
		},
		IsDirectory: false,
	},
	"%J": {
		ShortDescription: "Unescaped final component of the prefix",
		LongDescription: []string{
			"Same as `%j`, but with escaping undone.",
		},
		IsDirectory: false,
	},
	"%l": {
		ShortDescription: "Short host name",
		LongDescription: []string{
			"The hostname of the running system at the point in time the unit configuration is loaded, truncated at the first dot to remove any domain component.",
		},
		IsDirectory: false,
	},
	"%L": {
		ShortDescription: "Log directory root",
		LongDescription: []string{
			"This is either /var/log (for the system manager) or the path $XDG_STATE_HOME resolves to with /log appended (for user managers).",
		},
		IsDirectory: true,
	},
	"%m": {
		ShortDescription: "Machine ID",
		LongDescription: []string{
			"The machine ID of the running system, formatted as string. See machine-id(5) for more information.",
		},
		IsDirectory: false,
	},
	"%M": {
		ShortDescription: "Operqating system image identifier",
		LongDescription: []string{
			"The operating system 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.",
		},
		IsDirectory: false,
	},
	"%n": {
		ShortDescription: "Full unit name",
		LongDescription:  []string{},
		IsDirectory:      false,
	},
	"%N": {
		ShortDescription: "Full unit name",
		LongDescription: []string{
			"Same as `%n`, but with the type suffix removed.",
		},
		IsDirectory: false,
	},
	"%o": {
		ShortDescription: "Operating system ID",
		LongDescription: []string{
			"The operating system identifier of the running system, as read from the ID= field of /etc/os-release. See os-release(5) for more information.",
		},
		IsDirectory: false,
	},
	"%p": {
		ShortDescription: "Prefix name",
		LongDescription: []string{
			"For instantiated units, this refers to the string before the first `@` character of the unit name. For non-instantiated units, same as `%N`.",
		},
		IsDirectory: false,
	},
	"%P": {
		ShortDescription: "Unescaped prefix name",
		LongDescription: []string{
			"Same as `%p`, but with escaping undone.",
		},
		IsDirectory: false,
	},
	"%q": {
		ShortDescription: "Pretty host name",
		LongDescription: []string{
			"The pretty hostname of the running system at the point in time the unit configuration is loaded, as read from the PRETTY_HOSTNAME= field of /etc/machine-info. ",
			"If not set, resolves to the short hostname. See machine-info(5) for more information.",
		},
		IsDirectory: false,
	},
	"%s": {
		ShortDescription: "User shell",
		LongDescription: []string{
			"This is the shell of the user running the service manager instance.",
		},
		IsDirectory: false,
	},
	"%S": {
		ShortDescription: "State directory root",
		LongDescription: []string{
			"This is either /var/lib (for the system manager) or the path $XDG_STATE_HOME resolves to (for user managers).",
		},
		IsDirectory: true,
	},
	"%t": {
		ShortDescription: "Runtime directory root",
		LongDescription: []string{
			"This is either /run/ (for the system manager) or the path `$XDG_RUNTIME_DIR` resolves to (for user managers).",
		},
		IsDirectory: true,
	},
	"%T": {
		ShortDescription: "Directory for temporary files",
		LongDescription: []string{
			"This is either /tmp or the path `$TMPDIR`, `$TEMP` or `$TMP` are set to. (Note that the directory may be specified without a trailing slash.)",
		},
		IsDirectory: true,
	},
	"%u": {
		ShortDescription: "User name",
		LongDescription: []string{
			"This is the name of the user running the service manager instance. In case of the system manager this resolves to `root`. ",
			"Note that this setting is not influenced by the User= setting configurable in the [Service] section of the service unit.",
		},
		IsDirectory: false,
	},
	"%U": {
		ShortDescription: "User UID",
		LongDescription: []string{
			"This is the numeric UID of the user running the service manager instance. In case of the system manager this resolves to `0`.",
			"Note that this setting is not influenced by the User= setting configurable in the [Service] section of the service unit.",
		},
		IsDirectory: false,
	},
	"%v": {
		ShortDescription: "Kernel release",
		LongDescription: []string{
			"Identical to uname -r output.",
		},
		IsDirectory: false,
	},
	"%V": {
		ShortDescription: "Directory for larger and persistent temporary files",
		LongDescription: []string{
			"This is either /var/tmp or the path `$TMPDIR`, `$TEMP` or `$TMP` are set to. (Note that the directory may be specified without a trailing slash.)",
		},
		IsDirectory: true,
	},
	"%w": {
		ShortDescription: "Operating system version ID",
		LongDescription: []string{
			"The operating system 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.",
		},
		IsDirectory: false,
	},
	"%W": {
		ShortDescription: "Operating system variant ID",
		LongDescription: []string{
			"The operating system 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.",
		},
		IsDirectory: false,
	},
	"%y": {
		ShortDescription: "The path of the fragement",
		LongDescription: []string{
			"This is the path where the main part of the unit file is located. For linked unit files, the real path outside of the unit search directories is used. ",
			"For units that do not have a fragment file, this specifier will raise an error.",
		},
		IsDirectory: false,
	},
	"%Y": {
		ShortDescription: "The directory of the fragement",
		LongDescription: []string{
			"This is the directory part of `%y`.",
		},
		IsDirectory: false,
	},
	"%%": {
		ShortDescription: "Single percent sign",
		LongDescription: []string{
			"Use `%%` in place of `%` to specify a single percent sign.",
		},
		IsDirectory: false,
	},
}

Functions

This section is empty.

Types

type CategoryPropertyItem

type CategoryPropertyItem struct {
	InsertText *string
	Details    *string
}

type FormatGroup added in v0.6.0

type FormatGroup string
const (
	FormatGroupNetwork     FormatGroup = "Network"
	FormatGroupStorage     FormatGroup = "Storage"
	FormatGroupEnvironment FormatGroup = "Environment"
	FormatGroupBase        FormatGroup = "Base"
	FormatGroupHealth      FormatGroup = "Healthcheck"
	FormatGroupLabel       FormatGroup = "Label"
	FormatGroupSecret      FormatGroup = "Secret"
	FormatGroupOther       FormatGroup = "Other"
)

type PropertyMapItem

type PropertyMapItem struct {
	Label       string              // Name of the property
	Hover       []string            // Value for hover action
	Parameters  []string            // Values for completion
	Macro       string              // Snippet for completion
	MinVersion  utils.PodmanVersion // Minimun version for property
	FormatGroup FormatGroup         // When formatting, this tells where the property is placed
	MultipleAdd bool                // Property can be repeated multiple times
}

type SystemdSpecifier added in v0.4.0

type SystemdSpecifier struct {
	ShortDescription string
	LongDescription  []string
	IsDirectory      bool
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL