Apple ProDOS

ProDOS replaced Apple DOS 3.3 on the Apple II in 1983 with hierarchical directories and support for larger volumes, and it was the standard disk system for the Apple II and IIgs. It is seen today in preserved floppy and hard-disk images.

Overview

ProDOS volumes use 512-byte blocks. The volume directory starts at block 2 with a header, followed by file entries linked through directory blocks. Files are seedlings (one block), saplings (an index block) or trees (a master index block); extended files have two forks. A bitmap tracks free blocks. 140 KB floppies, 800 KB disks and hard disks are supported.

History

  • ProDOS 1.0 shipped in 1983.
  • Used with GS/OS on the Apple IIgs.

Structures

Offsets are in bytes from the start of the structure named in each heading. Field names are descriptive and are not an official specification. Fixed-width integers are shown as u/i (unsigned/signed) followed by bit width and byte order.

Probe

OffsetSizeTypeFieldNotes
0x61u8Description
0xE2u16 LEBlocks

Probe

OffsetSizeTypeFieldNotes
0x41u8Description
0x292u16 LEBlocks

Date

OffsetSizeTypeFieldNotes
0x02u16 LEDate
0x22u16 LETime

Make Entry

OffsetSizeTypeFieldNotes
0x01u8Storage
0x01u8Name Length
0x101u8–
0x112u16 LEKey
0x132u16 LEBlocks Used
0x151u8Eof
0x161u8Eof
0x171u8Eof
0x1E1u8Flags
0x1F2u16 LE–

Make Entry

OffsetSizeTypeFieldNotes
0x01u8Data
0x12u16 LEData
0x51u8Data Eof
0x61u8Data Eof
0x71u8Data Eof
0x1001u8Rsrc
0x1012u16 LERsrc

Pro Dos File System

OffsetSizeTypeFieldNotes
0x41u8Label
0x272u16 LEFree Blocks
0x292u16 LETotal Blocks

Other fields read

Read inOffsetSizeTypeFieldNotes
Read Block0x0256bytes–
Get Children0x22u16 LEBlock

Constants

Apple2 Layout

NameValueTypeNotes
DosLogicalToPhysical[0, 13, 11, 9, 7, 5, 3, 1, 14, 12, 10, 8, 6, 4, 2, 15]int[]
ProDosLogicalToPhysical[0, 2, 4, 6, 8, 10, 12, 14, 1, 3, 5, 7, 9, 11, 13, 15]int[]
DosPhysicalToLogicalInvert(DosLogicalToPhysical)int[]
ProDosPhysicalToLogicalInvert(ProDosLogicalToPhysical)int[]

Implementation limits

ClassNameValueNotes
Apple2 LayoutFloppyBytes143360
Apple2 LayoutThirteenSectorBytes116480

Apple2 Order

NameValue
Dos(next)
ProDos(next)
Structures and constants were extracted from the implementation. Prose sections are a summary from public sources; verify details before relying on them.