Difference between revisions of "Handles"
m (→Special cases) |
(XDFS provisional allocation) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
[[Category:Filing]] | [[Category:Filing]] | ||
===Summary=== | ===Summary=== | ||
| − | CFS | + | CFS &01-&02 SRAMFS &16-&18 DOSFS &40-&47 IOFS &80-&9F |
| − | + | ROMFS &03 HADFS &19-&1D VFS &50-&59 LINKFS &A0-&AF | |
| − | + | TFS &0E-&0F LanManFS &20-&23 RAMFS &60-&64 BEEBITFS &B0-&BF | |
| − | DFS | + | VaxHostFS &0E-&0F NFS &20-&27 ARAMFS &60-&65 COPROFS &C0-&CC |
| − | HDFS | + | DFS &11-&15 ANFS &20-&2F (XDFS &70-&7A) IEEEFS &F0-&FF |
| − | + | HDFS &12-&17 ADFS &30-&39 HOSTFS &80-&9F NEXUSFS | |
| + | |||
| + | XDFS provisional allocation | ||
===Full List=== | ===Full List=== | ||
| − | &00 0 No opened file &50 80 VFS &B0 176 BeebItFS | + | &00 0 No opened file &50 80 VFS &B0 176 BeebItFS, BeebLink |
| − | &01 1 CFS (in) &51 81 VFS &B1 177 BeebItFS | + | &01 1 CFS (in) &51 81 VFS &B1 177 BeebItFS, BeebLink |
| − | &02 2 CFS (out) &52 82 VFS &B2 178 BeebItFS | + | &02 2 CFS (out) &52 82 VFS &B2 178 BeebItFS, BeebLink |
| − | &03 3 ROMFS &53 83 VFS &B3 179 BeebItFS | + | &03 3 ROMFS &53 83 VFS &B3 179 BeebItFS, BeebLink |
| − | &04 4 &54 84 VFS &B4 180 BeebItFS | + | &04 4 &54 84 VFS &B4 180 BeebItFS, BeebLink |
| − | &05 5 &55 85 VFS &B5 181 BeebItFS | + | &05 5 &55 85 VFS &B5 181 BeebItFS, BeebLink |
| − | &06 6 &56 86 VFS &B6 182 BeebItFS | + | &06 6 &56 86 VFS &B6 182 BeebItFS, BeebLink |
| − | &07 7 &57 87 VFS &B7 183 BeebItFS | + | &07 7 &57 87 VFS &B7 183 BeebItFS, BeebLink |
| − | &08 8 &58 88 VFS &B8 184 BeebItFS | + | &08 8 &58 88 VFS &B8 184 BeebItFS, BeebLink |
| − | &09 9 &59 89 VFS &B9 185 BeebItFS | + | &09 9 &59 89 VFS &B9 185 BeebItFS, BeebLink |
| − | &0A 10 &5A 80 &BA 186 BeebItFS | + | &0A 10 &5A 80 &BA 186 BeebItFS, BeebLink |
| − | &0B 11 &5B 91 &BB 187 BeebItFS | + | &0B 11 &5B 91 &BB 187 BeebItFS, BeebLink |
| − | &0C 12 &5C 92 &BC 188 BeebItFS | + | &0C 12 &5C 92 &BC 188 BeebItFS, BeebLink |
| − | &0D 13 &5D 93 &BD 189 BeebItFS | + | &0D 13 &5D 93 &BD 189 BeebItFS, BeebLink |
| − | &0E 14 TFS | + | &0E 14 TFS, VaxHostFS &5E 94 &BE 190 BeebItFS, BeebLink |
| − | &0F 15 TFS | + | &0F 15 TFS, VaxHostFS &5F 95 &BF 191 BeebItFS, BeebLink |
&10 16 &60 96 Acacia RAMFS, RAMFS &C0 192 COPROFS | &10 16 &60 96 Acacia RAMFS, RAMFS &C0 192 COPROFS | ||
| Line 77: | Line 79: | ||
&3F 63 &9F 159 IOFS, HostFS &EF 239 | &3F 63 &9F 159 IOFS, HostFS &EF 239 | ||
| − | &40 64 DOSFS &A0 160 LFS | + | &40 64 DOSFS &A0 160 LFS, BeebLink* &F0 240 IEEEFS |
| − | &41 65 DOSFS &A1 161 LFS | + | &41 65 DOSFS &A1 161 LFS, BeebLink* &F1 241 IEEEFS |
| − | &42 66 DOSFS &A2 162 LFS | + | &42 66 DOSFS &A2 162 LFS, BeebLink* &F2 242 IEEEFS |
| − | &43 67 DOSFS &A3 163 LFS | + | &43 67 DOSFS &A3 163 LFS, BeebLink* &F3 243 IEEEFS |
| − | &44 68 DOSFS &A4 164 LFS | + | &44 68 DOSFS &A4 164 LFS, BeebLink* &F4 244 IEEEFS |
| − | &45 69 DOSFS &A5 165 LFS | + | &45 69 DOSFS &A5 165 LFS, BeebLink* &F5 245 IEEEFS |
| − | &46 70 DOSFS &A6 166 LFS | + | &46 70 DOSFS &A6 166 LFS, BeebLink* &F6 246 IEEEFS |
| − | &47 71 DOSFS &A7 167 LFS | + | &47 71 DOSFS &A7 167 LFS, BeebLink* &F7 247 IEEEFS |
| − | &48 72 &A8 168 LFS | + | &48 72 &A8 168 LFS, BeebLink* &F8 248 IEEEFS |
| − | &49 73 &A9 169 LFS | + | &49 73 &A9 169 LFS, BeebLink* &F9 249 IEEEFS |
| − | &4A 74 &AA 170 LFS | + | &4A 74 &AA 170 LFS, BeebLink* &FA 250 IEEEFS |
| − | &4B 75 &AB 171 LFS | + | &4B 75 &AB 171 LFS, BeebLink* &FB 251 IEEEFS |
| − | &4C 76 &AC 172 LFS | + | &4C 76 &AC 172 LFS, BeebLink* &FC 252 IEEEFS |
| − | &4D 77 &AD 173 LFS | + | &4D 77 &AD 173 LFS, BeebLink* &FD 253 IEEEFS |
| − | &4E 78 &AE 174 LFS | + | &4E 78 &AE 174 LFS, BeebLink* &FE 254 IEEEFS |
| − | &4F 79 &AF 175 LFS | + | &4F 79 &AF 175 LFS, BeebLink* &FF 255 IEEEFS |
===Special cases=== | ===Special cases=== | ||
| Line 102: | Line 104: | ||
: OSBGET#0 reads from OSRDCH | : OSBGET#0 reads from OSRDCH | ||
: OSBPUT#0 writes to OSWRCH | : OSBPUT#0 writes to OSWRCH | ||
| − | : EOF#0 returns | + | : EOF#0 returns TRUE if the next OSBGET#0 or OSRDCH/GET/INKEY will not return a character without waiting, ie <code>IF NOT EOF#0 THEN key%=GET</code> |
: PTR#0 returns platform-specific information | : PTR#0 returns platform-specific information | ||
: EXT#0 returns platform-specific information | : EXT#0 returns platform-specific information | ||
| Line 118: | Line 120: | ||
| style="text-align:left;" | BBC MOS and CoPros || untested || untested || || error or -1 || 0 || 0 | | style="text-align:left;" | BBC MOS and CoPros || untested || untested || || error or -1 || 0 || 0 | ||
|- align="center" valign="top" | |- align="center" valign="top" | ||
| − | | style="text-align:left;" | ARM Development System || OSRDCH || OSWRCH || OSWRCH / OSRDCH || untested || untested || untested | + | | style="text-align:left;" | ARM Development System[1] || <s>OSRDCH</s> || <s>OSWRCH</s> || <s>OSWRCH / OSRDCH</s> || untested || untested || untested |
|- align="center" valign="top" | |- align="center" valign="top" | ||
| − | | style="text-align:left;" | PDP11 CoPro || OSRDCH || OSWRCH || || untested || untested || untested | + | | style="text-align:left;" | PDP11 CoPro || OSRDCH[2] || OSWRCH[2] || || untested || untested || untested |
|- align="center" valign="top" | |- align="center" valign="top" | ||
| style="text-align:left;" | TubeHost || OSRDCH || OSWRCH || || 0 if keypress pending || untested || untested | | style="text-align:left;" | TubeHost || OSRDCH || OSWRCH || || 0 if keypress pending || untested || untested | ||
| Line 134: | Line 136: | ||
| style="text-align:left;" | Sinclair Z88 || untested || untested || || 0=unexpanded, -1=expanded || b0-b15=ROM version, b16=b31=number of<br> handles remaining || amount of free system memory | | style="text-align:left;" | Sinclair Z88 || untested || untested || || 0=unexpanded, -1=expanded || b0-b15=ROM version, b16=b31=number of<br> handles remaining || amount of free system memory | ||
|} | |} | ||
| − | + | [1] I'm sure there is an ARM system that does this, needs further investigation<br> | |
| + | [2] Build option | ||
===Notes=== | ===Notes=== | ||
| Line 150: | Line 153: | ||
LanManFS clashes with NFS/ANFS, but the hardware cannot be present at the | LanManFS clashes with NFS/ANFS, but the hardware cannot be present at the | ||
same time as the LanManFS Ethernet card plugs into the Econet card sockets. | same time as the LanManFS Ethernet card plugs into the Econet card sockets. | ||
| + | |||
| + | BeebLink* entries are used by the BeebLink Test FS ROM, which can coexist | ||
| + | with the ordinary BeebLink ROM while testing. | ||
===References=== | ===References=== | ||
Latest revision as of 02:33, 4 September 2023
Summary
CFS &01-&02 SRAMFS &16-&18 DOSFS &40-&47 IOFS &80-&9F ROMFS &03 HADFS &19-&1D VFS &50-&59 LINKFS &A0-&AF TFS &0E-&0F LanManFS &20-&23 RAMFS &60-&64 BEEBITFS &B0-&BF VaxHostFS &0E-&0F NFS &20-&27 ARAMFS &60-&65 COPROFS &C0-&CC DFS &11-&15 ANFS &20-&2F (XDFS &70-&7A) IEEEFS &F0-&FF HDFS &12-&17 ADFS &30-&39 HOSTFS &80-&9F NEXUSFS XDFS provisional allocation
Full List
&00 0 No opened file &50 80 VFS &B0 176 BeebItFS, BeebLink &01 1 CFS (in) &51 81 VFS &B1 177 BeebItFS, BeebLink &02 2 CFS (out) &52 82 VFS &B2 178 BeebItFS, BeebLink &03 3 ROMFS &53 83 VFS &B3 179 BeebItFS, BeebLink &04 4 &54 84 VFS &B4 180 BeebItFS, BeebLink &05 5 &55 85 VFS &B5 181 BeebItFS, BeebLink &06 6 &56 86 VFS &B6 182 BeebItFS, BeebLink &07 7 &57 87 VFS &B7 183 BeebItFS, BeebLink &08 8 &58 88 VFS &B8 184 BeebItFS, BeebLink &09 9 &59 89 VFS &B9 185 BeebItFS, BeebLink &0A 10 &5A 80 &BA 186 BeebItFS, BeebLink &0B 11 &5B 91 &BB 187 BeebItFS, BeebLink &0C 12 &5C 92 &BC 188 BeebItFS, BeebLink &0D 13 &5D 93 &BD 189 BeebItFS, BeebLink &0E 14 TFS, VaxHostFS &5E 94 &BE 190 BeebItFS, BeebLink &0F 15 TFS, VaxHostFS &5F 95 &BF 191 BeebItFS, BeebLink &10 16 &60 96 Acacia RAMFS, RAMFS &C0 192 COPROFS &11 17 DFS &61 97 Acacia RAMFS, RAMFS &C1 193 COPROFS &12 18 DFS, HDFS &62 98 Acacia RAMFS, RAMFS &C2 194 COPROFS &13 19 DFS, HDFS &63 99 Acacia RAMFS, RAMFS &C3 195 COPROFS &14 20 DFS, HDFS &64 100 Acacia RAMFS, RAMFS &C4 196 COPROFS &15 21 DFS, HDFS &65 101 Acacia RAMFS &C5 197 COPROFS &16 22 Sprow RAMFS, HDFS &66 102 &C6 198 COPROFS &17 23 Sprow RAMFS, HDFS &67 103 &C7 199 COPROFS &18 24 Sprow RAMFS .. &C8 200 COPROFS &19 25 HADFS .. &C9 201 COPROFS &1A 26 HADFS &7A 122 &CA 202 COPROFS &1B 27 HADFS &7B 123 &CB 203 COPROFS &1C 28 HADFS &7C 124 &CC 204 COPROFS &1D 29 HADFS &7D 125 &CD 205 &1E 30 &7E 126 &CE 206 &1F 31 &7F 127 &CF 207 &20 32 NFS, ANFS, LanManFS &80 128 IOFS, HostFS &D0 208 &21 33 NFS, ANFS, LanManFS &81 129 IOFS, HostFS &D1 209 &22 34 NFS, ANFS, LanManFS &82 130 IOFS, HostFS &D2 210 &23 35 NFS, ANFS, LanManFS &83 131 IOFS, HostFS &D3 211 &24 36 NFS, ANFS &84 132 IOFS, HostFS &D4 212 &25 37 NFS, ANFS &85 133 IOFS, HostFS &D5 213 &26 38 NFS, ANFS &86 134 IOFS, HostFS &D6 214 &27 39 NFS, ANFS &87 135 IOFS, HostFS &D7 215 &28 40 ANFS &88 136 IOFS, HostFS &D8 216 &29 41 ANFS &89 137 IOFS, HostFS &D9 217 &2A 42 ANFS &8A 138 IOFS, HostFS &DA 218 &2B 43 ANFS &8B 139 IOFS, HostFS &DB 219 &2C 44 ANFS &8C 140 IOFS, HostFS &DC 220 &2D 45 ANFS &8D 141 IOFS, HostFS &DD 221 &2E 46 ANFS &8E 142 IOFS, HostFS &DE 222 &2F 47 ANFS &8F 143 IOFS, HostFS &DF 223 &30 48 ADFS &90 144 IOFS, HostFS &E0 224 &31 49 ADFS &91 145 IOFS, HostFS &E1 225 &32 50 ADFS &92 146 IOFS, HostFS &E2 226 &33 51 ADFS &93 147 IOFS, HostFS &E3 227 &34 52 ADFS &94 148 IOFS, HostFS &E4 228 &35 53 ADFS &95 149 IOFS, HostFS &E5 229 &36 54 ADFS &96 150 IOFS, HostFS &E6 230 &37 55 ADFS &97 151 IOFS, HostFS &E7 231 &38 56 ADFS &98 152 IOFS, HostFS &E8 232 &39 57 ADFS &99 153 IOFS, HostFS &E9 233 &3A 58 &9A 154 IOFS, HostFS &EA 234 &3B 59 &9B 155 IOFS, HostFS &EB 235 &3C 60 &9C 156 IOFS, HostFS &EC 236 &3D 61 &9D 157 IOFS, HostFS &ED 237 &3E 62 &9E 158 IOFS, HostFS &EE 238 &3F 63 &9F 159 IOFS, HostFS &EF 239 &40 64 DOSFS &A0 160 LFS, BeebLink* &F0 240 IEEEFS &41 65 DOSFS &A1 161 LFS, BeebLink* &F1 241 IEEEFS &42 66 DOSFS &A2 162 LFS, BeebLink* &F2 242 IEEEFS &43 67 DOSFS &A3 163 LFS, BeebLink* &F3 243 IEEEFS &44 68 DOSFS &A4 164 LFS, BeebLink* &F4 244 IEEEFS &45 69 DOSFS &A5 165 LFS, BeebLink* &F5 245 IEEEFS &46 70 DOSFS &A6 166 LFS, BeebLink* &F6 246 IEEEFS &47 71 DOSFS &A7 167 LFS, BeebLink* &F7 247 IEEEFS &48 72 &A8 168 LFS, BeebLink* &F8 248 IEEEFS &49 73 &A9 169 LFS, BeebLink* &F9 249 IEEEFS &4A 74 &AA 170 LFS, BeebLink* &FA 250 IEEEFS &4B 75 &AB 171 LFS, BeebLink* &FB 251 IEEEFS &4C 76 &AC 172 LFS, BeebLink* &FC 252 IEEEFS &4D 77 &AD 173 LFS, BeebLink* &FD 253 IEEEFS &4E 78 &AE 174 LFS, BeebLink* &FE 254 IEEEFS &4F 79 &AF 175 LFS, BeebLink* &FF 255 IEEEFS
Special cases
When reading PTR and EXT from 8-bit BASIC, the data parameter is BASIC's integer store, which will be set to the channel as the last item evaluated. That means that PTR#0 and EXT#0 pass a data value of zero; OSARGS 0,0 and OSARGS 2,0 do not change the data word; this means that in 8-bit BASICs PTR#0 and EXT#0 return zero, being the unchanged data word set to the channel.
This means that other BASICs have the ability to use PTR#0 and EXT#0 to return information specific to that implementation. Some BASICs or operating systems allow other special handles to return specific information.
- The most common case is that channel 0 references the console, ie the keyboard and VDU:
- OSBGET#0 reads from OSRDCH
- OSBPUT#0 writes to OSWRCH
- EOF#0 returns TRUE if the next OSBGET#0 or OSRDCH/GET/INKEY will not return a character without waiting, ie
IF NOT EOF#0 THEN key%=GET - PTR#0 returns platform-specific information
- EXT#0 returns platform-specific information
- Some C compilers implement C console handles:
- Reading from channel 0 reads from STDIN (via OSRDCH)
- Writing to channel 1 writes to STDOUT (via OSWRCH)
- Writing to channel 2 writes to STDERR (via OSWRCH).
Known implementations
| Implemented at the operating system layer |
BGET#0 | BPUT#0 | OSGBPB#0 | EOF#0 | PTR#0 | EXT#0 |
|---|---|---|---|---|---|---|
| BBC MOS and CoPros | untested | untested | error or -1 | 0 | 0 | |
| ARM Development System[1] | |
|
|
untested | untested | untested |
| PDP11 CoPro | OSRDCH[2] | OSWRCH[2] | untested | untested | untested | |
| TubeHost | OSRDCH | OSWRCH | 0 if keypress pending | untested | untested | |
| Implemented by BASIC | BGET#0 | BPUT#0 | EOF#0 | PTR#0 | EXT#0 | |
| Windows BASIC | untested | untested | untested | untested | untested | |
| Brandy Basic | ||||||
| Others | BGET#-1 | BPUT#-1 | EOF#-1 | PTR#-1 | EXT#-1 | |
| Sinclair Z88 | untested | untested | 0=unexpanded, -1=expanded | b0-b15=ROM version, b16=b31=number of handles remaining |
amount of free system memory |
[1] I'm sure there is an ARM system that does this, needs further investigation
[2] Build option
Notes
CoProFS is documented as using &C0-&C4, but actually will use as many as its workspace allows, up to &C0-&CC.
RetroClinic RAMFS uses &60-&64, Acacia RAMFS uses &60-&65.
Early versions of HADFS used &05-&0A and &85-&8A to read/write control information, later versions use &19-&1D to access this control information.
IOFS in BBCTerm uses handles &80-&9F but its OSFSC entry reports that it uses &80-&A0. IOFS also incorrectly reports its filing system number as &00.
LanManFS clashes with NFS/ANFS, but the hardware cannot be present at the same time as the LanManFS Ethernet card plugs into the Econet card sockets.
BeebLink* entries are used by the BeebLink Test FS ROM, which can coexist with the ordinary BeebLink ROM while testing.
References
- Advanced BBC User Guide
- New Advanced BBC User Guide
- Advanced Electron User Guide (RAMFS)
- http://mdfs.net/Docs/Comp/BBC/Filing/Handles
Jgharston 22:14, 1 September 2007 (BST)
