1#!/bin/sh
2#
3# $FreeBSD: stable/10/release/tools/vmimage.subr 325491 2017-11-06 18:07:23Z gjb $
4#
5#
6# Common functions for virtual machine image build scripts.
7#
8
9export PATH="/bin:/usr/bin:/sbin:/usr/sbin:/usr/local/bin:/usr/local/sbin"
10trap "cleanup" INT QUIT TRAP ABRT TERM
11
12write_partition_layout() {
13	if [ -z "${NOSWAP}" ]; then
14		SWAPOPT="-p freebsd-swap/swapfs::${SWAPSIZE}"
15	fi
16
17	_OBJDIR="$(make -C ${WORLDDIR} -V .OBJDIR)"
18	_OBJDIR="$(realpath ${_OBJDIR})"
19	if [ -d "${_OBJDIR%%/usr/src}/${TARGET}.${TARGET_ARCH}" ]; then
20		BOOTFILES="/${_OBJDIR%%/usr/src}/${TARGET}.${TARGET_ARCH}/usr/src/sys/boot"
21	else
22		BOOTFILES="/${_OBJDIR}/sys/boot"
23	fi
24
25	case "${TARGET}:${TARGET_ARCH}" in
26		amd64:amd64 | i386:i386)
27			mkimg -s gpt -f ${VMFORMAT} \
28				-b ${BOOTFILES}/i386/pmbr/pmbr \
29				-p freebsd-boot/bootfs:=${BOOTFILES}/i386/gptboot/gptboot \
30				${SWAPOPT} \
31				-p freebsd-ufs/rootfs:=${VMBASE} \
32				-o ${VMIMAGE}
33			;;
34		powerpc:powerpc*)
35			mkimg -s apm -f ${VMFORMAT} \
36				-p apple-boot/bootfs:=${BOOTFILES}/powerpc/boot1.chrp/boot1.hfs \
37				${SWAPOPT} \
38				-p freebsd-ufs/rootfs:=${VMBASE} \
39				-o ${VMIMAGE}
40			;;
41		*)
42			# ENOTSUPP
43			return 1
44			;;
45	esac
46
47	return 0
48}
49
50err() {
51	printf "${@}\n"
52	cleanup
53	return 1
54}
55
56cleanup() {
57	if [ -c "${DESTDIR}/dev/null" ]; then
58		umount_loop ${DESTDIR}/dev 2>/dev/null
59	fi
60	umount_loop ${DESTDIR}
61	if [ ! -z "${mddev}" ]; then
62		mdconfig -d -u ${mddev}
63	fi
64
65	return 0
66}
67
68vm_create_base() {
69	# Creates the UFS root filesystem for the virtual machine disk,
70	# written to the formatted disk image with mkimg(1).
71
72	mkdir -p ${DESTDIR}
73	truncate -s ${VMSIZE} ${VMBASE}
74	mddev=$(mdconfig -f ${VMBASE})
75	newfs /dev/${mddev}
76	mount /dev/${mddev} ${DESTDIR}
77
78	return 0
79}
80
81vm_copy_base() {
82	# Creates a new UFS root filesystem and copies the contents of the
83	# current root filesystem into it.  This produces a "clean" disk
84	# image without any remnants of files which were created temporarily
85	# during image-creation and have since been deleted (e.g., downloaded
86	# package archives).
87
88	mkdir -p ${DESTDIR}/old
89	mdold=$(mdconfig -f ${VMBASE})
90	mount /dev/${mdold} ${DESTDIR}/old
91
92	truncate -s ${VMSIZE} ${VMBASE}.tmp
93	mkdir -p ${DESTDIR}/new
94	mdnew=$(mdconfig -f ${VMBASE}.tmp)
95	newfs /dev/${mdnew}
96	mount /dev/${mdnew} ${DESTDIR}/new
97
98	tar -cf- -C ${DESTDIR}/old . | tar -xUf- -C ${DESTDIR}/new
99
100	umount_loop /dev/${mdold}
101	rmdir ${DESTDIR}/old
102	mdconfig -d -u ${mdold}
103
104	umount_loop /dev/${mdnew}
105	rmdir ${DESTDIR}/new
106	tunefs -n enable /dev/${mdnew}
107	mdconfig -d -u ${mdnew}
108	mv ${VMBASE}.tmp ${VMBASE}
109}
110
111vm_install_base() {
112	# Installs the FreeBSD userland/kernel to the virtual machine disk.
113
114	cd ${WORLDDIR} && \
115		make DESTDIR=${DESTDIR} \
116		installworld installkernel distribution || \
117		err "\n\nCannot install the base system to ${DESTDIR}."
118
119	# Bootstrap etcupdate(8) and mergemaster(8) databases.
120	mkdir -p ${DESTDIR}/var/db/etcupdate
121	etcupdate extract -B \
122		-M "TARGET=${TARGET} TARGET_ARCH=${TARGET_ARCH}" \
123		-s ${WORLDDIR} -d ${DESTDIR}/var/db/etcupdate
124	sh ${WORLDDIR}/release/scripts/mm-mtree.sh -m ${WORLDDIR} \
125		-F "TARGET=${TARGET} TARGET_ARCH=${TARGET_ARCH}" \
126		-D ${DESTDIR}
127
128	echo '# Custom /etc/fstab for FreeBSD VM images' \
129		> ${DESTDIR}/etc/fstab
130	echo '/dev/gpt/rootfs   /       ufs     rw      1       1' \
131		>> ${DESTDIR}/etc/fstab
132	if [ -z "${NOSWAP}" ]; then
133		echo '/dev/gpt/swapfs  none    swap    sw      0       0' \
134			>> ${DESTDIR}/etc/fstab
135	fi
136
137	local hostname
138	hostname="$(echo $(uname -o) | tr '[:upper:]' '[:lower:]')"
139	echo "hostname=\"${hostname}\"" >> ${DESTDIR}/etc/rc.conf
140
141	mkdir -p ${DESTDIR}/dev
142	mount -t devfs devfs ${DESTDIR}/dev
143	chroot ${DESTDIR} /usr/bin/newaliases
144	chroot ${DESTDIR} /etc/rc.d/ldconfig forcestart
145	umount_loop ${DESTDIR}/dev
146
147	cp /etc/resolv.conf ${DESTDIR}/etc/resolv.conf
148
149	return 0
150}
151
152vm_extra_install_base() {
153	# Prototype.  When overridden, runs extra post-installworld commands
154	# as needed, based on the target virtual machine image or cloud
155	# provider image target.
156
157	return 0
158}
159
160vm_extra_enable_services() {
161	if [ ! -z "${VM_RC_LIST}" ]; then
162		for _rcvar in ${VM_RC_LIST}; do
163			echo ${_rcvar}_enable="YES" >> ${DESTDIR}/etc/rc.conf
164		done
165	fi
166
167	if [ -z "${VMCONFIG}" -o -c "${VMCONFIG}" ]; then
168		echo 'ifconfig_DEFAULT="DHCP inet6 accept_rtadv"' >> \
169			${DESTDIR}/etc/rc.conf
170	fi
171
172	return 0
173}
174
175vm_extra_install_packages() {
176	if [ -z "${VM_EXTRA_PACKAGES}" ]; then
177		return 0
178	fi
179	mkdir -p ${DESTDIR}/dev
180	mount -t devfs devfs ${DESTDIR}/dev
181	chroot ${DESTDIR} env ASSUME_ALWAYS_YES=yes \
182		/usr/sbin/pkg bootstrap -y
183	chroot ${DESTDIR} env ASSUME_ALWAYS_YES=yes \
184		/usr/sbin/pkg install -y ${VM_EXTRA_PACKAGES}
185	umount_loop ${DESTDIR}/dev
186
187	return 0
188}
189
190vm_extra_install_ports() {
191	# Prototype.  When overridden, installs additional ports within the
192	# virtual machine environment.
193
194	return 0
195}
196
197vm_extra_pre_umount() {
198	# Prototype.  When overridden, performs additional tasks within the
199	# virtual machine environment prior to unmounting the filesystem.
200	# Note: When overriding this function, removing resolv.conf in the
201	# disk image must be included.
202
203	rm -f ${DESTDIR}/etc/resolv.conf
204	return 0
205}
206
207vm_extra_pkg_rmcache() {
208	if [ -e ${DESTDIR}/usr/local/sbin/pkg ]; then
209		chroot ${DESTDIR} env ASSUME_ALWAYS_YES=yes \
210			/usr/local/sbin/pkg clean -y -a
211	fi
212
213	return 0
214}
215
216umount_loop() {
217	DIR=$1
218	i=0
219	sync
220	while ! umount ${DIR}; do
221		i=$(( $i + 1 ))
222		if [ $i -ge 10 ]; then
223			# This should never happen.  But, it has happened.
224			echo "Cannot umount(8) ${DIR}"
225			echo "Something has gone horribly wrong."
226			return 1
227		fi
228		sleep 1
229	done
230
231	return 0
232}
233
234vm_create_disk() {
235	echo "Creating image...  Please wait."
236	echo
237
238	write_partition_layout || return 1
239
240	return 0
241}
242
243vm_extra_create_disk() {
244
245	return 0
246}
247
248