3255 Commits

Author SHA1 Message Date
494287518b Merge pull request #26467 from ygalblum/secret-create-ignore
Secret create - add ignore option to allow noop
2025-06-26 15:25:52 +00:00
683e9b2c94 Merge pull request #26434 from mheon/import_export
Add remote support for `podman volume import` and `podman volume export`
2025-06-25 19:48:14 +00:00
7780e28b45 Merge pull request #26491 from ArthurWuTW/25389
Pod YAML: Add support for `lifecycle.stopSignal`
2025-06-24 19:44:30 +00:00
bfc327a08e Secret create - add ignore option to allow noop
Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-06-24 15:43:38 -04:00
1f1618fcb0 Merge pull request #26478 from ygalblum/pull-with-policy
Podman pull - add policy flag
2025-06-24 18:54:26 +00:00
844ed8296d Merge pull request #26485 from gumimin/update-latest
cmd/podman: add --latest option to update #26380
2025-06-24 18:15:40 +00:00
f21dacc4fb cmd/podman: add --latest option to update #26380
Allow users to target the most recently created container with
`podman update --latest` (short `-l`). The same option already exists
on many other commands, so this brings update in line with the rest of
the CLI and saves users from typing or looking up the newest container.

Fixes: #26380

Signed-off-by: Hayato Kihara <kai.21banana@gmail.com>
2025-06-24 22:06:26 +09:00
f266034d56 docs: document when a volume is chowned
add documentation to clarify when a volume is chowned.

Closes: https://github.com/containers/podman/issues/26474

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2025-06-24 12:10:06 +02:00
98876454cb Refactor volume import to support the remote client
As with `volume export`, this was coded up exclusively in cmd/
instead of in libpod. Move it into Libpod, add a REST endpoint,
add bindings, and now everything talks using the ContainerEngine
wiring.

Also similar to `volume export` this also makes things work much
better with volumes that require mounting - we can now guarantee
they're actually mounted, instead of just hoping.

Includes some refactoring of `volume export` as well, to simplify
its implementation and ensure both Import and Export work with
readers/writers, as opposed to just files.

Fixes #26409

Signed-off-by: Matt Heon <mheon@redhat.com>
2025-06-23 13:42:22 -04:00
5ab4328318 Podman pull - add policy flag
Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-06-23 11:28:39 -04:00
17601aa913 Pod YAML: Add support for lifecycle.stopSignal
The field allows users to specify a custom stop signal (e.g., SIGUSR1) per container.
If defined, it overrides the default stop signal (SIGTERM) or that defined in the image metadata.

Fixes: #25389

Signed-off-by: Arthur Wu <lion811004@gmail.com>
2025-06-23 08:23:31 -04:00
ca1c4388b3 update podman-machine-start with examples for --no-info and --quiet
Fixes: #26375

Signed-off-by: sushmitha37 <sushu52581@gmail.com>
2025-06-23 16:10:26 +05:30
617cdc4b36 Merge pull request #26466 from nbspsemicolon/quadlet-pod-exitpolicy
pkg/systemd: expose [Pod] ExitPolicy key for pod create --exit-policy
2025-06-19 19:01:13 +00:00
5c89b64441 Merge pull request #26463 from shu-kitamura/example_generate-spec
docs: add three examples to podman-generate-spec man page
2025-06-19 11:59:16 +00:00
fa67681601 docs: add three examples to podman-generate-spec man page
This patch adds three examples to the podman-generate-spec.1 man page:

- Example of executed without any options
- Example of executed with the `--compact` option
- Example of executed with the `--filename` option

Fixes: #26377

Signed-off-by: shu-kitamura <shusei3316@yahoo.co.jp>
2025-06-19 20:17:08 +09:00
5989370c39 pkg/systemd: expose [Pod] ExitPolicy key for pod create --exit-policy
Add ExitPolicy key to pod quadlets with logic to default to stop.

Docs updated with clarifcation on default value and usage example.

