mirror of
https://github.com/containers/podman.git
synced 2025-05-24 02:27:00 +08:00

Add new CI check to confirm that links and references in SEE ALSO sections are properly formatted and that links are valid (at least in theory: we do no actual URL fetching to test for 404). The check is piggybacked into existing xref-helpmsgs-manpages script. It could conceivably be more elegant to write a separate tool for this purpose, but I don't wish to duplicate the logic for finding and reading markdown files. Script identified various problems, which I fix in this PR: . missing '**' (asterisks) around some references, or '**' in the wrong place. . links pointing to github.com/.../tree/ instead of /blob/ (github redirects those automatically, but I like consistency) . a few copy-paste errors, e.g. subgid linking to subuid. Signed-off-by: Ed Santiago <santiago@redhat.com>
58 lines
2.4 KiB
Markdown
58 lines
2.4 KiB
Markdown
% podman-container-cleanup(1)
|
|
|
|
## NAME
|
|
podman\-container\-cleanup - Cleanup the container's network and mountpoints
|
|
|
|
## SYNOPSIS
|
|
**podman container cleanup** [*options*] *container* [*container* ...]
|
|
|
|
## DESCRIPTION
|
|
**podman container cleanup** cleans up exited *containers* by removing all mountpoints and network configuration from the host. The *container name* or *ID* can be used. The cleanup command does not remove the *containers*. Running *containers* will not be cleaned up.\
|
|
Sometimes container mount points and network stacks can remain if the podman command was killed or the *container* ran in daemon mode. This command is automatically executed when *containers* are run in daemon mode by the `conmon process` when the *container* exits.
|
|
|
|
## OPTIONS
|
|
#### **--all**, **-a**
|
|
|
|
Cleanup all *containers*.\
|
|
The default is **false**.\
|
|
*IMPORTANT: This OPTION does not need a container name or ID as input argument.*
|
|
|
|
#### **--exec**=*session*
|
|
|
|
Clean up an exec session for a single *container*.
|
|
Can only be specified if a single *container* is being cleaned up (conflicts with **--all** as such). If **--rm** is not specified, temporary files for the exec session will be cleaned up; if it is, the exec session will be removed from the *container*.\
|
|
*IMPORTANT: Conflicts with **--rmi** as the container is not being cleaned up so the image cannot be removed.*
|
|
|
|
#### **--latest**, **-l**
|
|
|
|
Instead of providing the *container ID* or *name*, use the last created *container*. If other methods than Podman are used to run *containers* such as `CRI-O`, the last started *container* could be from either of those methods.\
|
|
The default is **false**.\
|
|
*IMPORTANT: This OPTION is not available with the remote Podman client. This OPTION does not need a container name or ID as input argument.*
|
|
|
|
#### **--rm**
|
|
|
|
After cleanup, remove the *container* entirely.\
|
|
The default is **false**.
|
|
|
|
#### **--rmi**
|
|
|
|
After cleanup, remove the image entirely.\
|
|
The default is **false**.
|
|
|
|
## EXAMPLES
|
|
Cleanup the container "mywebserver".
|
|
```
|
|
$ podman container cleanup mywebserver
|
|
```
|
|
|
|
Cleanup the containers with the names "mywebserver", "myflaskserver", "860a4b23".
|
|
```
|
|
$ podman container cleanup mywebserver myflaskserver 860a4b23
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-container(1)](podman-container.1.md)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**
|
|
|
|
## HISTORY
|
|
Jun 2018, Originally compiled by Dan Walsh <dwalsh@redhat.com>
|