A block device in user space for Linux
Go to file
Adam Cozzette e49ded9330 Cleaned up the README. Copied some constants and struct definitions to buse.h so
that the code doesn't rely on a hard-coded location of nbd.h.
2011-11-23 14:34:43 -08:00
.gitignore Various changes: 2011-11-15 14:44:38 -08:00
Makefile Cleaned up the README. Copied some constants and struct definitions to buse.h so 2011-11-23 14:34:43 -08:00
README Cleaned up the README. Copied some constants and struct definitions to buse.h so 2011-11-23 14:34:43 -08:00
buse.c Cleaned up the README. Copied some constants and struct definitions to buse.h so 2011-11-23 14:34:43 -08:00
buse.h Cleaned up the README. Copied some constants and struct definitions to buse.h so 2011-11-23 14:34:43 -08:00
busexmp.c Changes to the BUSE memory disk example: 2011-11-17 11:19:09 -08:00

README

BUSE - A block device in userspace

Adam Cozzette
Fall 2011

This piece of software was inspired by FUSE, which allows the development of
Linux file systems that run in userspace. The goal of BUSE is to allow virtual
block devices to run in userspace as well. Currently BUSE is experimental and
should not be used for production code.

Implementing a block device with BUSE is fairly straightforward. Simply fill
struct buse_operations (declared in buse.h) with function pointers that define
the behavior of the block device, and set the size field to be the desired size
of the device in bytes. Then call buse_main and pass it a pointer to this
struct. busexmp.c is a simple example example that shows how this is done.

The implementation of BUSE itself relies on NBD, the Linux network block device,
which allows a remote machine to serve requests for reads and writes to a
virtual block device on the local machine. BUSE sets up an NBD server and client
on the same machine, with the server executing the code defined by the BUSE
user.