Simple assert added to bats to verify default constraint exists.

Changed argument order in ginkgo basic pod unit test

Signed-off-by: Neil Bailey <nbsp@nbailey.net>
2025-06-18 15:08:31 -04:00
dfd205fa24 Merge pull request #26459 from giuseppe/add-volume-uid-gid
volumes: add new --uid and --gid option
2025-06-18 14:49:51 +00:00
1f9893817b volumes: add new --uid and --gid option
they allow to override the owner of the volume.  Differently from
-o=uid= and -o=gid= they are not passed down to the mount operation.

Closes: https://issues.redhat.com/browse/RHEL-76452

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2025-06-18 15:33:09 +02:00
d79d596bce docs: add an example to podman-secret-rm man page
This patch adds an example of using the `--ingore` option to the podman-secret-rm.1 man page.

Fixes: #26361

Signed-off-by: shu-kitamura <shusei3316@yahoo.co.jp>
2025-06-18 21:10:17 +09:00
20d5b78a79 Merge pull request #26442 from shu-kitamura/example_network-rm-time
docs: add an example to podman-network-rm man page
2025-06-17 13:32:02 +00:00
474740fe2e Merge pull request #26427 from b3n4kh/issue-26349-force-flag-docs
Issue 26349 force flag docs
2025-06-17 11:13:13 +00:00
4ec7d35cbb Removed the 'Deleted: ' prefix from each example
Signed-off-by: shu-kitamura <shusei3316@yahoo.co.jp>
2025-06-17 19:00:44 +09:00
6b996445bc add more exmples applying current style for each page
Signed-off-by: Benjamin Akhras <b@akhras.at>
2025-06-16 19:52:36 +02:00
f235d47e1d Merge pull request #26308 from kolyshkin/blkdev
podman-update: fix block device handling
2025-06-16 14:46:05 +00:00
15d8b5b2fb docs: add an example to podman-network-rm man page
This patch adds an example of using the --time option to the podman-network-rm.1 man page.

Fixes: #26373
Signed-off-by: shu-kitamura <shusei3316@yahoo.co.jp>
2025-06-16 23:31:59 +09:00
547de9296a Merge pull request #26407 from shu-kitamura/example_mac-address
Manpages: podman network connect missing example with --mac-address option
2025-06-16 14:02:57 +00:00
233cae8f61 Merge pull request #26430 from Luap99/artifact-mount-name
artifact mount: improve single file behavior and add name option to specify a custom container name
2025-06-16 13:51:43 +00:00
38b52e380c Merge pull request #26435 from ArthurWuTW/26359
docs: add examples to podman-system-migrate man page
2025-06-16 09:28:22 +00:00
6510d81f69 docs: add examples to podman-system-migrate man page
This patch adds two usage examples to the podman-system-migrate.1 man page:
- Normal invocation, with no expected output
- Migration to a new OCI runtime (e.g., from crun to runc)

Fixes: #26359
Signed-off-by: Arthur Wu <lion811004@gmail.com>
2025-06-15 01:48:21 -04:00
0ab8a3c576 artifact mount: add new name option to specify filename
An artifact without the title annoation just gets the digest as name
which is less than ideal. While it is a decent default to avoid
conflicts users would like to configure the name.

With the name=abc option we will call the file abc in case of a signle
artifact and otherwise we use abc-x where x is the layer index starting
at 0 to avoid conflicts.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-06-14 12:25:21 +02:00
c647a7200e Fixes: #26374 add example network connect with mac address
Signed-off-by: shu-kitamura <shusei3316@yahoo.co.jp>
2025-06-14 16:45:41 +09:00
21f34601eb artifact mount: improve single blob behavior
If the artifact has a single blob then use the dst path directly as
mount in case it does not exist.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-06-14 09:16:06 +02:00
6368b248f0 docs: remove bogus markdown heading in podman-ps
The prior commit that expanded the examples added an out of
place heading to the manpage for podman-ps, which looks like
a probable AI tool hallucination.

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2025-06-13 16:46:58 +01:00
b74a7177fa Merge pull request #26403 from jobselko/fix_26358
Update podman system prune doc
2025-06-13 10:03:13 +00:00
282bcd878a Merge pull request #26402 from mareklibra/26348.latest
fix 26348: add container diff --latest doc
2025-06-13 10:00:30 +00:00
fd325e33fd Update podman system prune doc
Fixes #26358

