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.

Document that client pid/gid/uid may be zero.

Fixes #67.

Merged fuse_session.c into fuse_lowlevel.c

This distinction no longer makes sens. fuse_lowlevel.c already contains
several session related functions, and fuse_session.c contains various
stuff that is more related to the channel interface.

Merged fuse_mt.c into fuse.c

There is no point in having a separate file for a 10 line function.

Extended per-file comments.

This should make more clear what file contains code for what
purpose.

Don't handle --help and --version in fuse_session_new().

Help and version messages can be generated using the new
fuse_lowlevel_help(), fuse_lowlevel_version(), fuse_mount_help(), and
fuse_mount_version() functions.

The fuse_parse_cmdline() function has been made more powerful
to do this automatically, and is now explicitly intended only
for low-level API users.

This is a code simplication patch. We don't have to parse for --help and
--version in quite as many places, and we no longer have a low-level
initialization function be responsible for the (super-high level) task
of printing a program usage message.

In the high-level API, we can now handle the command line parsing
earlier and avoid running other initialization code if we're just going
to abort later on.

fuse_mount_opts: don't keep max_read= option.

There is no consumer of it down the line.

Add section headings for --help output

Also, do not include "General options" in usage message.

Edited comments for clarity.

Added test for fuse_lo-plus.

Run hello_ll single-threaded explicitly.

Fixed permissions of source files.

Turn struct fuse_chan into an implementation detail

The only struct fuse_chan that's accessible to the user application is
the "master" channel that is returned by fuse_mount and stored in struct
fuse_session.

When using the multi-threaded main loop with the "clone_fd" option, each
worker thread gets its own struct fuse_chan. However, none of these are
available to the user application, nor do they hold references to struct
fuse_session (the pointer is always null).

Therefore, any presence of struct fuse_chan can be removed
without loss of functionality by relying on struct fuse_session instead.

This reduces the number of API functions and removes a potential source
of confusion (since the new API no longer looks as if it might be
possible to add multiple channels to one session, or to share one
channel between multiple sessions).

Fixes issue #17.

Renamed fuse_lowlevel_new() to fuse_session_new().

Re-order declarations to reflect typical order of use

Introduce separate mount/umount functions for low-level API.

Tell emacs to use tabs for linkerscript.

Turned fuse_session_{process,receive}_buf into wrapper functions.