A disk management library than can be used to build filesystems

Clone this repo:

Branches

  1. 79a6990 Rename Magenta to Zircon by George Kulakowski · 8 days ago master
  2. 75c4876 go/fidl: use only explicit dependency paths by James Tucker · 11 days ago
  3. 092421e [rpc] Consolidate mxio packages by Sean Klein · 2 weeks ago
  4. 1a1b4f1 [FAT] Allow alternate value for BS_DrvNum by Sean Klein · 4 weeks ago
  5. 710273e [msdosfs] Prevent opening directories as writable by Sean Klein · 4 weeks ago

Thinfs

Thinfs is a collection of disk managment utilities which can be used to build a filesystem.

Thinfs currently includes an implementation of:

  • FAT16 and FAT32

Download Sources

Download ThinFS sources

Thinfs should be included in the full Fuchsia checkout by default.

jiri import thinfs
jiri update

Building

Thinfs will be built as a part of the Fuchsia build. Follow the instructions on the Fuchsia landing pages.

To build Thinfs exclusively, the “--modules” parameter can be provided to gn. This is useful if the rest of the build is broken, or if you're trying to incrementally rebuild Thinfs alone.

cd $FUCHSIA_ROOT
./packages/gn/gen.py --modules=thinfs
./buildtools/ninja -C out/debug-x86-64

Testing

Running on Fuchsia

If you have a partition (either on a hard disk or USB) which is formatted as FAT, it will be automatically detected by the Zircon kernel and mounted using thinfs under “/volume”.

If you want to manually mount a block device, use the following steps:

Use lsblk to determine which block device you'd like to mount.

lsblk

Let‘s arbitrarily choose block device ‘000’. If it is formatted as FAT, you can skip to the mounting stage immediately. Otherwise, you’ll need to format it as a FAT filesystem (which, as a warning, will wipe all data present on the partition).

To format the block device:

mkfs /dev/class/block/000 fat

To mount the block device:

mount /dev/class/block/000 /mount/path/of/your/choice