Released 3.0.0rc1

man: Document suid requirement

Add max_read to fuse_conn_info

Eventually, this setting should be negotiated in the filesystem's init()
handler (like e.g. max_write). However, this requires corresponding
changes in the FUSE kernel module. In preparation for this (and to allow
a transition period) we already allow (and require) filesystems to set
the value in the init() handler in addition to the mount option.

The end-goal is tracked in issue #91.

Removed obsolete FUSE_DEV_OLD

Removed some more "Changed in version x.py" comments.

Recommend when to use -o default_permissions automatically

Describe all mount options in mount.fuse(8).

Also improved manpage in several ways.

Improve documentation of -o default_permissions

Improve documentation of capability flags.

Improve man page title

Clarify which mount options are intended for file-system internal use.

Clarify difference between notify_inval_entry and notify_delete().

Fixes #85.

Use "se" instead of "f" for struct fuse_session

The fuse_session pointer is sometimes called f and at other times
se. The former is an artifact from the time when there still was a
separate struct fuse_ll object.

For consistency and to easy maintenance, this patch changes the name of
the fuse_session pointer to "se" wherever possible.

This patch was generated by the following Coccinelle script:

@@
symbol f, se;
@@
struct fuse_session *
-f
+se
;
<...
-f
+se
...>

@@
expression expr;
@@
struct fuse_session *
-f
+se
= expr;
<...
-f
+se
...>

@@
identifier fn;
@@
fn(...,struct fuse_session *
-f
+se
,...) { <...
-f
+se
...> }

Due to its complexity, the do_init() function had to be commented out
and then patched manually.

Added debug logging to chmod

Fix segfault in debug logging code

fi may be NULL, so we need to protect against this.

fuse_session_new(): don't accept empty argv, check argv[0]

This should help avoid people to accidentally put options
into argv[0].

Fixes #100.

Turn fuse_operations.nopath_flag into fuse_config.nullpath_ok

Modifying struct fuse_config in the init() handler is the canonical way
to adjust file-system implementation specific settings. There is no need
to have flags in struct fuse_operations.

fuse_new(): don't accept options that don't make sense for end-users

Several options (use_ino, etc) depend on the file system
implementation. Allowing them to be set from the command line makes no
sense.

Document -o remember= mount option.

Pass struct fuse_config to high-level init() handler.

ChangeLog: Remind people of to use FUSE_CAP_EXPORT_SUPPORT

Accept zero value for fuse_conn_info options

This may not make sense for all options, but it's good practice.

Removed all "Introduced in..." comments

Since FUSE 3 is breaking backwards compatibility, this really does
not matter.

mount.fuse(8): remove max_readahead, max_write, [a]sync_read

These are not mount options for FUSE file systems, but capabilites that
are worked out between libfuse and the fuse kernel module. For that
reason, they are also not accepted by fuse_session_new().

Do not close stdout on fuse_session_destroy()

If fuse_session_mount() fails (or was never called in the first place)
we end up with the default fd value which happens to be 0. It hurts
long-running processes, which lifetime extends beyond session's
lifetime.

Cast to void where we deliberately ignore return values

Ignore some errors

Update linker script

- Fixes commit d49f2e77b4.
- Fixes commit 199fc0f833.
- Thanks to Github user mtheall for the review!

fuse_session_new(): accept --debug

Fixes commit 3e022acf4076.

Thanks to Github user mtheall for the review!

Spelling fix

Thanks to (Github user) mtheall for the review!

Ignore GNU Global tag files.

Mention that low-level fs need to set FUSE_CAP_EXPORT_SUPPORT

Default to FUSE_USE_VERSION 30

Various documentation updates

Move README.NFS into doc/
Update project URL
Remove reference to non-existent INSTALL file
Remove outdated/obsolete NEWS and how-fuse-works files.
Update references to examples.

Inlined fuse_mount_help() into fuse_lowlevel_help().

