From 7b08aa78e4ede4c54fda6cd9917bb62e18d0d634 Mon Sep 17 00:00:00 2001 From: baude Date: Tue, 2 Jan 2018 16:29:43 -0600 Subject: Shortcut for most recent container It is desirable to have a shortcut for the most recently created container. We can now use "**latest" to represent the most recent container instead of its container ID or name. For example: Signed-off-by: baude Closes: #179 Approved by: baude --- docs/podman-attach.1.md | 8 ++++++++ docs/podman-exec.1.md | 4 ++++ docs/podman-inspect.1.md | 4 ++++ docs/podman-kill.1.md | 5 +++++ docs/podman-rm.1.md | 5 +++++ docs/podman-start.1.md | 5 +++++ docs/podman-stats.1.md | 4 ++++ docs/podman-stop.1.md | 5 +++++ docs/podman-top.1.md | 4 ++++ 9 files changed, 44 insertions(+) (limited to 'docs') diff --git a/docs/podman-attach.1.md b/docs/podman-attach.1.md index 4d8b803c8..64163b340 100644 --- a/docs/podman-attach.1.md +++ b/docs/podman-attach.1.md @@ -20,6 +20,10 @@ sequence is CTRL-p CTRL-q. You configure the key sequence using the --detach-key Override the key sequence for detaching a container. Format is a single character [a-Z] or ctrl- where is one of: a-z, @, ^, [, , or _. +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. + **--no-stdin** Do not attach STDIN. The default is false. @@ -30,6 +34,10 @@ podman attach foobar [root@localhost /]# ``` ``` +podman attach --latest +[root@localhost /]# +``` +``` podman attach 1234 [root@localhost /]# ``` diff --git a/docs/podman-exec.1.md b/docs/podman-exec.1.md index a9795002e..3c501b169 100644 --- a/docs/podman-exec.1.md +++ b/docs/podman-exec.1.md @@ -22,6 +22,10 @@ command to be executed. **--interactive, -i** Not supported. All exec commands are interactive by default. +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. + **--privileged** Give the process extended Linux capabilities when running the command in container. diff --git a/docs/podman-inspect.1.md b/docs/podman-inspect.1.md index c2edf896d..5b8a344d7 100644 --- a/docs/podman-inspect.1.md +++ b/docs/podman-inspect.1.md @@ -21,6 +21,10 @@ Return data on items of the specified type. Type can be 'container', 'image' or Format the output using the given Go template +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. + **--size** Display the total file size if the type is a container diff --git a/docs/podman-kill.1.md b/docs/podman-kill.1.md index e254f2af3..62cb39db4 100644 --- a/docs/podman-kill.1.md +++ b/docs/podman-kill.1.md @@ -12,6 +12,9 @@ podman kill - Kills one or more containers with a signal The main process inside each container specified will be sent SIGKILL, or any signal specified with option --signal. ## OPTIONS +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. **--signal, s** @@ -26,6 +29,8 @@ podman kill 860a4b23 podman kill --signal TERM 860a4b23 +podman kill --latest + ## SEE ALSO podman(1), podman-stop(1) diff --git a/docs/podman-rm.1.md b/docs/podman-rm.1.md index 0d86dae1c..1047c7fc7 100644 --- a/docs/podman-rm.1.md +++ b/docs/podman-rm.1.md @@ -21,6 +21,9 @@ Force the removal of a running container Remove all containers. Can be used in conjunction with -f as well. +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. ## EXAMPLE podman rm mywebserver @@ -31,6 +34,8 @@ podman rm -f 860a4b23 podman rm -f -a +podman rm -f --latest + ## SEE ALSO podman(1), podman-rmi(1) diff --git a/docs/podman-start.1.md b/docs/podman-start.1.md index a6791127a..492787e6c 100644 --- a/docs/podman-start.1.md +++ b/docs/podman-start.1.md @@ -29,6 +29,9 @@ ctrl- where is one of: a-z, @, ^, [, , or _. Attach container's STDIN. The default is false. +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. ## EXAMPLE @@ -38,6 +41,8 @@ podman start 860a4b23 5421ab4 podman start -i -a 860a4b23 +podman start -i -l + ## SEE ALSO podman(1), podman-create(1) diff --git a/docs/podman-stats.1.md b/docs/podman-stats.1.md index 6d050b485..b071a27fa 100644 --- a/docs/podman-stats.1.md +++ b/docs/podman-stats.1.md @@ -17,6 +17,10 @@ Display a live stream of one or more containers' resource usage statistics Show all containers. Only running containers are shown by default +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. + **--no-reset** Do not clear the terminal/screen in between reporting intervals diff --git a/docs/podman-stop.1.md b/docs/podman-stop.1.md index ad15b9117..f4372be5f 100644 --- a/docs/podman-stop.1.md +++ b/docs/podman-stop.1.md @@ -23,6 +23,9 @@ Timeout to wait before forcibly stopping the container Stop all running containers. This does not include paused containers. +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. ## EXAMPLE @@ -36,6 +39,8 @@ podman stop --timeout 2 860a4b23 podman stop -a +podman stop --latest + ## SEE ALSO podman(1), podman-rm(1) diff --git a/docs/podman-top.1.md b/docs/podman-top.1.md index 1067cdc52..eed15c584 100644 --- a/docs/podman-top.1.md +++ b/docs/podman-top.1.md @@ -21,6 +21,10 @@ Display the running process of the container. ps-OPTION can be any of the option **--format** Display the output in an alternate format. The only supported format is **JSON**. +**--latest, -l** +Instead of providing the container name or ID, use the last created container. If you use methods other than Podman +to run containers such as CRI-O, the last started container could be from either of those methods. + ## EXAMPLES ``` -- cgit v1.2.3-54-g00ecf