Man pages sections > man8 > ganesha-config

ganesha-config - NFS Ganesha Configuration File

GANESHA-CONFIG(8) NFS-Ganesha GANESHA-CONFIG(8)

NAME

ganesha-config - NFS Ganesha Configuration File

SYNOPSIS

/etc/ganesha/ganesha/conf
 

DESCRIPTION

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


 
The configuration file constitues of following parts:

Comments

Empty lines and lines starting with ‘#’ are comments.:
 
# This whole line is a comment
Protocol = TCP; # The rest of this line is a comment


Blocks

Related options are grouped together into "blocks". A block is a name followed by parameters enclosed between "{" and "}". A block can contain other sub blocks as well.:
 
Export
{
    Export_ID = 1;
    FSAL {
        Name = VFS:
    }
}


 
NOTE: FSAL is a sub block. Refer to BLOCKS section for list of blocks and options.

Options

Configuration options can be of following types.
 
1. Numeric Numeric options can be defined in octal, decimal, or hexadecimal. The format follows ANSI C syntax. eg.:
 
mode = 07555;  # This is octal 0755, 493 (decimal)


 
Numeric values can also be negated or logical NOT'd. eg.:
 
anonomousuid = -2; # this is a negative
mask = ~0xff; # Equivalent to 0xffffff00 (for 32 bit integers)


 
2. Boolean Possible values are true, false, yes and no. 1 and 0 are not acceptable.
 
3. List The option can contain a list of possible applicable values. Protocols = 3, 4, 9p;

Including other config files

Additional files can be referenced in a configuration using include statement.:
 
%include <filename>


 
The included file is inserted into the configuration text in place of this line. The configuration following this line is resumed after the end of the included files. File inclusion can be to any depth.
eg.::
%include base.conf %include "base.conf"

BLOCKS

NFS-Ganesha supports the following blocks:

EXPORT {}

Along with configuration options, it also support two subblocks: 1.**EXPORT { FSAL {} }** 2.**EXPORT { CLIENT {} }**
 
Refer to ganesha-export-config(8) for usage that this block and its sub blocks support.

EXPORT_DEFAULTS {}

Refer to ganesha-export-config(8) for usage

CACHEINODE {}

Refer to ganesha-cache-config(8) for usage

NFS_CORE_PARAM {}

Refer to ganesha-core-config(8) for usage

NFS_IP_NAME {}

Refer to ganesha-core-config(8) for usage

NFS_KRB5 {}

Refer to ganesha-core-config(8) for usage

NFSv4 {}

Refer to ganesha-core-config(8) for usage

CEPH {}

Refer to ganesha-ceph-config(8) for usage

9P {}

Refer to ganesha-9p-config(8) for usage

GPFS {}

Refer to ganesha-gpfs-config(8) for usage

LOG {}

Refer to ganesha-log-config(8) for usage
 
1.**LOG { FACILITY {} }** 2.**LOG { FORMAT {} }**

PROXY {}

Refer to ganesha-proxy-config(8) for usage
 
1.**PROXY { Remote_Server {} }**

RGW {}

Refer to ganesha-rgw-config(8) for usage

VFS {}

Refer to ganesha-vfs-config(8) for usage

XFS {}

Refer to ganesha-xfs-config(8) for usage

ZFS {}

Refer to ganesha-zfs-config(8) for usage

EXAMPLE

Along with "ganesha.conf", for each installed FSAL, a sample config file is added at:
/etc/ganesha
 

SEE ALSO

ganesha-log-config(8) ganesha-rgw-config(8) ganesha-vfs-config(8) ganesha-xfs-config(8) ganesha-zfs-config(8) ganesha-gpfs-config(8) ganesha-9p-config(8) ganesha-proxy-config(8) ganesha-ceph-config(8) ganesha-core-config(8) ganesha-export-config(8)
September 7, 2017