.ds Aq \(aq
.nh
.TH NAME
bootc-usr-overlay \- Adds a transient overlayfs on \fB/usr\fR that will be discarded
on reboot


.SH SYNOPSIS
\fBbootc usr-overlay\fP [\fIOPTIONS...\fP]


.SH DESCRIPTION
Adds a transient overlayfs on \fB/usr\fR that will be discarded on reboot. The
overlayfs is read/write by default.

.SH USE CASES
A common pattern is wanting to use tracing/debugging tools, such as
\fBstrace\fR that may not be in the base image. A system package manager
such as \fBapt\fR or \fBdnf\fR can apply changes into this transient overlay
that will be discarded on reboot.

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

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


.SH OPTIONS
.PP
\fB--read-only\fP

.EX
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
.EE


.SH VERSION
v1.15.2
