diff options
Diffstat (limited to 'man/apkg-chroot.8')
| -rw-r--r-- | man/apkg-chroot.8 | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/man/apkg-chroot.8 b/man/apkg-chroot.8 new file mode 100644 index 0000000..65bdd1d --- /dev/null +++ b/man/apkg-chroot.8 @@ -0,0 +1,42 @@ +.\" -*- 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 |