|
libfuse
|
Go to the source code of this file.
Data Structures | |
| struct | fuse_file_info |
| struct | fuse_loop_config |
| struct | fuse_conn_info |
| struct | fuse_buf |
| struct | fuse_bufvec |
Macros | |
| #define | FUSE_MAJOR_VERSION 3 |
| #define | FUSE_MINOR_VERSION 2 |
| #define | FUSE_CAP_ASYNC_READ (1 << 0) |
| #define | FUSE_CAP_POSIX_LOCKS (1 << 1) |
| #define | FUSE_CAP_ATOMIC_O_TRUNC (1 << 3) |
| #define | FUSE_CAP_EXPORT_SUPPORT (1 << 4) |
| #define | FUSE_CAP_DONT_MASK (1 << 6) |
| #define | FUSE_CAP_SPLICE_WRITE (1 << 7) |
| #define | FUSE_CAP_SPLICE_MOVE (1 << 8) |
| #define | FUSE_CAP_SPLICE_READ (1 << 9) |
| #define | FUSE_CAP_FLOCK_LOCKS (1 << 10) |
| #define | FUSE_CAP_IOCTL_DIR (1 << 11) |
| #define | FUSE_CAP_AUTO_INVAL_DATA (1 << 12) |
| #define | FUSE_CAP_READDIRPLUS (1 << 13) |
| #define | FUSE_CAP_READDIRPLUS_AUTO (1 << 14) |
| #define | FUSE_CAP_ASYNC_DIO (1 << 15) |
| #define | FUSE_CAP_WRITEBACK_CACHE (1 << 16) |
| #define | FUSE_CAP_NO_OPEN_SUPPORT (1 << 17) |
| #define | FUSE_CAP_PARALLEL_DIROPS (1 << 18) |
| #define | FUSE_CAP_POSIX_ACL (1 << 19) |
| #define | FUSE_CAP_HANDLE_KILLPRIV (1 << 20) |
| #define | FUSE_IOCTL_COMPAT (1 << 0) |
Enumerations | |
| enum | fuse_buf_flags { FUSE_BUF_IS_FD = (1 << 1), FUSE_BUF_FD_SEEK = (1 << 2), FUSE_BUF_FD_RETRY = (1 << 3) } |
| enum | fuse_buf_copy_flags { FUSE_BUF_NO_SPLICE = (1 << 1), FUSE_BUF_FORCE_SPLICE = (1 << 2), FUSE_BUF_SPLICE_MOVE = (1 << 3), FUSE_BUF_SPLICE_NONBLOCK = (1 << 4) } |
Functions | |
| struct fuse_conn_info_opts * | fuse_parse_conn_info_opts (struct fuse_args *args) |
| void | fuse_apply_conn_info_opts (struct fuse_conn_info_opts *opts, struct fuse_conn_info *conn) |
| int | fuse_daemonize (int foreground) |
| int | fuse_version (void) |
| const char * | fuse_pkgversion (void) |
| void | fuse_pollhandle_destroy (struct fuse_pollhandle *ph) |
| size_t | fuse_buf_size (const struct fuse_bufvec *bufv) |
| ssize_t | fuse_buf_copy (struct fuse_bufvec *dst, struct fuse_bufvec *src, enum fuse_buf_copy_flags flags) |
| int | fuse_set_signal_handlers (struct fuse_session *se) |
| void | fuse_remove_signal_handlers (struct fuse_session *se) |
| #define FUSE_CAP_ASYNC_DIO (1 << 15) |
Indicates that the filesystem supports asynchronous direct I/O submission.
If this capability is not requested/available, the kernel will ensure that there is at most one pending read and one pending write request per direct I/O file-handle at any time.
This feature is enabled by default when supported by the kernel.
Definition at line 257 of file fuse_common.h.
| #define FUSE_CAP_ASYNC_READ (1 << 0) |
Indicates that the filesystem supports asynchronous read requests.
If this capability is not requested/available, the kernel will ensure that there is at most one pending read request per file-handle at any time, and will attempt to order read requests by increasing offset.
This feature is enabled by default when supported by the kernel.
Definition at line 120 of file fuse_common.h.
| #define FUSE_CAP_ATOMIC_O_TRUNC (1 << 3) |
Indicates that the filesystem supports the O_TRUNC open flag. If disabled, and an application specifies O_TRUNC, fuse first calls truncate() and then open() with O_TRUNC filtered out.
This feature is enabled by default when supported by the kernel.
Definition at line 137 of file fuse_common.h.
| #define FUSE_CAP_AUTO_INVAL_DATA (1 << 12) |
Traditionally, while a file is open the FUSE kernel module only asks the filesystem for an update of the file's attributes when a client attempts to read beyond EOF. This is unsuitable for e.g. network filesystems, where the file contents may change without the kernel knowing about it.
If this flag is set, FUSE will check the validity of the attributes on every read. If the attributes are no longer valid (i.e., if the attr_timeout passed to fuse_reply_attr() or set in struct fuse_entry_param has passed), it will first issue a getattr request. If the new mtime differs from the previous value, any cached file contents will be invalidated as well.
This flag should always be set when available. If all file changes go through the kernel, attr_timeout should be set to a very large number to avoid unnecessary getattr() calls.
This feature is enabled by default when supported by the kernel.
Definition at line 219 of file fuse_common.h.
| #define FUSE_CAP_DONT_MASK (1 << 6) |
Indicates that the kernel should not apply the umask to the file mode on create operations.
This feature is disabled by default.
Definition at line 152 of file fuse_common.h.
| #define FUSE_CAP_EXPORT_SUPPORT (1 << 4) |
Indicates that the filesystem supports lookups of "." and "..".
This feature is disabled by default.
Definition at line 144 of file fuse_common.h.
| #define FUSE_CAP_FLOCK_LOCKS (1 << 10) |
If set, the calls to flock(2) will be emulated using POSIX locks and must then be handled by the filesystem's setlock() handler.
If not set, flock(2) calls will be handled by the FUSE kernel module internally (so any access that does not go through the kernel cannot be taken into account).
This feature is enabled by default when supported by the kernel and if the filesystem implements a flock() handler.
Definition at line 190 of file fuse_common.h.
| #define FUSE_CAP_HANDLE_KILLPRIV (1 << 20) |
Indicates that the filesystem is responsible for unsetting setuid and setgid bits when a file is written, truncated, or its owner is changed.
This feature is enabled by default when supported by the kernel.
Definition at line 317 of file fuse_common.h.
| #define FUSE_CAP_IOCTL_DIR (1 << 11) |
Indicates that the filesystem supports ioctl's on directories.
This feature is enabled by default when supported by the kernel.
Definition at line 197 of file fuse_common.h.
| #define FUSE_CAP_NO_OPEN_SUPPORT (1 << 17) |
Indicates support for zero-message opens. If this flag is set in the capable field of the fuse_conn_info structure, then the filesystem may return ENOSYS from the open() handler to indicate success. Further attempts to open files will be handled in the kernel. (If this flag is not set, returning ENOSYS will be treated as an error and signaled to the caller).
Setting (or unsetting) this flag in the want field has no effect.
Definition at line 279 of file fuse_common.h.
| #define FUSE_CAP_PARALLEL_DIROPS (1 << 18) |
Indicates support for parallel directory operations. If this flag is unset, the FUSE kernel module will ensure that lookup() and readdir() requests are never issued concurrently for the same directory.
This feature is enabled by default when supported by the kernel.
Definition at line 289 of file fuse_common.h.
| #define FUSE_CAP_POSIX_ACL (1 << 19) |
Indicates support for POSIX ACLs.
If this feature is enabled, the kernel will cache and have responsibility for enforcing ACLs. ACL will be stored as xattrs and passed to userspace, which is responsible for updating the ACLs in the filesystem, keeping the file mode in sync with the ACL, and ensuring inheritance of default ACLs when new filesystem nodes are created. Note that this requires that the file system is able to parse and interpret the xattr representation of ACLs.
Enabling this feature implicitly turns on the default_permissions mount option (even if it was not passed to mount(2)).
This feature is disabled by default.
Definition at line 308 of file fuse_common.h.
| #define FUSE_CAP_POSIX_LOCKS (1 << 1) |
Indicates that the filesystem supports "remote" locking.
This feature is enabled by default when supported by the kernel, and if getlk() and setlk() handlers are implemented.
Definition at line 128 of file fuse_common.h.
| #define FUSE_CAP_READDIRPLUS (1 << 13) |
Indicates that the filesystem supports readdirplus.
This feature is enabled by default when supported by the kernel and if the filesystem implements a readdirplus() handler.
Definition at line 227 of file fuse_common.h.
| #define FUSE_CAP_READDIRPLUS_AUTO (1 << 14) |
Indicates that the filesystem supports adaptive readdirplus.
If FUSE_CAP_READDIRPLUS is not set, this flag has no effect.
If FUSE_CAP_READDIRPLUS is set and this flag is not set, the kernel will always issue readdirplus() requests to retrieve directory contents.
If FUSE_CAP_READDIRPLUS is set and this flag is set, the kernel will issue both readdir() and readdirplus() requests, depending on how much information is expected to be required.
This feature is enabled by default when supported by the kernel and if the filesystem implements both a readdirplus() and a readdir() handler.
Definition at line 246 of file fuse_common.h.
| #define FUSE_CAP_SPLICE_MOVE (1 << 8) |
Indicates that libfuse should try to move pages instead of copying when writing to / reading from the fuse device. This may improve performance.
This feature is disabled by default.
Definition at line 168 of file fuse_common.h.
| #define FUSE_CAP_SPLICE_READ (1 << 9) |
Indicates that libfuse should try to use splice() when reading from the fuse device. This may improve performance.
This feature is enabled by default when supported by the kernel and if the filesystem implements a write_buf() handler.
Definition at line 177 of file fuse_common.h.
| #define FUSE_CAP_SPLICE_WRITE (1 << 7) |
Indicates that libfuse should try to use splice() when writing to the fuse device. This may improve performance.
This feature is disabled by default.
Definition at line 160 of file fuse_common.h.
| #define FUSE_CAP_WRITEBACK_CACHE (1 << 16) |
Indicates that writeback caching should be enabled. This means that individual write request may be buffered and merged in the kernel before they are send to the filesystem.
This feature is disabled by default.
Definition at line 266 of file fuse_common.h.
| #define FUSE_IOCTL_COMPAT (1 << 0) |
Ioctl flags
FUSE_IOCTL_COMPAT: 32bit compat ioctl on 64bit machine FUSE_IOCTL_UNRESTRICTED: not restricted to well-formed ioctls, retry allowed FUSE_IOCTL_RETRY: retry with new iovecs FUSE_IOCTL_DIR: is a directory
FUSE_IOCTL_MAX_IOV: maximum of in_iovecs + out_iovecs
Definition at line 329 of file fuse_common.h.
| #define FUSE_MAJOR_VERSION 3 |
Major version of FUSE library interface
Definition at line 22 of file fuse_common.h.
| #define FUSE_MINOR_VERSION 2 |
Minor version of FUSE library interface
Definition at line 25 of file fuse_common.h.
| enum fuse_buf_copy_flags |
Buffer copy flags
Definition at line 579 of file fuse_common.h.
| enum fuse_buf_flags |
Buffer flags
Definition at line 548 of file fuse_common.h.
| void fuse_apply_conn_info_opts | ( | struct fuse_conn_info_opts * | opts, |
| struct fuse_conn_info * | conn | ||
| ) |
This function applies the (parsed) parameters in opts to the conn pointer. It may modify the following fields: wants, max_write, max_readahead, congestion_threshold, max_background, time_gran. A field is only set (or unset) if the corresponding option has been explicitly set.
| ssize_t fuse_buf_copy | ( | struct fuse_bufvec * | dst, |
| struct fuse_bufvec * | src, | ||
| enum fuse_buf_copy_flags | flags | ||
| ) |
| size_t fuse_buf_size | ( | const struct fuse_bufvec * | bufv | ) |
| int fuse_daemonize | ( | int | foreground | ) |
| struct fuse_conn_info_opts* fuse_parse_conn_info_opts | ( | struct fuse_args * | args | ) |
This function parses several command-line options that can be used to override elements of struct fuse_conn_info. The pointer returned by this function should be passed to the fuse_apply_conn_info_opts() method by the file system's init() handler.
Before using this function, think twice if you really want these parameters to be adjustable from the command line. In most cases, they should be determined by the file system internally.
The following options are recognized:
-o max_write=N sets conn->max_write -o max_readahead=N sets conn->max_readahead -o max_background=N sets conn->max_background -o congestion_threshold=N sets conn->congestion_threshold -o async_read sets FUSE_CAP_ASYNC_READ in conn->want -o sync_read unsets FUSE_CAP_ASYNC_READ in conn->want -o atomic_o_trunc sets FUSE_CAP_ATOMIC_O_TRUNC in conn->want -o no_remote_lock Equivalent to -o no_remote_flock,no_remote_posix_lock -o no_remote_flock Unsets FUSE_CAP_FLOCK_LOCKS in conn->want -o no_remote_posix_lock Unsets FUSE_CAP_POSIX_LOCKS in conn->want -o [no_]splice_write (un-)sets FUSE_CAP_SPLICE_WRITE in conn->want -o [no_]splice_move (un-)sets FUSE_CAP_SPLICE_MOVE in conn->want -o [no_]splice_read (un-)sets FUSE_CAP_SPLICE_READ in conn->want -o [no_]auto_inval_data (un-)sets FUSE_CAP_AUTO_INVAL_DATA in conn->want -o readdirplus=no unsets FUSE_CAP_READDIRPLUS in conn->want -o readdirplus=yes sets FUSE_CAP_READDIRPLUS and unsets FUSE_CAP_READDIRPLUS_AUTO in conn->want -o readdirplus=auto sets FUSE_CAP_READDIRPLUS and FUSE_CAP_READDIRPLUS_AUTO in conn->want -o [no_]async_dio (un-)sets FUSE_CAP_ASYNC_DIO in conn->want -o [no_]writeback_cache (un-)sets FUSE_CAP_WRITEBACK_CACHE in conn->want -o time_gran=N sets conn->time_gran
Known options will be removed from args, unknown options will be passed through unchanged.
| args | argument vector (input+output) |
| const char* fuse_pkgversion | ( | void | ) |
| void fuse_pollhandle_destroy | ( | struct fuse_pollhandle * | ph | ) |
| void fuse_remove_signal_handlers | ( | struct fuse_session * | se | ) |
Restore default signal handlers
Resets global session. After this fuse_set_signal_handlers() may be called again.
| se | the same session as given in fuse_set_signal_handlers() |
See also: fuse_set_signal_handlers()
Definition at line 79 of file fuse_signals.c.
| int fuse_set_signal_handlers | ( | struct fuse_session * | se | ) |
Exit session on HUP, TERM and INT signals and ignore PIPE signal
Stores session in a global variable. May only be called once per process until fuse_remove_signal_handlers() is called.
Once either of the POSIX signals arrives, the signal handler calls fuse_session_exit().
| se | the session to exit |
See also: fuse_remove_signal_handlers()
Definition at line 62 of file fuse_signals.c.
1.8.13