summaryrefslogtreecommitdiffstats
path: root/etc/rc.initdiskless
diff options
context:
space:
mode:
authordillon <dillon@FreeBSD.org>2002-12-22 22:18:41 +0000
committerdillon <dillon@FreeBSD.org>2002-12-22 22:18:41 +0000
commit59db35bde2503abe71cac5a91acaedd768348893 (patch)
tree7a4959cdbe6bcce1760e14e20b92457e482609c6 /etc/rc.initdiskless
parentf2916da2791f333ec0f2f358bf35929a351bd2e0 (diff)
downloadFreeBSD-src-59db35bde2503abe71cac5a91acaedd768348893.zip
FreeBSD-src-59db35bde2503abe71cac5a91acaedd768348893.tar.gz
Do not unconditionally load the configuration files for the RCNG case.
Instead, load them as part of the rc.d system. This allows us to prioritize the initidiskless script so it runs before the configuration files are loaded and allows us to get rid of the exit 2 hack in /etc/rc. The exit 2 never worked anyway since it did not unset the prior configuration, causing the diskless code to not operate properly. Do a major cleanup and revamping of the diskless code for RCNG. This will be backported to the non-RCNG scripts as well as -stable. With suggestions from: Mike Makonnen <mtm@identd.net> MFC after: 7 days
Diffstat (limited to 'etc/rc.initdiskless')
-rw-r--r--etc/rc.initdiskless231
1 files changed, 156 insertions, 75 deletions
diff --git a/etc/rc.initdiskless b/etc/rc.initdiskless
index faa2acb..5ddc768 100644
--- a/etc/rc.initdiskless
+++ b/etc/rc.initdiskless
@@ -26,24 +26,61 @@
#
# $FreeBSD$
#
-
# PROVIDE: initdiskless
# KEYWORD: FreeBSD
-dlv=`/sbin/sysctl -n vfs.nfs.diskless_valid 2> /dev/null`
-[ ${dlv:=0} -eq 0 ] && exit 0
-
+
+# On entry to this script the entire system consists of a read-only root
+# mounted via NFS. We use the contents of /conf to create and populate
+# memory filesystems. The kernel has run BOOTP and configured an interface
+# (otherwise it would not have been able to mount the NFS root!)
+#
+# The following directories are scanned. Each sucessive directory overrides
+# (is merged into) the previous one.
+#
+# /conf/base universal base
+# /conf/default modified by a secondary universal base
+# /conf/${ipba} modified based on the assigned broadcast IP
+# /conf/${ip} modified based on the machine's assigned IP
+#
+# Each of these directories may contain any number of subdirectories which
+# represent directories in / on the diskless machine. The existance of
+# these subdirectories causes this script to create a MEMORY FILESYSTEM for
+# /<sub_directory_name>. For example, if /conf/base/etc exists then a
+# memory filesystem will be created for /etc.
+#
+# If a subdirectory contains the file 'diskless_remount' the contents of
+# the file is used to remount the subdirectory prior to it being copied to
+# the memory filesystem. For example, if /conf/base/etc/diskless_remount
+# contains the string 'my.server.com:/etc' then my.server.com:/etc will be
+# mounted in place of the subdirectory. This allows you to avoid making
+# duplicates of system directories in /conf.
#
-# BOOTP has mounted / for us. Assume a read-only mount. We must then
-# - figure out our IP by querying the interface
-# - mount /etc as an MFS
-# - populate /etc from /conf/default version
-# - override files in /etc with files from /conf/*/etc where
-# '*' is default, netmask of client, ip-address of client
+# If a subdirectory contains the file 'md_size', the contents of the
+# file is used to determine the size of the memory filesystem, in 512
+# byte sectors. The default is 8192 (4MB). You only have to specify an
+# md_size if the default doesn't work for you (i.e. if it is too big or
+# too small). Note that in -current the default is 4096 (2MB). For
+# example, /conf/base/etc/md_size might contain '16384'.
#
-# The operator is in charge of setting /conf/*/etc/* things as appropriate.
-# Typically rc.conf and fstab need to be changed, but possibly also other
-# files such as inetd.conf etc.
+# If /conf/<special_dir>/SUBDIR.cpio.gz exists, the file is cpio'd into
+# the specified /SUBDIR (and a memory filesystem is created for /SUBDIR
+# if necessary).
+#
+# If /conf/<special_dir>/SUBDIR.remove exists, the file contains a list
+# of paths which are rm -rf'd relative to /SUBDIR.
+#
+# You will almost universally want to create a /conf/base/etc containing
+# a diskless_remount and possibly an md_size file. You will then almost
+# universally want to override rc.conf, rc.local, and fstab by creating
+# /conf/default/etc/{rc.conf,rc.local,fstab}. Your fstab should be sure
+# to mount a /usr... typically an NFS readonly /usr.
+#
+# NOTE! rc.diskless2 will create /var, /tmp, and /dev. Those filesystems
+# should not be specified in /conf. At least not yet.
+
+dlv=`/sbin/sysctl -n vfs.nfs.diskless_valid 2> /dev/null`
+[ ${dlv:=0} -eq 0 ] && exit 0
# chkerr:
#
@@ -52,22 +89,37 @@ dlv=`/sbin/sysctl -n vfs.nfs.diskless_valid 2> /dev/null`
# checks error code and drops into shell on failure.
# if shell exits, terminates script as well as /etc/rc.
#
-chkerr()
-{
- case $1 in
- 0)
- ;;
- *)
- echo "$2 failed: dropping into /bin/sh"
- /bin/sh
- # RESUME
- ;;
- esac
+chkerr() {
+ case $1 in
+ 0)
+ ;;
+ *)
+ echo "$2 failed: dropping into /bin/sh"
+ /bin/sh
+ # RESUME
+ ;;
+ esac
}
-mount_md()
-{
- /sbin/mdmfs -i 4096 -s $1 -M md$3 $2
+# Create a generic memory disk
+#
+mount_md() {
+ /sbin/mdmfs -i 4096 -s $1 -M md $2
+}
+
+# Create the memory filesystem if it has not already been created
+#
+create_md() {
+ if [ "x`eval echo \\$md_created_$1`" = "x" ]; then
+ if [ "x`eval echo \$md_size_$1`" = "x" ]; then
+ md_size=4096
+ else
+ md_size=`eval echo \\$md_size_$1`
+ fi
+ mount_md $md_size /$1
+ /bin/chmod 755 /$1
+ eval md_created_$1=created
+ fi
}
# DEBUGGING
@@ -81,62 +133,91 @@ bootp_ipa=""
bootp_ipbca=""
iflist=`ifconfig -l`
for i in ${iflist} ; do
- set `ifconfig ${i}`
- while [ $# -ge 1 ] ; do
- if [ "${bootp_ifc}" = "" -a "$1" = "inet" ]; then
- bootp_ifc=${i} ; bootp_ipa=${2} ; shift
- fi
- if [ "${bootp_ipbca}" = "" -a "$1" = "broadcast" ]; then
- bootp_ipbca=$2; shift
- fi
- shift
- done
- if [ "${bootp_ifc}" != "" ]; then
- break
- fi
+ set `ifconfig ${i}`
+ while [ $# -ge 1 ] ; do
+ if [ "${bootp_ifc}" = "" -a "$1" = "inet" ] ; then
+ bootp_ifc=${i} ; bootp_ipa=${2} ; shift
+ fi
+ if [ "${bootp_ipbca}" = "" -a "$1" = "broadcast" ] ; then
+ bootp_ipbca=$2; shift
+ fi
+ shift
+ done
+ if [ "${bootp_ifc}" != "" ] ; then
+ break
+ fi
done
echo "Interface ${bootp_ifc} IP-Address ${bootp_ipa} Broadcast ${bootp_ipbca}"
-if [ -z "`hostname -s`" ]; then
- hostname=`kenv dhcp.host-name`
- hostname $hostname
- echo "Hostname is $hostname"
-fi
-
-if [ -d /conf/default/etc ]; then
- mount_md 4096 /etc 0
- chkerr $? "MFS mount on /etc"
- /bin/chmod 755 /etc
-
- /bin/cp -Rp /conf/default/etc/* /etc
- chkerr $? "cp /conf/default/etc to /etc MFS"
-fi
-
-# Allow for override files to replace files in /etc. Use /conf/*/etc to find
-# the override files. First choice is default files that # always override,
-# then files that from the directory that matches the client's broadcast
-# address, finally followed by overrides that match the client's IP address.
+# Resolve templates in /conf/base, /conf/default, /conf/${bootp_ipbca},
+# and /conf/${bootp_ipa}. For each subdirectory found within these
+# directories:
+#
+# - calculate memory filesystem sizes. If the subdirectory (prior to
+# NFS remounting) contains the file 'md_size', the contents specified
+# in 512 byte sectors will be used to size the memory filesystem. Otherwise
+# 8192 sectors (4MB) is used.
#
-# This way we have some flexibility to handle clusters of machines on
-# separate subnets.
+# - handle NFS remounts. If the subdirectory contains the file
+# diskless_remount, the contents of the file is NFS mounted over
+# the directory. For example /conf/base/etc/diskless_remount
+# might contain 'myserver:/etc'. NFS remounts allow you to avoid
+# having to dup your system directories in /conf. Your server must
+# be sure to export those filesystems -alldirs, however.
+#
+for i in base default ${bootp_ipbca} ${bootp_ipa} ; do
+ for j in /conf/$i/* ; do
+ # memory filesystem size specification
+ #
+ subdir=${j##*/}
+ if [ -d $j -a -f $j/md_size ]; then
+ eval md_size_$subdir=`cat $j/md_size`
+ fi
-for i in ${bootp_ipbca} ${bootp_ipa} ${hostname} ; do
- if [ -d /conf/${i}/etc ]; then
- cp -Rp /conf/${i}/etc/* /etc
+ # NFS remount
+ #
+ if [ -d $j -a -f $j/diskless_remount ]; then
+ nfspt=`/bin/cat $j/diskless_remount`
+ mount_nfs $nfspt $j
+ chkerr $? "mount_nfs $nfspt $j"
fi
+ done
done
+# - Create all required MFS filesystems and populate them from
+# our templates. Support both a direct template and a dir.cpio.gz
+# archive. Support dir.remove files containing a list of relative
+# paths to remove.
#
-# if the info is available via dhcp/kenv
-# build the resolv.conf
-#
-if [ ! -e /etc/resolv.conf ]; then
- echo domain `kenv dhcp.domain-name` > /etc/resolv.conf
+# TODO:
+# + find a way to assign a 'group' identifier to a machine
+# so we can use group-specific configurations;
- set `kenv dhcp.domain-name-servers`
- for ns in `IFS=','; echo $*`; do
- echo nameserver $ns >> /etc/resolv.conf;
- done
-fi
+for i in base default ${bootp_ipbca} ${bootp_ipa} ; do
+ for j in /conf/$i/* ; do
+ subdir=${j##*/}
+ if [ -d $j ]; then
+ create_md $subdir
+ cp -Rp $j/* /$subdir
+ fi
+ done
+ for j in /conf/$i/*.cpio.gz ; do
+ subdir=${j%*.cpio.gz}
+ subdir=${subdir##*/}
+ if [ -f $j ]; then
+ create_md $subdir
+ echo "Loading /$subdir from cpio archive $j"
+ (cd / ; /stand/gzip -d < $j | /stand/cpio --extract -d )
+ fi
+ done
+ for j in /conf/$i/*.remove ; do
+ subdir=${j%*.remove}
+ subdir=${subdir##*/}
+ if [ -f $j ]; then
+ # doubly sure it is a memory disk before rm -rf'ing
+ create_md $subdir
+ (cd /$subdir; rm -rf `/bin/cat $j`)
+ fi
+ done
+done
-exit 2 # Tell /etc/rc to re-source rc.conf
OpenPOWER on IntegriCloud