shithub: docs.9front.org

Download patch

ref: f1ff4ed206656bbc9578f9d5bde167d3e43498b1
parent: d691db89a964bef9e66eeaacbfb71f22602206ce
author: Moody <j4kem00dy@gmail.com>
date: Wed Jul 29 23:05:38 EDT 2020

Add kernel only iso file creation guide

--- /dev/null
+++ b/kernel-iso.md
@@ -1,0 +1,52 @@
+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.