freebsd-src/release/picobsd/README.luigi
Doug White 843fcabd9e Major PicoBSD update by luigi with some debugging help from myself.
. Now builds on -STABLE (-CURRENT is broken due to bugs)
. etc directory contents centralized instead of in each
  type directory (can exclude & override as desired)
. Removed extraneous language files (lang files for rc really necessary?)
. dialog-based build tool with support for custom floppy builds
. MFS image loads as a mfs_root module instead of compiled into kernel

THIS IS BROKEN ON CURRENT.  I'll MFC to -STABLE immediately following.
luigi tells me I have an OK from jkh on the MFC.

Submitted by:	luigi
1999-08-22 21:45:24 +00:00

151 lines
4.3 KiB
Text

In this file i try to document the overall architecture of PicoBSD
source tree.
build/
directory containing 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
floppy.tree/
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/
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
used.
tinyware/
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.
Structure of each image type is as follows:
Makefile.mfs
makefile used to build/populate the MFS
PICOBSD
kernel config file
crunch1/
directory with crunched config etc (unchanged from original)
floppy.tree/
local files to be put into the floppy/mfs trees.
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)
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