Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	  |
       +----------+-------------------------------+
       | exited	  | [Int] Container's exit code	  |
       +----------+-------------------------------+
       | status	  | [Status] Container's  status: |
       |	  | 'created',		'exited', |
       |	  | 'paused',	'running',   'un- |
       |	  | known'			  |
       +----------+-------------------------------+
       | ancestor | [ImageName]	 Image or descen- |
       |	  | dant used to create	container |
       +----------+-------------------------------+
       | 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			  |
       +----------+-------------------------------+
       | until	  | [DateTime]	container created |
       |	  | before the given duration  or |
       |	  | time.			  |
       +----------+-------------------------------+

   --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)

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+14.3.quarterly>

home | help