Skip to content
Tech News
← Back to articles

Show HN: nfsdiag – A NFS diagnostic application

read original get NFS Diagnostic Tool Kit → more articles
Why This Matters

nfs-doctor provides a comprehensive client-side diagnostic tool for troubleshooting NFS server issues, enabling users to quickly identify network, configuration, and permission problems. Its ability to test multiple NFS versions and gather detailed metrics makes it valuable for both developers and system administrators aiming to ensure reliable NFS performance. This tool enhances the troubleshooting process, reducing downtime and improving overall system stability in environments reliant on NFS.

Key Takeaways

nfs-doctor is a small command line tool written in C to help debug NFS servers from the client side.

The idea is simple: you give one IP or hostname, and the tool checks the things that usually break in NFS: network, rpcbind, NFS versions, mountd, exports, permissions, root squash, locking, stale handles and some basic performance.

It is not magic, and it will not replace a good server side analysis. But it helps a lot to understand if the problem is network, NFS config, permissions, UID/GID mapping, or something more strange.

What this tool does

Today nfs-doctor can do these checks:

test if rpcbind TCP port 111 is reachable

TCP port is reachable test if NFS TCP port 2049 is reachable

is reachable query the RPC service map from rpcbind (supports IPv6 fallback)

detect registered NFS, mountd, lockd/NLM and statd/NSM services

test NFS v2, v3 and v4 with RPC NULLPROC (including v4.1 and v4.2 hints)

... continue reading