Merge branch 'clone_fd'
[fuse.git] / README.NFS
blobf3348d5afba689bd6c5da5665a047e01b64a7367
1 NFS exporting is supported in Linux kernels 2.6.27 or later.
3 You need to add an fsid=NNN option to /etc/exports to make exporting a
4 FUSE directory work.
6 Filesystem support
7 ------------------
9 NFS exporting works to some extent on all fuse filesystems, but not
10 perfectly.  This is due to the stateless nature of the protocol, the
11 server has no way of knowing whether the client is keeping a reference
12 to a file or not, and hence that file may be removed from the server's
13 cache.  In that case there has to be a way to look up that object
14 using the inode number, otherwise an ESTALE error will be returned.
16 1) low-level interface
18 Filesystems need to implement special lookups for the names "." and
19 "..".  The former may be requested on any inode, including
20 non-directories, while the latter is only requested for directories.
21 Otherwise these special lookups should behave identically to ordinary
22 lookups.
24 2) high-level interface
26 Because the high-level interface is path based, it is not possible to
27 delegate looking up by inode to the filesystem.
29 To work around this, currently a "noforget" option is provided, which
30 makes the library remember nodes forever.  This will make the NFS
31 server happy, but also results in an ever growing memory footprint for
32 the filesystem.  For this reason if the filesystem is large (or the
33 memory is small), then this option is not recommended.