1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
/*
FUSE: Filesystem in Userspace
Copyright (C) 2001 Miklos Szeredi (mszeredi@inf.bme.hu)
This program can be distributed under the terms of the GNU GPL.
See the file COPYING.
*/
/* This file defines the library interface of FUSE */
#include <sys/types.h>
#include <sys/stat.h>
#include <utime.h>
/** Handle for a FUSE filesystem */
struct fuse;
/** Handle for a getdir() operation */
typedef struct fuse_dirhandle *fuse_dirh_t;
/** Function to add an entry in a getdir() operation */
typedef int (*fuse_dirfil_t) (fuse_dirh_t, const char *, int type);
/**
* The file system operations:
*
* Most of these should work very similarly to the well known UNIX
* file system operations. Exceptions are:
*
* - All operations should return the negated error value (-errno) on
* error.
*
* - readlink() should fill the buffer with a null terminated string. The
* buffer size argument includes the space for the terminating null
* character. If the linkname is too long to fit in the buffer, it should
* be truncated. The return value should be 0 for success.
*
* - getdir() is the opendir(), readdir(), ..., closedir() sequence
* in one call. For each directory entry the filldir parameter should
* be called.
*
* - There is no create() operation, mknod() will be called for
* creation of all non directory, non symlink nodes.
*
* - open() should not return a filehandle, but 0 on success. No
* creation, or trunctation flags (O_CREAT, O_EXCL, O_TRUNC) will be
* passed to open(). Open should only check if the operation is
* permitted for the given flags.
*
* - read(), write() are not passed a filehandle, but rather a
* pathname. The offset of the read and write is passed as the last
* argument, like the pread() and pwrite() system calls.
*/
struct fuse_operations {
int (*getattr) (const char *, struct stat *);
int (*readlink) (const char *, char *, size_t);
int (*getdir) (const char *, fuse_dirh_t, fuse_dirfil_t);
int (*mknod) (const char *, mode_t, dev_t);
int (*mkdir) (const char *, mode_t);
int (*unlink) (const char *);
int (*rmdir) (const char *);
int (*symlink) (const char *, const char *);
int (*rename) (const char *, const char *);
int (*link) (const char *, const char *);
int (*chmod) (const char *, mode_t);
int (*chown) (const char *, uid_t, gid_t);
int (*truncate) (const char *, off_t);
int (*utime) (const char *, struct utimbuf *);
int (*open) (const char *, int);
int (*read) (const char *, char *, size_t, off_t);
int (*write) (const char *, const char *, size_t, off_t);
};
/* FUSE flags: */
/** Process requests in multiple threads */
#define FUSE_MULTITHREAD (1 << 0)
/** Enable debuging output */
#define FUSE_DEBUG (1 << 1)
/**
* Create a new FUSE filesystem.
*
* @param fd the control file descriptor
* @param flags any combination of the FUSE flags defined above, or 0
* @return the created FUSE handle
*/
struct fuse *fuse_new(int fd, int flags);
/**
* Set the filesystem operations.
*
* Operations which are initialised to NULL will return ENOSYS to the
* calling process.
*
* @param f the FUSE handle
* @param op the operations
*/
void fuse_set_operations(struct fuse *f, const struct fuse_operations *op);
/**
* FUSE event loop.
*
* Requests from the kernel are processed, and the apropriate
* operations are called.
*
* @param f the FUSE handle
*/
void fuse_loop(struct fuse *f);
/**
* Destroy the FUSE handle.
*
* The filesystem is not unmounted.
*
* @param f the FUSE handle
*/
void fuse_destroy(struct fuse *f);
|