summaryrefslogtreecommitdiffhomepage
path: root/build.usage
blob: d11b391534760115a8fe749d5cb92028c63b1829 (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
usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-c] [-d] [-e] [-h] [-pi level.name.build]
                  [-pr level.name.build] [-r ALL|level.name.build[:diff|:step[,...]]]
                  [-t[.gz|.bz2|.xz] [-x]
        -a nt32|nt64           Selects 32-bit or 64-bit architecture; defaults to nt64.
        -b debug|release       Selects debug or release build; defaults to debug.
                               This currently only controls CFLAGS.
        -c                     Clean ${PREFIX} before processing build scripts.
        -d level.name.build    Disables the specified build script.
        -e level.name.build    Enables the specified build script.
        -h                     Show this screen.
        -pi level.name.build   Insert link to pkg.build for the specified build script.
                               All consecutive scripts with higher build levels will
                               be renamed automatically.
        -pr level.name.build   Remove the specified build script. As with -pi, all con-
                               secutive scripts with higher build levels will be renamed
                               automatically.
        -r ALL|level.name.build[:step[,...]]
                               Restart all or the specified build script(s) completely
                               or at the optionally specified build step. Currently defined
                               build steps are: fetch extract build_dir autoconf patch
                               configure clean build install.
        -r level.name.build:diff
                               Automatically produce diff(1).
        -t[.gz|.bz2|.xz]       Produce binary distribution and source tarballs containing ${PREFIX}
                               sans ${WORKDIR} and ${PREFIX}/src/midipix_build and ${WORKDIR} sans top-
                               level regular files at the end of a build with zero failures. The
                               tarballs will be compressed with either gzip, bzip2, or xz and signed
                               with GPG; the default compression is xz.
        -v                     Be verbose; this currently only affects secure_{cd,rm}() and insecure_mkdir().
        -x                     Set the xtrace sh(1)ell option for debugging purposes.

        Packages that are built by pkg.build will apply local patches in ${WORKDIR}
        named ${PKG_SUBDIR}.local.patch.

        Examples:
        ./build.sh -r ALL
        Forcibly restart the entire build.

        ./build.sh -r 301.coreutils.build
        Completely restart the coreutils build.

        ./build.sh -r 301.coreutils.build:configure,build,install
        Restart the configure, build, and install steps of the coreutils build script.

        ./build.sh -r 205.psxscl.build GITROOT_HEAD=... PKG_PSXSCL_CFLAGS_CONFIGURE_EXTRA=-DPSX_INTERNAL_STRACE
        Build psxscl from the internal repository with strace enabled.

        ./build.sh -c -r ALL GITROOT_HEAD=...
        Clean ${PREFIX} and forcibly rebuild everything.

This script has been tested on the following platforms:
Arch Linux 2016.02.01 (x86_64)
CentOS v7.2.1511 (Core) (x86_64)
Debian GNU/Linux v8.5 (stable) (jessie) (x86_64)
Exherbo Linux (x86_64-pc-linux-musl) (x86_64)
openSUSE 20150612 (Tumbleweed) (x86_64)