Command Reference - hoglet67/MMFS GitHub Wiki

MMFS

The following commands select MMFS as the current filesystem:

  • *MMFS
  • *DISK
  • *DISC

Any of these can be used.

DFS Compatible Commands

The following commands work as per Acorn DFS 2.x:

  • *ACCESS
  • *BACKUP
  • *CLOSE
  • *COMPACT
  • *COPY
  • *DELETE
  • *DESTROY
  • *DIR
  • *DRIVE
  • *ENABLE
  • *EX
  • *FORM
  • *FREE
  • *INFO
  • *LIB
  • *MAP
  • *RENAME
  • *TITLE
  • *VERIFY
  • *WIPE

The following commands work as per Acorn DFS 2.x Utilities:

  • *BUILD
  • *DUMP
  • *LIST
  • *ROMS
  • *TYPE

See http://chrisacorns.computinghistory.org.uk/docs/Acorn/Manuals/Acorn_DiscSystemUGI2.pdf

Note: In the Master build of MMFS, the UTILS commands are actually provided by the MOS rather than MMFS.

Note: In the Model B Sideways RAM build of MMFS, the ROMS command is omitted due to space constraints.

DUTILS Commands

The DUTILS commands replicate manual tasks such as inserting a disk into a drive.

A list of the commands can be displayed by entering *HELP DUTILS on the command line.

Parameters

  • <drive> Drive number (0 to 3)
  • <dno> Disk number (0 to a maximum of 511 dependent on the MMB image size)
  • <dsp> Disk specification, i.e. disk title (not case sensitive)
  • <adsp> Ambiguous disk specification, i.e. disk title terminated with optional wildcard “*”

Parameters in brackets are optional, and “/” indicates “either/or”.

Where the drive is optional, if no drive is given then the current drive (set using *DRIVE) is assumed.

Note: If disk titles contain spaces they must be enclosed in quotes.

Commands

DBOOT

Syntax: DBOOT <dno>/<dsp>

Inserts specified disk into drive 0 and boots it (if boot option of disk set).

Example:

>*DBOOT Planetoid

DCAT

Syntax: DCAT ((<from dno>) <to dno>) (<adsp>)

Lists disks in disk number order.

An optional disk number range and/or ambiguous disk title can be specified.

Example:

>*DCAT 10 20 R*
 12 Reversi P 13 Revs5Track P
 19 Repton3 P
3 discs found

This displays all (formatted) disks with numbers in the range 10 to 20 whose disk title begins with “R” or “r”.

Note: “P” after the disk title indicates that the disk is locked (read-only), and the number of disks found matching any specification is given at the bottom of the list.

DDRIVE

Syntax: DDRIVE (<drive>)

Lists the drives and which disks are currently “inserted”, plus their status.

Example:

>*DDRIVE
0: 253               U
1:   1 RAINBOW
2:   2 FROGGER
3:   3 PHOENIX       P

DFREE

Syntax: DFREE

Displays the number of unformatted disks, and the total number of formatted and unformatted disks.

Example:

>*DFREE
121 of 511 disks free (unformatted)
>

DIN

Syntax: DIN (<drive>) <dno>/<dsp>

Insert specified disk into drive.

If the drive number is omitted, the current drive is used.

Example:

>*DIN 0 REVS

Note: A disk cannot be in more than one drive at a time. E.g. if Disk 200 is in Drive 0, and the user enters *DIN 2 200, Disk 200 will then be in Drive 2, and “No Disk” will be in Drive 0.

DOP P

Syntax: DOP P (<drive>)

Protects (locks) the disk in a drive so that it is read-only.

If the drive number is omitted, the current drive is used.

Example:

>*DOP P 0

DOP U

Syntax: DOP U (<drive>)

Unprotects (unlocks) the disk in a drive so that it can be written to.

If the drive number is omitted, the current drive is used.

Example:

>*DOP U 0

DOP K

Syntax: DOP K (<drive>)

Marks the disk in a drive as unformatted.

Unless *ENABLE is used before this command, the user is asked for additional confirmation (i.e. twice)

If the drive number is omitted, the current drive is used.

Example:

>*DIN 0 498
>*ENABLE
>*DOP K 0
Kill 498  ADFS : Y
>*CAT

Disc not formatted
>

NB: This command does not change any data on the disk “surface” and can be undone using *DOP R.

DOP R

Syntax: DOP R (<drive>)

Marks a previously unformatted disk as in the drive as formatted.

If the drive number is omitted, the current drive is used.

Example:

>*DIN 0 498
>*CAT

Disc not formatted
>*DOP R 0
>*CAT
ADFS (498)
Drive 0           Option 0 (off)
Dir. :0.$         Lib. :3.$

    IDE              IDE2
    ORIG             SD
>

DOP N

Syntax: DOP N (<drive>)

Finds the first unformatted disk and places it in specified drive.

Note, the disk must then be formatted in the usual way.

Example:

>*DOP N
Disk 253 in drive :0
>*CAT

Disc not formatted
>*FORM 80 0
Go (Y/N) ? Y
Formatting drive 0 track 4F
>*CAT
 (253)
Drive 0           Option 0 (off)
Dir. :0.$         Lib. :3.$

DRECAT

Syntax: DRECAT

Rebuilds the “Disk Table”. The disk table contains a copy of the disk title, plus the disk status (read-only, read/write, unformatted or invalid).

The title in the disk table is updated when *TITLE is used, or a (new) disk is formatted using *DOP N. However, copying a disk using *BACKUP etc. will not update the “Disk Table”. In this case *DRECAT can be used to refresh the disk table.

DABOUT

Syntax: DABOUT

Prints the name of the original author of MMFS:

Example:

>*DABOUT
DUTILS by Martin Mather (2011)
⚠️ **GitHub.com Fallback** ⚠️