Signed-off-by: Jitka Obselkova <jobselko@redhat.com>
2025-06-13 11:36:05 +02:00
2708735b1d Merge pull request #26393 from devop-mmcgrath/fix-stats-manpage-format
Fix stats manpage format - fix for #26367
2025-06-13 09:35:34 +00:00
bd2c838b0e fix 26348: add container diff --latest doc
Signed-off-by: Marek Libra <marek.libra@gmail.com>
2025-06-13 11:28:11 +02:00
f6df4c259e Merge pull request #26398 from jnahorny/fix_26355
Fix 26355: move 'Examples' section down in the podman-volume-create
2025-06-13 09:27:17 +00:00
ffa4c124a1 Add missing --pod examples to podman ps manpage
The --pod flag is important for users working with pods but lacked
documentation examples. Added examples showing:
- Basic --pod usage to display pod information
- Using --pod with -a to show all containers and their pods
- Filtering containers by pod name
- Custom formatting with pod-related placeholders

Also: removed trailing whitespace on a few lines

Fixes #26367
Assisted-by: Claude Sonnet 4

Removed trailing whitespace on a few lines

Signed-off-by: Mike McGrath <mmcgrath@fedoraproject.org>

MH: Squashed, force-pushed to reset CI
Signed-off-by: Matt Heon <mheon@redhat.com>
2025-06-13 05:11:21 -04:00
93d66542d4 Move 'Examples' section down in the podman-volume-create man page
Fix #26355

Signed-off-by: Jarek Górny <jaroslaw.gorny@gmail.com>
2025-06-13 11:05:06 +02:00
cbba265f29 Add examples of --all flag
The following manpages were missing examples of the `--all` flag:
* podman init
* podman pod pause
* podman secret rm
* podman system connection remove
* podman system prune

Added examples of all.

Fixes #26354

Signed-off-by: Matt Heon <mheon@redhat.com>
2025-06-13 04:47:22 -04:00
f69f92cdf7 Merge pull request #26391 from Phaow/manpages
Manpages: podman machine init add example with --now
2025-06-13 08:01:57 +00:00
1a461fe41a Manpages: podman machine init add example with --now
Signed-off-by: Penghao <pewang@redhat.com>
2025-06-13 08:00:01 +02:00
98e6d857d1 Merge pull request #26263 from tangentsoft/network-host-doc-warning
Clarified the consequences of --network=host
2025-06-12 16:07:19 +00:00
a2ab16a7d2 Merge pull request #26385 from xstasi/main
Improve documentation for podman-secret-inspect, closes #26362
2025-06-12 15:28:17 +00:00
24e5c00e6e Update docs/source/markdown/podman-secret-inspect.1.md
Co-authored-by: Jan Rodák <hony.com@seznam.cz>
Signed-off-by: Alessandro Grassi <alessandro@aggro.it>
2025-06-12 15:52:31 +02:00
4a35cf00ec Improve documentation for podman-secret-inspect, closes #26362
Signed-off-by: Alessandro Grassi <alessandro@aggro.it>
2025-06-12 15:51:57 +02:00
0825e7d2cc Merge pull request #26388 from tyll/rmi-no-prune
man pages: Add an example about --no-prune
2025-06-12 13:42:50 +00:00
c94f5fd318 Merge pull request #26370 from mheon/manpage_fixes
Bunch of trivial manpage fixes
2025-06-12 13:34:09 +00:00