annotate config @ 630:0e8a887f9d8b

buildall.sh should create the README file in the output directory.
author Rob Landley <rob@landley.net>
date Thu, 05 Mar 2009 12:25:19 -0600
parents 6f7f4d9011af
children 950ef7de1cf9
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
598
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
3 # This file is a place for you to set configuration values. This entire
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
4 # file is optional; by default all the variables documented in this file
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
5 # are left blank by the build. Feel free to replace this file with your
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
6 # own version, or to set these as environment variables on the command line.
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
7
598
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
8 # By default mini-native.sh will build a native toolchain (binutils, gcc,
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
9 # make, bash, distcc). Set this variable to "none" to skip all that, and
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
10 # build a root filesystem containing only uClibc and busybox. You can also
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
11 # set it to "headers" to retain the linux/uClibc kernel headers (in case you'd
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
12 # like to build your own native toolchain based on a different compiler).
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
13
598
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
14 # export NATIVE_TOOLCHAIN=none
496
3cebbc0b0723 Rename (invert) NATIVE_NOTOOLCHAIN and NATIVE_NOTOOLSDIR, and tweak colors again.
Rob Landley <rob@landley.net>
parents: 485
diff changeset
15 # export NATIVE_TOOLCHAIN=headers
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
598
5fa326c07bc4 Change NATIVE_TOOLCHAIN to work like all the other config variables: unset gives the default behavior.
Rob Landley <rob@landley.net>
parents: 585
diff changeset
17 # If this is set, mini-native will build a Linux From Scratch style /tools
496
3cebbc0b0723 Rename (invert) NATIVE_NOTOOLCHAIN and NATIVE_NOTOOLSDIR, and tweak colors again.
Rob Landley <rob@landley.net>
parents: 485
diff changeset
18 # directory instead of a more conventional filesystem layout in /usr.
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
496
3cebbc0b0723 Rename (invert) NATIVE_NOTOOLCHAIN and NATIVE_NOTOOLSDIR, and tweak colors again.
Rob Landley <rob@landley.net>
parents: 485
diff changeset
20 # export NATIVE_TOOLSDIR=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
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
22 # If this is set, the build records the command lines run by each build into
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
23 # log files in the build directory, ala "build/cmdlines.$PACKAGENAME"
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
24
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
25 # export RECORD_COMMANDS=1
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
26
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
27 # If this is set, the cross-compiler stage is compiled with --static.
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
28
506
defaef66dfae Get the name right.
Rob Landley <rob@landley.net>
parents: 498
diff changeset
29 # export CROSS_BUILD_STATIC=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
30
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
31 # This may be set by the target's "details" file, but you can override it here.
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
32 # You can set it to ext2, initramfs, or squashfs. It defaults to ext2 if blank.
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
33
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
34 # export SYSIMAGE_TYPE=ext2
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
35
616
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
36 # 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
37
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
38 # export SYSIMAGE_HDA_MEGS=64
a95cb8f13284 Add SYSIMAGE_HDA_MEGS config parameter (defaulting to 64).
Rob Landley <rob@landley.net>
parents: 598
diff changeset
39
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
40 # 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
41 # 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
42 # 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
43 # 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
44
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
45 # 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
46
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
47 # If this is set, try downloading packages from this location first.
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
48
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
49 # export PREFERRED_MIRROR=http://landley.net/code/firmware/mirror
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
50
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
51 # If this is set, the toybox utilities will take precedence over busybox ones.
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
52
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
53 # export USE_TOYBOX=1
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
54
567
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
55 # 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
56 # 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
57
567
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
58 # 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
59
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
60 # Debugging option to leave source in build/temp-$ARCH after build.
5619a7375b74 Add NO_CLEANUP option to config.
Rob Landley <rob@landley.net>
parents: 506
diff changeset
61 # 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
62
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
63 # If this is set, the output of the various stages will be color coded.
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
64 # export USE_COLOR=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
65
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
66 if [ ! -z "$USE_COLOR" ]
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
67 then
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
68
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
69 # If you'd like to change colors, do so here.
496
3cebbc0b0723 Rename (invert) NATIVE_NOTOOLCHAIN and NATIVE_NOTOOLSDIR, and tweak colors again.
Rob Landley <rob@landley.net>
parents: 485
diff changeset
70
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
71 # Black background
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
72 export BACKGROUND_COLOR="\e[40m"
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
73
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
74 export DOWNLOAD_COLOR="$BACKGROUND_COLOR\e[34m"
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
75 export HOST_COLOR="$BACKGROUND_COLOR\e[37m"
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
76 export CROSS_COLOR="$BACKGROUND_COLOR\e[33m"
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
77 export NATIVE_COLOR="$BACKGROUND_COLOR\e[35m"
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
78 export PACKAGE_COLOR="$BACKGROUND_COLOR\e[36m"
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
79 fi