aboutsummaryrefslogtreecommitdiff
path: root/man/apkg-chroot.8
blob: 65bdd1d2e06c8a92ee7a247ad834829258fd5aa5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
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