{
    "mode": "man",
    "parameter": "rpcctl",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/rpcctl/8/json",
    "generated": "2026-10-04T18:34:25Z",
    "synopsis": "rpcctl [ -h | --help ] { client | switch | xprt }\nrpcctl client [ -h | --help ] { show }\nrpcctl client show [ -h  --help ] [ XPRT ]\nrpcctl switch [ -h | --help ] { set | show }\nrpcctl switch set [ -h | --help ] SWITCH dstaddr NEWADDR\nrpcctl switch show [ -h | --help ] [ SWITCH ]\nrpcctl xprt [ -h | --help ] { remove | set | show }\nrpcctl xprt remove [ -h | --help ] XPRT\nrpcctl xprt set [ -h | --help ] XPRT { dstaddr NEWADDR | offline | online }\nrpcctl xprt show [ -h | --help ] [ XPRT ]",
    "sections": {
        "NAME": {
            "content": "rpcctl - Displays SunRPC connection information\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "rpcctl [ -h | --help ] { client | switch | xprt }\n\nrpcctl client [ -h | --help ] { show }\nrpcctl client show [ -h  --help ] [ XPRT ]\n\nrpcctl switch [ -h | --help ] { set | show }\nrpcctl switch set [ -h | --help ] SWITCH dstaddr NEWADDR\nrpcctl switch show [ -h | --help ] [ SWITCH ]\n\nrpcctl xprt [ -h | --help ] { remove | set | show }\nrpcctl xprt remove [ -h | --help ] XPRT\nrpcctl xprt set [ -h | --help ] XPRT { dstaddr NEWADDR | offline | online }\nrpcctl xprt show [ -h | --help ] [ XPRT ]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The  rpcctl  command  displays information collected in the SunRPC sysfs files about the sys‐\ntem's SunRPC objects.\n\nrpcctl client - Commands operating on RPC clients\nshow [ CLIENT ] (default)\nShow detailed information about the RPC clients on this system.  If  CLIENT  was  pro‐\nvided, then only show information about a single RPC client.\n\nrpcctl switch - Commands operating on groups of transports\nset SWITCH dstaddr NEWADDR\nChange  the  destination  address of all transports in the SWITCH to NEWADDR.  NEWADDR\ncan be an IP address, DNS name, or anything else resolvable by gethostbyname(3).\n\nshow [ SWITCH ] (default)\nShow detailed information about groups of transports on this system.   If  SWITCH  was\nprovided, then only show information about a single transport group.\n\nrpcctl xprt - Commands operating on individual transports\nremove XPRT\nRemoves the specified XPRT from the system.  Note that \"main\" transports cannot be re‐\nmoved.\n\nset XPRT dstaddr NEWADDR\nChange  the  destination address of the specified XPRT  to NEWADDR.  NEWADDR can be an\nIP address, DNS name, or anything else resolvable by gethostbyname(3).\n\nset XPRT offline\nSets the specified XPRT's state to offline.\n\nset XPRT online\nSets the specified XPRT's state to online.\n\nshow [ XPRT ] (default)\nShow detailed information about this system's transports.  If XPRT was provided,  then\nonly show information about a single transport.\n",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "",
            "subsections": [
                {
                    "name": "rpcctl switch show switch-2",
                    "content": "Show details about the RPC switch named \"switch-2\".\n"
                },
                {
                    "name": "rpcctl xprt remove xprt-4",
                    "content": "Remove the xprt named \"xprt-4\" from the system.\n"
                },
                {
                    "name": "rpcctl xprt set xprt-3 dstaddr https://linux-nfs.org",
                    "content": "Change the dstaddr of the xprt named \"xprt-3\" to point to linux-nfs.org\n"
                }
            ]
        },
        "DIRECTORY": {
            "content": "",
            "subsections": [
                {
                    "name": "/sys/kernel/sunrpc/",
                    "content": ""
                }
            ]
        },
        "AUTHOR": {
            "content": "Anna Schumaker <Anna.Schumaker@Netapp.com>\n\n15 Feb 2022                                   rpcctl(8)",
            "subsections": []
        }
    },
    "summary": "rpcctl - Displays SunRPC connection information",
    "flags": [],
    "examples": [
        "Show details about the RPC switch named \"switch-2\".",
        "Remove the xprt named \"xprt-4\" from the system.",
        "Change the dstaddr of the xprt named \"xprt-3\" to point to linux-nfs.org"
    ],
    "see_also": []
}