OpenBSD manual page server

Manual Page Search Parameters

FUSE_MAIN(3) Library Functions Manual FUSE_MAIN(3)

fuse_mainFUSE helper function

#include <fuse.h>

int
fuse_main(int argc, char **argv, const struct fuse_operations *ops, void *data);

There are two ways of implementing a FUSE filesystem: by calling only () and passing this function the argument containing all the callbacks of the filesystem, or by using the other functions, as detailed in fuse_loop(3)

argv is the list of arguments supplied to the program's main method and must at a minimum specify the directory on which the file system is to be mounted. The other arguments can be custom arguments specific to the file system or those supported by fuse_parse_cmdline(3), fuse_new(3) and fuse_mount(3).

Here is a simple example of a FUSE implementation:

#include <errno.h>
#include <fuse.h>
#include <string.h>

static int
fs_readdir(const char *path, void *data, fuse_fill_dir_t filler,
    off_t off, struct fuse_file_info *ffi)
{
	if (strcmp(path, "/") != 0)
		return (-ENOENT);

	filler(data, ".", NULL, 0);
	filler(data, "..", NULL, 0);
	filler(data, "file", NULL, 0);
	return (0);
}

static int
fs_read(const char *path, char *buf, size_t size, off_t off,
    struct fuse_file_info *ffi)
{
	if (off >= 5)
		return (0);

	size = 5 - off;
	memcpy(buf, "data." + off, size);
	return (size);
}

static int
fs_open(const char *path, struct fuse_file_info *ffi)
{
	if (strncmp(path, "/file", 10) != 0)
		return (-ENOENT);

	if ((ffi->flags & 3) != O_RDONLY)
		return (-EACCES);

	return (0);
}

static int
fs_getattr(const char *path, struct stat *st)
{
	if (strcmp(path, "/") == 0) {
		st->st_blksize = 512;
		st->st_mode = 0755;
		st->st_nlink = 2;
	} else if (strcmp(path, "/file") == 0) {
		st->st_mode = 0644;
		st->st_blksize = 512;
		st->st_nlink = 1;
		st->st_size = 5;
	} else {
		return (-ENOENT);
	}

	return (0);
}

struct fuse_operations fsops = {
	.readdir = fs_readdir,
	.read = fs_read,
	.open = fs_open,
	.getattr = fs_getattr,
};

int
main(int ac, char **av)
{
	return (fuse_main(ac, av, &fsops, NULL));
}

fuse_loop(3), fuse_mount(3), fuse_new(3), fuse_parse_cmdline(3), fuse_setup(3), fuse(4)

The fuse_main() function conforms to FUSE 2.6.

The fuse_main() function first appeared in OpenBSD 5.4.

Sylvestre Gallon <ccna.syl@gmail.com>
Helg Bredow <helg@openbsd.org>

November 28, 2018 OpenBSD-6.6