SITS file system - Revision history

Jnc: +New cat

2023-06-12T17:21:53Z

+New cat

Jnc: more appropriate cat

2022-10-28T14:26:26Z

more appropriate cat

Larsbrinkhoff: /* Directory format */ Entry type field.

2022-10-28T11:07:47Z

‎Directory format: Entry type field.

Larsbrinkhoff: Initial description of SITS file system.

2022-10-28T11:01:27Z

Initial description of SITS file system.

New page

This is a partial description of the [[SITS]] file system disk format. It should be good enough for reading data, but not writing.

To SITS, an [[RK05]] disk pack is viewed as 2436 blocks of 1024 bytes. In the file system, block addresses are linear.

===Directory format===

A directory is a series of entries that each describe one file or subdirectory.

Block 46 (octal) on a disk pack is the root directory for that pack. The root directory should have the files DESCR and BITS; they are not yet covered in this description.

The entry begins with a header, after which follows some optional data.
{| class="wikitable"
! Offset || Size || Description
|-
| 0 || 1 || Entry size
|-
| 1 || 1 || Flags
|-
| 2 || 2 || Version
|}

The flags field has these bits.
{{8bit-header}}
| EOFB || ACCB || || SHRB || || || || MFISTB
{{8bit-bitout}}

The '''EOFB''' flag bit signals the header is followed by end-of-file and timestamp data.

{| class="wikitable"
! Offset || Size || Description
|-
| 0 || 2 || File size in 8192-byte pages, rounded down.
|-
| 2 || 2 || Additional bytes in file size.
|-
| 4 || 2 || Timestamp date.
|-
| 6 || 2 || Timestamp time.
|}

The timestamp date and time are formatted like this:
{{16bit-header}}
| colspan="7" | Year - 1900 || colspan="4" | Month || colspan="5" | Day
{{16bit-bitout}}
{{16bit-header}}
| colspan="5" | Hour || colspan="6" | Minute || colspan="5" | Second / 2
{{16bit-bitout}}

The '''ACCB''' flag bit signals the presence of access protection data, which is a series of three-byte blocks. The last block has bit 7 cleared.

Next in the entry comes the name. It's an ASCII string with the last byte having bit 7 cleared.

Finally comes a descriptor that specifies the file data blocks. It runs until the end of the entry as per the length field in the header. The descriptor is a series of bytes that specify linear block numbers. The current block number starts at 0 and is modified as the bytes are parsed. Skip means add to the current block number. Pick means to include a range of blocks in the file.

Descriptor type 0: skip ''n'' blocks, and pick one data block.
{{8bit-header}}
| colspan="2" | 0 || colspan="6" | ''n''
{{8bit-bitout}}

Descriptor type 1: pick ''n''+1 data blocks.
{{8bit-header}}
| colspan="2" | 1 || colspan="6" | ''n''
{{8bit-bitout}}

Descriptor type 2: set the current block number to the next little endian 16-bit, and pick ''n''+1 data blocks.
{{8bit-header}}
| colspan="2" | 2 || colspan="6" | ''n''
{{8bit-bitout}}

Descriptor type 3: skip ''n'' blocks, and pick ''m''+1 data blocks.
{{8bit-header}}
| colspan="2" | 3 || colspan="3" | ''n'' || colspan="3" | ''m''
{{8bit-bitout}}

[[Category: PDP-11 File Formats]]

← Older revision		Revision as of 17:21, 12 June 2023
Line 98:		Line 98:

	[[Category: File Systems]]		[[Category: File Systems]]
		+	[[Category: PDP-11 Disk Formats]]

@@ Line 1: / Line 1: @@
-This is a partial description of the [[SITS]] file system disk format.  It should be good enough for reading data, but not writing.
+This is a partial description of the [[SITS]] [[file system]] [[disk]] format.  It should be good enough for reading data, but not writing.
-To SITS, an [[RK05]] disk pack is viewed as 2436 blocks of 1024 bytes.  In the file system, block addresses are linear.
+To SITS, an [[RK05 disk drive|RK05]] [[disk pack]] is viewed as 2436 blocks of 1024 bytes.  In the file system, block addresses are linear.
 ===Directory format===
-A directory is a series of entries that each describe one file or subdirectory.  The first entry should describe the directory itself.  The second entry should point to the parent directory, or itself if it's the root directory.
+A [[directory]] is a series of entries that each describe one [[file]] or subdirectory.  The first entry should describe the directory itself.  The second entry should point to the parent directory, or itself if it's the root directory.
 Block 46 (octal) on a disk pack is the root directory for that pack.  The root directory should have the files DESCR and BITS; they are not yet covered in this description.
@@ Line 97: / Line 97: @@
 {{8bit-bitout}}
-[[Category: PDP-11 File Formats]]
+[[Category: File Systems]]

@@ Line 5: / Line 5: @@
 ===Directory format===
-A directory is a series of entries that each describe one file or subdirectory.
+A directory is a series of entries that each describe one file or subdirectory.  The first entry should describe the directory itself.  The second entry should point to the parent directory, or itself if it's the root directory.
 Block 46 (octal) on a disk pack is the root directory for that pack.  The root directory should have the files DESCR and BITS; they are not yet covered in this description.
@@ Line 22: / Line 22: @@
 The flags field has these bits.
 {{8bit-header}}
-| EOFB || ACCB || || SHRB || || || || MFISTB
+| EOFB || ACCB || || SHRB || colspan="3" | type || MFISTB
 {{8bit-bitout}}
 The '''EOFB''' flag bit signals the header is followed by end-of-file and timestamp data.