Commit Graph

2372 Commits

Author SHA1 Message Date
openshift-merge-bot[bot] 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
openshift-merge-bot[bot] 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
Ygal Blum 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
openshift-merge-bot[bot] 1f1618fcb0
Merge pull request #26478 from ygalblum/pull-with-policy
Podman pull - add policy flag
2025-06-24 18:54:26 +00:00
openshift-merge-bot[bot] 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
Hayato Kihara 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
Giuseppe Scrivano 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
Matt Heon 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
Ygal Blum 5ab4328318 Podman pull - add policy flag
Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-06-23 11:28:39 -04:00
sushmitha37 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
openshift-merge-bot[bot] 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
openshift-merge-bot[bot] 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
shu-kitamura 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
nbspsemicolon 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
openshift-merge-bot[bot] 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
Giuseppe Scrivano 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
shu-kitamura 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
openshift-merge-bot[bot] 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
openshift-merge-bot[bot] 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
shu-kitamura 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
Benjamin Akhras 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
openshift-merge-bot[bot] f235d47e1d
Merge pull request #26308 from kolyshkin/blkdev
podman-update: fix block device handling
2025-06-16 14:46:05 +00:00
shu-kitamura 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
openshift-merge-bot[bot] 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
openshift-merge-bot[bot] 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
openshift-merge-bot[bot] 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
Arthur Wu 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
Paul Holzinger 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
shu-kitamura 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
Paul Holzinger 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
Daniel P. Berrangé 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
openshift-merge-bot[bot] b74a7177fa
Merge pull request #26403 from jobselko/fix_26358
Update podman system prune doc
2025-06-13 10:03:13 +00:00
openshift-merge-bot[bot] 282bcd878a
Merge pull request #26402 from mareklibra/26348.latest
fix 26348: add container diff --latest doc
2025-06-13 10:00:30 +00:00
Jitka Obselkova fd325e33fd
Update podman system prune doc
Fixes #26358

Signed-off-by: Jitka Obselkova <jobselko@redhat.com>
2025-06-13 11:36:05 +02:00
openshift-merge-bot[bot] 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
Marek Libra 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
openshift-merge-bot[bot] 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
Mike McGrath 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
Jarek Górny 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
Matt Heon 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
openshift-merge-bot[bot] f69f92cdf7
Merge pull request #26391 from Phaow/manpages
Manpages: podman machine init add example with --now
2025-06-13 08:01:57 +00:00
Penghao 1a461fe41a Manpages: podman machine init add example with --now
Signed-off-by: Penghao <pewang@redhat.com>
2025-06-13 08:00:01 +02:00
openshift-merge-bot[bot] 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
openshift-merge-bot[bot] a2ab16a7d2
Merge pull request #26385 from xstasi/main
Improve documentation for podman-secret-inspect, closes #26362
2025-06-12 15:28:17 +00:00
Alessandro Grassi 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
Alessandro Grassi 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
openshift-merge-bot[bot] 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
openshift-merge-bot[bot] c94f5fd318
Merge pull request #26370 from mheon/manpage_fixes
Bunch of trivial manpage fixes
2025-06-12 13:34:09 +00:00
Till Maas ae49463a8f man pages: Add an example about --no-prune
Signed-off-by: Till Maas <opensource@till.name>
2025-06-12 15:13:10 +02:00
Fernando Fernandez Mancera 085082a805 Manpages: add podman exec missing example of detach option
Signed-off-by: Fernando Fernandez Mancera <ffmancera@riseup.net>
2025-06-12 14:43:15 +02:00