podman-build/docs/build/man/podman-pod-exists.1
2025-10-11 12:30:35 +09:00

36 lines
890 B
Groff

.nh
.TH podman-pod-exists 1
.SH NAME
podman-pod-exists \- Check if a pod exists in local storage
.SH SYNOPSIS
\fBpodman pod exists\fP \fIpod\fP
.SH DESCRIPTION
\fBpodman pod exists\fP checks if a pod exists in local storage. The \fBID\fP or \fBName\fP
of the pod may be used as input. Podman returns an exit code
of \fB0\fR when the pod is found. A \fB1\fR is returned otherwise. An exit code of \fB125\fR indicates there
was an issue accessing the local storage.
.SH EXAMPLES
Check if specified pod exists in local storage (the pod does actually exist):
.EX
$ sudo podman pod exists web; echo $?
0
.EE
.PP
Check if specified pod exists in local storage (the pod does not actually exist):
.EX
$ sudo podman pod exists backend; echo $?
1
.EE
.SH SEE ALSO
\fBpodman(1)\fP, \fBpodman-pod(1)\fP
.SH HISTORY
December 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)