86 lines
2.2 KiB
Groff
86 lines
2.2 KiB
Groff
'\" t
|
|
.nh
|
|
.TH podman-quadlet-list 1
|
|
.SH NAME
|
|
podman-quadlet-list \- List installed quadlets
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman quadlet list\fP [\fIoptions\fP]
|
|
|
|
.SH DESCRIPTION
|
|
List all Quadlets configured for the current user.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP
|
|
Filter output based on conditions give.
|
|
|
|
.PP
|
|
The \fIfilters\fP argument format is of \fBkey=value\fR\&. If there is more than one \fIfilter\fP, then pass multiple OPTIONS: \fB--filter\fP \fIfoo=bar\fP \fB--filter\fP \fIbif=baz\fP\&.
|
|
|
|
.PP
|
|
Supported filters:
|
|
|
|
.TS
|
|
allbox;
|
|
l l
|
|
l l .
|
|
\fBFilter\fP \fBDescription\fP
|
|
name Filter by quadlet name.
|
|
.TE
|
|
|
|
.SS \fB--format\fP=\fIformat\fP
|
|
Pretty-print output to JSON or using a Go template (default "{{range .}}{{.Name}}\\t{{.UnitName}}\\t{{.Path}}\\t{{.Status}}\\n{{end -}}")
|
|
|
|
.PP
|
|
Print results with a Go template.
|
|
|
|
.TS
|
|
allbox;
|
|
l l
|
|
l l .
|
|
\fB\fBPlaceholder\fP\fP \fB\fBDescription\fP\fP
|
|
\&.App T{
|
|
Name of application if Quadlet is part of an app
|
|
T}
|
|
\&.Name Name of the Quadlet file
|
|
\&.Path Quadlet file path on disk
|
|
\&.Status T{
|
|
Quadlet status corresponding to systemd unit
|
|
T}
|
|
\&.UnitName T{
|
|
Systemd unit name corresponding to quadlet
|
|
T}
|
|
.TE
|
|
|
|
.SH EXAMPLES
|
|
Simple list command
|
|
|
|
.EX
|
|
$ podman quadlet list
|
|
NAME UNIT NAME PATH ON DISK STATUS APPLICATION
|
|
test-service-quadlet.container test-service-quadlet.service /home/user/.config/containers/systemd/test-service-quadlet.container Not loaded
|
|
sample-quadlet.container sample-quadlet.service /home/user/.config/containers/systemd/sample-quadlet.container Not loaded
|
|
.EE
|
|
|
|
.PP
|
|
Filter list by name.
|
|
|
|
.EX
|
|
$ podman quadlet list --filter 'name=test*'
|
|
NAME UNIT NAME PATH ON DISK STATUS APPLICATION
|
|
test-service-quadlet.container test-service-quadlet.service /home/user/.config/containers/systemd/test-service-quadlet.container Not loaded
|
|
.EE
|
|
|
|
.PP
|
|
Format list output for a specific field.
|
|
|
|
.EX
|
|
$ podman quadlet list --format '{{ .UnitName }}'
|
|
UNIT NAME
|
|
test-service-quadlet.service
|
|
sample-quadlet.service
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBpodman-quadlet(1)\fP
|