midipix / build / midipix_build

Forked from build/midipix_build 4 years ago
Clone

Blame etc/build.usage

Lucio Andrés Illanes Albornoz (arab, vxp) c27bea
usage: ./build.sh [-x] [-4|6] [-a nt32|nt64] [-b debug|release] [-c] [-h]
Lucio Andrés Illanes Albornoz (arab, vxp) 648b81
                  [-i] [-N] [-r package[,...][:step]] [-R] [-t[.gz|.bz2|.xz] [-v[v[v]]]
Lucio Andrés Illanes Albornoz (arab, vxp) 7b01b5
                  [<target>[ ...]]
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        -x                      Set the xtrace sh(1)ell option for debugging purposes.
Lucio Andrés Illanes Albornoz (arab, vxp) 7b01b5
        -4|-6                   Force IPv[46] when downloading files.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        -a nt32|nt64            Selects 32-bit or 64-bit architecture; defaults to nt64.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        -b debug|release        Selects debug or release build; defaults to debug.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        -c                      Clean ${PREFIX} before processing build scripts.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        -h                      Show this screen.
Lucio Andrés Illanes Albornoz (arab, vxp) a0561a
        -i                      Ignore SHA256 hash mismatches when downloading files.
Lucio Andrés Illanes Albornoz (arab, vxp) 35633f
        -N                      Offline mode: no {wget,git-{clone,pull}}(1) calls.
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
        -r package[,...][:step] Restart the specified comma-separated build(s) completely
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                or at the optionally specified step. Currently defined
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                steps are:
Lucio Andrés Illanes Albornoz (arab, vxp) 32ad21
                                fetch_distclean, fetch_wget, fetch_git, fetch_extract,
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                configure_patch_pre, configure_autotools, configure_patch,
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                configure, build_clean, build, install_subdirs, install_make,
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                install_files, install_libs, install_pkgconfig, install_purge_la,
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                install_strip, and install.
Lucio Andrés Illanes Albornoz (arab, vxp) 648b81
        -R                      Ignore build failures, skip printing package logs, and continue
Lucio Andrés Illanes Albornoz (arab, vxp) 648b81
                                building (relaxed mode.)
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
        -t[.gz|.bz2|.xz]        Produce binary distribution and source tarballs containing
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                ${PREFIX} sans ${WORKDIR} and ${PREFIX}/src/midipix_build
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                and ${WORKDIR} sans top-level regular files at the end of
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                a build with zero failures. The tarballs will be compressed
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                with either gzip, bzip2, or xz and signed with GPG; the
Lucio Andrés Illanes Albornoz (arab, vxp) a44f58
                                default compression is xz.
Lucio Andrés Illanes Albornoz (arab, vxp) 648b81
        -v[v[v]]                Be verbose; -vv: always print package logs; -vvv: logs fileops.
Lucio Andrés Illanes Albornoz (arab, vxp) 7b01b5
        --debug-minipix         Don't strip(1) minipix binaries to facilitate debugging minipix.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        <target>[ ...]          One of:
Lucio Andrés Illanes Albornoz (arab, vxp) 9bed93
                                host_toolchain_deps, host_toolchain, native_toolchain_deps,
Lucio Andrés Illanes Albornoz (arab, vxp) 9bed93
                                native_toolchain, runtime, host_packages, lib_packages,
Lucio Andrés Illanes Albornoz (arab, vxp) 9bed93
                                dev_packages, leaf_packages, minipix, dist, devroot, dev,
Lucio Andrés Illanes Albornoz (arab, vxp) 9bed93
                                or world.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        ${HOME}/midipix_build.vars, ../midipix_build.vars, and build.vars are sourced
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        if they exist.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        Packages that are built by pkg.build will apply local patches in ${WORKDIR}
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        named ${PKG_SUBDIR}.local.patch.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        Examples:
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        ./build.sh -r coreutils
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        Completely restart the coreutils build.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        ./build.sh -r coreutils:configure,build,install
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        Restart the configure, build, and install steps of the coreutils build.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        ./build.sh -r psxscl GITROOT_HEAD=... PKG_PSXSCL_CFLAGS_CONFIGURE_EXTRA=-DPSX_INTERNAL_STRACE
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        Build psxscl from the internal repository with strace enabled.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        ./build.sh -c -r ALL GITROOT_HEAD=...
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
        Clean ${PREFIX} and forcibly rebuild everything.
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
This script has been tested on the following platforms:
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Alpine v3.4 (20160917_17:50) (x86_64)
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Arch Linux 2016.02.01 (x86_64)
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
CentOS v7.2.1511 (Core) (x86_64)
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Debian GNU/Linux v8.5 (stable) (jessie) (x86_64)
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
Exherbo Linux (x86_64-pc-linux-musl) (x86_64)
Lucio Andrés Illanes Albornoz (arab, vxp) 59765f
openSUSE 20150612 (Tumbleweed) (x86_64)