Both the BSD and Linux implementation actually accept mostly the same
FUSE-specific mount options. Up to now, the BSD help function appended
the output of ``mount_fusefs --help``, but looking at
http://www.unix.com/man-page/freebsd/8/mount_fusefs/ this is likely more
confusing than helpful (since the user is not actually invoking
mount_fusefs directly, most of the options don't make sense).

fuse_new(): instead of listing options, refer to mount.fuse(8)

fuse_session_new(): instead of listing options, refer to mount.fuse(8)

fuse_session_new: accept -o debug as synonym for -d

Updated man-pages.

* Removed -o nonempty
* Added -o noforget
* Split into high-level / low-level
* Added warning that most options should be chosen by file system
  internally.
* Updated maintainer.

Make --help output more suitable for end-user

We now only list options that are potentially useful for an
end-user (and unlikely to accidentally break a file system). The full
list of FUSE options has been moved to the documentation of the
fuse_new() and fuse_session_new() functions.

Removed -o nopath - it never did anything

We are overriding this setting with the flag in struct fuse_operations:

$ example/hello -f -d  ~/tmp/mnt
FUSE library version: 3.0.0pre0
nopath: 0
unique: 1, opcode: INIT (26), nodeid: 0, insize: 56, pid: 0
INIT: 7.25
flags=0x0007fffb
max_readahead=0x00020000
   INIT: 7.23
   flags=0x00006031
   max_readahead=0x00020000
   max_write=0x00020000
   max_background=0
   congestion_threshold=0
   time_gran=0
   unique: 1, success, outsize: 80

$ example/hello -f -d  ~/tmp/mnt -o nopath
FUSE library version: 3.0.0pre0
nopath: 0
unique: 1, opcode: INIT (26), nodeid: 0, insize: 56, pid: 0
INIT: 7.25
flags=0x0007fffb
max_readahead=0x00020000
   INIT: 7.23
   flags=0x00006031
   max_readahead=0x00020000
   max_write=0x00020000
   max_background=0
   congestion_threshold=0
   time_gran=0
   unique: 1, success, outsize: 80

Removed -o nonempty option

This brings the default behavior in-line with that of the
regular `mount` command.

Fix documentation of -o max_write=

big_writes has been available for some time, and is the default in FUSE
3. So max_write now actually takes effect.

(This really should have gone into commit 97f4a9cb4fc69)

Drop -o large_read mount option

This was only relevant for 2.4 kernels. Fixes #92.

Pass fuse_file_info to getattr, chown, chmod, truncate, utimens handlers

This obsoletes the ftruncate & fgetattr handlers.

Fixes #58.

Unify handling of fuse_conn_info options

Instead of using command line options to modify struct fuse_conn_info
before and after calling the init() handler, we now give the file system
explicit control over this.

Merge branch 'fixup-lock-options'

Re-activated lost no_remote_*lock options.

tests: use freshly-build fusermount (instead of system version)

When running tests as non-root, make fusermount setuid root.

Travis: use "make test" instead of calling pytest directly

Only test writeback cache if kernel is recent enough.

Added lost ChangeLog entries for -o writeback_cache and -o async_dio.

do_init(): treat command line options consistently

Previously, some command line options would change the FUSE defaults
but leave the final value to the file systems `init` handler while
others would override any changes made by `init`. Now, command line
options do both: they modify the default, *and* take precedence.

Make -o clone_fd into a parameter of session_loop_mt().

This option really affects the behavior of the session loop, not the
low-level interface. Therefore, it does not belong in the fuse_session
object.

Move session options into sub-struct

The session options are used only once to determine the proper
conn->want flags. It is nice to have them clearly separated from the
other struct fuse_session members that are used throughout the life of
the file system.

Mention atomic_o_trunc capability in description of open() handler.

Use NULL for option processing function where possible.

Activate splice_read by default if write_buf is implemented.

Document when fuse_reply_data will use splice()

Factored out LL_OPTIONS macro

Removed 'async_read' field in fuse_conn_info

This is redundant with the capability flags in `wants` and `capable`.

Make several -o NN options work again

In commit 2ed7af, we accidentally set the default values *after*
parsing the command line arguments.

Fix race condition in notify_* examples

The fix in commit cf4159156b was incomplete. While some false positives
are caused by sleep() in the file system taking longer than expected,
there was also a race condition where the file system would run before
the contents are initialized properly.

Added write cache tests.

Use "se" instead of "f" for fuse_session pointer where possible.

These changes were generated with the following Coccinelle semantic
patch:

@@
symbol f, se; // avoid unneeded warnings from Coccinelle
@@
struct fuse_session *
-f
+se
 ;
<...
-f
+se
...>

@@
identifier fn;
@@
fn(...,struct fuse_session *
-f
+se
,...) { <...
-f
+se
...> }

fuse_main(): extend support for printing help

There's now a way to inhibit the "usage" line (which actually got lost
in commit 225c12aebf2d), which makes it easier for simply file-systems
to generate good-looking --help output.

