blob: df5373e03de56362b71eb651040b82059bd9ea93 [file] [log] [blame]
swissChili4418ca52021-06-14 17:36:00 -07001Bluejay Filesystem
2==================
3
4Filesystem drivers are still a work in progress. To test a file system you will
5want to create and mount a virtual block device. The makefile in ``src/kernel``
swissChilie9fec8b2021-06-22 13:59:33 -07006will generate an ``hd0_ext2.img`` EXT2 disk image for you automatically. The
7default size is 32 megabytes, but you can create your own of any size if you
8want. Once the image has been created it will be loaded by QEMU automatically.
swissChili4418ca52021-06-14 17:36:00 -07009
10In order to write to the virtual hard disk from your host operating system you
11should mount it. The ``make mount`` command in ``src/kernel`` mount the image to
swissChilie9fec8b2021-06-22 13:59:33 -070012``$(BLUEJAY_ROOT)/mnt``. If you are using an EXT2 filesystem you should probably
13change the owner of that directory once it is mounted so that you can write to
14it.
swissChili4418ca52021-06-14 17:36:00 -070015
16Virtual Filesystem
17------------------
18
19The Bluejay VFS is heavily inspired by UNIX. It relies on inodes and a tree of
20file nodes. The source can be found in ``src/kernel/vfs.c``. This also exports a
21very low-level API for dealing with files -- including the usual read(),
22write(), readdir(), etc -- but this should not be used for much longer. A high
23level API utilizing file descriptors will be implemented to make this simpler.