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().

Merge fuse_ll into fuse_session (part 4)

Merge fuse_ll_destroy() and fuse_session_destroy().

Merge fuse_ll into fuse_session (part 3)

Replace se->f with se.

Merge fuse_ll into fuse_session (part 2)

Replaced all references to req->f with req->se.

Merge fuse_ll into fuse_session (part 1)

Merged the structures, and replaced fuse_ll with fuse_session
in all type definitions.

fuse_mount_help(): clarify that listed options are FUSE specific

We also accept a number of mount options that are common to
all  file systems (nosuid, nodev, ro, etc).

Clarified purpose of helper.c, moved *version() to fuse.c

Merge branch 'fix-root-umount'

Commit e4015aca9b7 already fixed this problem in a different way, so
this is effectively a null-merge.

fuse_session_unmount(): fix unmounting as root

We have to store the channel before removing it from the session,
otherwise we cannot use it to do the unmount.

This problem was introduced in commit 5698ee09cf7.

Thanks to Michael Theall for reporting & debugging this.

Merge master fuse_chan into fuse_session.

This is a code simplification patch.

- It confines most of the implementation channel implementation into
  fuse_loop_mt (which is its only user).

- It makes it more obvious in the code that channels are only ever used
  when using -o clone_fd and multi-threaded main loop.

- It simplies the definition of both struct fuse_session and struct
  fuse_chan.

- Theoretically it should result in (minuscule) performance
  improvements when not using -o clone_fd.

- Overall, it removes a lot more lines of source code than it adds :-).

fuse_lowlevel_notify_poll(): use master channel

In theory, a poll handle could hang around much longer than the worker
thread that creates it. Furthermore, the thread that created the
pollhandle is no more likely to call fuse_lowlevel_notify_poll() than
any other thread.

In theory, this would have kept the channel alive for much longer than
necessary. In practice, there seems to have been a bug that prevented
this - and instead allowed the channel to be destroyed while there
was still a pollhandle referring to it.

Instead of fixing this by calling fuse_chan_get() and fuse_chan_put() in
do_poll() and fuse_pollhandle_destroy(), we simply transmit poll
notifications over the master channel now.

Store struct fuse_session* in struct fuse_req

fuse_session_process_buf(): improve documentation

Released 3.0.0pre0

Don't crash if valgrind or libtool are not installed.

Run tests under valgrind when available.

Fixes #50.

Import os.path.join as pjoin

Makes the code much shorter :-).

Added fuse_session_fd()

Fixes #59.