Use NULL as option processor where possible.

fuse_main_real(): use fuse_parse_cmdline().

Added ChangeLog entry for commit 225c12aebf2d2f27e1d0.

Added cuse unit test.

Renamed cuses example and added test program

An earlier version of the fioclient.c example was intended to be
used together with cusexmp.c. The former has since evolved into
ioctl_client.c and no longer has the function necessary to test
CUSE. Therefore, we've added a new cuse_client.c that is clearly
associated with the cuse.c example file system.

Increase timeouts in notify_* tests

When running under Valgrind, we otherwise get sporadic test failures.

Don't confuse lookup count for mountpoint and file

I think this is the reason for a sporadic test failure, where
fuse_lowlevel_notify_store() fails.

Renamed timefsN examples to fuse_notify_*

This should make it more obvious at first glance what the different
examples do.

Include testfsN examples in Doxygen documentation.

Renamed ioctl and poll examples

The new names should make it more obvious at first glance
what each example demonstrates.

Renamed some examples to make their function more obvious

Also, added more comments for the same purpose.

fuse_parse_cmdline(): do not print help/version text

The current behavior makes it difficult to add help for
additional options. With the change, this becomes a lot easier.

Added missing export of fuse_pkgversion.

Merge pull request #80 from libfuse/master-proposed

Whitespace fix.

Fix valgrind warning

If we don't assign a value to padding, we get a warning about reading
uninitialized data when sending the iovec to the kernel.

Fix documentation of fuse_parse_cmdline().

For --help and --version, it returns -1.

Dropped example/null.c

This does not seem to be working. Maybe because it tries to treat the
mountpoint as a file rather than a directory?

Added timefs3 to test notify_inval_entry.

Fixes #32.

Add background and multithreading support to hello_ll and fuse_lo-plus

Update list of requests that can be answered with fuse_reply_none().

testfs2: Also test fuse_notify_retrieve().

Added timefs[12] examples.

These examplesdemonstrate the use of the `fuse_lowlevel_notify_store`
and `fuse_lowlevel_notify_inval_inode` functions.

Added safe_sleep()

Clarify that readdir() *may* report . and .. entries.

Removed ``-o big_writes`` option

This option is obsolete and should always be enabled. File systems that
want to limit the size of write requests should use the
``-o max_write=<N>`` option instead.

Test more combinations of low-level options.

Remove pointless aliasing of fuse_session *se to *f

This is an overlooked artifact of the fuse_ll-fuse_session merge.

Removed obsolete, unused *f member from struct fuse_session.

Merge struct fuse_ll into struct fuse_session.

This merge merges struct fuse_ll into struct fuse_session. Since
there is always a one-to-one correspondence between the two,
there is little reason to keep them separate. By merging them,
we save pointers and lines of code.

Merge fuse_ll into fuse_session (part 8)

Replaced "req->se" with "f" where the latter is already defined.

Merge fuse_ll into fuse_session (part 7)

Remove pointless aliasing of "struct fuse_session *se" to "struct
fuse_session *f".

Merge fuse_ll into fuse_session (part 6)

Fixup cuse_lowlevel_new().

Merge fuse_ll into fuse_session (part 5)

Fixup fuse_session_new().