FUSE

Table of Contents Exporting FUSE-based filesystems with GANESHA Compiling and installing Exporting your FUSE-based file system Details about GANESHA FUSE-like binding Interface Filesystem mandatory features Command line arguments Example

Exporting FUSE-based filesystems with GANESHA

Compiling and installing

Go to the "src" directory of NFS-GANESHA distribution. Then run:

  # ./configure --with-fsal=FUSE
  # make
  # make install

Exporting your FUSE-based file system

• • • In your source code, replace #include <fuse.h></fuse.h> with #include <ganesha_fuse_wrap.h></ganesha_fuse_wrap.h>
    • For linking your program, replace -lfuse with -lganeshaNFS

That's done! You can now start your daemon and mount your filesystem (here is an example in NFSv3):

 ./my_daemon
 mount &#45&#59;o vers&#61&#59;3,udp localhost&#58&#59;/ /mnt

Details about GANESHA FUSE-like binding

Interface

Ganesha FUSE-like interface provides most FUSE's "high-level" structures and calls (struct fuse_file_info, struct fuse_operations, fuse_main(), fuse_get_context(), ...)

Basically, it supports FUSE-based filesystems using <fuse.h></fuse.h> (at least version 2.6).

Filesystem mandatory features

For being able to export your filesystem with NFS-GANESHA, the following features are mandatory:

• • • getattr must be implemented
    • Each entry in your filesystem must have a unic <st_ino,></st_ino,> peer
    • You must set a correct value to the "st_mode" field of "struct stat" (type and access mode)
    • The "st_nlink" field of "struct stat" must not be null
    • Deprecated call "getdir" is not supported, replace it with "readdir"

Command line arguments

fuse_main() parameters slightly differ from FUSE implementation.

The expected command line parameters are:

 Usage&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;58&amp&#59;&#35&#59;59&#59&#59; fusexmp &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;hds&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;L &amp&#59;amp&#59&#59;lt&amp&#59;&#35&#59;59&#59&#59;logfile&amp&#59;amp&#59&#59;gt&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;N &amp&#59;amp&#59&#59;lt&amp&#59;&#35&#59;59&#59&#59;dbg_lvl&amp&#59;amp&#59&#59;gt&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;f &amp&#59;amp&#59&#59;lt&amp&#59;&#35&#59;59&#59&#59;config_file&amp&#59;amp&#59&#59;gt&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;h&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;                display this help
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;s&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;                single&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;threaded (for MT&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;unsafe filesystems)
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;L &amp&#59;amp&#59&#59;lt&amp&#59;&#35&#59;59&#59&#59;logfile&amp&#59;amp&#59&#59;gt&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;      set the logfile for the daemon
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;N &amp&#59;amp&#59&#59;lt&amp&#59;&#35&#59;59&#59&#59;dbg_lvl&amp&#59;amp&#59&#59;gt&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;      set the verbosity level
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;f &amp&#59;amp&#59&#59;lt&amp&#59;&#35&#59;59&#59&#59;config_file&amp&#59;amp&#59&#59;gt&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;  set the config file to be used
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;d&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;                the daemon starts in background,
                            in a new process group
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;R&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59;                daemon will manage RPCSEC_GSS
                            (default is no RPCSEC_GSS)
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;F&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59; &amp&#59;amp&#59&#59;lt&amp&#59;&#35&#59;59&#59&#59;nb_flushers&amp&#59;amp&#59&#59;gt&amp&#59;&#35&#59;59&#59&#59;  flushes the data cache with purge,
                            but do not answer to requests
        &amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;91&amp&#59;&#35&#59;59&#59&#59;&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;45&amp&#59;&#35&#59;59&#59&#59;S&amp&#59;amp&#59&#59;&amp&#59;&#35&#59;35&#59&#59;93&amp&#59;&#35&#59;59&#59&#59; &amp&#59;amp&#59&#59;lt&amp&#59;&#35&#59;59&#59&#59;nb_flushers&amp&#59;amp&#59&#59;gt&amp&#59;&#35&#59;59&#59&#59;  flushes the data cache without purge,
                            but do not answer to requests

Example

FUSE-binding examples are provided in the GANESHA repository (directory src/example-fuse).

These are the same as provided with FUSE distributions, except that #include <fuse.h></fuse.h> have been changed to #include <ganesha_fuse_wrap.h></ganesha_fuse_wrap.h>.

After compiling GANESHA with FUSE FSAL, you can simply run it the following way:

 ./fusexmp