GANESHA-PROXY-CONFIG(8)

📦
version 3.5 · 2 versions
, in ubuntu jammy

🌸 NAME

ganesha-proxy-config — the NFS Ganesha Proxy Configuration File, bestie. it's the whole vibe of how your Proxy FSAL gets set up 💅

✨ SYNOPSIS

/etc/ganesha/ganesha.conf

💖 DESCRIPTION

okay so listen. NFS-Ganesha goes and installs this config file for the Proxy FSAL:

/etc/ganesha/ganesha.conf

(yes there's a stray | hanging out at the end of that line in the original, we keep it, no cap, it's part of the lore 🫶)

this file is where all the Proxy-specific config options live. that's it, that's the tea ✨

👑 EXPORT { FSAL {} }

this is the block, this is the moment, this is the main character 🎀

  • Name (string, proxy) — the name of the FSAL. it should always be proxy. always. 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 — has to be greater than maxwrite+SEND_RECV_HEADER_SPACE. it's giving "size matters" 😭
  • NFS_RecvSize — has to 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, it's on its own fr fr
  • 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)
heads up bestie: NFS_SendSize and NFS_RecvSize both show up twice in this list — once as a bare "must be greater than…" note and once as a full uint64 with a default and a range. that's literally how the original rolls, so we keep both. don't come for me 💀

🦋 PROXY {}

the second block! the sequel! the encore! 🌈

  • 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

go read those too, they're lowkey iconic, iykyk 🧚

that's the whole page, babe 💜 huge thanks to NFS-Ganesha (that's the source/version energy right there) and this little masterpiece is dated Oct 26, 2022. slay, ate, no crumbs. 🎀✨💅

📦 where this page comes from