Differences

This shows you the differences between two versions of the page.

--- playground:plan_9_second_edition [2022/09/26 16:48] – [Chronology] hc9
+++ playground:plan_9_second_edition [2023/01/30 22:58] – [/bin] hc9
@@ Line 1: / Line 1: @@
 ======= Plan 9 Second Edition =======
-|DRAFT: Plan 9 Second Edition from Bell Labs.|
+|**DRAFT**: Plan 9 Second Edition from Bell Labs.|
-| Tutorial [ ] Guide [**x**]|
+|Tutorial [**x**] Guide [ ]|
+|  :!: System CPU //Execution Cap: 40%//  |
   * For educational and informational purposes only. [[playground:plan_9_second_edition#disk1img|Networking]] is not [[playground:plan_9_second_edition#disk1img|supported]].
+  * //You're stuck with this small [VirtualBox FreeDOS] screen [display resolution].//
+  * VirtualBox display scale factor setting is available.
 ==== Chronology ====
@@ Line 15: / Line 18: @@
 |README|http://doc.cat-v.org/plan_9/2nd_edition/README|
+|special interest|http://doc.cat-v.org/plan_9/2nd_edition/|
+|ways to install|http://doc.cat-v.org/plan_9/2nd_edition/install|
 <file config An asciidoc version of Plan 9 Second Edition.>
@@ Line 23: / Line 28: @@
 * Install FreeDOS from the FD13LIVE.iso with the default VirtualBox settings.
+* Install FreeDOS with the default install.
-==== The Plan 9 Second Edition Floppy Diskette (2-4) Install Target [C:] is the non-partitioned 25 MB area after the previously partitioned 95% (A, 500 MB, PRI DOS, FAT16) and formatted disk space:
 * Initial virtual disk settings after the default FreeDOS install to C: (Device 1).
-* Initial virtual disk settings after the FDISK (6 MB, PRI DOS, FAT12) D: partition (Device 0).
+* Initial virtual disk settings after the FDISK (17 MB, PRI DOS, FAT16) D: partition (Device 0).
 ----
 IDE Primary Device 1: freedos-13.vdi (Normal, 500.00 MB)
@@ Line 33: / Line 37: @@
 ----
-* Managed/modified disk (Device 1; C:) setting:
+=== CD-ROM Install
+==== The Plan 9 Second Edition CD-ROM (plan9-2e.iso) Install Target [D:] is the ~568 MB non-partitioned area after the previously partitioned 3% (17 MB, PRI DOS, FAT16) and formatted disk space:
+* Managed/modified disk (Device 0; D:) setting:
 ----
-$ VBoxManage showmediuminfo 'freedos-13.vdi'
+$ VBoxManage showmediuminfo 'freedos-13_1.vdi'
 Capacity:       500 MBytes
 ----
 ----
-$ VBoxManage modifymedium 'freedos-13.vdi' --compact
+$ VBoxManage modifymedium 'freedos-13_1.vdi' --compact
-$ VBoxManage modifymedium 'freedos-13.vdi' --resize 525
+$ VBoxManage modifymedium 'freedos-13_1.vdi' --resize 586
 ----
-==== The Plan 9 Second Edition CD-ROM (plan9-2e.iso) Install Target [D:] is the ~569 MB non-partitioned area after the previously partitioned 1% (6 MB, PRI DOS, FAT12) and formatted disk space:
+=== Demo Install
-* Managed/modified disk (Device 0; D:) setting:
+* Postpone the Demo install if completing the CD-ROM install.
+==== The Plan 9 Second Edition Floppy Diskette (2-4) Install Target [C:] is the non-partitioned 25 MB area after the previously partitioned 95% (A, 500 MB, PRI DOS, FAT16) and formatted disk space:
+* Managed/modified disk (Device 1; C:) setting:
 ----
-$ VBoxManage showmediuminfo 'freedos-13_1.vdi'
+$ VBoxManage showmediuminfo 'freedos-13.vdi'
 Capacity:       500 MBytes
 ----
 ----
-$ VBoxManage modifymedium 'freedos-13_1.vdi' --compact
+$ VBoxManage modifymedium 'freedos-13.vdi' --compact
-$ VBoxManage modifymedium 'freedos-13_1.vdi' --resize 575
+$ VBoxManage modifymedium 'freedos-13.vdi' --resize 525
 ----
-=== Run FreeDOS 1.3  in “Safe Mode” (press #3).
+=== Run FreeDOS 1.3  in "Safe Mode" (press #3).
 * 3 - Load FreeDOS low with some drivers (Safe Mode)
@@ Line 68: / Line 80: @@
 Enter choice: [4]
-“… Usage”
+"... Usage"
-“… 95%”
+"... 95%"
-“Total disk space is  525 Mbytes (1 Mbyte = 1048576 bytes)”
+"Total disk space is  525 Mbytes (1 Mbyte = 1048576 bytes)"
 Press Esc to continue
@@ Line 82: / Line 94: @@
 Enter choice: [5]
-Enter Fixed Disk Drive Number (1-2)…..[2]
+Enter Fixed Disk Drive Number (1-2).....[2]
-“Current Fixed Disk Drive: 2”
+"Current Fixed Disk Drive: 2"
 Enter choice: [4]
-“… Usage”
+"... Usage"
-“… 1%”
+"... 3%"
-“Total disk space is  575 Mbytes (1 Mbyte = 1048576 bytes)”
+"Total disk space is  565 Mbytes (1 Mbyte = 1048576 bytes)"
 Press Esc to continue
@@ Line 115: / Line 127: @@
 ** Copy README, disk1, disk2.vd, disk3.vd, and disk4.vd to the VirtualBox host machine.
-** disk1 (rename to disk1.img) is a boot-able diskette, and used to configure the  C:\plan9\plan9.ini or  D:\plan9\plan9.ini
+** disk1 (rename to disk1.img) is a boot-able diskette, and used to configure the C:\plan9\plan9.ini or D:\plan9\plan9.ini
 ** disk2.vd, disk3.vd, and disk4.vd are files that must be copied to new diskettes (disk2.img, disk3.img and disk4.img).
 === Notes:
-* C:\plan9\plan9.ini can configure the demo system.
-(limited VGA settings?)
-* D:\plan9\plan9.ini can configure the full system.
-(less limited VGA settings?)
 * Create a blank floppy.img with VirtualBox, for use with FreeDOS:
 ** Floppy Drive Device 0:
-** Choose/Create A Virtual Floppy Disk…
+** Choose/Create A Virtual Floppy Disk...
 ** Floppy Disk Selector (Popup)
 ** Create Disk Image (Icon)
@@ Line 146: / Line 154: @@
 ----
-=== Final VirtualBox guest Configuration Results (only):
+=== Final VirtualBox guest Configuration Results:
 * General
@@ Line 205: / Line 213: @@
 ----
-==== Boot the FreeDOS VM with diskette disk1.img to configure C:\plan9\plan9.ini:
+=== Boot the FreeDOS VM with diskette disk1.img to configure C:\plan9\plan9.ini:
-Plan 9 Second Edition Menu: “System Instillation & Configuration”
+Plan 9 Second Edition Menu: "System Instillation & Configuration"
-== Menu
+==== Menu
-“Select a disc containing a FAT-based filesystem.” [If the disc you want does not appear…]
+"Select a disc containing a FAT-based filesystem." [If the disc you want does not appear...]
-“/dev/hd1”
+"/dev/hd1"
-“/dev/hd2”
+"/dev/hd2"
 ** Select /dev/hd1 to configure the C:\plan9\plan9.ini
@@ Line 225: / Line 233: @@
 ----
-Plan 9 Second Edition Menu: “File System Instillation”
+Plan 9 Second Edition Menu: "File System Instillation"
 ** Select /dev/hd1 to configure the C:\plan9\plan9.ini
-Select: “1. Install 3 Diskette System to local drive”
+Select: "1. Install 3 Diskette System to local drive"
-** (The following menu steps may require several attempts before the “3 Diskette System” is installed, and configured, without interruption.)
+** (The following menu steps may require several attempts before the "3 Diskette System" is installed [in a familiar way], and configured, without interruption.)
 ** Make the newly installed Plan 9 the default (avoid this option initially)
@@ Line 239: / Line 247: @@
 ** Remove the floppy diskette from the virtual drive before restarting.
-=== "Reconfigure the system" by booting with diskette disk1.img after installing disk2.img, disk3.img, disk4.img, or plan9-2e.iso to a virtual hard drive storage device.
+=== "Reconfigure the system" by booting with diskette disk1.img after installing disk2.img, disk3.img, disk4.img, or the plan9-2e.iso, to a virtual hard disk drive storage device.
 ** Avoid "File System Installation"
@@ Line 265: / Line 273: @@
 ----
-* (type ‘disk/kfscmd halt’ in a terminal window, then  press return/enter to cleanly halt the system.)
+* (type 'disk/kfscmd halt' in a terminal window, then  press return/enter to cleanly halt the system.)
 Menu configuration note:
@@ Line 281: / Line 289: @@
 ----
-* Select /dev/hd2 to configure the D:\plan9\plan9.ini
+Disk1 re-config note:
-** Example Second Edition /dev/hd2 plan9.ini:
+* VGA setup
-----
+** 640x480x1
-mouseport=ps2
+** vga - Basic monitor or laptop LCD
-monitor=vga
+* Mouse type
-vgasize=1280x1024x8
+** PS2
-console=cga
+* Ethernet card
+** None
-bootfile=h!2
+* ATA (IDE) controller
-----
+** None
+* SCSI controller
+** None
+* SoundBlaster
+** None
+* SoundBlaster CD-ROM
+** None
+* File system console
+** CGA
+* Save configuration
+** Save
-=== Display Configuration
+=== Display configuration
 .6. Advanced Display Configuration
 http://www.virtualbox.org/manual/ch09.html#adv-display-config
-Freedos small screensize
+FreeDOS small screensize
 https://forums.virtualbox.org/viewtopic.php?t=9816
 "You're stuck with this small screen."
@@ Line 345: / Line 363: @@
 ----
 games/fireworks
-"Windowing system is 8½ which is closer to UNIX mux"
+"Windowing system is 8 1/2 which is closer to UNIX mux"
 Plan9 2nd Edition
@@ Line 371: / Line 389: @@
 **Select 2: "Reconfigure the system"**
-|You must enter information about all devices every time you use this menu to configure a device. This is not an editor; it makes a new ''PLAN9.INI'' file each time|
+|You must enter information about all devices every time you use this menu to configure a device. This is not an editor; it makes a new ''PLAN9.INI'' file each time||
+|PLAN9.INI(8) ((//You must now configure the devices. Look at plan9.ini(8) in the manual to help understand the choices//))|http://man.cat-v.org/plan_9_2nd_ed/8/plan9.ini|
   - VGA setup
@@ Line 440: / Line 459: @@
 |Save|
-<file config A "9. Save configuration" Redo Save menu snippet>
+  * Save or redo
+|**//System Instillation & Configuration//**|
+| mouseport=ps2  ||
+| monitor=vga  ||
+| vgasize=800x600x1  ||
+| ata1=irq=15  ||
+| auido0=type=sb16 port=0x220 irq=7 dma=5  ||
+| console=cga  ||
+| bootfile=hd!1!/plan9/9dos  ||
+| rootdir=/plan9  ||
+| bootdisk=#H/hd1disk:63  ||
+| |Redo  |
+| |**Save**  |
+<file config Another "Save Redo" configuration menu snippet>
 mouseport=ps2
 monitor=vga
@@ Line 457: / Line 492: @@
 |Choose the boot partition to mark as the active system.|
 ^Menu^
-|''/dev/hd1''|
+|''/dev/hd1'' ((//Create notes for further review of the menu selection//.))|
-|''/dev/hd2''|
+|''/dev/hd2'' ((//Create notes for further review of the menu selection//.))|
 ^Press the ''Esc'' key to see what happens.^
 |Reconfiguration complete. Remove the boot floppy and press any key to reboot, allowing the new configuration to come into effect.|
 |When you return to DOS, restart Plan 9 by typing ''PLAN9\B'' at the DOS prompt.|
+==== Disk1 re-config note ====
+  - VGA setup
+    * 640x480x1
+    * vga - Basic monitor or laptop LCD
+  - Mouse type
+    * PS2
+  - Ethernet card
+    * None
+  - ATA (IDE) controller
+    * None
+  - SCSI controller
+    * None
+  - SoundBlaster
+    * None
+  - SoundBlaster CD-ROM
+    * None
+  - File system console
+    * CGA
+  - Save configuration
+    * Save
 ===== \PLAN9\B =====
-  * //b.com - PC bootstrap program//
+  * //b.com ((//It is safer not to install the Extended Memory Manager before running b.com//.)) - PC bootstrap program//
 ^Remove Disk1 then reboot.^^
 |''C:\PLAN9\B''|''D:\PLAN9\B''|
-|Run FreeDOS 1.3  in //Safe Mode// (press #3).|
+|:!: Run FreeDOS 1.3  in //Safe Mode// (press #3, if not press #4).|
 |//''3 - Load FreeDOS low with some drivers (Safe Mode)''//|
+|//''4 - Load FreeDOS without drivers (Emergency Mode)''// ((//The FreeDOS ''EDIT.EXE'' cursor is missing//; ''C:\PLAN9\B.COM'' works.)) ((//Try FreeDOS text editors ''C:\APPS\EMACS\EMACS.EXE'' or ''VIM.EXE''.//))|
 ^Plan 9 Second Edition screen for: \PLAN9\B^
-|"File System Installation"|
+|//File System Installation//|
 ^File System Installation^
-|1. Install 3 Diskette System to local drive|
+|1. Install 3 Diskette System to local drive ((//Create notes for further review of the demo install//.))|
-|2. Install CD-ROM to local drive|
+|2. Install CD-ROM to local drive ((//Create notes for further review of the CD-ROM install//.)) ((//You must now configure the devices. Look at plan9.ini(8) in the manual to help understand the choices//))|
-|3a.Make a PC file server boot disk|
+|3a.Make a PC file server boot disk ((//Not reviewed in this tutorial//.))|
-|3b.Install CD-ROM to network file server|
+|3b.Install CD-ROM to network file server ((//Not reviewed in this tutorial//.))|
-|4. Make this PC a CPU and Authentication server|
+|4. Make this PC a CPU and Authentication server ((//Not reviewed in this tutorial//.))|
-|B.COM(8)|http://man.cat-v.org/plan_9_2nd_ed/8/b.com|
+  * Sufficient disc space
-===== System console =====
+|//File System Installation//||
+|1. Install 3 Diskette System to local drive||
+|**''2. Install CD-ROM to local drive''**||
+|''Select an ATAPI drive to load the distribution from:''||
+| |**''#H/atapi2disk''**|
+  * Insufficient disc space
+|//File System Installation//||
+|1. Install 3 Diskette System to local drive||
+|**''2. Install CD-ROM to local drive''**||
+|3a.Make a PC file server boot disk||
+| |**''There is insufficient disc space after the DOS partitions to install the system. You need to free 64718336 bytes. Press almost any key to continue...''**|
+|B.COM(8) ((//It is safer not to install the Extended Memory Manager before running b.com//.))|http://man.cat-v.org/plan_9_2nd_ed/8/b.com|
+==== CD-ROM ====
+|Load FreeDOS in //Safe Mode// to view the CD-ROM (//plan9-2e.iso//) at the ''E:\>''. While at the ''C:\>'' type ''E:'' then press the Return key.|
+<code>
+  Volume in drive E is PLAN 9 2ND
+  Directory of E:\
+</code>
+==== System console ====
 <file config failure, with console snippets>
@@ Line 499: / Line 583: @@
 term%
 </file>
+==== How to halt or shutdown ====
+Halt or shutdown the system.
+^Commands^
+|''disk/kfscmd sync''|
+|''disk/kfscmd halt''|
+  * Demo install
 <code>
@@ Line 511: / Line 605: @@
 </code>
+  * CD-ROM install
+<code>
+ term% man kfscmd|grep halt
+           halt      write all changed blocks and stop the file system.
+ term%
+</code>
+|KFSCMD(8)|http://man.cat-v.org/plan_9_2nd_ed/8/kfscmd|
+==== D:\> ====
+|x|CD-ROM Install|
+  * Postpone the //Demo// install if completing the //CD-ROM// install.
+  * The //user// is **''tor''** until //user// files are added to the //CD-ROM// installed files.
+    * A note about ''/usr/tor'' is located in the [[http://doc.cat-v.org/plan_9/2nd_edition/install|2. Install CD-ROM to local drive]] section (external link).
+  * The [[http://doc.cat-v.org/plan_9/2nd_edition/install|Setting up a stand-alone machine]] section suggests that //you should create a user name for yourself// (external link).
+|AUTH(8)|http://man.cat-v.org/plan_9_2nd_ed/8/auth|
+|NEWUSER(8)|http://man.cat-v.org/plan_9_2nd_ed/8/newuser|
+|ways to install|http://doc.cat-v.org/plan_9/2nd_edition/install|
+<code>
+  D:\PLAN9>more plan9.ini
+  mouseport=ps2
+  monitor=vga
+  vgasize=800x600x1
+  ata1=irq=15
+  auido0=type=sb16 port=0x220 irq=7 dma=5
+  console=cga
+  bootfile=h!1
+  D:\PLAN9>
+</code>
+==== CD install user login ====
+**From B.COM**:
+^ File Machine View Input Devices Help ^^
+| 5554 free pages, 22216K bytes, swap 108616K, highwater 1108k, headroom 1384K ||
+| CPU is a 128 MHz unknown (cpuid: ax 306c3 dx 178bfbbf) ||
+| root is from (local, 9600, 19200, il)[local!#H/hd1fs]: | ⇐ Press the Enter key.|
+^ File Machine View Input Devices Help ^^
+| 5554 free pages, 22216K bytes, swap 108616K, highwater 1108k, headroom 1384K ||
+| CPU is a 128 MHz unknown (cpuid: ax 306c3 dx 178bfbbf) ||
+| root is from (local, 9600, 19200, il)[local!#H/hd1fs]: ||
+| user[none]: USER | ⇐ Type the USER ((The //user// is **''tor''** until //user// files are added to the //CD-ROM// installed files.)) name, then press the Enter key. |
+| password: | ⇐ Press the Enter key.|
+==== D:\>plan9\b ====
+**From FreeDOS**:
+<code>
+  D:\>
+  D:\>plan9\b
+</code>
+**From B.COM**:
+<code>
+  root is from (local, 9600, 19200, il)[local!#H/hd1fs]:
+  user[none]: tor
+  password:
+</code>
+**From 8½ rc**:
+<code>
+  Welcome to Plan9.
+  This is rc.
+  term%
+</code>
+==== file transfer to C:\ ====
+Create the FreeDOS directory C:\FD9C
+<code>
+  term% cd /n/c:
+  term% mkdir fd9c
+  term% cd fd9c
+  term% pwd
+  /n/c:fd9c
+  term%
+</code>
+<code>
+  term% lc -l /bin/games >/n/c:fd9c/bingames.txt
+  term% cd /n/c:/fd9c
+  term% lc -l
+  --rw-rw-rw- M 8 bill trog 699 Dec 15 05:52 bingames.txt
+  term% cat bingames.txt
+  --rwxrwxr-x M 3 sys sys  70817 Apr  5  1995 4s
+  --rwxrwxr-x M 3 sys sys  73424 Apr  5  1995 5s
+  --rwxrwxr-x M 3 sys sys  30113 Apr  5  1995 ana
+  --rwxrwxr-x M 3 sys sys  66994 Apr  5  1995 catclock
+  --rwxrwxr-x M 3 sys sys  52998 Apr  5  1995 clock
+  --rwxrwxr-x M 3 sys sys  82700 Apr  5  1995 festoon
+  --rwxrwxr-x M 3 sys sys  43496 Apr  5  1995 fireworks
+  --rwxrwxr-x M 3 sys sys 224453 Apr  5  1995 fsim
+  --rwxrwxr-x M 3 sys sys  47330 Apr  5  1995 life
+  --rwxrwxr-x M 3 sys sys  61145 Apr  5  1995 mandel
+  --rwxrwxr-x M 3 sys sys 123862 Apr  5  1995 plumb
+  --rwxrwxr-x M 3 sys sys  98862 Apr  5  1995 road
+  --rwxrwxr-x M 3 sys sys  61740 Apr  5  1995 smiley
+  --rwxrwxr-x M 3 sys sys  78238 Apr  5  1995 swar
+  term% pwd
+  /n/c:/fd9c
+  term%
+</code>
+==== create a new user ====
+**From 8½ rc**:
+  * Create user ''none'' (for the CD-ROM install).
+<code>
+  term% pwd
+  /usr/tor
+  term% lc ..
+  tor
+  term% /sys/lib/kfsuser none
+  add user ’2:none:none:
+  ’term%
+</code>
+  * //Cause kfs to reread the ''/adm/users'' file//.
+<code>
+  term% disk/kfscmd user
+  term% pwd
+  /usr/tor
+  term% lc ..
+  none tor
+</code>
+  * Login as the new user and copy the mentioned files from ''/usr/tor''.
+  * //Even if you're planning to be the only person to use the machine, you should create a user name for yourself//.
+  * //Don't use [user] ''none'', which has special meaning in Plan 9//.
+|''/usr/tor/lib/first.window''|
+|''/usr/tor/lib/profile''|
+|''/usr/tor/bin/rc/8½start''|
+  * //The sequence for entering 8 1/2 on an IBM keyboard is// ''8-ALT-1-2''.
+  * For educational and informational purposes only. [[playground:plan_9_second_edition#disk1img|Networking]] is not [[playground:plan_9_second_edition#disk1img|supported]].
+==== /bin ====
+^art, art2pic - edit line-art^
+|ART(1)|http://man.cat-v.org/plan_9_2nd_ed/1/art|
+^tweak - edit bitmap files, subfont files, face files, etc.^
+|TWEAK(1)|http://man.cat-v.org/plan_9_2nd_ed/1/tweak|
+==== /bin/fb ====
+^cpr, cprview - cheesy polygon renderer and viewer^
+|CPR(9.1)|http://man.cat-v.org/plan_9_2nd_ed/9/cpr|
+^Manual pages - Section 1: Plan 9^
+|http://man.cat-v.org/plan_9_2nd_ed/1/|
+^The Use of Name Spaces in Plan 9^
+|http://doc.cat-v.org/plan_9/2nd_edition/papers/names|
+|https://plan9.io/sys/doc/names.pdf|
+^Plan 9 Volume 2 - The Documents^
+|http://doc.cat-v.org/plan_9/2nd_edition/papers/|
 ===== ISO image =====
@@ Line 530: / Line 798: @@
 ==== toobnix.org ====
-|games/fireworks|
+|games/fireworks ((//Included the CD-ROM install//.)) [[:playground:plan_9_second_edition#file_transfer_to_c|lc -l /bin/games]]|
 |Windowing system is 8½ which is closer to UNIX mux|