From bb4fc0a1dd2c5d6bfe4e5b1e6b064cda50390abd Mon Sep 17 00:00:00 2001 From: luigi Date: Tue, 8 Feb 2000 08:13:47 +0000 Subject: Start the cleanup of PicoBSD build scripts and general build structure. These changes have been discussed with Greg Lehey and posted on freebsd-small (most things in the PicoBSD tree were already broken so things can only improve!) Approved-By: jordan --- release/picobsd/README.luigi | 142 +++++++++++-------------------------------- 1 file changed, 34 insertions(+), 108 deletions(-) (limited to 'release/picobsd') diff --git a/release/picobsd/README.luigi b/release/picobsd/README.luigi index 5a3a333..4261a1a 100644 --- a/release/picobsd/README.luigi +++ b/release/picobsd/README.luigi @@ -1,16 +1,23 @@ In this file i try to document the overall architecture of PicoBSD source tree. - build/ - directory containing main build scripts and makefiles. + ./ Per-image directory-tree and generic trees. + + build/ Main build scripts and Makefiles. build: main build script stage1: invoked by build clean: to clean up previous compilations Makefile.conf makefile to edit config file and build kernel + Makefile.mfs + makefile to create the memory filesystem + Makefile.crunch + makefile to handle the crunched directory + mfs.mtree + mtree cmd -- structure of the mfs tree floppy.tree/ - default files to fill the floppy and mfs trees. + Default files to fill the floppy and mfs trees. Can be overridden by listing files to be removed in ${TYPE}/floppy.tree.exclude, and putting files to be replaced in ${TYPE}/floppy.tree/ @@ -18,9 +25,6 @@ source tree. doc/ documentation (unchanged from original) - forth/ - load files for the boot loader (unchanged from original) - help/ help files in various languages. The suffix is the two letter country code for the language. Currently only .en and .pl @@ -30,122 +34,44 @@ source tree. various small programs used instead of the corresponding full-blown utilities. - tools/ - couple of tools used during the build process. - - dial, isp, net, router, custom ... - directories containing the source and config files for the - various image types. - + $TYPE/ source and config files for the various image types. Structure of each image type is as follows: Makefile.mfs - makefile used to build/populate the MFS + Makefile used to build/populate the MFS. Only needs two + lines typically: + + MY_DEVS=std .... + .include "../build/Makefile.mfs" PICOBSD - kernel config file + kernel config file. One line is required + + #PicoBSD mfs_size init_name mfs_inodes floppy_inodes + e.g. + #PicoBSD 2400 init 4096 32768 crunch1/ - directory with crunched config etc (unchanged from original) + Directory with crunched config etc. Main files: + crunch.conf main config file for crunchgen + crunch.inc (optional) file included in crunchgen + Makefiles, used e.g. to set make variables + such as RELEASE_CRUNCH or similar. floppy.tree/ - local files to be put into the floppy/mfs trees. + local files to be put into the floppy/mfs trees instead + of the ones in ../build/floppy.tree floppy.tree.exclude - list of files in the default floppy.tree/ not to be copied - for this configuration (used by tar --exclude-from - floppy.tree.exclude) + list of files to be omitted in the copy from ../build/floppy.tree + + floppy.tree.${SITE}/ + site-specific files which update the ones taken from one + of the two places above. Typically they are passwd, hosts, + rc.conf, rc.firewall things to go in /etc lang/ language-dependant files (trimmed from the original one) - mfs.mtree - mtree structure used to populate the mfs image - MFS image, or on the floppy image in various phases.1G - ----- - -Below a partly incomplete list of files used by the various -picobsd types. - -Files for various systems - -= base file -x missing -X missing, not needed with oinit -D different -d minor difference, merge candidate -L copied from LANG directory -G generated in stage3 - -DIAL ISP NET ROUT MY1 MY2 File in floppy.tree ------------------------------------------------------- - = = = = boot.config - x = = = disktab - x = x x etc/firewall - = = = = etc/fstab - = = = = etc/gettytab - = = = = etc/group - = = = = etc/host.conf - L L L L L etc/hosts - x = = x etc/inetd.conf - = = = = etc/login.conf - d = = x etc/master.passwd - d = = D etc/mfs.rc - L L L L L etc/motd - D = = = etc/ppp/ppp.conf - = x x x etc/ppp/ppp.conf.template - = = = = etc/ppp/ppp.deny - d = = = etc/ppp/ppp.linkup - = = = = etc/ppp/ppp.secret.sample - = = = = etc/profile - = = = = etc/protocols - D = d D etc/rc - D = = X etc/rc.conf - x = = D etc/rc.firewall - = = = D etc/rc.network - x = = D etc/rc.serial - x = = = etc/remote - L = = X L etc/resolv.conf - = = = = etc/services - x = = = etc/shells - x = = x etc/snmpd.conf - = x x x G etc/spwd.db - = x x x etc/ssh_config - = = = = etc/termcap - D = = = etc/ttys - = = = = kernel.config - = = = = G kernel.gz - -DIAL ISP NET ROUT MY1 MY2 File in lang - README.en - README.pl - boot.help.en - boot.help.pl - hosts.en - hosts.pl - mfs.rc.en to floppy.tree - mfs.rc.pl - motd.en - motd.pl - rc.conf.en to floppy.tree - rc.conf.pl via - rc.en to floppy.tree - rc.network.en to floppy.tree - rc.network.pl via - rc.pl via - reboot.en - reboot.pl - resolv.conf.en to floppy.tree - resolv.conf.pl via - update.en - update.pl - - -DIAL ISP NET ROUT MY1 MY2 File in mfs.tree - - D = d d Makefile - = x x x login.conf - D = D D mfs.tree -- cgit v1.1