mirror of
https://github.com/containers/podman.git
synced 2025-06-03 03:07:56 +08:00

Followup to #15174. These are the options that are easy(ish) to review: those that have only drifted slightly, and need only minor tweaks to bring back to sanity. For the most part, I went with the text in podman-run because that was cleaned up in #5192 way back in 2020. These diffs primarily consist of using '**' (star star) instead of backticks, plus other formatting and punctuation changes. This PR also adds a README in the options dir, and a new convention: <<container text...|pod text...>> which tries to do the right thing based on whether the man page name includes "-pod-" or not. Since that's kind of hairy code, I've also added a test suite for it. Finally, since this is impossible to review by normal means, I'm temporarily committing hack/markdown-preprocess-review, a script that will diff option-by-option. I will remove it once we finish this cleanup, but be advised that there are still 130+ options left to examine, and some of those are going to be really hard to reunite. Review script usage: simply run it (you need to have 'diffuse' installed). It isn't exactly obvious, but it shouldn't take more than a minute to figure out. The rightmost column (zzz-chosen.md) is the "winner", the actual content that will be used henceforth. You really want an ultrawide screen here. Signed-off-by: Ed Santiago <santiago@redhat.com>
12 lines
735 B
Markdown
12 lines
735 B
Markdown
#### **--mac-address**=*address*
|
|
|
|
<<Container|Pod>> network interface MAC address (e.g. 92:d0:c6:0a:29:33)
|
|
This option can only be used if the <<container|pod>> is joined to only a single network - i.e., **--network=_network-name_** is used at most once -
|
|
and if the <<container|pod>> is not joining another container's network namespace via **--network=container:_id_**.
|
|
|
|
Remember that the MAC address in an Ethernet network must be unique.
|
|
The IPv6 link-local address will be based on the device's MAC address
|
|
according to RFC4862.
|
|
|
|
To specify multiple static MAC addresses per <<container|pod>>, set multiple networks using the **--network** option with a static MAC address specified for each using the `mac` mode for that option.
|