mirror of
https://github.com/containers/podman.git
synced 2025-12-15 19:49:29 +08:00
c9c2f644da
In each options/foo.md, keep a list of where the option is used. This will be valuable to anyone making future edits, and to those reviewing those edits. This may be a controversial commit, because those crossref lists are autogenerated as a side effect of the script that reads them. It definitely violates POLA. And one day, some kind person will reconcile (e.g.) --label, using it in more man pages, and maybe forget to git-commit the rewritten file, and CI will fail. I think this is a tough tradeoff, but worth doing. Without this, it's much too easy for someone to change an option file in a way that renders it inapplicable/misleading for some podman commands. Signed-off-by: Ed Santiago <santiago@redhat.com>
19 lines
701 B
Markdown
19 lines
701 B
Markdown
####> This option file is used in:
|
|
####> podman create, run
|
|
####> If you edit this file, make sure your changes
|
|
####> are applicable to all of those.
|
|
#### **--name**=*name*
|
|
|
|
Assign a name to the container.
|
|
|
|
The operator can identify a container in three ways:
|
|
|
|
- UUID long identifier (“f78375b1c487e03c9438c729345e54db9d20cfa2ac1fc3494b6eb60872e74778”);
|
|
- UUID short identifier (“f78375b1c487”);
|
|
- Name (“jonah”).
|
|
|
|
Podman generates a UUID for each container, and if a name is not assigned
|
|
to the container with **--name** then it will generate a random
|
|
string name. The name is useful any place you need to identify a container.
|
|
This works for both background and foreground containers.
|