annotate config @ 1839:c8293b3ab81f

Teach chroot-splice to accept one or two arguments. (Control image now optional.)
author Rob Landley <rob@landley.net>
date Sun, 17 Jan 2016 21:18:52 -0600
parents 5ff5fea0ad7a
children
rev   line source
rob@399 1 # Setup
rob@399 2
rob@1620 3 # This file is sourced, not run. It provides a place for you to persistently
rob@1061 4 # set configuration variables.
rob@399 5
rob@1061 6 # Feel free to replace this file with your own version, or to set these
rob@1620 7 # environment variables on the command line. By default all the variables
rob@1620 8 # listed in this file are left blank.
rob@1620 9
rob@1620 10 # This file is used by the whitelist logic to determine which variables to
rob@1620 11 # pass through when sanitizing the environment. Don't delete the commented
rob@1620 12 # out variables or they won't be passed through if you set them in the
rob@1620 13 # environment.
rob@1061 14
rob@1061 15 #############################################################################
rob@1061 16
rob@1620 17 # Set this if you don't want to drop all unrecognized environment variables.
rob@1620 18
rob@1620 19 # export NO_SANITIZE_ENVIRONMENT=1
rob@1620 20
rob@1128 21 # Setting this tells build.sh to use the existing $PATH commands to build
rob@1620 22 # everything, which probably won't work out of the box. Cross compiling is
rob@1128 23 # an insanely delicate process which requires a carefully configured host
rob@1620 24 # environment. If we don't set up our own, you'll have to supply one.
rob@1128 25
rob@1128 26 # export NO_HOST_TOOLS=1
rob@1128 27
rob@1083 28 # Set this to a comma separated list of packages to build statically,
rob@1620 29 # or "none" to build all packages dynamically. Set to "all" to build all
rob@1083 30 # packages statically (and not install static libraries on the target).
rob@399 31
rob@1083 32 # By default, busybox and the native compiler are built statically.
rob@1083 33 # (Using a static busybox on the target provides a 20% performance boost to
rob@1083 34 # autoconf under qemu, and building the native compiler static makes it much
rob@1083 35 # more portable to other target root filesystems.)
rob@865 36
rob@1800 37 # export BUILD_STATIC=busybox,toybox,binutils,gcc-core,gcc-g++,make
rob@399 38
rob@944 39 # If this is set, build.sh will build a cross compiler statically linked
rob@1620 40 # against uClibc. This indicates which host that compiler should run on.
rob@783 41 # Note that most x86_64 systems can run a statically linked i686 binary even
rob@944 42 # if they don't have the 32-bit libraries installed, so that's a good default.
rob@783 43
rob@1350 44 # export CROSS_COMPILER_HOST=i686
rob@783 45
rob@1130 46 # If this is set, only build a C compiler and not C++
rob@1130 47
rob@1130 48 # export NO_CPLUSPLUS=1
rob@1130 49
rob@1728 50 # What kind of root filesystem to create: ext2, rootfs (combined initramfs),
rob@1728 51 # cpio (separate initramfs), or squashfs. It defaults to cpio if blank.
rob@585 52
rob@1728 53 # export SYSIMAGE_TYPE=cpio
rob@585 54
rob@1553 55 # Size of writeable (ext2) HDA image. Does not apply to squashfs or initramfs
rob@616 56
rob@1347 57 # export SYSIMAGE_HDA_MEGS=2048
rob@616 58
rob@1620 59 # Comma separated list of packages to build from stable tarballs instead
rob@1620 60 # of source control repositories.
rob@623 61
rob@1553 62 # export IGNORE_REPOS=all
rob@623 63
rob@1061 64 # Use qemu to run "hello world" built by the cross compiler. Note that this
rob@1553 65 # requires working qemu application emulation for your target, which
rob@1620 66 # is significantly more brittle than system emulation. (To unbreak qemu-arm,
rob@1061 67 # "echo 0 > /proc/sys/vm/mmap_min_addr" as root.) You probably don't need
rob@1061 68 # to do this.
rob@654 69
rob@654 70 # export CROSS_SMOKE_TEST=1
rob@654 71
rob@1061 72 # If set, try downloading packages from this location first.
rob@399 73
rob@1620 74 # export PREFERRED_MIRROR=http://landley.net/aboriginal/mirror
rob@1175 75
rob@567 76 # Debugging option to leave source in build/temp-$ARCH after build.
rob@907 77
rob@567 78 # export NO_CLEANUP=1
rob@485 79
rob@675 80 # Don't create tarballs at the end of each stage.
rob@907 81
rob@988 82 # export NO_STAGE_TARBALLS=1
rob@675 83
rob@709 84 # Tell the linux kernel, uClibc, and busybox to show the actual build commands
rob@709 85 # instead of pretty-print output.
rob@709 86
rob@709 87 # export BUILD_VERBOSE=1
rob@762 88
rob@762 89 # Don't update the title bar in the display
rob@762 90
rob@762 91 # export NO_TITLE_BAR=1
rob@815 92
rob@815 93 # Create a tarball with the files installed by each individual package at
rob@815 94 # each stage of the build.
rob@815 95
rob@815 96 # export BINARY_PACKAGE_TARBALLS=1
mark@837 97
rob@856 98 # Set this if you want debug symbols in your binaries.
rob@854 99
rob@854 100 # export SKIP_STRIP=1
rob@854 101
rob@962 102 # Set this to tell download.sh to extract all the tarballs up-front right
rob@1620 103 # after downloading them. (Otherwise the tarball is extracted by setupfor
rob@962 104 # the first time the build tries to use it.)
rob@962 105 #
rob@962 106 # Extracting tarballs early is useful in order to run multiple build.sh
rob@962 107 # instances in parallel when building multiple targets, or to test that
rob@962 108 # new patches added to the sources/patches directory apply cleanly.
rob@962 109
rob@962 110 # export EXTRACT_ALL=1
rob@962 111
rob@1137 112 # If you build strange things (such as gcc 3.4 with binutils 2.14), you
rob@1620 113 # may need extra host binaries added to build/host. This lets you add them.
rob@1137 114 # In general, you don't want to do this.
rob@1137 115
rob@1137 116 # export HOST_EXTRA="lex yacc"
rob@1137 117
rob@1544 118 # Build with busybox defconfig instead of toybox.
rob@1477 119
rob@1544 120 # export BUSYBOX=1
rob@1477 121
rob@1098 122 # Set this to continue despite failed patches.
rob@1098 123
rob@1098 124 # export ALLOW_PATCH_FAILURE=1
rob@1098 125
rob@1181 126 # Build more things in parallel.
rob@1181 127
rob@1181 128 # export FORK=1
rob@1181 129
rob@1181 130 # Force a specific number of CPUs instead of autodetecting.
rob@1181 131
rob@1181 132 # export CPUS=1
rob@1181 133
rob@1620 134 # If set, list of packages to build with CPUS=1. (Faster than setting CPUS=1
rob@1200 135 # for the whole build if you know ahead of time which package is going to
rob@1620 136 # break.) Non-parallel builds give a more intelligent log output.
rob@1200 137
rob@1200 138 # export DEBUG_PACKAGE=bash,busybox
rob@1200 139
rob@856 140 # This isn't actually one of our variables, but a number of packages listen
rob@1620 141 # to this to add extra debug info to their binaries. (Use with SKIP_STRIP)
rob@856 142
rob@1045 143 # export CFLAGS="-g -pipe"
rob@1812 144
rob@1816 145 # The following paths supplement the build with additional site-specific data.
rob@1816 146 # Each path is either absolute or relative to the aboriginal topdir.
gsalmon@1814 147
gsalmon@1814 148 # If you have patches you want patch files outside the aboriginal
gsalmon@1814 149 # patch directory to be applied, supply the path here. Paths to the
rob@1816 150 # patches are built using the pattern ${MY_PATCH_DIR}/${PACKAGE}/*.patch
rob@1816 151 # so one or more patches to apply to linux could be in the
gsalmon@1814 152 # ${EXTERNAL_PATCH_DIR}/linux directory and will be applied in sorted
rob@1816 153 # order (after the builtin sources/patches/${PACKAGE}-*.patch files).
gsalmon@1814 154
rob@1816 155 # export MY_PATCH_DIR=/path/to/external/patches
rob@1816 156
rob@1816 157 # If this is set, it's points to a directory containing additional files to
rob@1816 158 # copy into the root-filesystem. (This overwrites existing conflicting files.)
rob@1816 159
rob@1816 160 # export MY_ROOT_OVERLAY="overlay"
rob@1816 161
rob@1816 162 # If you don't want to build cross compilers, supply path to existing one.
rob@1816 163 # Setting these tells build.sh not to build host or native compilers
rob@1816 164 # (the native compiler is very sensitive to libgcc build version skew).
rob@1816 165
rob@1816 166 # export MY_CROSS_PATH=/path/to/cross-compiler/bin
rob@1816 167 # export MY_CROSS_PREFIX=thingy-
rob@1816 168
rob@1816 169