annotate 3rdparty/utils/gene/vfy.doc @ 3118:ef66bdab9b45

mc09: Add mc09rtc command and GPIO registers defs in mc09.d New command mc09rtc to read/write a DS1802 RTC attached to multicomp09 GPIO. New help file mc09rtc.hp. Associated additions to mc09 makefile(s).
author Neal Crook <foofoobedoo@gmail.com>
date Tue, 01 Dec 2015 19:56:20 +0000
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 VFY Edition 16 docs
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 This utility is intended to be used as a replacement for the awkward to use
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
4 os9 utility "verify", but with the ability to do repairs and modifications to
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
5 the target file. These repairs/modifications are done 'insitu' to the named
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
6 file. It can also do the "split" operation on the named file, generating a
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
7 whole directory full of the individual modules of your merged files such as
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
8 "os9boot" or your boot time loaded "util" files.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
9
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
10 CAVEAT #1
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
11
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
12 Because it works on the named file, not a copy, be warned that this program
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
13 can also do a lot of damage if miss-used. If unsure of yourself in any way,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
14 make a backup copy of the file and work on it. Or if its your bootdisk, back
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
15 it up first! Even though I wrote this, I do exactly that! I do test
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
16 everything in this before I upload it for public usage, and I have not had
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
17 it break for anything in the "released" version since Edition 12 or before.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
18 Thats not to say it hasn't miss-behaved here, but the uploaded version is
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
19 solid, it will do exactly as you ask it to do!
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 Oh Well, edition 15 lasted a week. Nothing wrong with it (that I know of),
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
22 but there were a couple more bells and whistles that were just begging to be
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
23 added. I had written it originally to have total control over its
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
24 verbosity, but had never actually added the command line option to control
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
25 it. Now it has it. A "-v" in the option area will shut all reporting off,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
26 nary a squeek unless an error is returned which will make it spit out the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
27 help screen on its way to the exit and the system which will report it as
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
28 usual. Edition is now 16, and the ty/rv byte is back to $81. As before, all
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
29 screen output is thru the stderr path, so redirect it ">>" if you want a
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
30 record file to be made.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
31
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
32 Edition 16's big change is that it now implements the ability to fix any one
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
33 "named on the command line" module in the whole file. If a name is given on
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
34 the command line, then each modules name is compared to the command line
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
35 name, case insensitive, and when the match is found, the options updates are
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
36 done to this named module only. It then reverts to a report only mode for
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
37 the rest of the file. As in earlier versions, if no name is given, the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
38 first module only is fixed if one of the ty/la, at/rv or datasize is given
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
39 update/change status.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
40
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
41 Edition 15 fixed a long standing error in how the INIT module data was
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
42 displayed, and now skips the Exec and Data displays for device descriptors.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
43
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
44 For a quick syntax message, just type "vfy" with no options.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
45
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
46 To recap, if a -u(a,t,r,l,d)=$xx type entry is given on the cmnd line, the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
47 first (or the named one if -n=name is used) module encountered in "file"
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
48 will be modified accordingly. Someone did squawk about the $ sign, but I
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
49 still left that requirement in because it reminds the user this IS hex data
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
50 it wants, not decimal or some other number base.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
51
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
52 The (-ua=$hexdata etc) header repairs will only be re-written if a change
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
53 has taken place, and only for the first (named module if -n=name used now)
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
54 module found in a file if the -f isn't in effect. The first (or named) ones
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
55 crc will also be updated. Modules further into the file will not be fixed
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
56 if the -f option isn't used unless the -n=name option is used.
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 If the -f option is used, all of the modules in "file" will be repaired.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
59 Only the first will be subjected to the header (-ua=$hexchar etc) fixes in
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
60 that event, the rest being only updated if there is in fact an error found.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
61 I don't recommend including the -u stuffs without nameing the module they
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
62 are to be applied to as a matter of habitual usage. It might save a headache
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
63 someday!
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
64
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
65 It will still print the S/B $xx (Good) message and the "Repaired to $xx"
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
66 message if -f, even if no actual changes were made. It will beep if any
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
67 changes were in fact made to the module currently being scanned.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
68
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
69 The -ud=$hexdata needs further clarification. The addition is modulo 65536,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
70 a fancy way of saying it throws away the carry if the result of your
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
71 addition is >65536. In other words, to reduce the datasize in the module by
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
72 $100 bytes, add $FF00, not -$0100. It only keeps the last 4 digits you give
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
73 it on the command line too. Less than 4 default to $000yourdigit etc.
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 Also in need of clarification are the -s and -sk options.
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 The -s option causes it to split the target file (without inflicting any
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
78 damages other than the -u or -f might do to each module first) into
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
79 individual modules in the current working directory, a great way to take
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
80 your os9boot file apart. If a -u was used, the modified version is split to
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
81 disk file.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
82
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
83 If the -sk option is used, vfy ASSUMES you are naming a kernal track of a
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
84 bootable disk as the target file to read. This "filename" is best generated
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
85 by running my "krnl_to_dir" utility on the bootable diskette (which is not
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
86 write protected of course) which will look for an unused sector on the disk,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
87 allocate it, enter the required file descriptor information describing the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
88 kernel track (it assumes track 34 is the kernel) and make a directory entry
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
89 in the root directory of that disk, effectively converting the hidden kernel
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
90 track that only dcheck can find and report as 18 errors, into a normally
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
91 accessable file. That "krnl_to_dir" is in another archive I uploaded called
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
92 "krnlutils" in the delphi os9 database and on chestnut.
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 Once that is done, then vfy's -sk option will split it up into its 5 component
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
95 files.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
96
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
97 Caveat #2
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
98
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
99 Please note however that this "krnl_to_dir" generated file is not one that
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
100 can be copied from one disk to another (and be expected to work) with *any*
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
101 known utility other than my own "krnlmvr" which requires the write target
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
102 disk to have the directory entry krnlmvr uses already installed by
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
103 krnl_to_dir. The 5 files it makes CAN be freely copied, merged, cpa'd, etc
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
104 to make up the replacement KERNAL to copy back with "krnlmvr". I'm not
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
105 saying there isn't another copier that overwrites, only that I haven't found
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
106 it after diligent searching.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
107
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
108 For more info, see the archive "krnlutils" by myself. I could not find a
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
109 copy util in the whole os9 world that actually would over-write the targeted
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
110 file insitu. So I wrote krnlmvr. Why? Because it was one heck of a lot
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
111 easier to use than the utils furnished to install kernel track patches for
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
112 the earlier releases of Nitros9. Its worked so well that I've not used the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
113 Nitros9 furnished method since!
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
114
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
115 Caveat #3
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
116
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
117 Don't *ever* delete that now visible 'KERNAL' file on your bootable diskette
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
118 if you want it to stay bootable after something else has been written to
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
119 this diskette! If you want to hide it again once you are done making mods,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
120 use dEd to clear the name in the directory itself. I think the B&B "zap"
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
121 utility might also be safe to use but I haven't tried it. To totally
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
122 restore the disk so it doesn't show in the directory, find that allocated
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
123 for the FD sector using ded to look at the address in the last 3 bytes of
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
124 the directory entry and "bd" it. Or figure out which bit to clear in the
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
125 FAT.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
126
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
127 COPY RIGHTS and DISK CLAIMERS
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
128
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
129 As usual, this is Copyright (c) 1993, 1994 and 1995 by Maurice E.(Gene)
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
130 Heskett. It may be freely copied and used provided no intended profit is
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
131 realized other than the cost of the media. As one of its functions (-sk) has
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
132 been a great help to me in upgrading the kernal track for the later versions
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
133 of the os9/6309 opsys commonly called "NITROS9", permission for it to be
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
134 included as part of that distribution is hereby given to Colin McKay and
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
135 Alan Dekok, a.k.a. Northern Xposure. The cost of that software may not be
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
136 adjusted upward just because this program is included unless that puts it
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
137 over into another diskette to contain the complete package. It may also be
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
138 included in the patch collections available for os9 under the same
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
139 limitations. The ONLY limitation being that this archive's contents must be
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
140 included without modification in such distributions so that this .doc file,
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
141 however verbose, remains intact to the end users site.
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
142
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
143 I also make no claims about its suitability for the job. If your coffee
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
144 maker only makes bad bourbon after using this, I am not responsible, however
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
145 I would like an email message describing the exact circumstances under which
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
146 that error occured. Maybe I can fine tune it to make good bourbon! I seem to
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
147 be better at that than most. (Grin)
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
148
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
149 Cheers all, WDTV5@delphi.com
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
150
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
151
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
152 An os9 utility for verifying module files
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
153 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
154
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
155 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
156 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
157 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
158 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
159
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
160 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
161 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
162 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
163 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
164
2e740da2088e 3rdparty/utils: Add disk with Gene's bootlink and vfy utilities
Tormod Volden <debian.tormod@gmail.com>
parents:
diff changeset
165 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
166 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
167 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
168