Home | History | Annotate | Download | only in librefuse
History log of /src/lib/librefuse/fuse.h
RevisionDateAuthorComments
 1.36  26-Jan-2025  pho lib/librefuse: Fix an issue in the header <fuse.h>

It failed to expose "struct fuse_operations" when the FUSE 3.4 API was
requested. Any other API versions worked fine.
 1.35  21-Apr-2023  abs branches: 1.35.2;
Fix incorrect test for FUSE_USE_VERSION 34

(Thanks to Mark Davies for report)
 1.34  22-Jan-2022  pho branches: 1.34.2;
lib/librefuse: Implement all sorts of compat tweaks to appease various file systems

ReFUSE now supports all the FUSE API variants from FUSE 1.1 to FUSE
3.10. Sorry for the freaking giant patch. I could not break it down
any further.
 1.33  22-Jan-2022  pho Add some missing struct fields, structs, and constants that are part of the API
 1.32  22-Jan-2022  pho Implement some missing functions that are part of the API
 1.31  22-Jan-2022  pho Correct the wrong prototype of fuse_daemonize(3) while retaining ABI compatibility
 1.30  22-Jan-2022  pho Cosmetic changes
 1.29  22-Jan-2022  pho Change the way how FUSE_*_VERSION are handled

* FUSE_MAKE_VERSION(maj, min) now generates a 3-digits number if the
version is higher than 3.9. This is needed to support FUSE 3.10 API.

* FUSE_{MAJOR,MINOR}_VERSION no longer have a fixed value but are
derived from FUSE_USE_VERSION specified by the user code. This is
needed to support more FUSE filesystems in the wild.
 1.28  22-Jan-2022  pho lib/librefuse: Add support for legacy types and functions
 1.27  22-Jan-2022  pho lib/librefuse: Add stub functions for FUSE polling API
 1.26  22-Jan-2022  pho lib/librefuse: Implement data buffer API appeared on FUSE 2.9
 1.25  22-Jan-2022  pho lib/librefuse: Implement FUSE session API and its signal handling functionality
 1.24  04-Dec-2021  pho librefuse: Preparation of a proper API versioning; no more #ifdef woes in user code

The goal is to fully support FUSE API version 3.0 while maintaining
API/ABI compatibility with code written for 2.6 (or even older).

* <fuse.h> now emits a compiler warning if it's included without
defining FUSE_USE_VERSION. It had been silently defaulted to the
latest supported version prior to this change. This is permissive
compared to the original FUSE, as it emits an error instead.

* <fuse.h> now emits a warning if FUSE_USE_VERSION is higher than what
can be provided.

* Added a macro FUSE_MAKE_VERSION(maj, min). It was missing from
librefuse <fuse.h>.

No actual API updates have been made (yet).
 1.23  10-Apr-2019  maya provide fuse_version
 1.22  20-Nov-2016  pho branches: 1.22.14;
fuse_main(3): Support general fuse options via fuse_parse_cmdline(3)

* Prototypes for fuse_new(3), fuse_mount(3), and fuse_unmount(3) now
matches to the original fuse interface.

* Add fuse_daemonize(3): needs to have a different prototype,
otherwise we can't use puffs_daemon(3).

* Remove fuse_setup(3) and fuse_teardown(3). These obsolete functions
has already been removed from the original interface.

* fuse_main(3) now supports the following command-line options
compatible with the original fuse:

-h, --help print help message
-V, --version print library version (currently does nothing)
-d, -o debug enable debug output (PUFFS_FLAG_OPDUMP), implies -f
-f foreground mode
-s single threaded mode (always enabled for now)
-o fsname=NAME explicitly set the name of the file system

* fuse_main(3) now daemonizes the process by default. This is for the
compatibility with the original fuse.
 1.21  01-Aug-2008  dillo branches: 1.21.42;
Add API version 2.6 variant of fuse_setup.

Reviewed by agc.
 1.20  14-Jan-2008  pooka branches: 1.20.6;
Remove puffs_ops from fuse_operations, no reason for it to be there.
 1.19  17-May-2007  christos branches: 1.19.4;
More fixes:
- make sure that the args array is NULL terminated.
- make sure argc is initialized and argv is set to NULL after freeing.
- make the deep copy function an opt interface function.
 1.18  16-May-2007  xtraeme Add the $NetBSD$ tag, it's easier to know what revision you have.
 1.17  16-May-2007  christos - Always check strdup return. For now we are lazy and bail instead of cleaning
up.
- Use malloc and free instead of macros, delete macros.
- Merge the two copies of deep copy and free args that were slightly buggy
into one and use that one.

XXX: Lots of ints should be size_t.
XXX: Bailing on error is not a good thing for a library.
XXX: Defs.h should be eliminated completely. Not all files need all the headers.
 1.16  16-May-2007  agc The FUSE_USE_VERSION is the definition which the user sets, and which
determines the API.

Provide a default for FUSE_USE_VERSION if it's not set, and use this
value to determine the number of arguments given to fuse_main().
 1.15  15-May-2007  agc Fuse version 2.6 (and above) has a 4 argument version of fuse_main(),
whereas previous versions had a 3 argument one. Accept both.
 1.14  03-May-2007  agc ...and include fuse_opt.h in the correct place.
 1.13  03-May-2007  agc Implement fuse_setup(), and fuse_teardown() - necessary for the python
bindings for refuse.
 1.12  03-May-2007  agc FUSE includes fuse_opt.h from fuse.h, albeit indirectly, via fuse_common.h.

Refuse doessn't have a fuse_common.h, so include fuse_opt.h explicitly
from fuse.h. To avoid circular dependencies, don't include fuse.h
from fuse_opt.h.

