HDFS

A Hierarchical Disc Filing System for the BBC Microcomputer

Angus Duggan (c) AJCD 31 October 1991

Contents
 1 Introduction
 2 Differences between DNFS and HDFS
 3 Disc organisation
   3.1  Files
   3.2  Directories
   3.3  Permissions
   3.4  Auto-booting
 4 Disc management
   4.1  Formatting and verifying
   4.2  Loading and saving
   4.3  Copying and renaming
   4.4  File handling
   4.5  Compacting and extending
 5 Command syntax
 6 Filing system commands
   6.1  *ACCESS afsp (LXWR)
   6.2  *ATTRIB fsp (load exec) (len) (LXWR)
   6.3  *BUILD fsp (A)
   6.4  *COMPACT (dsp) (D)
   6.5  *COPY <fsp fsp/afsp dsp> (C)
   6.6  *CREATE fsp (load exec) (len) (LXWR) (D)
   6.7  *DEDIT (drv) start (+) (+) (R)
   6.8  *DELETE fsp
   6.9  *DFIND (drv) start (+) <string/ { hex } >
   6.10 *DIR (dsp)
   6.11 *DRIVE drv (S/D/A) (C)
   6.12 *DUMP fsp
   6.13 *ENABLE
   6.14 *EXTEND fsp
   6.15 *FEDIT fsp (offs) (R)
   6.16 *FFIND fsp (offs) <string/ { hex } >
   6.17 *FORMAT drv <40/80> <X/A> <S/D> (skew)
   6.18 *FREE (dsp)
   6.19 *INFO afsp
   6.20 *LIB (dsp)
   6.21 *READ (drv) addr start (+) (D)
   6.22 *RENAME <fsp fsp/afsp dsp> (C)
   6.23 *TITLE string (dsp)
   6.24 *TYPE fsp (C)
   6.25 *VERIFY drv <40/80> <X/A> <S/D>
   6.26 *WILD :$^.*?
   6.27 *WIPE afsp (A)
   6.28 *WRITE (drv) addr start (+) (D)
 7 Utility Commands
   7.1  *CLOSE
   7.2  *DISC, *DISK
   7.3  *GOIO addr
   7.4  *KEYS
   7.5  *MEDIT start (+) ((+) (R)
   7.6  *MFIND start (+) <string> { hex } >
   7.7  *MODE dec
   7.8  *MOVE start (+) addr
   7.9  *ROMS
   7.10 *VDU <string> { ((+/-) (,/;) } >
 8 Other commands
   8.1  *.
   8.2  */fsp
   8.3  *CAT (dsp)
   8.4  *EXEC fsp
   8.5  *HELP (HDFS/UTILS)
   8.6  *LOAD fsp (addr)
   8.7  *OPT dec(,dec)
   8.8  *RUN fsp
   8.9  *SAVE fsp start (+) (exec (load)
   8.10 *SPOOL (fsp)
 9 The Disc, File, and Memory Editors
10 OSWORD
   10.1  A=&7B Move a block of memory
   10.2  A=&7C Multiple track 8271 command
   10.3  A=&7D Read cycle number
   10.4  A=&7E Read directory size
   10.5  A=&7F Single track 8271 command
11 Vectors
   11.1  OSFILE
   11.2  OSARGS
   11.3  OSBGET
   11.4  OSBPUT
   11.5  OSGBPB
   11.6  OSFIND
   11.7  FSCV
12 Errors
   12.1  Escape (&11)
   12.2  Bad end (&B0)
   12.3  Bad start (&B1)
   12.4  Bad length (&B2)
   12.5  Bad range (&B3)
   12.6  Not empty (&B4)
   12.7  Too long (&B5)
   12.8  Bad wild char (&B6)
   12.9  Find what? (&B7)
   12.10 Bad edit mode (&B8)
   12.11 Parameters (&B9)
   12.12 Wrong format (&BA)
   12.13 Not readable (&BB)
   12.14 Not executable (&BC)
   12.15 Too big (&BD)
   12.16 Cat full (&BE)
   12.17 Can't extend (&BF)
   12.18 Too many open (&C0)
   12.19 Not writable (&C1)
   12.20 Open (&C2)
   12.21 Locked (&C3)
   12.22 Exists (&C4)
   12.23 Drive fault EE at DD/TT (&C5)
   12.24 Dir full (&C6)
   12.25 Disc fault EE at DD/TT (&C7)
   12.26 Disc changed (&C8)
   12.27 Disc read only (&C9)
   12.28 Bad track (&CA)
   12.29 Bad option (&CB)
   12.30 Bad name (&CC)
   12.31 Bad drive (&CD)
   12.32 Directory (&CE)
   12.33 Not found (&D6)
   12.34 Syntax (&DC)
   12.35 Channel (&DE)
   12.36 EOF (&DF)
   12.37 Bad command (&FE)
13 Compatibility
   A Overview
   B Installation
   C Command Summary
   D 8271 commands
   E Catalogue Format
   F Memory Usage
       F.1 Zero page
	F.2 NMI workspace
	F.3 Absolute workspace
	F.4 Private workspace
   G Benchmarks
	G.1 SAVE 32K
	G.2 LOAD 32K
	G.3 OPEN
	G.4 BPUT 32K
	G.5 BGET 32K
	G.6 MOVE
	G.7 GBPB
	G.8 SHIFT