.\" -*- mode: troff; coding: utf-8 -*-
.TH APKG-CHROOT 8
.SH NAME
apkg-chroot \- enter a chroot environment for package building
.SH DESCRIPTION
.LP
\fBapkg-chroot\fR enters a chroot environment suitable for package building and
system maintenance. It mounts the required virtual filesystems (\fI/dev\fR,
\fI/proc\fR, \fI/sys\fR, \fI/run\fR), copies the host's \fI/etc/resolv.conf\fR,
and executes a command inside the chroot (default: \fI/bin/sh\fR). All mounts are
cleaned up on exit.
.SH USAGE
.LP
\f(CRapkg-chroot <chroot-dir> [command]\fR
.PP
If \fIcommand\fR is not specified, \fB/bin/sh\fR is launched.
The script must be run as root.
.SH ENVIRONMENT
.TP
\fBHOME\fR
Set to \fI/root\fR inside the chroot.
.TP
\fBTERM\fR
Passed through from the host.
.TP
\fBPATH\fR
Set to \fI/bin:/usr/bin:/sbin:/usr/sbin\fR.
.SH EXAMPLES
.LP
\f(CRapkg-chroot /mnt/alice\fR - Enter a chroot and launch an interactive shell.
.PP
\f(CRapkg-chroot /mnt/alice apkg -i mypkg\fR - Run apkg inside the chroot.
.SH AUTHORS
.LP
emmett1 \c
.MT me@emmett1.my
.ME
.SH REPORTING BUGS
.LP
Please report bugs and issues in the project issue tracker: \c
.UR https://codeberg.org/emmett1/autils/issues
.UE