2253 Commits

Author SHA1 Message Date
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
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
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
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
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
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
f0c15f1c7a docs: replace RemapUsers=keep-id with UserNS=keep-id
Git commit 0c3b5e433e26d6a8a99a0967be91be897bbdc068
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
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
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
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
3b91669cd4 Merge pull request #26235 from mheon/fix_26101
Allow not specifying type with --mount flag
2025-05-30 20:50:20 +00:00
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
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
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
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
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
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
700c679cd2 Quadlet - Update the docs to reflect the default naming of resources
Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-05-12 09:33:28 -04:00
d6239385fd Update podman-secret-create.1.md
* Adds example showing secure secret generation / rotation & mounting
* fixes https://github.com/containers/podman/issues/26064

Signed-off-by: Stuart Cardall <itoffshore@users.noreply.github.com>
2025-05-06 22:41:49 +01:00