General Information — Python-LLFUSE 1.5.1 documentation

# General Information

## Getting started

A file system is implemented by subclassing the `llfuse.Operations` class and implementing the various request handlers. The handlers respond to requests received from the FUSE kernel module and perform functions like looking up the inode given a file name, looking up attributes of an inode, opening a (file) inode for reading or writing or listing the contents of a (directory) inode.

An instance of the operations class is passed to `llfuse.init` to mount the file system. To enter the request handling loop, run `llfuse.main`. This function will return when the file system should be unmounted again, which is done by calling `llfuse.close`.

All character data (directory entry names, extended attribute names and values, symbolic link targets etc) are passed as `bytes` and must be returned as `bytes`. This applies to both running under Python 2.x and 3.x

For easier debugging, it is strongly recommended that applications using Python-LLFUSE also make use of the faulthandler module.

## Lookup Counts

Most file systems need to keep track which inodes are currently known to the kernel. This is, for example, necessary to correctly implement the unlink system call: when unlinking a directory entry whose associated inode is currently opened, the file system must defer removal of the inode (and thus the file contents) until it is no longer in use by any process.

FUSE file systems achieve this by using “lookup counts”. A lookup count is a number that’s associated with an inode. An inode with a lookup count of zero is currently not known to the kernel. This means that if there are no directory entries referring to such an inode it can be safely removed, or (if a file system implements dynamic inode numbers), the inode number can be safely recycled.

The lookup count of an inode is increased by one for each call to the `lookup`, `create`, `symlink`, `mknod`, `link` and `mkdir` handlers. The lookup count is decreased by calls to the `forget` handler.

## FUSE and VFS Locking

FUSE and the kernel’s VFS layer provide some basic locking that FUSE file systems automatically take advantage of. Specifically:

- Calls to `rename`, `create`, `symlink`, `mknod`, `link` and `mkdir` acquire a write-lock on the inode of the directory in which the respective operation takes place (two in case of rename).

- Calls to `lookup` acquire a read-lock on the inode of the parent directory (meaning that lookups in the same directory may run concurrently, but never at the same time as e.g. a rename or mkdir operation).

- Unless writeback caching is enabled (which Python-LLFUSE does not yet allow), calls to `write` for the same inode are automatically serialized (i.e., there are never concurrent calls for the same inode even when multithreading is enabled).