ref: f1ff4ed206656bbc9578f9d5bde167d3e43498b1
parent: d691db89a964bef9e66eeaacbfb71f22602206ce
author: Moody <[email protected]>
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.