Mercurial > hg > Members > kono > nitros9-code

annotate 3rdparty/utils/gene/bootlink.doc @ 3199:dd553bb32ebb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
3rdparty: Changed the names of many disks for easier reading
author Bill Pierce <merlinious999@gmail.com>
date Tue, 06 Jun 2017 23:59:39 +0200
parents 2e740da2088e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2977
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
1 bootlink
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
2
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
3 A utility to facilitate using different boot vdisk images on a hard drive
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
4 as the next default vdisk to boot from.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
5
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
6 I'm an owner with both the superdriver, and HDB-DOS, the combination of which
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
7 seems to be at least as good as sliced bread or bottled beer.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
8 HDB-DOS opens up so many possibilities for os9 that I can't see a good
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
9 reason not to have it.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
10
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
11 One of the possibilities is being able to use the superdrivers /sh descriptor
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
12 to handle 99.9% of the bootup differences you can envision, like booting to
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
13 a bootfile composed so as to be a web server, and another one more designed
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
14 to develop programs in, and another just to run driverwire, or ultimuseIII,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
15 and the list probably includes all the os9 games ever written for level 2
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
16 also.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
17
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
18 Generally the default HDB-DOS disk it boots from is disk 128, aka $80 when
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
19 set into your /sh.dd descriptor. Generally it should look similar to this:
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
20
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
21 {t2|03}/DD/SRC:dmode /sh
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
22
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
23 nam=SH mgr=RBF ddr=rbsuper
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
24 hpn=07 hpa=FF74 drv=07 stp=80 typ=81 dns=08 cyl=0023 sid=01
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
25 vfy=01 sct=0012 t0s=0012 ilv=00 sas=08 wpc=1D ofs=BB90 rwc=
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
26
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
27 Where the 'stp' value, in hex, is the same as HDB=DOS's disk 128.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
28
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
29 Couple of things to note here.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
30
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
31 1. dos128 only does one thing that is guaranteed to come from that actual
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
32 virtual disk, and that is to load the boottrack from its track 34.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
33
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
34 2. Once that is loaded, and the stuff moved around so its located at the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
35 proper place in memory by relXX, then the boot module is entered. Its
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
36 a bit dumb and has no clue about the os9 file system or its directory
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
37 stucture. So it does the next best thing, it goes and reads the first
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
38 sector of the drive specified in the last byte of the boot module -4 bytes.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
39 I have not done this, but it follows that one could even get the OS9Boot
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
40 file FROM A DIFFERENT HARD DRIVE if you wanted to.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
41
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
42 Anyway, having read the LSN0 of the specified drive, it then looks at the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
43 5 bytes of where the file is in its absolute address on the drive, and how
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
44 big it is. These are the 3 bytes of offset DD.BT, and the 2 bytes that
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
45 follow which are DD.BSZ, its size. Then the boot module seeks to the DD.BT
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
46 specified location in the drive, and loads DD.BSZ worth of data, which it
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
47 hopes is the OS9Boot file.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
48
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
49 Because there is no absolute certainty that it is an os9boot file, my
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
50 offering here, bootlink, goes to extraordinary lengths to assure that
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
51 the address you pass it as the argument, actually IS an os9 formatted
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
52 35 track SS floppy image that was generated by os9gen, and has valid data
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
53 for its DD.BT and DD.BSZ entries and that a file named OS9Boot with an
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
54 $87CD as the first 2 bytes actually exists in this image. Failing any
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
55 one of those tests results in an error message and an exit without doing
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
56 anythng.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
57
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
58 Since you'll want to store some of your game disks, say using the first
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
59 50 HDB-DOS 'disks', in that case you could have 205 (talk about overkill)
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
60 different OS9Boot files to choose from just by running "bootlink xxx" or
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
61 $xx, it works with either format of input, and rebooting. It will get
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
62 the boottrack from the default drive, but then finish the custom boot
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
63 from any drive that has a valid bootable image backed up to it from a
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
64 floppy, best done with the HDB-DOS driveoff:backup0toxxx command. I
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
65 think I'd wind up with post-it notes all over so I could recall which
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
66 was which, but however you solve the record keeping is up to you. Some,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
67 or many of the games will have a custom boottrack, so you will probably
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
68 need to use the link.bas program to run those. Say you have DoD on
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
69 disk 33, you will probably need to run bootlink 033, reboot, chose H
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
70 after the green screen comes up, and then a "dos33" to run it.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
71
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
72 One final note, bootlink absolutely must have a 3 digit input argument.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
73 So it can be in the range of 000-255, or $00-$ff.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
74
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
75 I hope this is a useful tool.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
76
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
77 Cheers, Gene
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
78
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
79
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
80 A utility to facilitate using different boot vdisk images on a hard drive
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
81 as the next default vdisk to boot from.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
82 Copyright (C) 2014 Gene Heskett
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
83
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
84 This program is free software; you can redistribute it and/or
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
85 modify it under the terms of the GNU General Public License
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
86 as published by the Free Software Foundation; either version 2
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
87 of the License, or (at your option) any later version.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
88
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
89 This program is distributed in the hope that it will be useful,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
90 but WITHOUT ANY WARRANTY; without even the implied warranty of
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
91 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
92 GNU General Public License for more details.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
93
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
94 You should have received a copy of the GNU General Public License
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
95 along with this program; if not, write to the Free Software
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
96 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
97