freebsd-skq/release/picobsd
Doug White 88e4dbacdb Add a new floppy type, install. This type builds a disk that can
slice, partition, newfs, and install FreeBSD from a tarball on a remote server.
Handy for doing mass-installs for server farms.

Documentation following shortly.
1999-10-08 04:00:21 +00:00
..
build Add a new floppy type, install. This type builds a disk that can 1999-10-08 04:00:21 +00:00
dial $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
doc/src $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
floppy.tree $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
forth $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
help $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
install Add a new floppy type, install. This type builds a disk that can 1999-10-08 04:00:21 +00:00
isp $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
net Add file which was missing from previous commits 1999-08-28 06:22:07 +00:00
router Add file which was missed in last commits due to CVS problems 1999-08-28 06:24:16 +00:00
tinyware $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
tools $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
README.html $Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00
README.luigi Major PicoBSD update by luigi with some debugging help from myself. 1999-08-22 21:45:24 +00:00
Version Additional cleanup of the picobsd scripts. 1999-08-23 08:33:08 +00:00

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