summaryrefslogtreecommitdiffstats
path: root/upstream/archlinux/man1/archbuild.1
blob: bb1448fc5eabb0816fa0d5b1903215d8df8d7f1b (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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
'\" t
.\"     Title: archbuild
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.21
.\"      Date: 2024-05-01
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "ARCHBUILD" "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"
archbuild \- a script to build an Arch Linux package inside a clean chroot.
.SH "SYNOPSIS"
.sp
archbuild [options] \(em [makechrootpkg args]
.SH "DESCRIPTION"
.sp
\fIarchbuild\fP is a script to build an Arch Linux package. archbuild is part of devtools but should only be used via one of the included symlinks:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
extra\-x86_64\-build
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
gnome\-unstable\-x86_64\-build
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
kde\-unstable\-x86_64\-build
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
multilib\-build
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
multilib\-staging\-build
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
multilib\-testing\-build
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
staging\-x86_64\-build
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
testing\-x86_64\-build
.RE
.sp
The symlink used to run it will be inspected by archbuild, to determine which target you want it to use. It will load the available pacman configuration from \fIreponame\-arch.conf\fP with a fallback to \fIreponame.conf\fP from /usr/share/devtools/pacman.conf.d. The makepkg configuration is loaded from \fIrepo\-arch.conf\fP with a fallback to \fIreponame.conf\fP from /usr/share/devtools/makepkg.conf.d.
.sp
It will also load the bind mount configuration from \fImount.d/arch\fP in /usr/share/devtools. The file format is that each line starting with ro and rw will be used, other lines will be ignored, and the rest of the used line is out/path:in/path preceded by a space as a separator. ro means it is a read\-only mount, rw means a read\-write mount.
.SH "OPTIONS"
.sp
\fB\-h\fP
.RS 4
Output command line options.
.RE
.sp
\fB\-c\fP
.RS 4
Recreate the chroot before building.
.RE
.sp
\fB\-r\fP <dir>
.RS 4
Create chroots in this directory.
.RE
.SH "SEE ALSO"
.sp
devtools(7)
.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.