This means that we no longer have to modify packages which use the argument
and option parsing routines to include fuse_opt.h.
 1.11  13-Mar-2007  agc Revert the most recent changes I made - they weren't ready for primetime.
 1.10  13-Mar-2007  agc + Only use EXIT_SUCCESS and EXIT_FAILURE for the return code to the
shell in the fuse_opt functions

+ add new debugging functions:
+ __fuse_debug(), which is used to set and retrieve the
debugging level, so that debugging information can be turned
on and off from the user-level filesystem, and
+ __fuse_pargs(), which prints out an argv vector

+ put the comment about pu_privdata back with the code it references

+ put the code to place the refuse name back into the fuse_new()
function - we have access to all the arguments there.

+ specifically include <fuse_opt.h> in <fuse.h> - this would seem to
be what FUSE itself does, judging by the number of fuse-based
filesystems I've patched to include <fuse_opt.h> specifically

+ do away with the forward reference to struct fuse_args in fuse.h,
since it is defined just after the forward reference without being
referenced in between

+ fill in the missing refuse_opt args functionality - add an arg to the
args structure in fuse_opt_add_arg() and fuse_opt_insert_arg(), and
free allocated memory in fuse_opt_free_args().

+ get rid of spurious forward declarations and prototypes.

+ if REFUSE_INHERIT_FS_CHARACTERISTICS is defined when refuse is built,
file systems inherit the vfs characteristics of their mountpoints. The
default value is NOT to inherit the vfs characteristics.

+ perform a deep copy of the fuse_args structure in fuse_mount() -
this is so that existing FUSE filesystems still DTRT when arguments
are zeroed out.
 1.9  28-Feb-2007  xtraeme * Move fuse_opt* defs and prototypes into fuse_opt.h.
* Move fuse_opt* funcs from refuse.c into refuse_opt.c.

Implement fuse_opt_parse() and fuse_opt_match(). And make the other
functions just dummy, always returning 0 (I added debugging printfs
to see what the application is trying to do).

For now there are two things that do not work in fuse_opt:

* options accepting arguments, i.e -otimeout=%u or -ofile=%s.
* options without arguments are not enabled, just parsed.

At least now curlftpfs works, even with verbose mode! :-)

Ok'ed by pooka.
 1.8  26-Feb-2007  pooka Refactor a few interfaces a bit to look more like fuse. fuse_args
is implemented as a very dummy version (i.e. totally unimplemented),
so some effort is still needed there.

After this change it is possible to compile and run ntfs-3g. It
works read/write for ntfs images and shows no faults at least with
superficial testing. I did not test it against a block device,
only an image.

Thanks to Tracy and Jason for help with the test image.
 1.7  26-Feb-2007  pooka Implement readdir properly, or at least as close to possible to how
fuse does it: read directory completely into refuse buffers if starting
from read offset 0 and for later calls trickle results from the buffers
to the kernel without consulting the fuse file system.
 1.6  19-Feb-2007  pooka Implement a very very stubby fuse_unmount(), which does ... nothing.
Pending some puffs changes that are in the queue, this is the best way
currently.
 1.5  18-Feb-2007  pooka move getdir() location to match layout of real fuse operations
 1.4  18-Feb-2007  agc Added extra functionality:

fuse_opt_free_args()

fuse_exit()

Both from Juan RP - thanks!
 1.3  15-Feb-2007  pooka Implement a very very hacky fuse_get_context(), needs to be visited once
threading is added (and probably otherwise also).
 1.2  11-Feb-2007  pooka implement getdir, used by some older fuse file systems instead of readdir
 1.1  11-Feb-2007  agc Add an implementation of the file system in userspace functionality,
based on top of libpuffs. This version is still barebones and
incomplete, but will benefit from others working on it, rather than
just me.

The option code has still to be implemented, but this gets far enough
to run hellofs (from the fuse web page):

% priv ./hellofs ~/hellofs/mnt &
% l ~/hellofs/mnt
total 2
drwxr-xr-x 2 root wheel 0 Jan 1 1970 .
drwxr-xr-x 4 agc agc 512 Feb 9 18:05 ..
-r--r--r-- 1 root wheel 13 Jan 1 1970 hello
% cat ~/hellofs/mnt/hello
Hello World!
% df ~/hellofs/mnt
Filesystem 1K-blocks Used Avail Capacity Mounted on
/dev/dk0 28101396 18946682 7749646 70% /
kernfs 1 1 0 100% /kern
procfs 4 4 0 100% /proc
ptyfs 1 1 0 100% /dev/pts
puffs:refuse:hellofs 28101396 18946682 7749646 70% /home/agc/hellofs/mnt
% mount -v -v
...
mount: mount_puffs not found for /home/agc/hellofs/mnt
puffs:refuse:hellofs on /home/agc/hellofs/mnt type puffs (nosuid, nodev, fsid: 0xcb01/0x6acb, reads: sync 0 async 0, writes: sync 0 async 0)
%

This code is not enabled by default. Yet.
 1.19.4.1  23-Mar-2008  matt sync with HEAD
 1.20.6.1  18-Sep-2008  wrstuden Sync with wrstuden-revivesa-base-2.
 1.21.42.1  07-Jan-2017  pgoyette Sync with HEAD. (Note that most of these changes are simply $NetBSD$
tag issues.)
 1.22.14.1  10-Jun-2019  christos Sync with HEAD
 1.34.2.1  25-Apr-2023  martin Pull up following revision(s) (requested by abs in ticket #146):

lib/librefuse/fuse.h: revision 1.35

Fix incorrect test for FUSE_USE_VERSION 34
(Thanks to Mark Davies for report)
 1.35.2.1  02-Aug-2025  perseant Sync with HEAD

RSS XML Feed