rc.initdiskless revision 128685
1#!/bin/sh 2# 3# Copyright (c) 1999 Matt Dillon 4# All rights reserved. 5# 6# Redistribution and use in source and binary forms, with or without 7# modification, are permitted provided that the following conditions 8# are met: 9# 1. Redistributions of source code must retain the above copyright 10# notice, this list of conditions and the following disclaimer. 11# 2. Redistributions in binary form must reproduce the above copyright 12# notice, this list of conditions and the following disclaimer in the 13# documentation and/or other materials provided with the distribution. 14# 15# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25# SUCH DAMAGE. 26# 27# $FreeBSD: head/etc/rc.initdiskless 128685 2004-04-27 15:42:34Z phk $ 28# 29# REQUIRE: preseedrandom 30# PROVIDE: initdiskless 31# KEYWORD: FreeBSD nojail 32 33 34# On entry to this script the entire system consists of a read-only root 35# mounted via NFS. The kernel has run BOOTP and configured an interface 36# (otherwise it would not have been able to mount the NFS root!) 37# 38# We use the contents of /conf to create and populate memory filesystems 39# that are mounted on top of this root to implement the writable 40# (and host-specific) parts of the root filesystem, and other volatile 41# filesystems. 42# 43# The hierarchy in /conf has the form /conf/T/M/ where M are directories 44# for which memory filesystems will be created and filled, 45# and T is one of the "template" directories below: 46# 47# base universal base, typically a replica of the original root; 48# default secondary universal base, typically overriding some 49# of the files in the original root; 50# ${ipba} where ${ipba} is the assigned broadcast IP address 51# ${class} where ${class} is a list of directories supplied by 52# bootp/dhcp through the T134 option. 53# ${ipba} and ${class} are typicall used to configure features 54# for group of diskless clients, or even individual features; 55# ${ip} where ${ip} is the machine's assigned IP address, typically 56# used to set host-specific features; 57# 58# Template directories are scanned in the order they are listed above, 59# with each sucessive directory overriding (merged into) the previous one; 60# non-existing directories are ignored. 61# 62# The existence of a directory /conf/T/M causes this script to create a 63# memory filesystem mounted as /M on the client. 64# 65# Some files in /conf have special meaning, namely: 66# 67# Filename Action 68# ---------------------------------------------------------------- 69# /conf/T/M/remount 70# The contents of the file is a mount command. E.g. if 71# /conf/1.2.3.4/foo/remount contains "mount -o ro /dev/ad0s3", 72# then /dev/ad0s3 will be be mounted on /conf/1.2.3.4/foo/ 73# 74# /conf/T/M/diskless_remount 75# The contents of the file points to an NFS filesystem. E.g. if 76# /conf/base/etc/diskless_remount contains "foo.com:/etc", 77# then foo.com:/etc will be be mounted on /conf/base/etc/ 78# If the file contains a pathname starting with "/", then 79# the root path is prepended to it; this allows relocation of 80# the root filesystem withouth changing configuration files. 81# 82# /conf/T/M/md_size 83# The contents of the file specifies the size of the memory 84# filesystem to be created, in 512 byte blocks. 85# The default size is 10240 blocks (5MB). E.g. if 86# /conf/base/etc/md_size contains "30000" then a 15MB MFS 87# will be created. In case of multiple entries for the same 88# directory M, the last one in the scanning order is used. 89# NOTE: If you only need to create a memory filesystem but not 90# initialize it from a template, it is preferrable to specify 91# it in fstab e.g. as "md /tmp mfs -s=30m,rw 0 0" 92# 93# /conf/T/SUBDIR.cpio.gz 94# The file is cpio'd into /SUBDIR (and a memory filesystem is 95# created for /SUBDIR if necessary). The presence of this file 96# prevents the copy from /conf/T/SUBDIR/ 97# 98# /conf/T/SUBDIR.remove 99# The list of paths contained in the file are rm -rf'd 100# relative to /SUBDIR. 101# 102# You will almost universally want to create the following files under /conf 103# 104# File Content 105# ---------------------------- ------------------------------------------ 106# /conf/base/etc/md_size size of /etc filesystem 107# /conf/base/diskless_remount "/etc" 108# /conf/default/etc/rc.conf generic diskless config parameters 109# /conf/default/etc/fstab generic diskless fstab e.g. like this 110# 111# foo:/root_part / nfs ro 0 0 112# foo:/usr_part /usr nfs ro 0 0 113# foo:/home_part /home nfs rw 0 0 114# md /tmp mfs -s=30m,rw 0 0 115# md /var mfs -s=30m,rw 0 0 116# proc /proc procfs rw 0 0 117# 118# plus, possibly, overrides for password files etc. 119# 120# NOTE! /var, /tmp, and /dev will be typically created elsewhere, e.g. 121# as entries in the fstab as above. 122# Those filesystems should not be specified in /conf. 123# 124# (end of documentation, now get to the real code) 125 126dlv=`/sbin/sysctl -n vfs.nfs.diskless_valid 2> /dev/null` 127[ ${dlv:=0} -eq 0 ] && [ ! -f /etc/diskless ] && exit 0 128 129# chkerr: 130# 131# Routine to check for error 132# 133# checks error code and drops into shell on failure. 134# if shell exits, terminates script as well as /etc/rc. 135# 136chkerr() { 137 case $1 in 138 0) 139 ;; 140 *) 141 echo "$2 failed: dropping into /bin/sh" 142 /bin/sh 143 # RESUME 144 ;; 145 esac 146} 147 148# Create a generic memory disk 149# 150mount_md() { 151 /sbin/mdmfs -i 4096 -s $1 -M md $2 152} 153 154# Create the memory filesystem if it has not already been created 155# 156create_md() { 157 if [ "x`eval echo \\$md_created_$1`" = "x" ]; then 158 if [ "x`eval echo \\$md_size_$1`" = "x" ]; then 159 md_size=10240 160 else 161 md_size=`eval echo \\$md_size_$1` 162 fi 163 mount_md $md_size /$1 164 /bin/chmod 755 /$1 165 eval md_created_$1=created 166 fi 167} 168 169# DEBUGGING 170# 171# set -v 172 173# Figure out our interface and IP. 174# 175bootp_ifc="" 176bootp_ipa="" 177bootp_ipbca="" 178if [ ${dlv:=0} -ne 0 ] ; then 179 iflist=`ifconfig -l` 180 for i in ${iflist} ; do 181 set `ifconfig ${i}` 182 while [ $# -ge 1 ] ; do 183 if [ "${bootp_ifc}" = "" -a "$1" = "inet" ] ; then 184 bootp_ifc=${i} ; bootp_ipa=${2} ; shift 185 fi 186 if [ "${bootp_ipbca}" = "" -a "$1" = "broadcast" ] ; then 187 bootp_ipbca=$2; shift 188 fi 189 shift 190 done 191 if [ "${bootp_ifc}" != "" ] ; then 192 break 193 fi 194 done 195 # Insert the directories passed with the T134 bootp cookie 196 # in the list of paths used for templates. 197 i="`/sbin/sysctl -n kern.bootp_cookie`" 198 [ "${i}" != "" ] && bootp_ipbca="${bootp_ipbca} ${i}" 199 200 echo "Interface ${bootp_ifc} IP-Address ${bootp_ipa} Broadcast ${bootp_ipbca}" 201fi 202 203# Figure out our NFS root path 204# 205# The 'x' is there in case the list is empty. 206set x `mount -t nfs` 207while [ $# -ge 1 ] ; do 208 if [ "$2" = "on" -a "$3" = "/" ]; then 209 nfsroot="$1" 210 break 211 fi 212 shift 213done 214 215# The list of directories with template files 216templates="base default ${bootp_ipbca} ${bootp_ipa}" 217 218# The list of filesystems to umount after the copy 219to_umount="" 220 221# If /conf/diskless_remount exists, remount all of /conf. This allows 222# multiple roots to share the same conf files. 223if [ -d /conf -a -f /conf/diskless_remount ]; then 224 nfspt=`/bin/cat /conf/diskless_remount` 225 if [ `expr "$nfspt" : '\(.\)'` = "/" ]; then 226 nfspt="${nfsroot}${nfspt}" 227 fi 228 mount_nfs $nfspt /conf 229 chkerr $? "mount_nfs $nfspt /conf" 230 to_umount="/conf" 231fi 232 233# Resolve templates in /conf/base, /conf/default, /conf/${bootp_ipbca}, 234# and /conf/${bootp_ipa}. For each subdirectory found within these 235# directories: 236# 237# - calculate memory filesystem sizes. If the subdirectory (prior to 238# NFS remounting) contains the file 'md_size', the contents specified 239# in 512 byte sectors will be used to size the memory filesystem. Otherwise 240# 8192 sectors (4MB) is used. 241# 242# - handle NFS remounts. If the subdirectory contains the file 243# diskless_remount, the contents of the file is NFS mounted over 244# the directory. For example /conf/base/etc/diskless_remount 245# might contain 'myserver:/etc'. NFS remounts allow you to avoid 246# having to dup your system directories in /conf. Your server must 247# be sure to export those filesystems -alldirs, however. 248# If the diskless_remount file contains a string beginning with a 249# '/' it is assumed that the local nfsroot should be prepended to 250# it before attemping to the remount. This allows the root to be 251# relocated without needing to change the remount files. 252# 253for i in ${templates} ; do 254 for j in /conf/$i/* ; do 255 # memory filesystem size specification 256 # 257 subdir=${j##*/} 258 if [ -d $j -a -f $j/md_size ]; then 259 eval md_size_$subdir=`cat $j/md_size` 260 fi 261 262 # remount 263 # 264 if [ -d $j -a -f $j/remount ]; then 265 nfspt=`/bin/cat $j/remount` 266 $nfspt $j 267 chkerr $? "$nfspt $j" 268 to_umount="${to_umount} $j" # XXX hope it is really a mount! 269 fi 270 271 # NFS remount 272 # 273 if [ -d $j -a -f $j/diskless_remount ]; then 274 nfspt=`/bin/cat $j/diskless_remount` 275 if [ `expr "$nfspt" : '\(.\)'` = "/" ]; then 276 nfspt="${nfsroot}${nfspt}" 277 fi 278 mount_nfs $nfspt $j 279 chkerr $? "mount_nfs $nfspt $j" 280 to_umount="${to_umount} $j" 281 fi 282 done 283done 284 285# - Create all required MFS filesystems and populate them from 286# our templates. Support both a direct template and a dir.cpio.gz 287# archive. Support dir.remove files containing a list of relative 288# paths to remove. 289# 290# The dir.cpio.gz form is there to make the copy process more efficient, 291# so if the cpio archive is present, it prevents the files from dir/ 292# from being copied. 293 294for i in ${templates} ; do 295 for j in /conf/$i/* ; do 296 subdir=${j##*/} 297 if [ -d $j -a ! -f $j.cpio.gz ]; then 298 create_md $subdir 299 cp -Rp $j/* /$subdir 300 fi 301 done 302 for j in /conf/$i/*.cpio.gz ; do 303 subdir=${j%*.cpio.gz} 304 subdir=${subdir##*/} 305 if [ -f $j ]; then 306 create_md $subdir 307 echo "Loading /$subdir from cpio archive $j" 308 (cd / ; /stand/gzip -d < $j | /stand/cpio --extract -d ) 309 fi 310 done 311 for j in /conf/$i/*.remove ; do 312 subdir=${j%*.remove} 313 subdir=${subdir##*/} 314 if [ -f $j ]; then 315 # doubly sure it is a memory disk before rm -rf'ing 316 create_md $subdir 317 (cd /$subdir; rm -rf `/bin/cat $j`) 318 fi 319 done 320done 321 322# umount partitions used to fill the memory filesystems 323[ -n "${to_umount}" ] && umount $to_umount 324