NAME

bootc-usr-overlay - Adds a transient overlayfs on /usr that will be discarded on reboot

SYNOPSIS

bootc usr-overlay [OPTIONS...]

DESCRIPTION

Adds a transient overlayfs on /usr that will be discarded on reboot. The overlayfs is read/write by default.

USE CASES

A common pattern is wanting to use tracing/debugging tools, such as strace that may not be in the base image. A system package manager such as apt or dnf can apply changes into this transient overlay that will be discarded on reboot.

/ETC AND /VAR

However, this command has no effect on /etc and /var - changes written there will persist. It is common for package installations to modify these directories.

UNMOUNTING

Almost always, a system process will hold a reference to the open mount point. You can however invoke umount -l /usr to perform a "lazy unmount".

OPTIONS

--read-only

Mount the overlayfs as read-only. A read-only overlayfs is useful since it may be remounted as read/write in a private mount namespace and written to while the mount point remains read-only to the rest of the system

VERSION

The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.