opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2026-03-13 08:01:19 +08:00
Code Issues Packages Projects Releases Wiki Activity

[DOCS] Update references common -> container-libs/common

Browse Source 
Signed-off-by: Lewis Roy <lewisdenny@me.com>
This commit is contained in:
Lewis Roy
2026-02-04 20:16:49 +10:00
parent fad519747e
commit fc18d3229d
26 changed files with 66 additions and 66 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
CONTRIBUTING.md
View File

@@ -37,7 +37,7 @@ Reproducers make finding and fixing issues much easier for maintainers.
The easier it is for us to reproduce a bug, the faster it'll be fixed! The easier it is for us to reproduce a bug, the faster it'll be fixed!
Please don't include any private/sensitive information in your issue! Please don't include any private/sensitive information in your issue!
Security issues should NOT be reported via Github and should instead be reported via the process described [here](https://github.com/containers/common/blob/main/SECURITY.md). Security issues should NOT be reported via Github and should instead be reported via the process described [here](https://github.com/containers/container-libs/blob/main/SECURITY.md).
## Working On Issues ## Working On Issues
@@ -248,7 +248,7 @@ For example:
``` ```
Fixes: #00000 Fixes: #00000
Fixes: https://github.com/containers/common/issues/00000 Fixes: https://github.com/containers/container-libs/issues/00000
Fixes: https://issues.redhat.com/browse/RHEL-00000 Fixes: https://issues.redhat.com/browse/RHEL-00000
Fixes: RHEL-00000 Fixes: RHEL-00000
``` ```

4
DISTRO_PACKAGE.md
View File

@@ -29,7 +29,7 @@ This illustrates the subpackage breakdown as well as top-level dependencies.
Podman requires a *runtime*, a *runtime monitor*, a *pause process*, Podman requires a *runtime*, a *runtime monitor*, a *pause process*,
and *networking tools*. In Fedora, some of these requirements are indirectly and *networking tools*. In Fedora, some of these requirements are indirectly
specified via [containers-common](https://github.com/containers/common); specified via [container-libs/common](https://github.com/containers/container-libs/tree/main/common);
the nested tree looks like this: the nested tree looks like this:
``` ```
Podman Podman
@@ -108,4 +108,4 @@ fine-tune config settings and dependencies.
You will probably be responsible for packaging this. You will probably be responsible for packaging this.
The best starting point is its The best starting point is its
[RPM spec file](https://github.com/containers/common/blob/main/rpm/containers-common.spec). [RPM spec file](https://github.com/containers/container-libs/blob/main/common/rpm/containers-common.spec).

4
README.md
View File

@@ -95,7 +95,7 @@ Podman uses OCI projects and best of breed libraries for different aspects:
- Networking: Networking support through use of [Netavark](https://github.com/containers/netavark) and [Aardvark](https://github.com/containers/aardvark-dns). Rootless networking is handled via [pasta](https://passt.top/passt) or [slirp4netns](https://github.com/rootless-containers/slirp4netns). - Networking: Networking support through use of [Netavark](https://github.com/containers/netavark) and [Aardvark](https://github.com/containers/aardvark-dns). Rootless networking is handled via [pasta](https://passt.top/passt) or [slirp4netns](https://github.com/rootless-containers/slirp4netns).
- Builds: Builds are supported via [Buildah](https://github.com/containers/buildah). - Builds: Builds are supported via [Buildah](https://github.com/containers/buildah).
- Conmon: [Conmon](https://github.com/containers/conmon) is a tool for monitoring OCI runtimes, used by both Podman and CRI-O. - Conmon: [Conmon](https://github.com/containers/conmon) is a tool for monitoring OCI runtimes, used by both Podman and CRI-O.
- Seccomp: A unified [Seccomp](https://github.com/containers/common/blob/main/pkg/seccomp/seccomp.json) policy for Podman, Buildah, and CRI-O. - Seccomp: A unified [Seccomp](https://github.com/containers/container-libs/blob/main/common/pkg/seccomp/seccomp.json) policy for Podman, Buildah, and CRI-O.
## Podman Information for Developers ## Podman Information for Developers
@@ -104,7 +104,7 @@ For blogs, release announcements and more, please checkout the [podman.io](https
**[Installation notes](install.md)** **[Installation notes](install.md)**
Information on how to install Podman in your environment. Information on how to install Podman in your environment.
**[OCI Hooks Support](https://github.com/containers/common/blob/main/pkg/hooks/README.md)** **[OCI Hooks Support](https://github.com/containers/container-libs/blob/main/common/pkg/hooks/README.md)**
Information on how Podman configures [OCI Hooks][spec-hooks] to run when launching a container. Information on how Podman configures [OCI Hooks][spec-hooks] to run when launching a container.
**[Podman API](https://docs.podman.io/en/latest/_static/api.html)** **[Podman API](https://docs.podman.io/en/latest/_static/api.html)**

2
build_windows.md
View File

@@ -263,7 +263,7 @@ provider="hyperv"
``` ```
Find the complete list of configuration options in the Find the complete list of configuration options in the
[documentation](https://github.com/containers/common/blob/main/docs/containers.conf.5.md). [documentation](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md).
### Create and start a podman machine ### Create and start a podman machine

4
contrib/design-docs/podman6hld.md
View File

@@ -87,7 +87,7 @@ and an ugly bug, we added SQLite3 support. SQLite has been the default since 4.
[deprecation notice for Podman 5.7](https://issues.redhat.com/browse/RUN-3343), and remove this as an option for 6.0. [deprecation notice for Podman 5.7](https://issues.redhat.com/browse/RUN-3343), and remove this as an option for 6.0.
We must also remove code in Podman’s test suite that specifically tests BoltDB. There will be a small amount of work, We must also remove code in Podman’s test suite that specifically tests BoltDB. There will be a small amount of work,
presumably cleanup, in [common](https://github.com/containers/common) as well. presumably cleanup, in [container-libs](https://github.com/containers/container-libs) as well.
## **--network-cmd-path** ## **--network-cmd-path**
@@ -106,7 +106,7 @@ In Podman 6, Podman will no longer support Intel based Macs. You can read a [wi
# Configuration files {#configuration-files} # Configuration files {#configuration-files}
Podman 6 will address a long standing problem with our configuration files largely centered around the remote client. Podman 6 will address a long standing problem with our configuration files largely centered around the remote client.
When the remote client was introduced, [containers-common](https://github.com/containers/common) already existed. While we did introduce remote client When the remote client was introduced, [container-lib/common](https://github.com/containers/container-libs/tree/main/common) already existed. While we did introduce remote client
related content to the containers.conf files, we did not take an overall look at how the remote client would impact our related content to the containers.conf files, we did not take an overall look at how the remote client would impact our
configuration files. With the popularity of our Windows and Mac clients, this became more exacerbated and the configuration files. With the popularity of our Windows and Mac clients, this became more exacerbated and the
introduction of the “machine” function only made that worse. In Podman 6, we must make containers-common more aware introduction of the “machine” function only made that worse. In Podman 6, we must make containers-common more aware

2
docs/MANPAGE_SYNTAX.md
View File

@@ -34,7 +34,7 @@ Many manpages include the OPTIONS **--all**, **-a** and/or **--latest**, **-l**.
Example for the first sentence: **podman command** is an example command. Example for the first sentence: **podman command** is an example command.
Commands or files that are quoted from other podman manpages or podman repositories have to be linked to those. Non-podman commands are not to be linked.\ Commands or files that are quoted from other podman manpages or podman repositories have to be linked to those. Non-podman commands are not to be linked.\
Example sentence: Use **[podman-run](podman-run.1.md)** or **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** for the problem. Example sentence: Use **[podman-run](podman-run.1.md)** or **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** for the problem.
It should also be specified if the command can only be run as root. In addition, it should be described when a command, OPTION, or other content cannot be executed with the remote client or in combination with other commands, OPTIONS, or content. In this case, the following sentence is put at the end of a command, OPTION, or content:\ It should also be specified if the command can only be run as root. In addition, it should be described when a command, OPTION, or other content cannot be executed with the remote client or in combination with other commands, OPTIONS, or content. In this case, the following sentence is put at the end of a command, OPTION, or content:\
*IMPORTANT: This command/OPTION/content is not available with the command/OPTION/content/on the remote Podman client.*\ *IMPORTANT: This command/OPTION/content is not available with the command/OPTION/content/on the remote Podman client.*\

50
docs/source/locale/ja/LC_MESSAGES/markdown.po
View File

@@ -549,7 +549,7 @@ msgid ""
"leave it running) using a configurable key sequence. The default sequence" "leave it running) using a configurable key sequence. The default sequence"
" is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-" " is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-"
"keys** OPTION, or specifying it in the `containers.conf` file: see " "keys** OPTION, or specifying it in the `containers.conf` file: see "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" for more information." " for more information."
msgstr "" msgstr ""
@@ -1088,7 +1088,7 @@ msgstr ""
msgid "" msgid ""
"**[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, " "**[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, "
"**[podman-run(1)](podman-run.1.md)**, " "**[podman-run(1)](podman-run.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr "" msgstr ""
#: ../../source/markdown/podman-auto-update.1.md:5 #: ../../source/markdown/podman-auto-update.1.md:5
@@ -4585,7 +4585,7 @@ msgid ""
msgstr "" msgstr ""
#: ../../source/markdown/podman-build.1.md:1402 #: ../../source/markdown/podman-build.1.md:1402
msgid "https://github.com/containers/common/blob/main/docs/containerignore.5.md" msgid "https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md"
msgstr "" msgstr ""
#: ../../source/markdown/podman-build.1.md:1404 #: ../../source/markdown/podman-build.1.md:1404
@@ -4640,9 +4640,9 @@ msgid ""
"**[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**," "**[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**,"
" **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, " " **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, "
"**[podman-ps(1)](podman-ps.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, " "**[podman-ps(1)](podman-ps.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, "
"**[Containerfile(5)](https://github.com/containers/common/blob/main/docs/Containerfile.5.md)**," "**[Containerfile(5)](https://github.com/containers/container-libs/blob/main/common/docs/Containerfile.5.md)**,"
" " " "
"**[containerignore(5)](https://github.com/containers/common/blob/main/docs/containerignore.5.md)**" "**[containerignore(5)](https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md)**"
msgstr "" msgstr ""
#: ../../source/markdown/podman-build.1.md:1426 #: ../../source/markdown/podman-build.1.md:1426
@@ -5150,7 +5150,7 @@ msgstr ""
#: ../../source/markdown/podman-events.1.md:208 #: ../../source/markdown/podman-events.1.md:208
msgid "" msgid ""
"**[podman(1)](podman.1.md)**, " "**[podman(1)](podman.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr "" msgstr ""
#: ../../source/markdown/podman-container-checkpoint.1.md:5 #: ../../source/markdown/podman-container-checkpoint.1.md:5
@@ -12338,7 +12338,7 @@ msgid ""
"systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, " "systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, "
"**[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, " "**[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, "
"**[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, " "**[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**," "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" " " "
"**[systemd.unit(5)](https://www.freedesktop.org/software/systemd/man/systemd.unit.html)**," "**[systemd.unit(5)](https://www.freedesktop.org/software/systemd/man/systemd.unit.html)**,"
" **[setsebool(8)](https://man7.org/linux/man-" " **[setsebool(8)](https://man7.org/linux/man-"
@@ -14449,7 +14449,7 @@ msgid ""
"**[podman-save(1)](podman-save.1.md)**, **[podman-remote(1)](podman-" "**[podman-save(1)](podman-save.1.md)**, **[podman-remote(1)](podman-"
"remote.1.md)**, **[podman-system-connection-add(1)](podman-system-" "remote.1.md)**, **[podman-system-connection-add(1)](podman-system-"
"connection-add.1.md)**, " "connection-add.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**," "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" **[containers-" " **[containers-"
"transports(5)](https://github.com/containers/image/blob/main/docs" "transports(5)](https://github.com/containers/image/blob/main/docs"
"/containers-transports.5.md)**" "/containers-transports.5.md)**"
@@ -19758,7 +19758,7 @@ msgid ""
"/plugin-API.md) documentation in netavark. The binary must be placed in a" "/plugin-API.md) documentation in netavark. The binary must be placed in a"
" specified directory so podman can discover it, this list is set in " " specified directory so podman can discover it, this list is set in "
"`netavark_plugin_dirs` in " "`netavark_plugin_dirs` in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" under the `[network]` section." " under the `[network]` section."
msgstr "" msgstr ""
@@ -20059,7 +20059,7 @@ msgid ""
"**[podman(1)](podman.1.md)**, **[podman-network(1)](podman-" "**[podman(1)](podman.1.md)**, **[podman-network(1)](podman-"
"network.1.md)**, **[podman-network-inspect(1)](podman-network-" "network.1.md)**, **[podman-network-inspect(1)](podman-network-"
"inspect.1.md)**, **[podman-network-ls(1)](podman-network-ls.1.md)**, " "inspect.1.md)**, **[podman-network-ls(1)](podman-network-ls.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr "" msgstr ""
#: ../../source/markdown/podman-network-create.1.md:200 #: ../../source/markdown/podman-network-create.1.md:200
@@ -20663,7 +20663,7 @@ msgid ""
"was added in Podman v4.0. CNI will be deprecated in the future in " "was added in Podman v4.0. CNI will be deprecated in the future in "
"preference of Netavark. To configure the network backend use the " "preference of Netavark. To configure the network backend use the "
"`network_backend` key under the `[Network]` in " "`network_backend` key under the `[Network]` in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**." "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**."
" New systems use netavark by default, to check what backend is used run " " New systems use netavark by default, to check what backend is used run "
"`podman info --format {{.Host.NetworkBackend}}`." "`podman info --format {{.Host.NetworkBackend}}`."
msgstr "" msgstr ""
@@ -20774,7 +20774,7 @@ msgstr ""
msgid "" msgid ""
"Podman requires specific default IPs and, thus, network subnets. The " "Podman requires specific default IPs and, thus, network subnets. The "
"default values used by Podman can be modified in the " "default values used by Podman can be modified in the "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" file." " file."
msgstr "" msgstr ""
@@ -20788,7 +20788,7 @@ msgid ""
"subnet. When Podman runs as root, the `podman` network is used as " "subnet. When Podman runs as root, the `podman` network is used as "
"default. It is the same as adding the option `--network bridge` or " "default. It is the same as adding the option `--network bridge` or "
"`--network podman`. This subnet can be changed in " "`--network podman`. This subnet can be changed in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" under the [network] section. Set the `default_subnet` to any subnet that" " under the [network] section. Set the `default_subnet` to any subnet that"
" is free in the environment. The name of the default network can also be " " is free in the environment. The name of the default network can also be "
"changed from `podman` to another name using the default network key. Note" "changed from `podman` to another name using the default network key. Note"
@@ -20804,7 +20804,7 @@ msgid ""
"When Podman is run as rootless, the internet connectivity is provided " "When Podman is run as rootless, the internet connectivity is provided "
"with slirp4netns by default. Slirp4nents uses 10.0.2.0/24 for its default" "with slirp4netns by default. Slirp4nents uses 10.0.2.0/24 for its default"
" network. This can also be changed in " " network. This can also be changed in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" but under the `[engine]` section. Use the `network_cmd_options` key and " " but under the `[engine]` section. Use the `network_cmd_options` key and "
"add `[\"cidr=X.X.X.X/24\"]` as a value. Note that slirp4netns needs a " "add `[\"cidr=X.X.X.X/24\"]` as a value. Note that slirp4netns needs a "
"network prefix size between 1 and 25. This option accepts an array, so " "network prefix size between 1 and 25. This option accepts an array, so "
@@ -20832,7 +20832,7 @@ msgid ""
" no subnet is given with the --subnet option, Podman starts picking a " " no subnet is given with the --subnet option, Podman starts picking a "
"free subnet from 10.89.0.0/24 to 10.255.255.0/24. Use the " "free subnet from 10.89.0.0/24 to 10.255.255.0/24. Use the "
"`default_subnet_pools` option under the `[network]` section in " "`default_subnet_pools` option under the `[network]` section in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" to change the range and/or size that is assigned by default." " to change the range and/or size that is assigned by default."
msgstr "" msgstr ""
@@ -20840,7 +20840,7 @@ msgstr ""
msgid "" msgid ""
"**[podman(1)](podman.1.md)**, **[podman-network-create(1)](podman-" "**[podman(1)](podman.1.md)**, **[podman-network-create(1)](podman-"
"network-create.1.md)**, " "network-create.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr "" msgstr ""
#: ../../source/markdown/podman-pause.1.md:5 #: ../../source/markdown/podman-pause.1.md:5
@@ -24655,7 +24655,7 @@ msgstr ""
msgid "" msgid ""
"**[podman(1)](podman.1.md)**, **[podman-system-service(1)](podman-system-" "**[podman(1)](podman.1.md)**, **[podman-system-service(1)](podman-system-"
"service.1.md)**, " "service.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr "" msgstr ""
#: ../../source/markdown/podman-rename.1.md:5 #: ../../source/markdown/podman-rename.1.md:5
@@ -25676,7 +25676,7 @@ msgstr ""
#: ../../source/markdown/podman-save.1.md:115 #: ../../source/markdown/podman-save.1.md:115
msgid "" msgid ""
"**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, " "**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**," "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" **[containers-" " **[containers-"
"transports(5)](https://github.com/containers/image/blob/main/docs" "transports(5)](https://github.com/containers/image/blob/main/docs"
"/containers-transports.5.md)**" "/containers-transports.5.md)**"
@@ -27160,7 +27160,7 @@ msgstr ""
msgid "" msgid ""
"**[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**," "**[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**,"
" " " "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr "" msgstr ""
#: ../../source/markdown/podman-system-renumber.1.md:27 #: ../../source/markdown/podman-system-renumber.1.md:27
@@ -27407,7 +27407,7 @@ msgstr ""
msgid "" msgid ""
"The default timeout can be changed via the `service_timeout=VALUE` field " "The default timeout can be changed via the `service_timeout=VALUE` field "
"in containers.conf. See " "in containers.conf. See "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" for more information." " for more information."
msgstr "" msgstr ""
@@ -27451,7 +27451,7 @@ msgstr ""
msgid "" msgid ""
"**[podman(1)](podman.1.md)**, **[podman-system-connection(1)](podman-" "**[podman(1)](podman.1.md)**, **[podman-system-connection(1)](podman-"
"system-connection.1.md)**, " "system-connection.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr "" msgstr ""
#: ../../source/markdown/podman-system-service.1.md:148 #: ../../source/markdown/podman-system-service.1.md:148
@@ -30255,7 +30255,7 @@ msgid ""
"Using a value other than **local** or **image**, Podman attempts to " "Using a value other than **local** or **image**, Podman attempts to "
"create the volume using a volume plugin with the given name. Such plugins" "create the volume using a volume plugin with the given name. Such plugins"
" must be defined in the **volume_plugins** section of the " " must be defined in the **volume_plugins** section of the "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**" "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" configuration file." " configuration file."
msgstr "" msgstr ""
@@ -30404,7 +30404,7 @@ msgstr ""
#: ../../source/markdown/podman-volume-create.1.md:115 #: ../../source/markdown/podman-volume-create.1.md:115
msgid "" msgid ""
"**[podman(1)](podman.1.md)**, " "**[podman(1)](podman.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**," "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" **[podman-volume(1)](podman-volume.1.md)**, **mount(8)**, " " **[podman-volume(1)](podman-volume.1.md)**, **mount(8)**, "
"**xfs_quota(8)**, **xfs_quota(8)**, **projects(5)**, **projid(5)**" "**xfs_quota(8)**, **xfs_quota(8)**, **projects(5)**, **projid(5)**"
msgstr "" msgstr ""
@@ -32013,9 +32013,9 @@ msgstr ""
#: ../../source/markdown/podman.1.md:459 #: ../../source/markdown/podman.1.md:459
msgid "" msgid ""
"**[containers-" "**[containers-"
"mounts.conf(5)](https://github.com/containers/common/blob/main/docs" "mounts.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs"
"/containers-mounts.conf.5.md)**, " "/containers-mounts.conf.5.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**," "**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" **[containers-" " **[containers-"
"registries.conf(5)](https://github.com/containers/image/blob/main/docs" "registries.conf(5)](https://github.com/containers/image/blob/main/docs"
"/containers-registries.conf.5.md)**, **[containers-" "/containers-registries.conf.5.md)**, **[containers-"

2
docs/source/markdown/options/network.md
View File

@@ -72,7 +72,7 @@ Valid _mode_ values are:
to disable automatic port forwarding based on bound ports. Similarly, **-T none** to disable automatic port forwarding based on bound ports. Similarly, **-T none**
and **-U none** are given to disable the same functionality from container to and **-U none** are given to disable the same functionality from container to
host. \ host. \
All options can also be set in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**; All options can also be set in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**;
see the `pasta_options` key under the network section in that file. \ see the `pasta_options` key under the network section in that file. \
Some examples: Some examples:
- **pasta:--map-gw**: Allow the container to directly reach the host using the - **pasta:--map-gw**: Allow the container to directly reach the host using the

4
docs/source/markdown/podman-attach.1.md.in
View File

@@ -10,7 +10,7 @@ podman\-attach - Attach to a running container
## DESCRIPTION ## DESCRIPTION
**podman attach** attaches to a running *container* using the *container's name* or *ID*, to either view its ongoing output or to control it interactively.\ **podman attach** attaches to a running *container* using the *container's name* or *ID*, to either view its ongoing output or to control it interactively.\
The *container* can be detached from (and leave it running) using a configurable key sequence. The default sequence is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-keys** OPTION, or specifying it in the `containers.conf` file: see **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** for more information. The *container* can be detached from (and leave it running) using a configurable key sequence. The default sequence is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-keys** OPTION, or specifying it in the `containers.conf` file: see **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** for more information.
## OPTIONS ## OPTIONS
@@option detach-keys @@option detach-keys
@@ -47,4 +47,4 @@ $ podman attach --no-stdin foobar
``` ```
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**

4
docs/source/markdown/podman-build.1.md.in
View File

@@ -711,7 +711,7 @@ mechanism:
Exclude all doc files except Help.doc from the image. Exclude all doc files except Help.doc from the image.
This functionality is compatible with the handling of .containerignore files This functionality is compatible with the handling of .containerignore files
described here: **[containerignore(5)](https://github.com/containers/common/blob/main/docs/containerignore.5.md)** described here: **[containerignore(5)](https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md)**
### registries.conf (`/etc/containers/registries.conf`) ### registries.conf (`/etc/containers/registries.conf`)
@@ -735,7 +735,7 @@ When using the `useradd` command within the build script, pass the
useradd to stop creating the lastlog file. useradd to stop creating the lastlog file.
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[Containerfile(5)](https://github.com/containers/common/blob/main/docs/Containerfile.5.md)**, **[containerignore(5)](https://github.com/containers/common/blob/main/docs/containerignore.5.md)** **[podman(1)](podman.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[Containerfile(5)](https://github.com/containers/container-libs/blob/main/common/docs/Containerfile.5.md)**, **[containerignore(5)](https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md)**
### Troubleshooting ### Troubleshooting

2
docs/source/markdown/podman-compose.1.md.in
View File

@@ -20,4 +20,4 @@ By default, `podman compose` will emit a warning saying that it executes an exte
To see supported options of the installed compose provider, please run `podman compose --help`. To see supported options of the installed compose provider, please run `podman compose --help`.
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**

2
docs/source/markdown/podman-create.1.md.in
View File

@@ -543,7 +543,7 @@ page.
NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of downloaded container images. Podman defaults to use `/var/tmp`. NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of downloaded container images. Podman defaults to use `/var/tmp`.
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-attach(1)](podman-attach.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **[podman-port(1)](podman-port.1.md)**, **[podman-start(1)](podman-start.1.md)**, **[podman-kill(1)](podman-kill.1.md)**, **[podman-stop(1)](podman-stop.1.md)**, **[podman-generate-systemd(1)](podman-generate-systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**, **[setsebool(8)](https://man7.org/linux/man-pages/man8/setsebool.8.html)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[fuse-overlayfs(1)](https://github.com/containers/fuse-overlayfs/blob/main/fuse-overlayfs.1.md)**, **proc(5)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **personality(2)** **[podman(1)](podman.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-attach(1)](podman-attach.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **[podman-port(1)](podman-port.1.md)**, **[podman-start(1)](podman-start.1.md)**, **[podman-kill(1)](podman-kill.1.md)**, **[podman-stop(1)](podman-stop.1.md)**, **[podman-generate-systemd(1)](podman-generate-systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**, **[setsebool(8)](https://man7.org/linux/man-pages/man8/setsebool.8.html)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[fuse-overlayfs(1)](https://github.com/containers/fuse-overlayfs/blob/main/fuse-overlayfs.1.md)**, **proc(5)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **personality(2)**
### Troubleshooting ### Troubleshooting

2
docs/source/markdown/podman-events.1.md
View File

@@ -221,7 +221,7 @@ $ podman events --format json
``` ```
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
## HISTORY ## HISTORY
March 2019, Originally compiled by Brent Baude <bbaude@redhat.com> March 2019, Originally compiled by Brent Baude <bbaude@redhat.com>

2
docs/source/markdown/podman-farm-build.1.md.in
View File

@@ -274,7 +274,7 @@ $ podman farm build --platforms arm64,amd64 -t name .
``` ```
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-farm(1)](podman-farm.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, **[Containerfile(5)](https://github.com/containers/common/blob/main/docs/Containerfile.5.md)**, **[containerignore(5)](https://github.com/containers/common/blob/main/docs/containerignore.5.md)** **[podman(1)](podman.1.md)**, **[podman-farm(1)](podman-farm.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, **[Containerfile(5)](https://github.com/containers/container-libs/blob/main/common/docs/Containerfile.5.md)**, **[containerignore(5)](https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md)**
## HISTORY ## HISTORY

2
docs/source/markdown/podman-image-scp.1.md
View File

@@ -96,7 +96,7 @@ Loaded image: docker.io/library/alpine:latest
``` ```
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-remote(1)](podman-remote.1.md)**, **[podman-system-connection-add(1)](podman-system-connection-add.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)** **[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-remote(1)](podman-remote.1.md)**, **[podman-system-connection-add(1)](podman-system-connection-add.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**
## HISTORY ## HISTORY
July 2021, Originally written by Charlie Doern <cdoern@redhat.com> July 2021, Originally written by Charlie Doern <cdoern@redhat.com>

4
docs/source/markdown/podman-network-create.1.md
View File

@@ -34,7 +34,7 @@ The netavark backend allows the use of so called *netavark plugins*, see the
[plugin-API.md](https://github.com/containers/netavark/blob/main/plugin-API.md) [plugin-API.md](https://github.com/containers/netavark/blob/main/plugin-API.md)
documentation in netavark. The binary must be placed in a specified directory documentation in netavark. The binary must be placed in a specified directory
so podman can discover it, this list is set in `netavark_plugin_dirs` in so podman can discover it, this list is set in `netavark_plugin_dirs` in
**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
under the `[network]` section. under the `[network]` section.
The name of the plugin can then be used as driver to create a network for your plugin. The name of the plugin can then be used as driver to create a network for your plugin.
@@ -205,7 +205,7 @@ newnet
``` ```
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-network(1)](podman-network.1.md)**, **[podman-network-inspect(1)](podman-network-inspect.1.md)**, **[podman-network-ls(1)](podman-network-ls.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[podman(1)](podman.1.md)**, **[podman-network(1)](podman-network.1.md)**, **[podman-network-inspect(1)](podman-network-inspect.1.md)**, **[podman-network-ls(1)](podman-network-ls.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
## HISTORY ## HISTORY
August 2021, Updated with the new network format by Paul Holzinger <pholzing@redhat.com> August 2021, Updated with the new network format by Paul Holzinger <pholzing@redhat.com>

14
docs/source/markdown/podman-network.1.md
View File

@@ -27,21 +27,21 @@ Podman uses [Netavark](https://github.com/containers/netavark) as the network ba
| update | [podman-network-update(1)](podman-network-update.1.md) | Update an existing Podman network | | update | [podman-network-update(1)](podman-network-update.1.md) | Update an existing Podman network |
## SUBNET NOTES ## SUBNET NOTES
Podman requires specific default IPs and, thus, network subnets. The default values used by Podman can be modified in the **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** file. Podman requires specific default IPs and, thus, network subnets. The default values used by Podman can be modified in the **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** file.
### Podman network ### Podman network
The default bridge network (called `podman`) uses 10.88.0.0/16 as a subnet. When Podman runs as root, the `podman` network is used as default. It is the same as adding the option `--network bridge` or `--network podman`. This subnet can be changed in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** under the [network] section. Set the `default_subnet` to any subnet that is free in the environment. The name of the default network can also be changed from `podman` to another name using the default network key. Note that this is only done when no containers are running. The default bridge network (called `podman`) uses 10.88.0.0/16 as a subnet. When Podman runs as root, the `podman` network is used as default. It is the same as adding the option `--network bridge` or `--network podman`. This subnet can be changed in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** under the [network] section. Set the `default_subnet` to any subnet that is free in the environment. The name of the default network can also be changed from `podman` to another name using the default network key. Note that this is only done when no containers are running.
### Pasta ### Pasta
Pasta by default performs no Network Address Translation (NAT) and copies the IPs from your main interface into the container namespace. If pasta cannot find an interface with the default route, it will select an interface if there is only one interface with a valid route. If you do not have a default route and several interfaces have defined routes, pasta will be unable to figure out the correct interface and it will fail to start. To specify the interface, use `-i` option to pasta. A default set of pasta options can be set in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** under the `[network]` section with the `pasta_options` key. Pasta by default performs no Network Address Translation (NAT) and copies the IPs from your main interface into the container namespace. If pasta cannot find an interface with the default route, it will select an interface if there is only one interface with a valid route. If you do not have a default route and several interfaces have defined routes, pasta will be unable to figure out the correct interface and it will fail to start. To specify the interface, use `-i` option to pasta. A default set of pasta options can be set in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** under the `[network]` section with the `pasta_options` key.
The default rootless networking tool can be selected in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** under the `[network]` section with `default_rootless_network_cmd`, which can be set to `pasta` (default) or `slirp4netns`. The default rootless networking tool can be selected in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** under the `[network]` section with `default_rootless_network_cmd`, which can be set to `pasta` (default) or `slirp4netns`.
### Slirp4netns ### Slirp4netns
Slirp4netns uses 10.0.2.0/24 for its default network. This can also be changed in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** but under the `[engine]` section. Use the `network_cmd_options` key and add `["cidr=X.X.X.X/24"]` as a value. Note that slirp4netns needs a network prefix size between 1 and 25. This option accepts an array, so more options can be added in a comma-separated string as described on the **[podman-network-create(1)](podman-network-create.1.md)** man page. To change the CIDR for just one container, specify it on the cli using the `--network` option like this: `--network slirp4netns:cidr=192.168.1.0/24`. Slirp4netns uses 10.0.2.0/24 for its default network. This can also be changed in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** but under the `[engine]` section. Use the `network_cmd_options` key and add `["cidr=X.X.X.X/24"]` as a value. Note that slirp4netns needs a network prefix size between 1 and 25. This option accepts an array, so more options can be added in a comma-separated string as described on the **[podman-network-create(1)](podman-network-create.1.md)** man page. To change the CIDR for just one container, specify it on the cli using the `--network` option like this: `--network slirp4netns:cidr=192.168.1.0/24`.
### Podman network create ### Podman network create
When a new network is created with a `podman network create` command, and no subnet is given with the --subnet option, Podman starts picking a free subnet from 10.89.0.0/24 to 10.255.255.0/24. Use the `default_subnet_pools` option under the `[network]` section in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** to change the range and/or size that is assigned by default. When a new network is created with a `podman network create` command, and no subnet is given with the --subnet option, Podman starts picking a free subnet from 10.89.0.0/24 to 10.255.255.0/24. Use the `default_subnet_pools` option under the `[network]` section in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** to change the range and/or size that is assigned by default.
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-network-create(1)](podman-network-create.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[podman(1)](podman.1.md)**, **[podman-network-create(1)](podman-network-create.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**

2
docs/source/markdown/podman-remote.1.md
View File

@@ -193,7 +193,7 @@ Users can modify defaults by creating the `$HOME/.config/containers/containers.c
Podman uses builtin defaults if no containers.conf file is found. Podman uses builtin defaults if no containers.conf file is found.
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-system-service(1)](podman-system-service.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[podman(1)](podman.1.md)**, **[podman-system-service(1)](podman-system-service.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
### Troubleshooting ### Troubleshooting

2
docs/source/markdown/podman-run.1.md.in
View File

@@ -990,7 +990,7 @@ page.
NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of downloaded container images. Podman defaults to use `/var/tmp`. NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of downloaded container images. Podman defaults to use `/var/tmp`.
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-attach(1)](podman-attach.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **[podman-port(1)](podman-port.1.md)**, **[podman-start(1)](podman-start.1.md)**, **[podman-kill(1)](podman-kill.1.md)**, **[podman-stop(1)](podman-stop.1.md)**, **[podman-generate-systemd(1)](podman-generate-systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**, **[setsebool(8)](https://man7.org/linux/man-pages/man8/setsebool.8.html)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[fuse-overlayfs(1)](https://github.com/containers/fuse-overlayfs/blob/main/fuse-overlayfs.1.md)**, **proc(5)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **personality(2)** **[podman(1)](podman.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-attach(1)](podman-attach.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **[podman-port(1)](podman-port.1.md)**, **[podman-start(1)](podman-start.1.md)**, **[podman-kill(1)](podman-kill.1.md)**, **[podman-stop(1)](podman-stop.1.md)**, **[podman-generate-systemd(1)](podman-generate-systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**, **[setsebool(8)](https://man7.org/linux/man-pages/man8/setsebool.8.html)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[fuse-overlayfs(1)](https://github.com/containers/fuse-overlayfs/blob/main/fuse-overlayfs.1.md)**, **proc(5)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **personality(2)**
### Troubleshooting ### Troubleshooting

2
docs/source/markdown/podman-save.1.md.in
View File

@@ -84,7 +84,7 @@ Storing signatures
``` ```
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)** **[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**
## HISTORY ## HISTORY
July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com> July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>

2
docs/source/markdown/podman-system-renumber.1.md
View File

@@ -27,7 +27,7 @@ $ podman system renumber
``` ```
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
## HISTORY ## HISTORY
February 2019, Originally compiled by Matt Heon (mheon at redhat dot com) February 2019, Originally compiled by Matt Heon (mheon at redhat dot com)

4
docs/source/markdown/podman-system-service.1.md
View File

@@ -105,7 +105,7 @@ Connections that present no certificate or a certificate not signed by one of th
Path to a PEM file containing the private key matching `--tls-cert`. `--tls-cert` must also be provided. Path to a PEM file containing the private key matching `--tls-cert`. `--tls-cert` must also be provided.
The default timeout can be changed via the `service_timeout=VALUE` field in containers.conf. The default timeout can be changed via the `service_timeout=VALUE` field in containers.conf.
See **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** for more information. See **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** for more information.
## EXAMPLES ## EXAMPLES
@@ -155,7 +155,7 @@ podman system service --time 0 unix:///var/run/mypodman.sock
This starts the API service listening on the custom socket `/var/run/mypodman.sock` with no inactivity timeout (runs indefinitely). This starts the API service listening on the custom socket `/var/run/mypodman.sock` with no inactivity timeout (runs indefinitely).
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-system-connection(1)](podman-system-connection.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** **[podman(1)](podman.1.md)**, **[podman-system-connection(1)](podman-system-connection.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
## HISTORY ## HISTORY
January 2020, Originally compiled by Brent Baude `<bbaude@redhat.com>` January 2020, Originally compiled by Brent Baude `<bbaude@redhat.com>`

4
docs/source/markdown/podman-volume-create.1.md
View File

@@ -26,7 +26,7 @@ The **image** driver uses an image as the backing store of for the volume.
An overlay filesystem is created, which allows changes to the volume to be committed as a new layer on top of the image. An overlay filesystem is created, which allows changes to the volume to be committed as a new layer on top of the image.
Using a value other than **local** or **image**, Podman attempts to create the volume using a volume plugin with the given name. Using a value other than **local** or **image**, Podman attempts to create the volume using a volume plugin with the given name.
Such plugins must be defined in the **volume_plugins** section of the **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** configuration file. Such plugins must be defined in the **volume_plugins** section of the **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** configuration file.
#### **--gid**=*gid* #### **--gid**=*gid*
@@ -214,7 +214,7 @@ If performance is the priority, please check out the more performant [goofys](ht
## SEE ALSO ## SEE ALSO
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[podman-volume(1)](podman-volume.1.md)**, **mount(8)**, **xfs_quota(8)**, **xfs_quota(8)**, **projects(5)**, **projid(5)** **[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[podman-volume(1)](podman-volume.1.md)**, **mount(8)**, **xfs_quota(8)**, **xfs_quota(8)**, **projects(5)**, **projid(5)**
## HISTORY ## HISTORY
January 2020, updated with information on volume plugins by Matthew Heon <mheon@redhat.com> January 2020, updated with information on volume plugins by Matthew Heon <mheon@redhat.com>

2
docs/source/markdown/podman.1.md
View File

@@ -487,7 +487,7 @@ The Overlay file system (OverlayFS) is not supported with kernels prior to 5.12.
The Network File System (NFS) and other distributed file systems (for example: Lustre, Spectrum Scale, the General Parallel File System (GPFS)) are not supported when running in rootless mode as these file systems do not understand user namespace. However, rootless Podman can make use of an NFS Homedir by modifying the `$HOME/.config/containers/storage.conf` to have the `graphroot` option point to a directory stored on local (Non NFS) storage. The Network File System (NFS) and other distributed file systems (for example: Lustre, Spectrum Scale, the General Parallel File System (GPFS)) are not supported when running in rootless mode as these file systems do not understand user namespace. However, rootless Podman can make use of an NFS Homedir by modifying the `$HOME/.config/containers/storage.conf` to have the `graphroot` option point to a directory stored on local (Non NFS) storage.
## SEE ALSO ## SEE ALSO
**[containers-mounts.conf(5)](https://github.com/containers/common/blob/main/docs/containers-mounts.conf.5.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[containers-storage.conf(5)](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[oci-hooks(5)](https://github.com/containers/common/blob/main/pkg/hooks/docs/oci-hooks.5.md)**, **[containers-policy.json(5)](https://github.com/containers/image/blob/main/docs/containers-policy.json.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **[podman-quadlet(1)](podman-quadlet.1.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)** **[containers-mounts.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers-mounts.conf.5.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[containers-storage.conf(5)](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[oci-hooks(5)](https://github.com/containers/container-libs/blob/main/common/pkg/hooks/docs/oci-hooks.5.md)**, **[containers-policy.json(5)](https://github.com/containers/image/blob/main/docs/containers-policy.json.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **[podman-quadlet(1)](podman-quadlet.1.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**
### Troubleshooting ### Troubleshooting

4
docs/tutorials/rootless_tutorial.md
View File

@@ -31,7 +31,7 @@ The major user-facing difference between the two is outlined in [this blog post]
> [!note] > [!note]
> pasta's default situation of not being able to communicate between the container and the host has been fixed in Podman 5.3: see [Podman 5.3 changes for improved networking experience with pasta](https://blog.podman.io/2024/10/podman-5-3-changes-for-improved-networking-experience-with-pasta/). > pasta's default situation of not being able to communicate between the container and the host has been fixed in Podman 5.3: see [Podman 5.3 changes for improved networking experience with pasta](https://blog.podman.io/2024/10/podman-5-3-changes-for-improved-networking-experience-with-pasta/).
The default rootless networking tool can be selected in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** under the `[network]` section with `default_rootless_network_cmd`, which can be set to `pasta` (default) or `slirp4netns`. The default rootless networking tool can be selected in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** under the `[network]` section with `default_rootless_network_cmd`, which can be set to `pasta` (default) or `slirp4netns`.
### `/etc/subuid` and `/etc/subgid` configuration ### `/etc/subuid` and `/etc/subgid` configuration
@@ -125,7 +125,7 @@ Note: in environments without `XDG` environment variables, Podman internally set
- `/run/user/$UID` on `systemd` environments - `/run/user/$UID` on `systemd` environments
- `$TMPDIR/podman-run-$UID` otherwise - `$TMPDIR/podman-run-$UID` otherwise
The three main configuration files are [containers.conf](https://github.com/containers/common/blob/main/docs/containers.conf.5.md), [storage.conf](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md) and [registries.conf](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md). The user can modify these files as they wish. The three main configuration files are [containers.conf](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md), [storage.conf](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md) and [registries.conf](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md). The user can modify these files as they wish.
#### containers.conf #### containers.conf
Podman reads Podman reads

2
troubleshooting.md
View File

@@ -1406,7 +1406,7 @@ Executing a step in a `Dockerfile`/`Containerfile` which mounts secrets using `-
#### Symptom #### Symptom
A `RUN` line in the `Dockerfile`/`Containerfile` contains a [secret mount](https://github.com/containers/common/blob/main/docs/Containerfile.5.md) such as `--mount=type=secret,id=MY_USER,target=/etc/dnf/vars/MY_USER`. A `RUN` line in the `Dockerfile`/`Containerfile` contains a [secret mount](https://github.com/containers/container-libs/blob/main/common/docs/Containerfile.5.md) such as `--mount=type=secret,id=MY_USER,target=/etc/dnf/vars/MY_USER`.
When running `podman build` the process fails with an error message like: When running `podman build` the process fails with an error message like:
``` ```