summaryrefslogtreecommitdiffstats
path: root/upstream/archlinux/man1/makechrootpkg.1
blob: cc21479b5cb2385f5dc3a9e1c3608d7668ba5242 (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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
'\" t
.\"     Title: makechrootpkg
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.21
.\"      Date: 2024-05-01
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "MAKECHROOTPKG" "1" "2024-05-01" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
makechrootpkg \- Build a PKGBUILD in a given chroot environment
.SH "SYNOPSIS"
.sp
makechrootpkg [OPTIONS] \-r <chrootdir> [\-\-] [makepkg args]
.SH "DESCRIPTION"
.sp
Run this script in a directory containing a PKGBUILD to build a package
inside a clean chroot. Arguments passed to this script after the
end\-of\-options marker (\-\-) will be passed to makepkg.
.sp
The chroot dir consists of the following directories:
<chrootdir>/{root, copy} but only "root" is required
by default. The working copy will be created as needed
.sp
The chroot "root" directory must be created via the following
command:
mkarchroot <chrootdir>/root base\-devel
.sp
This script reads {SRC,SRCPKG,PKG,LOG}DEST, MAKEFLAGS and PACKAGER
from makepkg.conf(5), if those variables are not part of the
environment.
.sp
Default makepkg args: \-\-syncdeps \-\-noconfirm \-\-log \-\-holdver \-\-skipinteg
.SH "OPTIONS"
.sp
\fB\-h\fP
.RS 4
Show this usage message
.RE
.sp
\fB\-c\fP
.RS 4
Clean the chroot before building
.RE
.sp
\fB\-d\fP <dir>
.RS 4
Bind directory into build chroot as read\-write
.RE
.sp
\fB\-D\fP <dir>
.RS 4
Bind directory into build chroot as read\-only
.RE
.sp
\fB\-u\fP
.RS 4
Update the working copy of the chroot before building
This is useful for rebuilds without dirtying the pristine
chroot
.RE
.sp
\fB\-r\fP <dir>
.RS 4
The chroot dir to use
.RE
.sp
\fB\-I\fP <pkg>
.RS 4
Install a package into the working copy of the chroot
.RE
.sp
\fB\-l\fP <copy>
.RS 4
The directory to use as the working copy of the chroot
Useful for maintaining multiple copies
Default: $USER
.RE
.sp
\fB\-n\fP
.RS 4
Run namcap on the build package
.RE
.sp
\fB\-C\fP
.RS 4
Run checkpkg on the build package
.RE
.sp
\fB\-T\fP
.RS 4
Build in a temporary directory
.RE
.sp
\fB\-U\fP
.RS 4
Run makepkg as a specified user
.RE
.sp
\fB\-x\fP <when>
.RS 4
Inspect chroot after build, possible modes are \fInever\fP (default), \fIalways\fP or \fIfailure\fP
.RE
.SH "HOMEPAGE"
.sp
\fI\c
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP"
.sp
Please report bugs and feature requests in the issue tracker. Please do your best to provide a reproducible test case for bugs.