Commit Graph

68 Commits

Author SHA1 Message Date
Sergey Fedoseev
f4187fe5fa
fix typo in man (#609) 2021-06-09 09:04:08 +01:00
Junichi Uekawa
0b6d97cf59
Define FUSE_USE_VERSION in Doxygen. (#608)
We currently do not pass anything in PREDEFINED and that means
FUSE_USE_VERSION is undefined.

Add that definition so that Doxygen built-in C pre-processor can use
FUSE_USE_VERSION value to find the correct comment to parse.
2021-05-19 09:32:14 +01:00
rfjakob
d169d512de
doc: Add "fuse (4)" to SEE ALSO sections in man pages (#601)
fuse (4) is an excellent introduction to the FUSE protocol,
and it lists fusermount (1) and mount.fuse (8) in its
SEE ALSO section.

I (the author of gocryptfs) was not aware of this man
page till March 2021, which suggest that it should be
made more discoverable.

So link back to fuse (4) in our SEE ALSO sections.
2021-05-08 14:15:55 +01:00
Junichi Uekawa
98e261cfab
fusermount3.1: refer to mount.fuse3 (#599)
mount.fuse was renamed to mount.fuse3.
2021-05-05 10:51:08 +01:00
ferivoz
f54eb86e9a
Fix typo "retuned" -> "returned" (#553) 2020-10-03 13:14:00 +01:00
Junichi Uekawa
e8a9e84672
Doc fixes (#537)
* Add fallocate to list of operations that may omit path.

* earlier versions is 10+ years old.

Document is not obvious how old it is. Add it.

* Update manpage link
2020-08-09 12:35:28 +01:00
winndows
9fa4dc1661
Fix the typo "filed" -> "field" in fuse manpage (#524)
Fix the typo "filed" -> "field" in fuse manpage.

Signed-off-by: Liao Pingfang <liao.pingfang@zte.com.cn>

Co-authored-by: Liao Pingfang <liao.pingfang@zte.com.cn>
2020-07-03 12:30:40 +01:00
Mattias Nissler
da7c9b228a Add unprivileged option in mount.fuse3
The unprivileged option allows to run the FUSE file system process
without privileges by dropping capabilities and preventing them from
being re-acquired via setuid / fscaps etc. To accomplish this,
mount.fuse sets up the `/dev/fuse` file descriptor and mount itself
and passes the file descriptor via the `/dev/fd/%u` mountpoint syntax
to the FUSE file system.
2018-10-09 20:36:22 +01:00
Laszlo Boszormenyi (GCS)
644ec8ceca Fix manpage filename for mount.fuse3 2018-07-04 19:52:32 +01:00
Tomohiro Kusumi
72ab7172b8 Fix build error on DragonFlyBSD (sync with other *BSD) (#240)
DragonFlyBSD has no "bsd" in uname, so add 'dragonfly' to conditionals.

-- e.g. uname(1) in DragonFlyBSD
[root@ ~]# uname
DragonFly
[root@ ~]# python -c "import sys; print(sys.platform)"
dragonfly5
2018-03-28 20:32:59 +01:00
Josh Soref
8157b4d9b9 Spelling (#223)
Fix spelling errors
2017-11-27 10:23:20 +00:00
Nikolaus Rath
16422eb03c Don't install manpages under *BSD
Were not installing the corresponding binaries either, since those
are provided by the BSD base system.
2017-10-20 09:20:39 +01:00
Nikolaus Rath
945ce7a9d4 Don't use Python mode for meson.build
Emacs now has a proper meson mode :-).
2017-10-20 09:19:16 +01:00
Nikolaus Rath
da363c514b Include source code in documentation. 2017-09-17 09:39:47 +01:00
Nikolaus Rath
109ab4fa53 Added some documentation of fuse internals. 2017-09-17 09:35:43 +01:00
Nikolaus Rath
30ead3a5cf Dropped support for building with autotools
It's just too much pain to keep it working.
2017-08-24 20:50:44 +02:00
Nikolaus Rath
77dee679eb Document that -o auto_unmount implies -o nodev,nosuid
See also issue #148.
2017-03-16 10:47:26 -07:00
Nikolaus Rath
9f96db7125 Added experimental support for building with Meson+Ninja 2017-01-12 15:19:04 -08:00
Przemysław Pawełczyk
dfbfee07ab Rename more things from fuse to fuse3 2016-11-28 21:33:14 -08:00
Nikolaus Rath
4fdf83f4dd Document that FUSE_CAP_POSIX_ACL turns on -o default_permissions 2016-11-22 16:39:59 -08:00
Nikolaus Rath
cb2111cc8b Distinguish between mount options and libfuse options 2016-11-17 15:51:22 -08:00
Nikolaus Rath
4172f7883a Fixed manpage formatting. 2016-11-17 15:49:05 -08:00
Nikolaus Rath
16a24c0d8e Removed reference to developer-notes.rst (was removed earlier) 2016-11-06 21:58:26 -08:00
Nikolaus Rath
d85279d0cb Fixed section names in documentation index 2016-11-06 21:53:28 -08:00
Nikolaus Rath
7983414b33 Clean-up doxygen documentation
Fixes: #81.
2016-10-28 20:44:39 -07:00
Mihail Konev
d8d894e780 man: Document suid requirement 2016-10-27 21:52:31 -07:00
Nikolaus Rath
e885e84f79 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.
2016-10-27 21:38:42 -07:00
Nikolaus Rath
131955ff7c Recommend when to use -o default_permissions automatically 2016-10-27 13:57:19 -07:00
Nikolaus Rath
11f07d1033 Describe all mount options in mount.fuse(8).
Also improved manpage in several ways.
2016-10-27 13:42:08 -07:00
Nikolaus Rath
ba653b1c24 Improve documentation of -o default_permissions 2016-10-27 12:46:16 -07:00
Nikolaus Rath
768f29fc2a Improve man page title 2016-10-27 09:43:28 -07:00
Nikolaus Rath
7be8c8ff2d Clarify which mount options are intended for file-system internal use. 2016-10-25 22:16:33 -07:00
Nikolaus Rath
8ee553dac0 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.
2016-10-20 15:32:20 -07:00
Nikolaus Rath
cb8fa961dc Document -o remember= mount option. 2016-10-20 15:22:05 -07:00
Nikolaus Rath
e869f7cc8e 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().
2016-10-20 14:04:37 -07:00
Nikolaus Rath
26f0dba3c8 Mention that low-level fs need to set FUSE_CAP_EXPORT_SUPPORT 2016-10-16 15:34:20 -07:00
Nikolaus Rath
1c08ee91f6 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.
2016-10-16 15:12:29 -07:00
Nikolaus Rath
3c76d564e4 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.
2016-10-16 14:12:39 -07:00
Nikolaus Rath
86b2614906 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 97f4a9cb4f)
2016-10-15 18:51:00 -07:00
Nikolaus Rath
d6217bb2a0 Drop -o large_read mount option
This was only relevant for 2.4 kernels. Fixes #92.
2016-10-15 18:49:52 -07:00
Nikolaus Rath
5698ee09cf 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.
2016-10-02 13:56:40 -07:00
Nikolaus Rath
944d1e1521 Added notes for libfuse hackers. 2016-09-27 20:45:26 -07:00
Nikolaus Rath
b8a6921da5 Fixed up permissions. 2016-09-27 20:45:26 -07:00
Nikolaus Rath
a1e8fc90ba Include documentation in tarball. 2016-01-28 18:01:48 -08:00
Miklos Szeredi
3c3f03b81f ulockmgr: strip ulockmgr support from this source package
Distribute ulockmgr separately.  It is not needed for the building of
libfuse, only fusexmp_fh.  Check ulockmgr library in ./configure and if not
disable remote-lock suport in fusexmp_fh.
2013-07-25 17:58:48 +02:00
Miklos Szeredi
7dfb43254c Documentation fixes 2013-07-17 15:58:53 +02:00
Joachim Schiele
ea7227db43 - added a doxygen main page
- modified all examples to be included in doxygen
- modified the API documentation to have more details
- added the 490px_FUSE_structure.svg.png (c) wikipedia
2013-06-20 19:18:18 +02:00
Miklos Szeredi
95e1a99472 Create doc/.gitignore 2013-02-05 13:20:25 +01:00
Miklos Szeredi
b02843393f clean up man page 2012-01-26 18:01:14 +01:00
Miklos Szeredi
cd0ad2cf01 Add doc/Makefile.am 2012-01-26 17:44:35 +01:00