annotate config @ 1816:fb05f99ffcce draft

Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR, MY_ROOT_OVERLAY, MY_CROSS_PATH and MY_CROSS_PREFIX.
author Rob Landley <rob@landley.net>
date Sat, 21 Nov 2015 16:44:39 -0600
parents 5ff5fea0ad7a
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
399
4e11cfb255e2 Break config out from include.sh, so environment variables users can edit to affect the build are collected together in one place with nothing else in it.
Rob Landley <rob@landley.net>
parents:
diff changeset
1 # Setup
4e11cfb255e2 Break config out from include.sh, so environment variables users can edit to affect the build are collected together in one place with nothing else in it.
Rob Landley <rob@landley.net>
parents:
diff changeset
2
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
3 # This file is sourced, not run. It provides a place for you to persistently
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
4 # set configuration variables.
399
4e11cfb255e2 Break config out from include.sh, so environment variables users can edit to affect the build are collected together in one place with nothing else in it.
Rob Landley <rob@landley.net>
parents:
diff changeset
5
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
6 # Feel free to replace this file with your own version, or to set these
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
7 # environment variables on the command line. By default all the variables
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
8 # listed in this file are left blank.
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
9
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
10 # This file is used by the whitelist logic to determine which variables to
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
11 # pass through when sanitizing the environment. Don't delete the commented
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
12 # out variables or they won't be passed through if you set them in the
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
13 # environment.
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
14
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
15 #############################################################################
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
16
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
17 # Set this if you don't want to drop all unrecognized environment variables.
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
18
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
19 # export NO_SANITIZE_ENVIRONMENT=1
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
20
1128
e5f9681a8b3c Lots of comment updates. Add a NO_HOST_TOOLS=1 config option, and a few "time" calls to stages that didn't have them. Put native-compiler.sh after root-filesystem.sh in build so it's slightly easier to document.
Rob Landley <rob@landley.net>
parents: 1116
diff changeset
21 # Setting this tells build.sh to use the existing $PATH commands to build
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
22 # everything, which probably won't work out of the box. Cross compiling is
1128
e5f9681a8b3c Lots of comment updates. Add a NO_HOST_TOOLS=1 config option, and a few "time" calls to stages that didn't have them. Put native-compiler.sh after root-filesystem.sh in build so it's slightly easier to document.
Rob Landley <rob@landley.net>
parents: 1116
diff changeset
23 # an insanely delicate process which requires a carefully configured host
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
24 # environment. If we don't set up our own, you'll have to supply one.
1128
e5f9681a8b3c Lots of comment updates. Add a NO_HOST_TOOLS=1 config option, and a few "time" calls to stages that didn't have them. Put native-compiler.sh after root-filesystem.sh in build so it's slightly easier to document.
Rob Landley <rob@landley.net>
parents: 1116
diff changeset
25
e5f9681a8b3c Lots of comment updates. Add a NO_HOST_TOOLS=1 config option, and a few "time" calls to stages that didn't have them. Put native-compiler.sh after root-filesystem.sh in build so it's slightly easier to document.
Rob Landley <rob@landley.net>
parents: 1116
diff changeset
26 # export NO_HOST_TOOLS=1
e5f9681a8b3c Lots of comment updates. Add a NO_HOST_TOOLS=1 config option, and a few "time" calls to stages that didn't have them. Put native-compiler.sh after root-filesystem.sh in build so it's slightly easier to document.
Rob Landley <rob@landley.net>
parents: 1116
diff changeset
27
1083
cb4dbdb7f2cd Make BUILD_STATIC take comma separated list of packages, or "all" or "none". Default behavior should remain the same.
Rob Landley <rob@landley.net>
parents: 1061
diff changeset
28 # Set this to a comma separated list of packages to build statically,
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
29 # or "none" to build all packages dynamically. Set to "all" to build all
1083
cb4dbdb7f2cd Make BUILD_STATIC take comma separated list of packages, or "all" or "none". Default behavior should remain the same.
Rob Landley <rob@landley.net>
parents: 1061
diff changeset
30 # packages statically (and not install static libraries on the target).
399
4e11cfb255e2 Break config out from include.sh, so environment variables users can edit to affect the build are collected together in one place with nothing else in it.
Rob Landley <rob@landley.net>
parents:
diff changeset
31
1083
cb4dbdb7f2cd Make BUILD_STATIC take comma separated list of packages, or "all" or "none". Default behavior should remain the same.
Rob Landley <rob@landley.net>
parents: 1061
diff changeset
32 # By default, busybox and the native compiler are built statically.
cb4dbdb7f2cd Make BUILD_STATIC take comma separated list of packages, or "all" or "none". Default behavior should remain the same.
Rob Landley <rob@landley.net>
parents: 1061
diff changeset
33 # (Using a static busybox on the target provides a 20% performance boost to
cb4dbdb7f2cd Make BUILD_STATIC take comma separated list of packages, or "all" or "none". Default behavior should remain the same.
Rob Landley <rob@landley.net>
parents: 1061
diff changeset
34 # autoconf under qemu, and building the native compiler static makes it much
cb4dbdb7f2cd Make BUILD_STATIC take comma separated list of packages, or "all" or "none". Default behavior should remain the same.
Rob Landley <rob@landley.net>
parents: 1061
diff changeset
35 # more portable to other target root filesystems.)
865
15522b490e53 Build busybox static by default (but not for host-tools.sh, since static glibc is buggy, and let .config to switch it off).
Rob Landley <rob@landley.net>
parents: 862
diff changeset
36
1800
60d648f342ab Update config comment to show correct defaults.
Rob Landley <rob@landley.net>
parents: 1728
diff changeset
37 # export BUILD_STATIC=busybox,toybox,binutils,gcc-core,gcc-g++,make
399
4e11cfb255e2 Break config out from include.sh, so environment variables users can edit to affect the build are collected together in one place with nothing else in it.
Rob Landley <rob@landley.net>
parents:
diff changeset
38
944
fc134a13357e Largeish refactoring and cleanup of compiler build:
Rob Landley <rob@landley.net>
parents: 907
diff changeset
39 # If this is set, build.sh will build a cross compiler statically linked
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
40 # against uClibc. This indicates which host that compiler should run on.
783
db06a8c1bfed Lots of changes to move buildall.sh functionality into build.sh.
Rob Landley <rob@landley.net>
parents: 762
diff changeset
41 # Note that most x86_64 systems can run a statically linked i686 binary even
944
fc134a13357e Largeish refactoring and cleanup of compiler build:
Rob Landley <rob@landley.net>
parents: 907
diff changeset
42 # if they don't have the 32-bit libraries installed, so that's a good default.
783
db06a8c1bfed Lots of changes to move buildall.sh functionality into build.sh.
Rob Landley <rob@landley.net>
parents: 762
diff changeset
43
1350
7eabfa815c90 Split up system-image.sh into root-image.sh, linux-kernel.sh, and system-image.sh. Rename CROSS_HOST_ARCH to CROSS_COMPILER_HOST.
Rob Landley <rob@landley.net>
parents: 1349
diff changeset
44 # export CROSS_COMPILER_HOST=i686
783
db06a8c1bfed Lots of changes to move buildall.sh functionality into build.sh.
Rob Landley <rob@landley.net>
parents: 762
diff changeset
45
1130
c222ae88733a Add NO_CPLUSPLUS config option, to skip c++ support entirely.
Rob Landley <rob@landley.net>
parents: 1128
diff changeset
46 # If this is set, only build a C compiler and not C++
c222ae88733a Add NO_CPLUSPLUS config option, to skip c++ support entirely.
Rob Landley <rob@landley.net>
parents: 1128
diff changeset
47
c222ae88733a Add NO_CPLUSPLUS config option, to skip c++ support entirely.
Rob Landley <rob@landley.net>
parents: 1128
diff changeset
48 # export NO_CPLUSPLUS=1
c222ae88733a Add NO_CPLUSPLUS config option, to skip c++ support entirely.
Rob Landley <rob@landley.net>
parents: 1128
diff changeset
49
1728
b89324905ca2 Giant redo to put simple-root-filesystem in initmpfs.
Rob Landley <rob@landley.net>
parents: 1727
diff changeset
50 # What kind of root filesystem to create: ext2, rootfs (combined initramfs),
b89324905ca2 Giant redo to put simple-root-filesystem in initmpfs.
Rob Landley <rob@landley.net>
parents: 1727
diff changeset
51 # cpio (separate initramfs), or squashfs. It defaults to cpio if blank.
585
dd03aa5996e6 Two more $ARCH->$ARCH_NAME changes for hw- targets, add another example to config, and make hw-wrt610n build.
Rob Landley <rob@landley.net>
parents: 567
diff changeset
52
1728
b89324905ca2 Giant redo to put simple-root-filesystem in initmpfs.
Rob Landley <rob@landley.net>
parents: 1727
diff changeset
53 # export SYSIMAGE_TYPE=cpio
585
dd03aa5996e6 Two more $ARCH->$ARCH_NAME changes for hw- targets, add another example to config, and make hw-wrt610n build.
Rob Landley <rob@landley.net>
parents: 567
diff changeset
54
1553
da21ff27331e Add ability to check out repositories in packages, IGNORE_REPOS to build from tarballs anyway, a FAQ entry on it, and more/repo.sh to set up/update some of the common ones.
Rob Landley <rob@landley.net>
parents: 1552
diff changeset
55 # Size of writeable (ext2) HDA image. Does not apply to squashfs or initramfs
616
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
56
1347
8a0a65d7a072 Change SYSIMAGE_HDA_MEGS default to 2 gigs: it only applies to ext2 and if you're specifying that you probably want some scratch space.
Rob Landley <rob@landley.net>
parents: 1342
diff changeset
57 # export SYSIMAGE_HDA_MEGS=2048
616
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
58
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
59 # Comma separated list of packages to build from stable tarballs instead
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
60 # of source control repositories.
623
6f7f4d9011af Add SNAPSHOT_SYMLINK option so extracted source packages can live in a different filesystem than the build directory.
Rob Landley <rob@landley.net>
parents: 616
diff changeset
61
1553
da21ff27331e Add ability to check out repositories in packages, IGNORE_REPOS to build from tarballs anyway, a FAQ entry on it, and more/repo.sh to set up/update some of the common ones.
Rob Landley <rob@landley.net>
parents: 1552
diff changeset
62 # export IGNORE_REPOS=all
623
6f7f4d9011af Add SNAPSHOT_SYMLINK option so extracted source packages can live in a different filesystem than the build directory.
Rob Landley <rob@landley.net>
parents: 616
diff changeset
63
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
64 # Use qemu to run "hello world" built by the cross compiler. Note that this
1553
da21ff27331e Add ability to check out repositories in packages, IGNORE_REPOS to build from tarballs anyway, a FAQ entry on it, and more/repo.sh to set up/update some of the common ones.
Rob Landley <rob@landley.net>
parents: 1552
diff changeset
65 # requires working qemu application emulation for your target, which
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
66 # is significantly more brittle than system emulation. (To unbreak qemu-arm,
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
67 # "echo 0 > /proc/sys/vm/mmap_min_addr" as root.) You probably don't need
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
68 # to do this.
654
fa2498e3b3c9 Make a config option for the cross compiler smoke test. The problem is that recent kernel upgrades broke qemu-arm (application emulation, not system emulation), so it can't run anything unless you "echo 0 > /proc/sys/vm/mmap_min_addr" as root. Fun.
Rob Landley <rob@landley.net>
parents: 649
diff changeset
69
fa2498e3b3c9 Make a config option for the cross compiler smoke test. The problem is that recent kernel upgrades broke qemu-arm (application emulation, not system emulation), so it can't run anything unless you "echo 0 > /proc/sys/vm/mmap_min_addr" as root. Fun.
Rob Landley <rob@landley.net>
parents: 649
diff changeset
70 # export CROSS_SMOKE_TEST=1
fa2498e3b3c9 Make a config option for the cross compiler smoke test. The problem is that recent kernel upgrades broke qemu-arm (application emulation, not system emulation), so it can't run anything unless you "echo 0 > /proc/sys/vm/mmap_min_addr" as root. Fun.
Rob Landley <rob@landley.net>
parents: 649
diff changeset
71
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
72 # If set, try downloading packages from this location first.
399
4e11cfb255e2 Break config out from include.sh, so environment variables users can edit to affect the build are collected together in one place with nothing else in it.
Rob Landley <rob@landley.net>
parents:
diff changeset
73
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
74 # export PREFERRED_MIRROR=http://landley.net/aboriginal/mirror
1175
886a2ea90bc1 Add sanitize_environment to unset unrecognized environment variables.
Rob Landley <rob@landley.net>
parents: 1174
diff changeset
75
567
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
76 # Debugging option to leave source in build/temp-$ARCH after build.
907
890aa372ee30 Remove old USE_COLOR code, superceded by set_titlebar.
Rob Landley <rob@landley.net>
parents: 906
diff changeset
77
567
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
78 # export NO_CLEANUP=1
485
b0438691e9e1 Move color selection into ./config. (The default colors don't look great on a white background.)
Rob Landley <rob@landley.net>
parents: 482
diff changeset
79
675
4571f63c2298 Add SKIP_STAGE_TARBALLS config option to skip creating tarballs after each stage.
Rob Landley <rob@landley.net>
parents: 654
diff changeset
80 # Don't create tarballs at the end of each stage.
907
890aa372ee30 Remove old USE_COLOR code, superceded by set_titlebar.
Rob Landley <rob@landley.net>
parents: 906
diff changeset
81
988
30e4bab11f9e Rename SKIP_STAGE_TARBALLS to NO_STAGE_TARBALLS (for consistency), and make system-image.sh use it instead of doing it by hand.
Rob Landley <rob@landley.net>
parents: 962
diff changeset
82 # export NO_STAGE_TARBALLS=1
675
4571f63c2298 Add SKIP_STAGE_TARBALLS config option to skip creating tarballs after each stage.
Rob Landley <rob@landley.net>
parents: 654
diff changeset
83
709
64cc63ad26ce Add BUILD_VERBOSE config option.
Rob Landley <rob@landley.net>
parents: 689
diff changeset
84 # Tell the linux kernel, uClibc, and busybox to show the actual build commands
64cc63ad26ce Add BUILD_VERBOSE config option.
Rob Landley <rob@landley.net>
parents: 689
diff changeset
85 # instead of pretty-print output.
64cc63ad26ce Add BUILD_VERBOSE config option.
Rob Landley <rob@landley.net>
parents: 689
diff changeset
86
64cc63ad26ce Add BUILD_VERBOSE config option.
Rob Landley <rob@landley.net>
parents: 689
diff changeset
87 # export BUILD_VERBOSE=1
762
879cf963cdbb Add option to disable title bar display updates.
Rob Landley <rob@landley.net>
parents: 731
diff changeset
88
879cf963cdbb Add option to disable title bar display updates.
Rob Landley <rob@landley.net>
parents: 731
diff changeset
89 # Don't update the title bar in the display
879cf963cdbb Add option to disable title bar display updates.
Rob Landley <rob@landley.net>
parents: 731
diff changeset
90
879cf963cdbb Add option to disable title bar display updates.
Rob Landley <rob@landley.net>
parents: 731
diff changeset
91 # export NO_TITLE_BAR=1
815
8129df56091b Extended setupfor/cleanup to create binary package tarballs if the configure option BINARY_PACKAGE_TARBALLS is set. These tarballs extract into the current directory and add all the changed files installed by this package build, so you can pick and choose when assembling your own filesystem.
Rob Landley <rob@landley.net>
parents: 783
diff changeset
92
8129df56091b Extended setupfor/cleanup to create binary package tarballs if the configure option BINARY_PACKAGE_TARBALLS is set. These tarballs extract into the current directory and add all the changed files installed by this package build, so you can pick and choose when assembling your own filesystem.
Rob Landley <rob@landley.net>
parents: 783
diff changeset
93 # Create a tarball with the files installed by each individual package at
8129df56091b Extended setupfor/cleanup to create binary package tarballs if the configure option BINARY_PACKAGE_TARBALLS is set. These tarballs extract into the current directory and add all the changed files installed by this package build, so you can pick and choose when assembling your own filesystem.
Rob Landley <rob@landley.net>
parents: 783
diff changeset
94 # each stage of the build.
8129df56091b Extended setupfor/cleanup to create binary package tarballs if the configure option BINARY_PACKAGE_TARBALLS is set. These tarballs extract into the current directory and add all the changed files installed by this package build, so you can pick and choose when assembling your own filesystem.
Rob Landley <rob@landley.net>
parents: 783
diff changeset
95
8129df56091b Extended setupfor/cleanup to create binary package tarballs if the configure option BINARY_PACKAGE_TARBALLS is set. These tarballs extract into the current directory and add all the changed files installed by this package build, so you can pick and choose when assembling your own filesystem.
Rob Landley <rob@landley.net>
parents: 783
diff changeset
96 # export BINARY_PACKAGE_TARBALLS=1
837
f80c47e8991d Abstract the C library away from uClibc, so when more build sections are added potentially (For glibc, eglibc, et cetera), nothing needs to be changed in the other files
Mark Miller <mark@mirell.org>
parents: 815
diff changeset
97
856
733f42839bfb Add CFLAGS example to config.
Rob Landley <rob@landley.net>
parents: 854
diff changeset
98 # Set this if you want debug symbols in your binaries.
854
3794d9a0be4c Add SKIP_STRIP configuration option to do what it says on the tin, and stop blanking CFLAGS and CFLAGSXX so "export CFLAGS=-g" can pass through to package builds.
Rob Landley <rob@landley.net>
parents: 837
diff changeset
99
3794d9a0be4c Add SKIP_STRIP configuration option to do what it says on the tin, and stop blanking CFLAGS and CFLAGSXX so "export CFLAGS=-g" can pass through to package builds.
Rob Landley <rob@landley.net>
parents: 837
diff changeset
100 # export SKIP_STRIP=1
3794d9a0be4c Add SKIP_STRIP configuration option to do what it says on the tin, and stop blanking CFLAGS and CFLAGSXX so "export CFLAGS=-g" can pass through to package builds.
Rob Landley <rob@landley.net>
parents: 837
diff changeset
101
962
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
102 # Set this to tell download.sh to extract all the tarballs up-front right
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
103 # after downloading them. (Otherwise the tarball is extracted by setupfor
962
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
104 # the first time the build tries to use it.)
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
105 #
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
106 # Extracting tarballs early is useful in order to run multiple build.sh
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
107 # instances in parallel when building multiple targets, or to test that
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
108 # new patches added to the sources/patches directory apply cleanly.
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
109
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
110 # export EXTRACT_ALL=1
3d2261361009 Remove the --extract option from download.sh, since EXTRACT_ALL=1 does the same thing and everything _else_ is controlled by environment variables. At it to the config file and adjust existing users.
Rob Landley <rob@landley.net>
parents: 944
diff changeset
111
1137
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
112 # If you build strange things (such as gcc 3.4 with binutils 2.14), you
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
113 # may need extra host binaries added to build/host. This lets you add them.
1137
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
114 # In general, you don't want to do this.
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
115
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
116 # export HOST_EXTRA="lex yacc"
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
117
1544
e2f722cc97a6 Make busybox build by default, switch override knob to BUSYBOX=1 to use defconfig busybox, always use toybox for oneit, cleanup/fix record-commands logic.
Rob Landley <rob@landley.net>
parents: 1477
diff changeset
118 # Build with busybox defconfig instead of toybox.
1477
431d5b4ee537 Switch from busybox defconfig to baseconfig-busybox selecting just what we need, with a config variable to use defconfig instead if you really want that.
Rob Landley <rob@landley.net>
parents: 1461
diff changeset
119
1544
e2f722cc97a6 Make busybox build by default, switch override knob to BUSYBOX=1 to use defconfig busybox, always use toybox for oneit, cleanup/fix record-commands logic.
Rob Landley <rob@landley.net>
parents: 1477
diff changeset
120 # export BUSYBOX=1
1477
431d5b4ee537 Switch from busybox defconfig to baseconfig-busybox selecting just what we need, with a config variable to use defconfig instead if you really want that.
Rob Landley <rob@landley.net>
parents: 1461
diff changeset
121
1098
8f72a8d4acc3 Add ALLOW_PATCH_FAILURE config switch to continue despite failed patches.
Rob Landley <rob@landley.net>
parents: 1083
diff changeset
122 # Set this to continue despite failed patches.
8f72a8d4acc3 Add ALLOW_PATCH_FAILURE config switch to continue despite failed patches.
Rob Landley <rob@landley.net>
parents: 1083
diff changeset
123
8f72a8d4acc3 Add ALLOW_PATCH_FAILURE config switch to continue despite failed patches.
Rob Landley <rob@landley.net>
parents: 1083
diff changeset
124 # export ALLOW_PATCH_FAILURE=1
8f72a8d4acc3 Add ALLOW_PATCH_FAILURE config switch to continue despite failed patches.
Rob Landley <rob@landley.net>
parents: 1083
diff changeset
125
1181
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
126 # Build more things in parallel.
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
127
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
128 # export FORK=1
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
129
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
130 # Force a specific number of CPUs instead of autodetecting.
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
131
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
132 # export CPUS=1
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
133
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
134 # If set, list of packages to build with CPUS=1. (Faster than setting CPUS=1
1200
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
135 # for the whole build if you know ahead of time which package is going to
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
136 # break.) Non-parallel builds give a more intelligent log output.
1200
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
137
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
138 # export DEBUG_PACKAGE=bash,busybox
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
139
856
733f42839bfb Add CFLAGS example to config.
Rob Landley <rob@landley.net>
parents: 854
diff changeset
140 # This isn't actually one of our variables, but a number of packages listen
1620
3c9b927b9da8 Refresh documentation.
Rob Landley <rob@landley.net>
parents: 1553
diff changeset
141 # to this to add extra debug info to their binaries. (Use with SKIP_STRIP)
856
733f42839bfb Add CFLAGS example to config.
Rob Landley <rob@landley.net>
parents: 854
diff changeset
142
1045
a5b0f0a11792 Add BUILD_RW_SYSTEM_IMAGE=1 config option to build 2 gig writeable HDA (new stage named rw-system-image-$ARCH).
Rob Landley <rob@landley.net>
parents: 988
diff changeset
143 # export CFLAGS="-g -pipe"
1812
acaa88463c0c Add CROSS_COMPILER_PATH and CC_PREFIX knobs.
Rob Landley <rob@landley.net>
parents: 1811
diff changeset
144
1816
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
145 # The following paths supplement the build with additional site-specific data.
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
146 # Each path is either absolute or relative to the aboriginal topdir.
1814
5ff5fea0ad7a Add EXTERNAL_PATCH_DIR option for applying patches from outside aboriginal
Geoff Salmon <gsalmon@se-instruments.com>
parents: 1812
diff changeset
147
5ff5fea0ad7a Add EXTERNAL_PATCH_DIR option for applying patches from outside aboriginal
Geoff Salmon <gsalmon@se-instruments.com>
parents: 1812
diff changeset
148 # If you have patches you want patch files outside the aboriginal
5ff5fea0ad7a Add EXTERNAL_PATCH_DIR option for applying patches from outside aboriginal
Geoff Salmon <gsalmon@se-instruments.com>
parents: 1812
diff changeset
149 # patch directory to be applied, supply the path here. Paths to the
1816
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
150 # patches are built using the pattern ${MY_PATCH_DIR}/${PACKAGE}/*.patch
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
151 # so one or more patches to apply to linux could be in the
1814
5ff5fea0ad7a Add EXTERNAL_PATCH_DIR option for applying patches from outside aboriginal
Geoff Salmon <gsalmon@se-instruments.com>
parents: 1812
diff changeset
152 # ${EXTERNAL_PATCH_DIR}/linux directory and will be applied in sorted
1816
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
153 # order (after the builtin sources/patches/${PACKAGE}-*.patch files).
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
154
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
155 # export MY_PATCH_DIR=/path/to/external/patches
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
156
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
157 # If this is set, it's points to a directory containing additional files to
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
158 # copy into the root-filesystem. (This overwrites existing conflicting files.)
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
159
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
160 # export MY_ROOT_OVERLAY="overlay"
1814
5ff5fea0ad7a Add EXTERNAL_PATCH_DIR option for applying patches from outside aboriginal
Geoff Salmon <gsalmon@se-instruments.com>
parents: 1812
diff changeset
161
1816
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
162 # If you don't want to build cross compilers, supply path to existing one.
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
163 # Setting these tells build.sh not to build host or native compilers
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
164 # (the native compiler is very sensitive to libgcc build version skew).
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
165
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
166 # export MY_CROSS_PATH=/path/to/cross-compiler/bin
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
167 # export MY_CROSS_PREFIX=thingy-
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
168
fb05f99ffcce Collate site-local variables under "MY_XXX" prefix: MY_PATCH_DIR,
Rob Landley <rob@landley.net>
parents: 1814
diff changeset
169