summaryrefslogtreecommitdiff
path: root/doc/makepkg.8.txt
blob: bb7a9a3ff2771729f6946c370a4127ef27984e26 (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
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
/////
vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
/////
makepkg(8)
==========

Name
----
makepkg - package build utility


Synopsis
--------
'makepkg' [options]


Description
-----------
'makepkg' is a script to automate the building of packages. The requirements for
using the script are a build-capable \*nix platform and a custom build script
for each package you wish to build (known as a PKGBUILD). See
linkman:PKGBUILD[5] for details on creating your own build scripts.

The advantage to a script-based build is that the work is only done once. Once
you have the build script for a package, 'makepkg' will do the rest: download and
validate source files, check dependencies, configure the build-time settings,
build the package, install the package into a temporary root, make
customizations, generate meta-info, and package the whole thing up for pacman
to use.

NOTE: 'makepkg' uses your current locale by default and does not unset it when
building packages. If you wish to share your build output with others when
seeking help or for other purposes, you may wish to run "`LC_ALL=C makepkg`" so
your logs and output are not localized.

Options
-------
*\--asroot*::
    Allow makepkg to run as root. This is for security purposes as it is
    normally dangerous to do so. This will also disable use of fakeroot and
    sudo.

*-A, \--ignorearch*::
    Ignore a missing or incomplete arch field in the build script. This is
    for rebuilding packages from source when the PKGBUILD may be slightly
    outdated and not updated with an `arch=('yourarch')` field.

*-c, \--clean*::
    Clean up leftover work files and directories after a successful build.

*\--config* <file>::
    Use an alternate config file instead of the +{sysconfdir}/makepkg.conf+
    default.

*-d, \--nodeps*::
    Do not perform any dependency checks. This will let you override and
    ignore any dependencies required. There is a good chance this option
    will break the build process if all of the dependencies are not
    installed.

*-e, \--noextract*::
    Do not extract source files or run the prepare() function (if present);
    use whatever source already exists in the $srcdir/ directory. This is
    handy if you want to go into $srcdir/ and manually patch or tweak code,
    then make a package out of the result. Keep in mind that creating a
    patch may be a better solution to allow others to use your PKGBUILD.

*\--verifysource*::
    For each source file in the source array of PKGBUILD, download the file
    if required and perform the integrity checks. No extraction or build is
    performed. Useful for performing subsequent offline builds.

*-f, \--force*::
    makepkg will not build a package if a built package already exists in
    the `PKGDEST` (set in linkman:makepkg.conf[5]) directory, which may
    default to the current directory. This allows the built package to be
    overwritten.

*-g, \--geninteg*::
    For each source file in the source array of PKGBUILD, download the file
    if required and generate integrity checks. The integrity checks generated
    are determined by the checks present in the PKGBUILD, falling back to the
    value of the INTEGRITY_CHECK array in makepkg.conf(5) if these are absent
    This output can be redirected into your PKGBUILD for source validation
    using "`makepkg -g >> PKGBUILD`".

*--skipinteg*::
    Do not perform any integrity checks (checksum and PGP) on source files.

*\--skipchecksums*::
    Do not verify checksums of source files.

*\--skippgpcheck*::
    Do not verify PGP signatures of source files.

*-h, \--help*::
    Output syntax and command line options.

*--holdver*::
    When using VCS sources (linkman:PKGBUILD[5]) any currently checked out source
    will not be updated to the latest revision.

*-i, \--install*::
    Install or upgrade the package after a successful build using
    linkman:pacman[8].

*-L, \--log*::
    Enable makepkg build logging. This will use the *tee* program to send
    output of the `build()` function to both the console and to a text file in
    the build directory named `pkgname-pkgver-pkgrel-arch.log`. As mentioned
    above, the build log will be localized so you may want to set your locale
    accordingly if sharing the log output with others.

*-m, \--nocolor*::
    Disable color in output messages.

*-o, \--nobuild*::
    Download and extract files, run the prepare() function, but do not build
    them. Useful with the '\--noextract' option if you wish to tweak the files
    in $srcdir/ before building.

*-p* <buildscript>::
    Read the package script `buildscript` instead of the `PKGBUILD` default;
    see linkman:PKGBUILD[5].

*-r, \--rmdeps*::
    Upon successful build, remove any dependencies installed by makepkg
    during dependency auto-resolution and installation when using `-s`.

*-R, \--repackage*::
    Repackage contents of the package without rebuilding the package. This
    is useful if you forgot a depend or install file in your PKGBUILD and
    the build itself will not change.

*-s, \--syncdeps*::
    Install missing dependencies using pacman. When build-time or run-time
    dependencies are not found, pacman will try to resolve them. If
    successful, the missing packages will be downloaded and installed.

*-S, \--source*::
    Do not actually build the package, but build a source-only tarball that
    does not include sources that can be fetched via a download URL. This is
    useful for passing a single tarball to another program such as a chroot,
    remote builder, or a tarball upload. Because integrity checks are verified,
    all source files of the package need to be present or downloadable.

*-V, \--version*::
    Display version information.

*\--allsource*::
    Do not actually build the package, but build a source-only tarball that
    includes all sources, including those that are normally download via
    makepkg. This is useful for passing a single tarball to another program
    such as a chroot or remote builder. It will also satisfy requirements of
    the GPL when distributing binary packages.

*\--pkg* <list>::
    Only build listed packages from a split package. Multiple packages should
    be comma separated in the list. This option can be specified multiple times.

*\--check*::
    Run the check() function in the PKGBUILD, overriding the setting in
    linkman:makepkg.conf[5].

*\--nocheck*::
    Do not run the check() function in the PKGBUILD or handle the checkdepends.

*\--sign*::
    Sign the resulting package with gpg, overriding the setting in
    linkman:makepkg.conf[5].

*\--nosign*::
    Do not create a signature for the built package.

*\--key* <key>::
    Specify a key to use when signing packages, overriding the GPGKEY setting
    in linkman:makepkg.conf[5]. If not specified in either location, the
    default key from the keyring will be used.

*\--noconfirm*::
    (Passed to pacman) Prevent pacman from waiting for user input before
    proceeding with operations.

*\--needed*::
    (Passed to pacman) Tell pacman not to reinstall a target if it is already
    up to date. (used with -i / --install).

*\--asdeps*::
    (Passed to pacman) Install packages as non-explicitly installed (used
    with -i / --install).

*\--noprogressbar*::
    (Passed to pacman) Prevent pacman from displaying a progress bar;
    useful if you are redirecting makepkg output to file.


Additional Features
-------------------
makepkg supports building development versions of packages without having to
manually update the pkgver in the PKGBUILD. This was formerly done using the
separate utility 'versionpkg'. See linkman:PKGBUILD[5] for details on how to
set up a development PKGBUILD.


Environment Variables
---------------------
*PACMAN*::
    The command that will be used to check for missing dependencies and to
    install and remove packages. Pacman's -Qq, -Rns, -S, -T, and -U
    operations must be supported by this command. If the variable is not
    set or empty, makepkg will fall back to `pacman'.

**PKGDEST=**"/path/to/folder"::
    Folder where the resulting packages will be stored. Overrides the
    corresponding value defined in linkman:makepkg.conf[5].

**SRCDEST=**"/path/to/folder"::
    Folder where the downloaded sources will be stored. Overrides the
    corresponding value defined in linkman:makepkg.conf[5].

**PACKAGER=**"John Doe <john@doe.com>"::
    String to identify the creator of the resulting package. Overrides
    the corresponding value defined in linkman:makepkg.conf[5].

**BUILDDIR=**"/path/to/folder"::
    Folder where the package will be built. Overrides the corresponding
    value defined in linkman:makepkg.conf[5].

Configuration
-------------
See linkman:makepkg.conf[5] for more details on configuring makepkg using the
'makepkg.conf' file.


See Also
--------
linkman:makepkg.conf[5], linkman:PKGBUILD[5], linkman:pacman[8]

include::footer.txt[]