Provided by: nfs-ganesha_3.5-1ubuntu1_amd64 bug

NAME

       ganesha-export-config - NFS Ganesha Export Configuration File

SYNOPSIS

          /etc/ganesha/ganesha.conf

DESCRIPTION

       NFS-Ganesha obtains configuration data from the configuration file:
          /etc/ganesha/ganesha.conf

       This file lists NFS-Ganesha Export block config options.

   EXPORT_DEFAULTS {}
       These  options are all "export permissions" options, and will be repeated in the EXPORT {}
       and EXPORT { CLIENT {} } blocks.

       These options will all be dynamically updateable.

       Access_Type(enum, default None)

              Possible values:
                     None, RW, RO, MDONLY, MDONLY_RO

       Protocols(enum list, default [3,4])

              Possible values:
                     3, 4, NFS3, NFS4, V3, V4, NFSv3, NFSv4, 9P

       Transports(enum list, values [UDP, TCP, RDMA], default [UDP, TCP])

       Anonymous_uid(anonid, range INT32_MIN to UINT32_MAX, default -2)

       Anonymous_gid(anonid, range INT32_MIN to UINT32_MAX, default -2)

       SecType(enum list, default [none, sys])

              Possible values:
                     none, sys, krb5, krb5i, krb5p

       PrivilegedPort(bool, default false)

       Manage_Gids(bool, default false)

       Squash(enum, default root_sqaush)

              Possible values:
                     root, root_squash, rootsquash, rootid,  root_id_squash,  rootidsquash,  all,
                     all_squash,  allsquash,  all_anomnymous, allanonymous, no_root_squash, none,
                     noidsquash

              Each line of defaults above are synonyms

       Security_Label(bool, default false)

       NFS_Commit(bool, default false)

       Delegations(enum, default None)

              Possible values:
                     None, read, write, readwrite, r, w, rw

       Attr_Expiration_Time(int32, range -1 to INT32_MAX, default 60)

   EXPORT {}
       Export_id (required):
              An identifier for the export, must be unique and betweem 0 and 65535.  If Export_Id
              0 is specified, Pseudo must be the root path (/).

       Path (required)
              The  directory in the exported file system this export is rooted on (may be ignored
              for some FSALs). It need not be unique if Pseudo and/or Tag are specified.

              Note that if it is not unique, and the core option  mount_path_pseudo  is  not  set
              true,  a  v3  mount  using  the  path  will ONLY be able to access the first export
              configured. To access other exports the Tag option would need to be used.

       Pseudo (required v4)
              This option specifies the position in the Pseudo FS this export occupies if this is
              an  NFS  v4  export. It must be unique. By using different Pseudo options, the same
              Path may be exported multiple times.

              This option is used to place the export within the NFS v4 Pseudo  Filesystem.  This
              creates  a  single  name space for NFS v4. Clients may mount the root of the Pseudo
              Filesystem and navigate to exports.  Note that the Path and Tag options are not  at
              all visible to NFS v4 clients.

              Export  id  0  is  automatically  created  to  provide the root and any directories
              necessary to navigate to exports if there is no other export specified with  Pseudo
              =  /;.  Note that if an export is specified with Pseudo = /;, it need not be export
              id 0. Specifying such an export with FSAL { name = PSEUDO; } may be used to  create
              a  Pseudo FS with specific options. Such an export may also use other FSALs (though
              directories to reach exports will ONLY be  automatically  created  on  FSAL  PSEUDO
              exports).

       Tag (no default)
              This  option  allows  an  alternative access for NFS v3 mounts. The option MUST not
              have a leading /. Clients may not mount subdirectories (i.e.  if  Tag  =  foo,  the
              client may not mount foo/baz). By using different Tag options, the same Path may be
              exported multiple times.

       MaxRead (64*1024*1024)
              The maximum read size on this export

       MaxWrite (64*1024*1024)
              The maximum write size on this export

       PrefRead (64*1024*1024)
              The preferred read size on this export

       PrefWrite (64*1024*1024)
              The preferred write size on this export

       PrefReaddir (16384)
              The preferred readdir size on this export

       MaxOffsetWrite (INT64_MAX)
              Maximum file offset that may be written Range is 512 to UINT64_MAX

       MaxOffsetRead (INT64_MAX)
              Maximum file offset that may be read Range is 512 to UINT64_MAX

       CLIENT (optional)
              See the EXPORT { CLIENT  {} } block.

       FSAL (required)
              See the EXPORT { FSAL  {} } block.

   EXPORT { CLIENT {} }
       Take all the "export permissions" options from  EXPORT_DEFAULTS.   The  client  lists  are
       dynamically updateable.

       Clients(client list, empty)
              Client list entries can take on one of the following forms: Match any client:

                 @name       Netgroup name
                 x.x.x.x/y   IPv4 network address
                 wildcarded  If the string contains at least one ? or *
                             character (and is not simply "*"), the string is
                             used to pattern match host names. Note that [] may
                             also be used, but the pattern MUST have at least one
                             ? or *
                 hostname    Match a single client (match is by IP address, all
                             addresses returned by getaddrinfo will match, the
                             getaddrinfo call is made at config parsing time)
                 IP address  Match a single client

   EXPORT { FSAL {} }
       NFS-Ganesha supports the following FSALs: Ceph Gluster GPFS Proxy RGW VFS LUSTRE

       Refer to individual FSAL config file for list of config options.

SEE ALSO

       ganesha-config(8)   ganesha-rgw-config(8)  ganesha-vfs-config(8)  ganesha-lustre-config(8)
       ganesha-xfs-config(8) ganesha-gpfs-config(8) ganesha-9p-config(8)  ganesha-proxy-config(8)
       ganesha-ceph-config(8)

                                           Oct 26, 2022                  GANESHA-EXPORT-CONFIG(8)