Improve documentation of `fuse_file_info.keep_cache`

examples/passthrough_ll.c: Include <limits.h> (for PATH_MAX macro).

Otherwise building w/o optimization (-O0) fails.

    passthrough_ll.c: In function 'lo_readlink':
    passthrough_ll.c:251:11: error: 'PATH_MAX' undeclared (first use in this function)
      char buf[PATH_MAX + 1];

(gcc v5.3.0 in Alpine Linux v3.4.6 x86_64 w/ musl-libc v1.1.14.)

examples/passthrough_ll.c: Close root fd before application ends.

If we want to do, what system would do anyway upon program termination,
then let's try to be a bit more scrupulous.

examples/passthrough_ll.c: Fix segfault when showing help or version.

root lo_inode's next and prev were not set early enough, which led to
accessing addr 0x8 (or 0x4, depending on ptr size) when setting prev
variable in lo_free(lo.root.next), because lo.root.next was NULL.

Rename more things from fuse to fuse3

Document that FUSE_CAP_POSIX_ACL turns on -o default_permissions

Make handling of -oallow_root easier to understand

-oallow_root is handled in userspace, and requires passing -oallow_other
 to the kernel. This patch should make the code easier to understand and
 avoid the confusion that gave rise to issue #86.

Add support for FUSE_HANDLE_KILLPRIV

Fixes #116.

Add support for FUSE_POSIX_ACL

Fixes #117.

Added support for FUSE_PARALLEL_DIROPS

Enabled by default since we haven't released libfuse 3.0 yet :-).

Fixes #112.

Updated kernel API headers.

Taken from Linux kernel commit 27bcd37.

Document fuse_conn_info.max_background

Fixes #95.

Distinguish between mount options and libfuse options

Fixed manpage formatting.

Enable more capabilities by default, and document defaults.

Fixes #112.

Update ChangeLog to include recent documentation improvements

Abort if fs requests capabilities not supported by kernel.

See also issue #114.

Fail more nicely on max_read mismatch

Instead of abort()ing, close the session properly and return an
error code.

Fix typo in comment

Add support for more detailed error codes from main loop

Fix typo in comment

Document special semantics of ENOSYS error code.

Document "congestion_threshold" parameter.

Fixes #96.

Thanks to Maxim Patlasov <mpatlasov@virtuozzo.com> for help!

Make max_background and congestion_threshold "officially undocumented"

Improve documentation of FUSE_CAP_AUTO_INVAL_DATA

Fixes #84.

Improve getattr() description

When writeback caching is enabled, the st_size value reported
by the filesystem may be ignored.

Improve description of FUSE_CAP_NO_OPEN_SUPPORT flag.

Fixes #107.

Added documentation for FUSE_CAP_FLOCK_LOCKS

Fixes #106.

Improve documentation of fuse_conn_info.time_gran.

Fixes #97.

Make test for util-linux version more robust

The current version fails on Amazon Linux. This check should work
better.

Fixes #64.

Don't expect EACCESS errors as root

Fixes #111.

Released 3.0.0-rc2

Removed reference to developer-notes.rst (was removed earlier)

Fixed section names in documentation index

Fix documentation: fuse_file_info may be NULL for open files

This turns issue #62 from a bug into an enhancement :-).

Removed reference to fgetattr and ftruncate (don't exist anymore)

Fixed typo in comment.

Don't hardcode test file name.

Added test for fchmod

At the moment this test fails (cf. issue #62). If that gets fixed in the
kernel, this test can be activated conditionally.

Merge pull request #109 from divinity76/patch-1

silence bogus eclipse linter warning

silence bogus eclipse linter warning

"No break at the end of case cuse.c     /example     line 235  Code Analysis Problem"

Clean-up doxygen documentation

Fixes: #81.

Fix memory leak in fusermount.

Renamed fusermount / mount.fuse to fusermount3 / mount.fuse3

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.