'\" 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