Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
podman-system-renumber(1)   General Commands Manual  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 contain-
       ers.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 containers.conf and subsequently running podman system	renum-
       ber  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  results 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 ver-
       sions 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), podman-system(1), containers.conf(5)

HISTORY
       February	 2019,	Originally  compiled by	Matt Heon (mheon at redhat dot
       com)

						     podman-system-renumber(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-system-renumber&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help