From 79a49dd07e2247be63f89f3b06f27e8e4e42633b Mon Sep 17 00:00:00 2001 From: tschettervictor <85497460+tschettervictor@users.noreply.github.com> Date: Fri, 28 Feb 2025 23:50:42 -0700 Subject: [PATCH] docs: update targeting for new functions --- docs/chapters/targeting.rst | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/chapters/targeting.rst b/docs/chapters/targeting.rst index a71331ce..63df3575 100644 --- a/docs/chapters/targeting.rst +++ b/docs/chapters/targeting.rst @@ -4,15 +4,19 @@ Targeting Bastille uses a `command target arguments` syntax, meaning that each command requires a target. Targets are usually containers, but can also be releases. -Targeting a container is done by providing the exact containers name. +Targeting a container is done by providing the exact jail name, the JID of the jail, or by typing the +starting few characters of a jail. If more than one matching jail will be found, you will see a message +saying so. -Targeting a release is done by providing the release name. (Note: do not +Targeting a release is done by providing the exact release name. (Note: do not include the `-pX` point-release version.) -Bastille includes a pre-defined keyword ALL to target all running containers. +Bastille includes a pre-defined keyword [ALL|all} to target all running containers. +It is also possible to target multiple jails by grouping them in quotes, as seen below. -In the future I would like to support more options, including globbing, lists -and regular-expressions. +.. code-block:: shell + + ishmael ~ # bastille cmd "jail1 jail2 jail3" echo Hello! Examples: Containers ====================