[CI:DOCS] Man pages: refactor common options: --shm-size

[edsantiago]

Mostly went with the podman-run version. For ease of review, I
kept the "you" word -- I will fix that in my in-progress
cleanup PR.

This affects lots of files, each of which had slightly different
wording, but this actually isn't as bad as it looks. The diffs
were minor, and I'm pretty sure the new refactored text applies
equally well to all the man pages.

Signed-off-by: Ed Santiago [email protected]

more man-page deduplication

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: edsantiago

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [edsantiago]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[rhatdan]

This option conflicts with --ipc=host when running containers.
Should be in the shared block, I believe.

[edsantiago]

Oh, indeed:

$ bin/podman run --shm-size=100k --ipc=host quay.io/libpod/testimage:20220615 date
Error: invalid config provided: cannot set shmsize when running in the {host } IPC Namespace

I only left it in the pod files, because it was only present in the pod files. Looks like the "conflict" wording dates to #14625 on 2022-06-21 in both of the pod man pages. Should I keep the "when running containers" text, or just leave it as "This option conflicts with --ipc=host" ?

Thank you for catching that!

[rhatdan]

I would just leave it as conflicts with ipc=host.

[edsantiago]

So done. Rebased and repushed. Thanks again, that was a subtle one!

[rhatdan]

LGTM

[rhatdan]

@containers/podman-maintainers PTAL

[vrothberg]

/lgtm