shithub: docs.9front.org

ref: 8982115fc3363420e3f287f23ed99f394e420710
dir: /kernel-iso.md/

View raw version
Building a kernel only 9front ISO
===================================

For times in which PXE is not avaible, it can be useful
to have access to an ISO file that just contains a kernel
for booting machines and then having them tls/tcp boot from
a file server. 

This guide will be assuming you have a file and auth server somewhere on your network,
and that you plan to boot a amd64 kernel on the target machine.

Lets start with a plan9.ini for our target system:

	bootfile=/amd64/9pc64
	cdboot=yes
	mouseport=ps2
	monitor=vesa
	vgasize=1024x768x16
	auth=192.168.1.6
	fs=192.168.1.5
	user=moody
	bootargs=tls


Next we will need a proto file for disk/mk9660:

	uid=sys
	gid=sys
	386	d775
		9bootfat	664
		9boothyb	664
		9bootiso	664
		mbr		664
		pbs		664

	cfg	d775
		plan9.ini	664

	amd64	d775
		9pc64	664


For a small script to generate the ISO file itself:
	#!/bin/rc
	rfork n
	bind /root /n/src9
	bind plan9.ini /n/src9/cfg/plan9.ini
	disk/mk9660 -c9j -B 386/9bootiso \
		-p 9bootproto \
		-s /n/src9 -v 'Plan 9' kern.iso

This results in a `kern.iso` file being created in the current directory.