annotate sources/README @ 1398:b74d36876c0a

Replace read_arch_dir with load_target, which understands that sources/targets/$TARGET can be a file or a directory.
author Rob Landley <rob@landley.net>
date Sun, 26 Jun 2011 17:44:02 -0500
parents 7d086d8fa348
children aabc07905de3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
1 The following files live here:
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
2
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
3 include.sh: Common code included by every build stage. Defines many
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
4 environment variables, and sources the various *functions.sh.
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
5
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
6 functions.sh: Shell functions internal to Aboriginal Linux.
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
7
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
8 utility-functions.sh: Functions usable in contexts other than the Aboriginal
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
9 Linux build.
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
10
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
11 download-functions.sh: Functions to manage package source. (Download
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
12 tarballs, confirm checksums, extract and apply
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
13 patches, manage package cache.)
966
bd2ea96aac53 Update READMEs.
Rob Landley <rob@landley.net>
parents: 888
diff changeset
14
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
15 timeout.sh: Wrapper to run a command line with a timeout.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
16
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
17 baseconfig-linux: Common miniconfig shared by most architectures, to which
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
18 $LINUX_CONFIG from the target/$ARCH/settings is appended.
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
19
871
b274eb556b50 Merge common uclibc miniconfig stuff into baseconfig-uClibc, and add the few lines that vary per target to each target's settings file.
Rob Landley <rob@landley.net>
parents: 858
diff changeset
20 baseconfig-uClibc: Common miniconfig shared by all architectures, to which
b274eb556b50 Merge common uclibc miniconfig stuff into baseconfig-uClibc, and add the few lines that vary per target to each target's settings file.
Rob Landley <rob@landley.net>
parents: 858
diff changeset
21 $UCLIBC_CONFIG from the target/$ARCH/settings is appended.
b274eb556b50 Merge common uclibc miniconfig stuff into baseconfig-uClibc, and add the few lines that vary per target to each target's settings file.
Rob Landley <rob@landley.net>
parents: 858
diff changeset
22
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
23 The following subdirectories live here:
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
24
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
25 native: Files copied verbatim into each architecture's root-filesystem image.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
26
888
626288dd5cf3 Lots of comments.
Rob Landley <rob@landley.net>
parents: 871
diff changeset
27 toys: Various small code snippets written or maintained for this project.
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
28
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
29 sections: Package build scripts called more than once during build.sh.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
30 This is duplicate code factored out into a common location.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
31
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
32 patches: Patches applied to the packages listed in download.sh by "setupfor".
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
33 Each package has "$PACKAGE-*.patch" applied in alphabetical order,
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
34 or "alt-$PACKAGE-*.patch" for USE_UNSTABLE versions.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
35
1398
b74d36876c0a Replace read_arch_dir with load_target, which understands that sources/targets/$TARGET can be a file or a directory.
Rob Landley <rob@landley.net>
parents: 1315
diff changeset
36 targets: Configuration for each target platform, parsed by load_target()
b74d36876c0a Replace read_arch_dir with load_target, which understands that sources/targets/$TARGET can be a file or a directory.
Rob Landley <rob@landley.net>
parents: 1315
diff changeset
37 and getconfig() in functions.sh. Each entry is a target name,
b74d36876c0a Replace read_arch_dir with load_target, which understands that sources/targets/$TARGET can be a file or a directory.
Rob Landley <rob@landley.net>
parents: 1315
diff changeset
38 either a self-contained script setting configuration information,
b74d36876c0a Replace read_arch_dir with load_target, which understands that sources/targets/$TARGET can be a file or a directory.
Rob Landley <rob@landley.net>
parents: 1315
diff changeset
39 or else a directory containing:
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
40
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
41 settings: Environment variables needed by the build.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
42
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
43 miniconfig-linux: linux kernel .config compressed by toys/miniconfig.sh
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
44 (If miniconfig-alt-linux exists, USE_UNSTABLE=linux
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
45 will use that instead.)
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
46
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
47 miniconfig-uClibc: uClibc .config compressed by toys/miniconfig.sh
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
48 (If miniconfig-alt-uClibc exists, USE_UNSTABLE=uClibc
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
49 will use that instead.)
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
50
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
51 root-filesystem: Files to be copied verbatim into the target filesystem.
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
52 Used by simple-root-filesystem.sh.
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
53
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
54 control-images: Scripts to generate control images, used to run automated
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
55 native builds under target system images. Used by
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
56 more/build-control-images.sh.