annotate config @ 1228:8a88cae14011

Remove RW_SYSTEM_IMAGE option. The gentoo-stage1 build shows how to setup a writeable chroot, and the FAQ says how to build a writeable system image. I'm not shipping two different system iamges, then I'd have to explain it and it's not worth the confusion.
author Rob Landley <rob@landley.net>
date Tue, 24 Aug 2010 02:53:11 -0500
parents 8651437b2b44
children 313c702a0984
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
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
3 # This file is sourced, not run. It provides a place for you to persisently
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
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
7 # environment variables on the command line. This entire file is optional;
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
8 # by default all the variables listed in this file are left blank.
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
9
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
10 #############################################################################
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
11
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
12 # Seting this tells build.sh not to build a native toolchain. (This yields
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
13 # a much smaller root-filesystem tarball.)
498
e4f6da942dbf Make colors no longer be the default (adding a guard for the lot of 'em), and tweak NATIVE_TOOLCHAIN setting so it's more clear.
Rob Landley <rob@landley.net>
parents: 496
diff changeset
14
944
fc134a13357e Largeish refactoring and cleanup of compiler build:
Rob Landley <rob@landley.net>
parents: 907
diff changeset
15 # export NO_NATIVE_COMPILER=1
482
3e9d715e4a11 Rename CROSS_BUILD_STATIC, NATIVE_NOTOOLSDIR, NATIVE_NOTOOLCHAIN and make them work properly.
Rob Landley <rob@landley.net>
parents: 430
diff changeset
16
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
17 # Setting this tells root-filesystem.sh not to create the normal directory
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
18 # hierarchy of /usr, /tmp, /etc, and so on.
482
3e9d715e4a11 Rename CROSS_BUILD_STATIC, NATIVE_NOTOOLSDIR, NATIVE_NOTOOLCHAIN and make them work properly.
Rob Landley <rob@landley.net>
parents: 430
diff changeset
19
783
db06a8c1bfed Lots of changes to move buildall.sh functionality into build.sh.
Rob Landley <rob@landley.net>
parents: 762
diff changeset
20 # export ROOT_NODIRS=1
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
21
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
22 # Setting this tells build.sh to use the existing $PATH commands to build
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 # everything, which probably won't work out of the box. Cross compiling is
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
24 # an insanely delicate process which requires a carefully configured host
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 # environment. If we don't set up our own, you'll have to supply one.
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
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 # 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
28
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
29 # Set this to a comma separated list of packages to build 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
30 # or "none" to build all packages dynamically. Set to "all" to build all
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
31 # 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
32
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
33 # 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
34 # (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
35 # 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
36 # 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
37
1174
5061606337d0 Add "make" to the default static list, for native-compiler tarball portability. (If you haven't got make working, it's hard to build it.)
Rob Landley <rob@landley.net>
parents: 1151
diff changeset
38 # export BUILD_STATIC=busybox,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
39
944
fc134a13357e Largeish refactoring and cleanup of compiler build:
Rob Landley <rob@landley.net>
parents: 907
diff changeset
40 # If this is set, build.sh will build a cross compiler statically linked
783
db06a8c1bfed Lots of changes to move buildall.sh functionality into build.sh.
Rob Landley <rob@landley.net>
parents: 762
diff changeset
41 # against uClibc. This indicates which host that compiler should run on.
db06a8c1bfed Lots of changes to move buildall.sh functionality into build.sh.
Rob Landley <rob@landley.net>
parents: 762
diff changeset
42 # 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
43 # 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
44
1116
2b68517f5b62 Break out simple-root-filesystem.sh and root-filesystem.sh (adding native-compiler.sh output), and use NO_NATIVE_COMPILER to determine which to use. Rename STATIC_CC_HOST to CROSS_HOST_ARCH.
Rob Landley <rob@landley.net>
parents: 1098
diff changeset
45 # export CROSS_HOST_ARCH=i686
783
db06a8c1bfed Lots of changes to move buildall.sh functionality into build.sh.
Rob Landley <rob@landley.net>
parents: 762
diff changeset
46
1130
c222ae88733a Add NO_CPLUSPLUS config option, to skip c++ support entirely.
Rob Landley <rob@landley.net>
parents: 1128
diff changeset
47 # 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
48
c222ae88733a Add NO_CPLUSPLUS config option, to skip c++ support entirely.
Rob Landley <rob@landley.net>
parents: 1128
diff changeset
49 # export NO_CPLUSPLUS=1
c222ae88733a Add NO_CPLUSPLUS config option, to skip c++ support entirely.
Rob Landley <rob@landley.net>
parents: 1128
diff changeset
50
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
51 # This may be set by the target's "details" file, but you can override it here.
731
545f5665835b Documentation tweak.
Rob Landley <rob@landley.net>
parents: 714
diff changeset
52 # You can set it to ext2, initramfs, or squashfs. It defaults to squashfs
545f5665835b Documentation tweak.
Rob Landley <rob@landley.net>
parents: 714
diff changeset
53 # 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
54
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
55 # export SYSIMAGE_TYPE=squashfs
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
56
616
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
57 # Size of writeable HDA image (if any), defaults to 64 megs
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
58
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
59 # export SYSIMAGE_HDA_MEGS=64
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
60
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 # Set this to use symlinks instead of hard links when creating temporary copies
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
62 # of the source packages (in setupfor). This is slower and uses more inodes,
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 # but allows the extracted source packages to live in a different filesystem
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
64 # than the build directory.
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
65
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
66 # export SNAPSHOT_SYMLINK=1
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
67
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
68 # Use qemu to run "hello world" built by the cross compiler. Note that this
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
69 # requires working qemu application emulation for your target to do this, which
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
70 # is significantly more brittle than system emulation. (To unbreak qemu-arm,
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
71 # "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
72 # 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
73
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
74 # 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
75
1061
c3cb63262c40 Comment/documentation updates.
Rob Landley <rob@landley.net>
parents: 1045
diff changeset
76 # 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
77
649
950ef7de1cf9 Add qemu to host-tools.sh. If HOST_BUILD_EXTRA set, compile from source, otherwise symlink it from host. (Note that ppc --nographic and sh4 --append are currently broken in host version of qemu.)
Rob Landley <rob@landley.net>
parents: 623
diff changeset
78 # export PREFERRED_MIRROR=http://impactlinux.com/fml/mirror
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
79
1175
886a2ea90bc1 Add sanitize_environment to unset unrecognized environment variables.
Rob Landley <rob@landley.net>
parents: 1174
diff changeset
80 # Set this if you don't want to drop all unrecognized environment variables.
886a2ea90bc1 Add sanitize_environment to unset unrecognized environment variables.
Rob Landley <rob@landley.net>
parents: 1174
diff changeset
81
886a2ea90bc1 Add sanitize_environment to unset unrecognized environment variables.
Rob Landley <rob@landley.net>
parents: 1174
diff changeset
82 # NO_SANITIZE_ENVIRONMENT=1
886a2ea90bc1 Add sanitize_environment to unset unrecognized environment variables.
Rob Landley <rob@landley.net>
parents: 1174
diff changeset
83
567
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
84 # Try development versions of these packages. (Know what you're doing if
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
85 # you select these, it's quite possible the result won't work.)
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
86
567
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
87 # export USE_UNSTABLE=uClibc,busybox,toybox,linux,binutils,make,gcc-core,gcc-g++
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
88
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
89 # 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
90
567
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
91 # 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
92
675
4571f63c2298 Add SKIP_STAGE_TARBALLS config option to skip creating tarballs after each stage.
Rob Landley <rob@landley.net>
parents: 654
diff changeset
93 # 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
94
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
95 # 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
96
709
64cc63ad26ce Add BUILD_VERBOSE config option.
Rob Landley <rob@landley.net>
parents: 689
diff changeset
97 # 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
98 # instead of pretty-print output.
64cc63ad26ce Add BUILD_VERBOSE config option.
Rob Landley <rob@landley.net>
parents: 689
diff changeset
99
64cc63ad26ce Add BUILD_VERBOSE config option.
Rob Landley <rob@landley.net>
parents: 689
diff changeset
100 # export BUILD_VERBOSE=1
762
879cf963cdbb Add option to disable title bar display updates.
Rob Landley <rob@landley.net>
parents: 731
diff changeset
101
879cf963cdbb Add option to disable title bar display updates.
Rob Landley <rob@landley.net>
parents: 731
diff changeset
102 # 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
103
879cf963cdbb Add option to disable title bar display updates.
Rob Landley <rob@landley.net>
parents: 731
diff changeset
104 # 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
105
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
106 # 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
107 # 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
108
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
109 # 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
110
856
733f42839bfb Add CFLAGS example to config.
Rob Landley <rob@landley.net>
parents: 854
diff changeset
111 # 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
112
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
113 # 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
114
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
115 # Set this to tell download.sh to extract all the tarballs up-front right
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
116 # after downloading them. (Otherwise the tarball is extracted by setupfor
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
117 # 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
118 #
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
119 # 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
120 # 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
121 # 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
122
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
123 # 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
124
1137
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
125 # If you build strange things (such as gcc 3.4 with binutils 2.14), you
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
126 # may need extra host binaries added to build/host. This lets you add them.
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
127 # 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
128
8a0b2268c8ca Add HOST_EXTRA. Using it is a horrible idea, please don't.
Rob Landley <rob@landley.net>
parents: 1130
diff changeset
129 # 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
130
1098
8f72a8d4acc3 Add ALLOW_PATCH_FAILURE config switch to continue despite failed patches.
Rob Landley <rob@landley.net>
parents: 1083
diff changeset
131 # 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
132
8f72a8d4acc3 Add ALLOW_PATCH_FAILURE config switch to continue despite failed patches.
Rob Landley <rob@landley.net>
parents: 1083
diff changeset
133 # 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
134
1151
b55c80be32b6 Add SIMPLE_ROOT_OVERLAY.
Rob Landley <rob@landley.net>
parents: 1137
diff changeset
135 # If this is set, it's points to a directory containing additional files to
b55c80be32b6 Add SIMPLE_ROOT_OVERLAY.
Rob Landley <rob@landley.net>
parents: 1137
diff changeset
136 # copy into the simple-root-filesystem. The path is either absolute or
b55c80be32b6 Add SIMPLE_ROOT_OVERLAY.
Rob Landley <rob@landley.net>
parents: 1137
diff changeset
137 # relavitve to the aboriginal topdir.
b55c80be32b6 Add SIMPLE_ROOT_OVERLAY.
Rob Landley <rob@landley.net>
parents: 1137
diff changeset
138
b55c80be32b6 Add SIMPLE_ROOT_OVERLAY.
Rob Landley <rob@landley.net>
parents: 1137
diff changeset
139 # export SIMPLE_ROOT_OVERLAY="overlay"
b55c80be32b6 Add SIMPLE_ROOT_OVERLAY.
Rob Landley <rob@landley.net>
parents: 1137
diff changeset
140
1181
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
141 # Build more things in parallel.
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
142
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
143 # export FORK=1
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
144
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
145 # 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
146
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
147 # export CPUS=1
0cc86c6680ac List more environment variables sanitizing shouldn't drop.
Rob Landley <rob@landley.net>
parents: 1175
diff changeset
148
1200
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
149 # If set, list of packages to build with CPUS=1. (Faster than setting CPUS=1
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
150 # for the whole build if you know ahead of time which package is going to
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
151 # break.)
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
152
8651437b2b44 Add DEBUG_PACKAGE config variable to build just one package with CPUS=1.
Rob Landley <rob@landley.net>
parents: 1199
diff changeset
153 # 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
154
856
733f42839bfb Add CFLAGS example to config.
Rob Landley <rob@landley.net>
parents: 854
diff changeset
155 # This isn't actually one of our variables, but a number of packages listen
733f42839bfb Add CFLAGS example to config.
Rob Landley <rob@landley.net>
parents: 854
diff changeset
156 # to this to add extra debug info to their binaries. (Use with SKIP_STRIP)
733f42839bfb Add CFLAGS example to config.
Rob Landley <rob@landley.net>
parents: 854
diff changeset
157
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
158 # export CFLAGS="-g -pipe"