Mercurial > hg > Members > kono > nitros9-code
annotate defs/rbfdefs @ 1266:7cb546cb7e80
Moved Eliminator NVRAM call into clock2 for that RTC
| author | boisy |
|---|---|
| date | Tue, 19 Aug 2003 04:21:47 +0000 |
| parents | 383d5981c23f |
| children | 7e26b1ec9738 |
| rev | line source |
|---|---|
| 1199 | 1 IFEQ RBFDEFS |
|
373
c07686556109
Added ifeq statements at top to allow for multiple use's of same def
boisy
parents:
71
diff
changeset
|
2 |
|
c07686556109
Added ifeq statements at top to allow for multiple use's of same def
boisy
parents:
71
diff
changeset
|
3 RBFDEFS set 1 |
|
c07686556109
Added ifeq statements at top to allow for multiple use's of same def
boisy
parents:
71
diff
changeset
|
4 |
| 1200 | 5 ******************************************************************** |
| 6 * RBFDefs - Random Block File Manager Definitions | |
| 0 | 7 * |
| 1200 | 8 * $Id$ |
| 9 * | |
| 1199 | 10 * RBF stands for 'Random Block Filemanager' and is a package of subroutines |
| 11 * that define the logical structure of a disk and allows access to the files | |
| 12 * in that structure. | |
| 13 * | |
| 14 * The data structures in this file give RBF its 'personality' and are used | |
| 15 * by RBF itself, as well as applications that will require disk I/O. | |
| 1200 | 16 * |
| 17 * Edt/Rev YYYY/MM/DD Modified by | |
| 18 * Comment | |
| 19 * ------------------------------------------------------------------ | |
| 20 * 1982/07/13 Robert F. Doggett | |
| 21 * PD.Exten added to path descriptor and PE Entries defined. | |
| 22 * | |
| 23 * 1982/07/15 Robert F. Doggett | |
| 24 * V.FileHd inserted in driver static storage. | |
| 25 * | |
| 26 * 1982/09/10 WGP | |
| 27 * Level One/Level Two condionals added. | |
| 28 * | |
| 29 * 1982/09/17 WGP | |
| 30 * | |
| 31 * 1982/09/17 Robert F. Doggett | |
| 32 * PD.SLE renamed to PD.Creat. | |
| 33 * | |
| 34 * 1982/09/17 Robert F. Doggett | |
| 35 * V.DiskID, V.BMapSz, V.MapSct added for smart multi-sector bitmap searching. | |
| 36 * | |
| 37 * 1982/09/20 Robert F. Doggett | |
| 38 * Reserved areas added in static storage. | |
| 39 | |
| 40 * 1983/06/07 Robert F. Doggett | |
| 41 * Added InDriver flag in PD.SMF. | |
| 42 * | |
| 43 * 1983/06/13 Robert F. Doggett | |
| 44 * Added PE.Req tmp save for PE.Lock. | |
| 45 * | |
| 46 * 1983/08/08 Robert F. Doggett | |
| 47 * Reserved PD.SToff for Japanese. | |
| 48 * | |
| 49 * 1983/11/19 Robert F. Doggett | |
| 50 * Added V.ResBit in drive tables. | |
| 51 * | |
| 52 * 1983/12/12 Robert F. Doggett | |
| 53 * Added PE.Prior to save process priority. | |
| 54 * | |
| 55 * 1983/12/13 Robert F. Doggett | |
| 56 * Added BufBusy bit in state flag (PD.SMF). | |
| 57 * | |
| 58 * 1984/07/06 Mark G. Hawkins | |
| 59 * Added Bit Definitions for DD.FMT. | |
| 60 * | |
| 61 * 1987/06/23 Kevin K. Darling | |
| 62 * Updated with Dev Desc Info | |
| 63 * | |
| 64 * 2003/06/02 Boisy G. Pitre | |
| 65 * Updated comments for clarity. | |
|
1205
383d5981c23f
Updated for anticipation of 256-2048 byte sector support
boisy
parents:
1200
diff
changeset
|
66 * Added TYP.256-TYP.2048 definitions for future expansion. |
| 1200 | 67 |
| 68 nam RBFDefs | |
| 69 ttl Random Block File Manager Definitions | |
| 1199 | 70 |
| 0 | 71 |
| 1200 | 72 pag |
| 0 | 73 ******************************* |
| 74 * RBF Device Descriptor Offsets | |
| 75 * | |
| 1199 | 76 * These definitions are for RBF device descriptors. |
| 77 | |
| 0 | 78 org M$DTyp |
| 1199 | 79 rmb 1 Device type (DT.RBF) |
| 0 | 80 IT.DRV rmb 1 Drive number |
| 81 IT.STP rmb 1 Step rate | |
| 1199 | 82 IT.TYP rmb 1 Disk device type information |
| 0 | 83 IT.DNS rmb 1 Density capability |
| 84 IT.CYL rmb 2 Number of cylinders | |
| 85 IT.SID rmb 1 Number of surfaces | |
| 1199 | 86 IT.VFY rmb 1 Verify disk writes (0 = verify, 1 = don't) |
| 0 | 87 IT.SCT rmb 2 Default sectors/track |
| 1199 | 88 IT.T0S rmb 2 Default sectors/track for track 0 sector 0 |
| 0 | 89 IT.ILV rmb 1 Sector interleave offset |
| 90 IT.SAS rmb 1 Segment allocation size | |
| 91 | |
| 1199 | 92 * IT.TYP/IT.DNS/IT.STP bit definitions |
| 0 | 93 * |
|
1205
383d5981c23f
Updated for anticipation of 256-2048 byte sector support
boisy
parents:
1200
diff
changeset
|
94 TYP.256 equ %00000000 256 byte sector device |
|
383d5981c23f
Updated for anticipation of 256-2048 byte sector support
boisy
parents:
1200
diff
changeset
|
95 TYP.512 equ %00000010 512 byte sector device |
|
383d5981c23f
Updated for anticipation of 256-2048 byte sector support
boisy
parents:
1200
diff
changeset
|
96 TYP.1024 equ %00000100 1024 byte sector device |
|
383d5981c23f
Updated for anticipation of 256-2048 byte sector support
boisy
parents:
1200
diff
changeset
|
97 TYP.2048 equ %00000110 2048 byte sector device |
|
383d5981c23f
Updated for anticipation of 256-2048 byte sector support
boisy
parents:
1200
diff
changeset
|
98 TYP.SSM equ %00000110 Sector size mask |
| 1199 | 99 TYP.FLP equ %00000000 Floppy disk |
| 100 TYP.HARD equ %10000000 Hard disk | |
| 101 | |
| 102 * The following TYP and DNS bit definitions are applicable | |
| 103 * only if the TYP.FLP bit is clear. | |
| 0 | 104 TYP.5 equ %00000000 5" media |
| 105 TYP.8 equ %00000001 8" media | |
| 106 TYP.CCF equ %00100000 CoCo format | |
| 107 TYP.NCCF equ %00000000 Non-CoCo format | |
| 108 TYP.SOF equ %00000000 Standard OS-9 format | |
| 109 TYP.NSF equ %01000000 Non-standard format | |
| 110 | |
| 1199 | 111 * Density bit definitions |
| 0 | 112 DNS.FM equ %00000000 Single-density (FM) |
| 113 DNS.MFM equ %00000001 Double-density (MFM) | |
| 114 DNS.STD equ %00000000 Single track density (48 tpi) | |
| 115 DNS.DTD equ %00000010 Single track density (96 tpi) | |
| 116 | |
| 1199 | 117 * Floppy disk step rate definitions |
| 480 | 118 IFEQ Level-1 |
| 119 STP.30ms equ 3 30ms step rate | |
| 120 STP.20ms equ 2 20ms step rate | |
| 121 STP.12ms equ 1 12ms step rate | |
| 122 STP.6ms equ 0 6ms step rate | |
| 123 ELSE | |
| 0 | 124 STP.30ms equ 0 30ms step rate |
| 125 STP.20ms equ 1 20ms step rate | |
| 126 STP.12ms equ 2 12ms step rate | |
| 127 STP.6ms equ 3 6ms step rate | |
| 480 | 128 ENDC |
| 0 | 129 |
| 1200 | 130 pag |
| 0 | 131 ************************************* |
| 132 * Random Block Path Descriptor Format | |
| 133 * | |
| 1199 | 134 * A path descriptor is created for every new path that is open |
| 135 * via the I$Open system call (processed by IOMan). Process | |
| 136 * descriptors track state information of a path. | |
| 137 * | |
| 0 | 138 org PD.FST |
| 139 PD.SMF rmb 1 State flags | |
| 140 PD.CP rmb 4 Current logical byte position | |
| 141 PD.SIZ rmb 4 File size | |
| 142 PD.SBL rmb 3 Segment beginning lsn | |
| 143 PD.SBP rmb 3 Segment beginning psn | |
| 144 PD.SSZ rmb 3 Segment size | |
| 145 PD.DSK rmb 2 Disk id | |
| 146 PD.DTB rmb 2 Drive table ptr | |
| 147 org PD.OPT | |
| 148 rmb 1 Device type | |
| 149 PD.DRV rmb 1 Drive number | |
| 150 PD.STP rmb 1 Step rate | |
| 151 PD.TYP rmb 1 Disk device type (5" 8" other) | |
| 152 PD.DNS rmb 1 Density capability | |
| 153 PD.CYL rmb 2 Number of cylinders | |
| 154 PD.SID rmb 1 Number of surfaces | |
| 155 PD.VFY rmb 1 0=verify disk writes | |
| 156 PD.SCT rmb 2 Default sectors/track | |
| 157 PD.T0S rmb 2 Default sectors/track tr00,s0 | |
| 158 PD.ILV rmb 1 Sector interleave offset | |
| 159 PD.SAS rmb 1 Segment allocation size | |
| 160 PD.TFM rmb 1 DMA Transfer Mode | |
| 161 PD.Exten rmb 2 Path Extension (PE) for record locking | |
| 162 PD.SToff rmb 1 Sector/Track offsets (for "foreign" disk formats) | |
| 163 PD.ATT rmb 1 File attributes | |
| 164 PD.FD rmb 3 File descriptor psn | |
| 165 PD.DFD rmb 3 Directory file descriptor psn | |
| 166 PD.DCP rmb 4 File directory entry ptr | |
| 167 PD.DVT rmb 2 User readable dev tbl ptr | |
| 168 | |
| 169 * State Flags | |
| 170 BUFMOD equ $01 Buffer modified | |
| 171 SINBUF equ $02 Sector in buffer | |
| 172 FDBUF equ $04 File descriptor in buffer | |
| 173 *EOFSEC equ $08 End of file sector | |
| 174 *EOF equ $10 End of file | |
| 175 InDriver equ $20 Currently in Disk Driver, or queued | |
| 176 BufBusy equ $40 Buffer is currently busy | |
| 177 | |
| 1199 | 178 IFNE Level-1 |
| 0 | 179 ************************************ |
| 180 * Random Block Path Extension Format | |
| 181 * | |
| 1199 | 182 * RBF paths under Level Two have additional information that |
| 183 * is referenced by the path extension area. | |
| 184 * | |
| 0 | 185 org 0 |
| 186 PE.PE rmb 1 PE path number | |
| 1199 | 187 PE.PDptr rmb 2 Back ptr to this PE's Path Descriptor |
| 0 | 188 PE.NxFil rmb 2 Drive Open-File list ptr |
| 1199 | 189 PE.Confl rmb 2 Circular File Conflict list |
| 0 | 190 PE.Lock rmb 1 Path lockout status |
| 191 PE.LoLck rmb 4 Low Locked Logical addr | |
| 192 PE.HiLck rmb 4 High Locked Logical addr | |
| 193 PE.Wait rmb 2 PE ptr to (next) locked-out PE | |
| 194 PE.TmOut rmb 2 Max ticks to wait for locked segment | |
| 195 PE.Owner rmb 1 Process ID of owner of locked segment | |
| 1199 | 196 PE.Req rmb 1 Temp for PE.Lock in GAIN when LockSeg fails |
| 197 PE.Prior rmb 1 Temp for process priority while in driver | |
| 198 PE.SigSg rmb 1 Signal code to send | |
| 199 PE.SigID rmb 1 Process ID to send the signal to | |
| 200 rmb 32-. Reserved | |
| 201 PE.FilNm rmb 32 Temp for filename during directory search | |
| 0 | 202 |
| 203 * PE.Lock status codes | |
| 1199 | 204 Unlocked equ 0 No portion of file is locked |
| 205 RcdLock equ 1 Record from LoLck to HiLck locked | |
| 206 FileLock equ 2 Entire file locked | |
| 0 | 207 EofLock equ 4 End of file is locked |
| 1199 | 208 ENDC |
| 209 | |
| 0 | 210 |
| 1200 | 211 pag |
| 0 | 212 *********************** |
| 213 * LSN0 Disk Data Format | |
| 214 * | |
| 1199 | 215 * Logical Sector Number 0 is the first sector on an RBF formatted device |
| 216 * and contains information about the device's size and format. | |
| 217 * | |
| 0 | 218 org 0 |
| 219 DD.TOT rmb 3 Total number of sectors | |
| 220 DD.TKS rmb 1 Track size in sectors | |
| 221 DD.MAP rmb 2 Number of bytes in allocation bit map | |
| 222 DD.BIT rmb 2 Number of sectors/bit | |
| 223 DD.DIR rmb 3 Address of root directory fd | |
| 224 DD.OWN rmb 2 Owner | |
| 225 DD.ATT rmb 1 Attributes | |
| 1199 | 226 DD.DSK rmb 2 Disk ID |
| 0 | 227 DD.FMT rmb 1 Disk format; density/sides |
| 228 DD.SPT rmb 2 Sectors/track | |
| 229 DD.RES rmb 2 Reserved for future use | |
| 230 DD.SIZ equ . Device descriptor minimum size | |
| 231 DD.BT rmb 3 System bootstrap sector | |
| 232 DD.BSZ rmb 2 Size of system bootstrap | |
| 233 DD.DAT rmb 5 Creation date | |
| 234 DD.NAM rmb 32 Volume name | |
| 1199 | 235 DD.OPT rmb 32 Option area |
| 0 | 236 |
| 1199 | 237 * DD.FMT Bit Definitions - valid only if device is a floppy disk |
| 0 | 238 FMT.SIDE equ %00000001 Single Side=0, Double Side=1 |
| 239 FMT.DNS equ %00000010 Single DNS=0, Double DNS=1 | |
| 240 FMT.TDNS equ %00000100 48tpi=0, 96tpi=1 | |
| 241 FMT.T0DN equ %00100000 Track 0 DNS, see FMT.DNS | |
| 242 | |
| 1199 | 243 |
| 1200 | 244 pag |
| 0 | 245 ************************ |
| 246 * File Descriptor Format | |
| 247 * | |
| 1199 | 248 * The file descriptor is a sector that is present for every file |
| 249 * on an RBF device. It contains attributes, modification dates, | |
| 250 * and segment information on a file. | |
| 251 * | |
| 0 | 252 org 0 |
| 253 FD.ATT rmb 1 Attributes | |
| 254 FD.OWN rmb 2 Owner | |
| 255 FD.DAT rmb 5 Date last modified | |
| 256 FD.LNK rmb 1 Link count | |
| 257 FD.SIZ rmb 4 File size | |
| 258 FD.Creat rmb 3 Segment list extension | |
| 259 FD.SEG equ . Beginning of segment list | |
| 260 * Segment List Entry Format | |
| 261 org 0 | |
| 262 FDSL.A rmb 3 Segment beginning physical sector number | |
| 263 FDSL.B rmb 2 Segment size | |
| 264 FDSL.S equ . Segment list entry size | |
| 265 FD.LS1 equ FD.SEG+((256-FD.SEG)/FDSL.S-1)*FDSL.S | |
| 266 FD.LS2 equ (256/FDSL.S-1)*FDSL.S | |
| 267 MINSEC set 16 | |
| 268 | |
| 1199 | 269 |
| 1200 | 270 pag |
| 0 | 271 ************************ |
| 272 * Directory Entry Format | |
| 273 * | |
| 1199 | 274 * Directory entries are part of a directory and define the name |
| 275 * of the file, as well as a pointer to its file descriptor. | |
| 276 * | |
| 0 | 277 org 0 |
| 278 DIR.NM rmb 29 File name | |
| 279 DIR.FD rmb 3 File descriptor physical sector number | |
| 280 DIR.SZ equ . Directory record size | |
| 281 | |
| 1199 | 282 |
| 1200 | 283 pag |
| 284 ******************** | |
| 285 * RBF Static Storage | |
| 0 | 286 * |
| 287 * Overall Disk Static Storage | |
| 288 * | |
| 1199 | 289 * Note: This does not reserve any memory for drive tables. Each |
| 290 * driver is responsible for reserving sufficient memory for | |
| 291 * the appropriate number of tables. | |
| 0 | 292 * |
| 293 org V.USER Reserve required ($06) | |
| 294 V.NDRV rmb 1 Number of drives ($07) | |
| 295 rmb 8 reserved ($08) | |
| 296 DRVBEG equ . Beginning of drive tables ($10) | |
| 1199 | 297 |
| 298 | |
| 1200 | 299 pag |
| 1199 | 300 **************** |
| 0 | 301 * Global Storage For Disk Drive Tables |
| 1199 | 302 * |
| 303 * Each table contains the first 'DD.SIZ' bytes from | |
| 304 * LSN 0, and the current track, stepping rate, | |
| 305 * bitmap use flag, and disk type. | |
| 0 | 306 * |
| 307 org 0 | |
| 1199 | 308 rmb DD.SIZ Device descriptor, LSN 0 |
| 0 | 309 V.TRAK rmb 2 Current track |
| 310 V.BMB rmb 1 Bit-map use flag | |
| 1199 | 311 V.FileHd rmb 2 Open file list for this drive |
| 0 | 312 V.DiskID rmb 2 Disk ID |
| 313 V.BMapSz rmb 1 Bitmap Size | |
| 1199 | 314 V.MapSct rmb 1 Lowest reasonable bitmap sector |
| 315 V.ResBit rmb 1 Reserved bitmap sector (for compaction) | |
| 0 | 316 V.ScTkOf rmb 1 Sector/Track byte (Combined from descriptor) |
| 317 V.ScOfst rmb 1 Sector offset split from byte above | |
| 318 V.TkOfst rmb 1 Track offset split from byte above | |
| 1199 | 319 rmb 4 Reserved |
| 0 | 320 DRVMEM equ . |
| 321 | |
| 1199 | 322 ENDC |
|
373
c07686556109
Added ifeq statements at top to allow for multiple use's of same def
boisy
parents:
71
diff
changeset
|
323 |