---
name: "ganesha-log-config"
section: "8"
platform: "linux"
package: "nfs-ganesha"
version: "6.5-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ganesha-log-config"
---

# ganesha-log-config(8)

NFS Ganesha Log Configuration File

## NAME

ganesha-log-config - NFS Ganesha Log Configuration File

## SYNOPSIS

```
/etc/ganesha/ganesha.conf
```

## DESCRIPTION

NFS-Ganesha reads the configuration data from: \| /etc/ganesha/ganesha.conf

This file lists NFS-Ganesha Log config options.

These options may be dynamically updated by issuing a SIGHUP to the ganesha.nfsd process.

### LOG {}

Default\_log\_level(token,default EVENT)

If this option is NOT set, the fall back log level will be that specified in the -N option on the command line if that is set, otherwise the fallback level is EVENT.

If a SIGHUP is issued, any components not specified in LOG { COMPONENTS {} } will be reset to this value.

The log levels are:

NULL, FATAL, MAJ, CRIT, WARN, EVENT, INFO, DEBUG, MID\_DEBUG, M\_DBG, FULL\_DEBUG, F\_DBG

- **RPC\_Debug\_Flags(uint32, range 0 to UINT32\_MAX, default 7)**

  Debug flags for TIRPC (default 7 matches log level default EVENT).

  These flags are only used if the TIRPC component is set to DEBUG

- **Display\_UTC\_Timestamp(bool, default false)**

  Flag to enable displaying UTC date/time in log messages instead of localtime.

### LOG { COMPONENTS {} }

- **Default\_log\_level(token,default EVENT)**

  - **These entries are of the form:**

    COMPONENT = LEVEL;

  - **The components are:**

    ALL, LOG, MEMLEAKS, FSAL, NFSPROTO, NFS\_V4, EXPORT, FILEHANDLE, DISPATCH, MDCACHE, MDCACHE\_LRU, HASHTABLE, HASHTABLE\_CACHE, DUPREQ, INIT, MAIN, IDMAPPER, NFS\_READDIR, NFS\_V4\_LOCK, CONFIG, CLIENTID, SESSIONS, PNFS, RW\_LOCK, NLM, TIRPC, NFS\_CB, THREAD, NFS\_V4\_ACL, STATE, 9P, 9P\_DISPATCH, FSAL\_UP, DBUS, NFS\_MSK, XPRT

  - **Some synonyms are:**

    FH = FILEHANDLE HT = HASHTABLE CACHE\_INODE\_LRU = MDCAHCE\_LRU CACHE\_INODE = MDCACHE INODE\_LRU = MDCAHCE\_LRU INODE = MDCACHE DISP = DISPATCH LEAKS = MEMLEAKS NFS3 = NFSPROTO NFS4 = NFS\_V4 HT\_CACHE = HASHTABLE\_CACHE NFS\_STARTUP = INIT NFS4\_LOCK = NFS\_V4\_LOCK NFS4\_ACL = NFS\_V4\_ACL 9P\_DISP = 9P\_DISPATCH

  - **The log levels are:**

    NULL, FATAL, MAJ, CRIT, WARN, EVENT, INFO, DEBUG, MID\_DEBUG, M\_DBG, FULL\_DEBUG, F\_DBG

    default none

  ALL is a special component that when set, sets all components to the specified value, overriding any that are explicitly set. Note that if ALL is then removed from the config and SIGHUP is issued, all components will revert to what is explicitly set, or Default\_Log\_Level if that is specified, or the original log level from the -N command line option if that was set, or the code default of EVENT.

  TIRPC is a special component that also sets the active RPC\_Debug\_Flags. If the level for TIRPC is DEBUG or MID\_DEBUG, the custom RPC\_Debug\_Flags set by that parameter will be used, otherwise flags will depend on the level the TIRPC component is set to:

  NULL or FATAL: 0

  CRIT or MAJ: TIRPC\_DEBUG\_FLAG\_ERROR

  WARN: TIRPC\_DEBUG\_FLAG\_ERROR \| TIRPC\_DEBUG\_FLAG\_WARN

  EVENT or INFO: TIRPC\_DEBUG\_FLAG\_ERROR \| TIRPC\_DEBUG\_FLAG\_WARN \| TIRPC\_DEBUG\_FLAG\_EVENT

  DEBUG or MID\_DEBUG: RPC\_Debug\_Flags

  FULL\_DEBUG: 0xffffffff

### LOG { FACILITY {} }

This block may be repeated to configure multiple log facilities.

**name(string, no default)**

**destination(string, no default, must be supplied)**

- **max\_level(token,default FULL\_DEBUG)**

  The log levels are:

  NULL, FATAL, MAJ, CRIT, WARN, EVENT, INFO, DEBUG, MID\_DEBUG, M\_DBG, FULL\_DEBUG, F\_DBG

**headers(token, values \[none, component, all\], default all)**

**enable(token, values \[idle, active, default\], default idle)**

### LOG { FORMAT {} }

- **date\_format(enum,default ganesha)**

  - **Possible values:**

    ganesha, true, local, 8601, ISO-8601, ISO 8601, ISO, syslog, syslog\_usec, false, none, user\_defined

- **time\_format(enum,default ganesha)**

  - **Possible values:**

    ganesha, true, local, 8601, ISO-8601, ISO 8601, ISO, syslog, syslog\_usec, false, none, user\_defined

**user\_date\_format(string, no default)**

**user\_time\_format(string, no default)**

**EPOCH(bool, default true)**

**CLIENTIP(bool, default false)**

**HOSTNAME(bool, default true)**

**PROGNAME(bool, default true)**

**PID(bool, default true)**

**THREAD\_NAME(bool, default true)**

**FILE\_NAME(bool, default true)**

**LINE\_NUM(bool, default true)**

**FUNCTION\_NAME(bool, default true)**

**COMPONENT(bool, default true)**

**LEVEL(bool, default true)**

**OP\_ID(bool, default false)**

**CLIENT\_REQ\_XID(bool, default false)**

## SEE ALSO

[*ganesha-config*(8)](/ganesha-config/8.md)