GANESHA-PROXY-V4-CONFIG(8)

📦
version 9.16 · 11 versions
, in fedora 44

✨ NAME ✨

ganesha-proxy-v4-config — NFS Ganesha Proxy V4 Configuration File 💖

(you found the section 8 page for ganesha-proxy-v4-config, bestie — yes, the one about the config file, come sit with me)

🎀 SYNOPSIS 🎀

/etc/ganesha/ganesha.conf

🌸 DESCRIPTION 🌸

NFS-Ganesha installs the following config file for Proxy V4 FSAL: 🦋

/etc/ganesha/ganesha.conf

This file lists Proxy V4 specific config options. That's it, that's the whole vibe — it's the place where all the Proxy V4 knob-twiddling lives. 👑

💅 EXPORT { FSAL {} } 💅

Okay so this is the block where you tell the FSAL who it is and how it talks to the world. Every option below goes inside there, bestie. 🫶

  • Name (string, "proxy_v4") — the name of the FSAL, and it should always be proxy_v4. Not vibes-adjacent, not a nickname. proxy_v4. periodt. 💀
  • Retry_SleepTime (uint32, range 0 to 60, default 10)
  • Srv_Addr (ipv4_addr, default "127.0.0.1")
  • NFS_Service (uint32, range 0 to UINT32_MAX, default 100003)
  • NFS_SendSize — must be greater than maxwrite+SEND_RECV_HEADER_SPACE
  • NFS_RecvSize — must be greater than maxread+SEND_RECV_HEADER_SPACE
  • MAX_READ_WRITE_SIZE (default 1 MB)
  • SEND_RECV_HEADER_SPACE (default 512 Bytes)
  • FSAL_MAXIOSIZE (default 64 MB)
  • NFS_SendSize (uint64, default MAX_READ_WRITE_SIZE + SEND_RECV_HEADER_SPACE) — range 512 + SEND_RECV_HEADER_SPACE to FSAL_MAXIOSIZE
  • NFS_RecvSize (uint64, default MAX_READ_WRITE_SIZE + SEND_RECV_HEADER_SPACE) — range 512 + SEND_RECV_HEADER_SPACE to FSAL_MAXIOSIZE
  • NFS_Port (uint16, range 0 to UINT16_MAX, default 2049)
  • Use_Privileged_Client_Port (bool, default true)
  • RPC_Client_Timeout (uint32, range 1 to 60*4, default 60)
  • Remote_PrincipalName (string, no default) — nope, nothing there unless you put something there 🙈
  • KeytabPath (string, default "/etc/krb5.keytab")
  • Credential_LifeTime (uint32, range 0 to 86400*2, default 86400)
  • Sec_Type (enum, values [krb5, krb5i, krb5p], default krb5)
  • Active_krb5 (bool, default false)
  • Enable_Handle_Mapping (bool, default false)
  • HandleMap_DB_Dir (string, default "/var/ganesha/handlemap")
  • HandleMap_Tmp_Dir (string, default "/var/ganesha/tmp")
  • HandleMap_DB_Count (uint32, range 1 to 16, default 8)
  • HandleMap_HashTable_Size (uint32, range 1 to 127, default 103)

🧚 PROXY_V4 {} 🧚

And this block is where the Proxy V4 module itself gets its little personality. 🌈

  • link_support (bool, default true)
  • symlink_support (bool, default true)
  • cansettime (bool, default true)
  • MAX_READ_WRITE_SIZE (default 1MB)
  • FSAL_MAXIOSIZE (default 64 MB)
  • SEND_RECV_HEADER_SPACE (default, 512 Bytes)
  • maxread (uint64, default MAX_READ_WRITE_SIZE) — range 512 to FSAL_MAXIOSIZE - SEND_RECV_HEADER_SPACE
  • maxwrite (uint64, default MAX_READ_WRITE_SIZE) — range 512 to FSAL_MAXIOSIZE - SEND_RECV_HEADER_SPACE
  • umask (mode, range 0 to 0777, default 0)
  • auth_xdev_export (bool, default false)

⭐ SEE ALSO ⭐

ganesha-log-config <>(8) ganesha-core-config <>(8) ganesha-export-config <>(8)

lowkey the most important part: go read your logs config, your core config, and your export config. the way that they'll explain the rest of this whole situation? iconic. 🍓

that's the whole page, bestie 💖 this one comes from the NFS-Ganesha source, dated Aug 11, 2026, and yeah — it's GANESHA-PROXY-V4-CONFIG(8) all the way down. now go configure something cute. 👑✨

📦 where this page comes from