From 486fcd4e1e6f00424f1016d8e331582523bd2c68 Mon Sep 17 00:00:00 2001 From: Jhon Honce Date: Tue, 29 Oct 2019 17:27:12 -0700 Subject: Update document formatting and packaging code * Refactored code and Makefile to support new docs layout * Removed some old code packaging code * Add Readme.md to document what we're doing Signed-off-by: Jhon Honce Signed-off-by: baude --- docs/source/markdown/podman-system-renumber.1.md | 26 ++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/source/markdown/podman-system-renumber.1.md (limited to 'docs/source/markdown/podman-system-renumber.1.md') diff --git a/docs/source/markdown/podman-system-renumber.1.md b/docs/source/markdown/podman-system-renumber.1.md new file mode 100644 index 000000000..071eefe29 --- /dev/null +++ b/docs/source/markdown/podman-system-renumber.1.md @@ -0,0 +1,26 @@ +% podman-system-renumber(1) + +## NAME +podman\-system\-renumber - Migrate lock numbers to handle a change in maximum number of locks + +## SYNOPSIS +**podman system renumber** + +## DESCRIPTION +**podman system renumber** renumbers locks used by containers and pods. + +Each Podman container and pod is allocated a lock at creation time, up to a maximum number controlled by the **num_locks** parameter in **libpod.conf**. + +When all available locks are exhausted, no further containers and pods can be created until some existing containers and pods are removed. This can be avoided by increasing the number of locks available via modifying **libpod.conf** and subsequently running **podman system renumber** to prepare the new locks (and reallocate lock numbers to fit the new struct). + +**podman system renumber** must be called after any changes to **num_locks** - failure to do so will result in errors starting Podman as the number of locks available conflicts with the configured number of locks. + +**podman system renumber** can also be used to migrate 1.0 and earlier versions of Podman, which used a different locking scheme, to the new locking model. It is not strictly required to do this, but it is highly recommended to do so as deadlocks can occur otherwise. + +If possible, avoid calling **podman system renumber** while there are other Podman processes running. + +## SEE ALSO +`podman(1)`, `libpod.conf(5)` + +## HISTORY +February 2019, Originally compiled by Matt Heon (mheon at redhat dot com) -- cgit v1.2.3-54-g00ecf