rpcctl(8) System Manager's Manual rpcctl(8)

# [NAME](#NAME)

rpcctl - Displays SunRPC connection information

# [SYNOPSIS](#SYNOPSIS)

```
rpcctl [ -h | --help ] { client | switch | xprt }
```

```
rpcctl client [ -h | --help ] { show }
rpcctl client show [ -h  --help ] [ XPRT ]
```

```
rpcctl switch [ -h | --help ] { set | show }
rpcctl switch add-xprt [ -h | --help ] [ SWITCH ]
rpcctl switch set [ -h | --help ] SWITCH dstaddr NEWADDR
rpcctl switch show [ -h | --help ] [ SWITCH ]
```

```
rpcctl xprt [ -h | --help ] { remove | set | show }
rpcctl xprt remove [ -h | --help ] XPRT
rpcctl xprt set [ -h | --help ] XPRT { dstaddr NEWADDR | offline | online }
rpcctl xprt show [ -h | --help ] [ XPRT ]
```

# [DESCRIPTION](#DESCRIPTION)

The **rpcctl** command displays information collected in the SunRPC sysfs files about the system's SunRPC objects.

## [rpcctl client - **Commands** **operating** **on** **RPC** **clients**](#rpcctl_client_)

[**show** \[ *CLIENT* \] **(default)**](#show)

Show detailed information about the RPC clients on this system. If *CLIENT* was provided, then only show information about a single RPC client.

## [rpcctl switch - **Commands** **operating** **on** **groups** **of** **transports**](#rpcctl_switch_)

[**add-xprt SWITCH**](#add-xprt)

Add an additional transport to the *SWITCH*. Note that the new transport will take its values from the "main" transport.

[**set SWITCH dstaddr NEWADDR**](#set)

Change the destination address of all transports in the *SWITCH* to *NEWADDR*. *NEWADDR* can be an IP address, DNS name, or anything else resolvable by [**gethostbyname**(3)](/man/os/nfs-utils/gethostbyname.3).

[**show** \[ *SWITCH* \] **(default)**](#show~2)

Show detailed information about groups of transports on this system. If *SWITCH* was provided, then only show information about a single transport group.

## [rpcctl xprt - **Commands** **operating** **on** **individual** **transports**](#rpcctl_xprt_)

[**remove XPRT**](#remove)

Removes the specified *XPRT* from the system. Note that "main" transports cannot be removed.

[**set XPRT dstaddr NEWADDR**](#set~2)

Change the destination address of the specified *XPRT* to *NEWADDR*. *NEWADDR* can be an IP address, DNS name, or anything else resolvable by [**gethostbyname**(3)](/man/os/nfs-utils/gethostbyname.3).

[**set XPRT offline**](#set~3)

Sets the specified *XPRT*'s state to offline.

[**set XPRT online**](#set~4)

Sets the specified *XPRT*'s state to online.

[**show** \[ *XPRT* \] **(default)**](#show~3)

Show detailed information about this system's transports. If *XPRT* was provided, then only show information about a single transport.

# [EXAMPLES](#EXAMPLES)

[**rpcctl switch show switch-2**](#rpcctl)

Show details about the RPC switch named "switch-2".

[**rpcctl xprt remove xprt-4**](#rpcctl~2)

Remove the xprt named "xprt-4" from the system.

[**rpcctl xprt set xprt-3 dstaddr https://linux-nfs.org**](#rpcctl~3)

Change the dstaddr of the xprt named "xprt-3" to point to linux-nfs.org

# [DIRECTORY](#DIRECTORY)

**/sys/kernel/sunrpc/**

# [AUTHOR](#AUTHOR)

Anna Schumaker <Anna.Schumaker@Netapp.com>

15 Feb 2022

---

Document: rpcctl(8) from nfs-utils 3.1.1-r0 (Chainguard OS)
Source: git://git.linux-nfs.org/projects/steved/nfs-utils.git