# eric-lo/csci3150-lab9-filesystem architecture

> Architecture diagram of the GitHub repository eric-lo/csci3150-lab9-filesystem, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eric-lo/csci3150-lab9-filesystem
- Repository: https://github.com/eric-lo/csci3150-lab9-filesystem

## Overview

This repository is a teaching lab about Linux file handling, with a static GitBook-rendered set of lessons rather than an executable filesystem product. The intended learner workflow is to study file commands and C I/O, then Linux system calls; the chapter files broaden this into FAT32 inspection, directory traversal, mounting, and repair. The graph includes those documented lesson stages and the sampled search and reader-preference behavior. The README is brief, and the FAT lesson source was not sampled, so their internal links are based only on documented lesson scope.

Main entry points: [`_book/gitbook/gitbook.js`](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook.js) (GitBook runtime), [`_book/gitbook/gitbook-plugin-fontsettings/fontsettings.js`](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-fontsettings/fontsettings.js) (Font settings), [`_book/gitbook/gitbook-plugin-sharing/buttons.js`](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-sharing/buttons.js) (Sharing controls), [`_book/gitbook/gitbook-plugin-search/search.js`](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-search/search.js) (Search interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["File-system lessons"]
  node_commands["Linux commands"]
  node_stdio["C standard I/O"]
  node_syscalls["Linux file calls"]
  node_fat_overview["FAT32 overview"]
  node_disk_inspection["Disk inspection<br/>[dd.md]"]
  node_boot_header["Boot header"]
  node_read_header["Read header<br/>[read-the-header.md]"]
  node_fat_layout["FAT structures<br/>[c-header-of-fat.md]"]
  node_endian["Endian handling"]
  node_clusters["Cluster traversal"]
  node_traversal["Directory traversal"]
  node_dir_entry["Directory entries"]
  node_dir_calls["Directory calls"]
  node_mounting["Mounting filesystems<br/>[mount.md]"]
  node_repair["Check and repair"]
  node_permissions["File permissions<br/>[file-permission.md]"]
  node_demo["FAT demo<br/>[demo.md]"]
end

subgraph group_reader["Book reader"]
  node_book_runtime["GitBook runtime<br/>[gitbook.js]"]
  node_theme["Reader theme<br/>[theme.js]"]
  node_font_settings["Font settings<br/>[fontsettings.js]"]
  node_sharing["Sharing controls<br/>[buttons.js]"]
end

subgraph group_search["Book search"]
  node_search_ui["Search interface<br/>[search.js]"]
  node_search_engine["Search API<br/>[search-engine.js]"]
  node_lunr["Lunr provider<br/>[search-lunr.js]"]
  node_index_data[("Search index<br/>[search_index.json]")]
end

node_learner(("Learner"))

node_learner -->|"studies"| node_commands
node_learner -->|"studies"| node_stdio
node_learner -->|"studies"| node_syscalls
node_learner -.->|"studies"| node_fat_overview
node_learner -.->|"studies"| node_demo
node_learner -.->|"reads lessons"| node_book_runtime
node_book_runtime -->|"starts plugin"| node_font_settings
node_font_settings -->|"uses storage"| node_book_runtime
node_font_settings -->|"adds toolbar"| node_book_runtime
node_book_runtime -->|"starts plugin"| node_sharing
node_sharing -->|"adds buttons"| node_book_runtime
node_book_runtime -.->|"page events"| node_search_ui
node_search_ui -->|"queries"| node_search_engine
node_search_engine -->|"selects provider"| node_lunr
node_lunr -->|"loads index"| node_index_data

click node_commands "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/important-commands.md"
click node_stdio "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/accessing-fat-using-c.md"
click node_syscalls "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/linux-file-system-calls.md"
click node_fat_overview "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/overview-of-fat32.md"
click node_disk_inspection "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/dd.md"
click node_boot_header "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/header-boot-sector.md"
click node_read_header "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/read-the-header.md"
click node_fat_layout "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/c-header-of-fat.md"
click node_endian "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/endian-ness-in-fat32.md"
click node_clusters "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/finding-next-cluster.md"
click node_traversal "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/traversing-cluster.md"
click node_dir_entry "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/header-dir-entry.md"
click node_dir_calls "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/directory-related-calls.md"
click node_mounting "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/mount.md"
click node_repair "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/check-and-repair-fat-filesystem.md"
click node_permissions "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/file-permission.md"
click node_demo "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/demo.md"
click node_book_runtime "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook.js"
click node_theme "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/theme.js"
click node_font_settings "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-fontsettings/fontsettings.js"
click node_sharing "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-sharing/buttons.js"
click node_search_ui "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-search/search.js"
click node_search_engine "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-search/search-engine.js"
click node_lunr "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-lunr/search-lunr.js"
click node_index_data "https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/search_index.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_commands,node_stdio,node_syscalls,node_fat_overview,node_disk_inspection,node_boot_header,node_read_header,node_fat_layout,node_endian,node_clusters,node_traversal,node_dir_entry,node_dir_calls,node_mounting,node_repair,node_permissions,node_demo toneBlue
class node_book_runtime,node_theme,node_font_settings,node_sharing toneAmber
class node_search_ui,node_search_engine,node_lunr,node_index_data toneMint
class node_learner toneIndigo
```

## Components

### File-system lessons

- [Linux commands](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/important-commands.md): `important-commands.md`
- [C standard I/O](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/accessing-fat-using-c.md): `accessing-fat-using-c.md`
- [Linux file calls](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/linux-file-system-calls.md): `linux-file-system-calls.md`
- [FAT32 overview](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/overview-of-fat32.md): `overview-of-fat32.md`
- [Disk inspection](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/dd.md): `dd.md`
- [Boot header](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/header-boot-sector.md): `header-boot-sector.md`
- [Read header](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/read-the-header.md): `read-the-header.md`
- [FAT structures](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/c-header-of-fat.md): `c-header-of-fat.md`
- [Endian handling](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/endian-ness-in-fat32.md): `endian-ness-in-fat32.md`
- [Cluster traversal](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/finding-next-cluster.md): `finding-next-cluster.md`
- [Directory traversal](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/traversing-cluster.md): `traversing-cluster.md`
- [Directory entries](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/header-dir-entry.md): `header-dir-entry.md`
- [Directory calls](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/directory-related-calls.md): `directory-related-calls.md`
- [Mounting filesystems](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/mount.md): `mount.md`
- [Check and repair](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/check-and-repair-fat-filesystem.md): `check-and-repair-fat-filesystem.md`
- [File permissions](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/file-permission.md): `file-permission.md`
- [FAT demo](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/demo.md): `demo.md`

### Book reader

- [GitBook runtime](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook.js): `_book/gitbook/gitbook.js`
- [Reader theme](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/theme.js): `_book/gitbook/theme.js`
- [Font settings](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-fontsettings/fontsettings.js): `_book/gitbook/gitbook-plugin-fontsettings/fontsettings.js`
- [Sharing controls](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-sharing/buttons.js): `_book/gitbook/gitbook-plugin-sharing/buttons.js`

### Book search

- [Search interface](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-search/search.js): `_book/gitbook/gitbook-plugin-search/search.js`
- [Search API](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-search/search-engine.js): `_book/gitbook/gitbook-plugin-search/search-engine.js`
- [Lunr provider](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/gitbook/gitbook-plugin-lunr/search-lunr.js): `_book/gitbook/gitbook-plugin-lunr/search-lunr.js`
- [Search index](https://github.com/eric-lo/csci3150-lab9-filesystem/blob/master/_book/search_index.json): `_book/search_index.json`

### Other components

- **Learner**

## Connections

- Learner → Linux commands: studies (evidence: `README.md`)
- Learner → C standard I/O: studies (evidence: `README.md`)
- Learner → Linux file calls: studies (evidence: `README.md`)
- Learner → FAT32 overview: studies
- Learner → FAT demo: studies
- Learner → GitBook runtime: reads lessons
- GitBook runtime → Font settings: starts plugin (evidence: `_book/gitbook/gitbook-plugin-fontsettings/fontsettings.js`)
- Font settings → GitBook runtime: uses storage (evidence: `_book/gitbook/gitbook-plugin-fontsettings/fontsettings.js`)
- Font settings → GitBook runtime: adds toolbar (evidence: `_book/gitbook/gitbook-plugin-fontsettings/fontsettings.js`)
- GitBook runtime → Sharing controls: starts plugin (evidence: `_book/gitbook/gitbook-plugin-sharing/buttons.js`)
- Sharing controls → GitBook runtime: adds buttons (evidence: `_book/gitbook/gitbook-plugin-sharing/buttons.js`)
- GitBook runtime → Search interface: page events
- Search interface → Search API: queries (evidence: `_book/gitbook/gitbook-plugin-search/search.js`)
- Search API → Lunr provider: selects provider (evidence: `_book/gitbook/gitbook-plugin-lunr/search-lunr.js`)
- Lunr provider → Search index: loads index (evidence: `_book/gitbook/gitbook-plugin-lunr/search-lunr.js`)
