summaryrefslogtreecommitdiffhomepage
path: root/etc/build.usage
blob: bd77ae37cb3f10fc5a4d412a1bbd0d04f784395c (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
usage: ./build.sh [-4|6] [-a nt32|nt64] [-b debug|release] [-c] [-C dir[,..]]
                  [-D kind[,..]] [-h] [-N] [-P [jobs]] [-r ALL[:step,..]]
                  [-r name[,..][:step,..]] [-R] [-v[v[v]]] [-x]
                  [--as-needed] [--debug-minipix] [<target>[ ..]]
        -4|-6                   Force IPv[46] when downloading files.
        -a nt32|nt64            Selects 32-bit or 64-bit architecture; defaults to nt64.
        -b debug|release        Selects debug or release build; defaults to debug.
        -c                      Clean ${PREFIX} before processing build scripts.
        -C dir[,..]             Clean build directory (build,) source directory (src,) and/or
                                destination directory (dest) after successful package builds.
        -D kind[,..]            Produce minimal midipix distribution directory (minipix,) package
                                tarballs (pkg,) RPM binary packages (rpm,) compressed and optionally
                                signed binary and source tarballs containing ${PREFIX} sans ${BUILD_WORKDIR}
                                (t{bz2,gz,xz},) and/or deployable distribution ZIP archive (zipdist.)
                                {t{bz2,gz,xz},zipdist} imply minipix.
        -h                      Show this screen.
        -N                      Offline mode: no {wget,git-{clone,pull}}(1) calls.
        -P [jobs]               Enables parallelisation at target-level, whenever applicable.
                                The maximum count of jobs defaults to the number of logical
                                processors on the host system.
                                If -R is not specified and at least one (1) package fails to build,
                                all remaining package builds will be forcibly aborted for convenience.
        -r ALL[:step,..]
        -r name[,..][:step,..]  Restart all packages/the specified comma-separated package(s)
                                completely or at optionally specified comma-separated step(s).
                                Currently defined steps are:
                                fetch_wget, fetch_git, fetch_extract,
                                configure_patch_pre, configure_autotools, configure_patch,
                                configure, build, install_subdirs, install_make,
                                install_files, install_libs, install_pkgconfig, install_purge_la,
                                install_strip, install, and install_rpm.
        -R                      Ignore build failures, skip printing package logs, and continue
                                building (relaxed mode.)
        -v[v[v]]                Be verbose; -vv: always print package logs; -vvv: logs fileops.
        -x                      Set xtrace during package builds; implies -vv.
        --as-needed             Don't build unless the midipix_build repository has received new commits.
        --debug-minipix         Don't strip(1) minipix binaries to facilitate debugging minipix.
        <target>[ ..]           One of:
                                host or host_tools, host_tools_deps, host_tools_rpm, host_toolchain_deps, host_toolchain, host_toolchain_mingw32,
                                native or native_tools, native_toolchain_deps, native_toolchain, native_toolchain_mingw32, native_runtime,
                                packages_deps or host_packages_deps, native_packages_deps, native_packages_deps_x11,
                                packages or native_packages.

        ${HOME}/midipix_build.vars, ${HOME}/.midipix_build.vars, and/or ../midipix_build.vars will be sourced if present.

        Examples:
        ./build.sh -r coreutils
        Completely restart the coreutils build.

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

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