FreeBSD Manual Pages
podman-pause(1) General Commands Manual podman-pause(1) NAME podman-pause - Pause one or more containers SYNOPSIS podman pause [options] [container...] podman container pause [options] [container...] DESCRIPTION Pauses all the processes in one or more containers. You may use con- tainer IDs or names as input. OPTIONS --all, -a Pause all running containers. --cidfile=file Read container ID from the specified file and pause the container. Can be specified multiple times. --filter, -f=filter Filter what containers pause. Multiple filters can be given with mul- tiple uses of the --filter flag. Filters with the same key work inclu- sive with the only exception being label which is exclusive. Filters with different keys always work exclusive. Valid filters are listed below: +----------------------+-------------------------------+ | Filter | Description | +----------------------+-------------------------------+ | id | [ID] Container's ID (CID pre- | | | fix match by default; accepts | | | regex) | +----------------------+-------------------------------+ | name | [Name] Container's name (ac- | | | cepts regex) | +----------------------+-------------------------------+ | label | [Key] or [Key=Value] Label | | | assigned to a container | +----------------------+-------------------------------+ | label! | [Key] or [Key=Value] Label | | | NOT assigned to a container | +----------------------+-------------------------------+ | exited | [Int] Container's exit code | +----------------------+-------------------------------+ | status | [Status] Container's status: | | | 'created', 'initialized', | | | 'exited', 'paused', 'run- | | | ning', 'unknown' | +----------------------+-------------------------------+ | ancestor | [ImageName] Image or descen- | | | dant used to create container | | | (accepts regex) | +----------------------+-------------------------------+ | before | [ID] or [Name] Containers | | | created before this container | +----------------------+-------------------------------+ | since | [ID] or [Name] Containers | | | created since this container | +----------------------+-------------------------------+ | volume | [VolumeName] or [Mountpoint- | | | Destination] Volume mounted | | | in container | +----------------------+-------------------------------+ | health | [Status] healthy or unhealthy | +----------------------+-------------------------------+ | pod | [Pod] name or full or partial | | | ID of pod | +----------------------+-------------------------------+ | network | [Network] name or full ID of | | | network | +----------------------+-------------------------------+ | restart-policy | [Policy] Container's restart | | | policy (e.g., 'no', 'on-fail- | | | ure', 'always', 'unless- | | | stopped') | +----------------------+-------------------------------+ | until | [DateTime] Containers created | | | before the given duration or | | | time. | +----------------------+-------------------------------+ | command | [Command] the command the | | | container is executing, only | | | argv[0] is taken | +----------------------+-------------------------------+ | should-start-on-boot | [Bool] Containers that need | | | to be restarted after system | | | reboot. True for containers | | | with restart policy 'always', | | | or 'unless-stopped' that were | | | not explicitly stopped by the | | | user | +----------------------+-------------------------------+ --latest, -l Instead of providing the container name or ID, use the last created container. Note: the last started container can be from other users of Podman on the host machine. (This option is not available with the re- mote Podman client, including Mac and Windows (excluding WSL2) ma- chines) EXAMPLE Pause specified container: podman pause mywebserver Pause container by partial container ID: podman pause 860a4b23 Pause all running containers: podman pause --all Pause container using ID specified in given files: podman pause --cidfile /home/user/cidfile-1 podman pause --cidfile /home/user/cidfile-1 --cidfile ./cidfile-2 Pause the latest container. (This option is not available with the re- mote Podman client, including Mac and Windows (excluding WSL2) ma- chines): podman pause --latest SEE ALSO podman(1), podman-unpause(1) HISTORY September 2017, Originally compiled by Dan Walsh dwalsh@redhat.com <mailto:dwalsh@redhat.com> podman-pause(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | SEE ALSO | HISTORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-container-pause&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>