Commit Graph

3239 Commits

Author SHA1 Message Date
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
Matt Heon d1187be8a3 Bunch of trivial manpage fixes
In a lot of places, `Example` -> `Examples` for consistency

Plus similar trivial fixes

Signed-off-by: Matt Heon <mheon@redhat.com>
2025-06-12 02:22:42 -04:00
Kir Kolyshkin 5838bfef9a podman-update: fix EXAMPLES
Mainly this fixes an issue of using /dev/zero for block device examples.

Also:
 * fix section title;
 * remove separate cgroup v2 and v1 examples, only leaving one;
 * break long lines.

Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
2025-06-10 14:25:57 -07:00
Warren Young 0080368fd6
Clarified the consequences of --network=host
The prior version talked about potential access to DBus, but this is a
bogus warning: default OS setups do not bind DBus to localhost or to an
abstract Unix socket.  It is possible that the original author was
thinking of CVE-2020–15257, which affected containerd's abstract Unix
socket; they fixed it by switching to a named socket, just as DBus
always (?) has done.

Signed-off-by: Warren Young <wyoung@tangentsoft.com>
Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-06-10 18:47:55 +02:00
Erik Sjölund f0c15f1c7a
docs: replace RemapUsers=keep-id with UserNS=keep-id
Git commit 0c3b5e433e
added a comment that RemapUsers is deprecated.
Use UserNS=keep-id instead.

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2025-06-08 09:06:25 +02:00
openshift-merge-bot[bot] 17e9ada37d
Merge pull request #26272 from sonnysasaka/check-quicker
Skip layer digests for podman system check --quick
2025-06-05 18:47:01 +00:00
Sonny Sasaka 971321228c Skip layer digests for podman system check --quick
podman system check --quick currently only skips layer contents, but
practically it's not much quicker than without the flag.

This changes the flag to also skip checking layer digests which speed up
the check significantly.

In some cases, it is useful to opt for a quicker check if we prioritize
detecting and fixing severe corruption and can tolerate minor damage.

The check option is derived from CRI-O's internal repair:
9e4d86d823/internal/lib/container_server.go (L860)

Signed-off-by: Sonny Sasaka <sonnysasaka@gmail.com>
2025-06-05 17:00:50 +00:00
Paul Holzinger a0f7db44e8
quadlet: add InterfaceName option to network unit
I noticed this was missing, its a simple 1 to 1 mapping to
--interface-name.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-06-04 16:46:39 +02:00
openshift-merge-bot[bot] 3b91669cd4
Merge pull request #26235 from mheon/fix_26101
Allow not specifying type with --mount flag
2025-05-30 20:50:20 +00:00
Matthew Heon 775a85004f Add "dest" as an alias for "destination" in `--mount`
Given I wrote this and I still mess it up on a regular basis, I
cannot be alone in forgetting whether "dst" or "dest" is the
correct short option for "destination". Let's just make both
valid, I don't see a reason not to.

Signed-off-by: Matthew Heon <matthew.heon@pm.me>
2025-05-30 14:47:13 -04:00
Paul Holzinger f2d941b241
docs: quadlet can translate names now
Remove no longer correct statement that quadlet that does not translate
our own custom unit types

Fixes: e498c652 ("Quadlet - translate dependencies on other quadlet units")
Fixes: #26243

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-05-30 18:06:03 +02:00
François Poirotte 5bfdb25b26
Support --cpuset-<cpus/mems> in podman kube play
This commit adds two new annotations named
io.podman.annotations.cpuset/$ctrname and
io.podman.annotations.memory-nodes/$ctrname

The first one allows restricting a container's execution to specific
CPU cores while the second restricts memory allocations to specific
NUMA memory nodes. They are also added automatically when the
--cpuset-cpus and --cpuset-mems options are used.

Fixes: containers#26172

Signed-off-by: François Poirotte <clicky@erebot.net>
2025-05-22 11:45:01 +02:00
Erik Sjölund 9c206a467d
docs: drop --pre-checkpoint requirement
runc is not the only runtime supporting --pre-checkpoint

crun commit 0683fec8b mentions

"This commit takes the interface as implemented in runc and implements it
for crun. "

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2025-05-15 08:42:31 +02:00
openshift-merge-bot[bot] a1ac6c33cc
Merge pull request #26113 from ygalblum/quadlet-pod-name
Quadlet - restore pod name to not use systemd specifiers
2025-05-12 23:22:28 +00:00
Jan Rodák 499ea1168b
Fix: Ensure HealthCheck exec session terminates on timeout
Previously, the HealthCheck exec session would not terminate on timeout, allowing the healthcheck to run indefinitely.

Fixes: https://issues.redhat.com/browse/RHEL-86096

Signed-off-by: Jan Rodák <hony.com@seznam.cz>
2025-05-12 17:01:35 +02:00