# rpcctl - Displays SunRPC connection information - man(8) - [phpMan]

[_rpcctl_(8)](https://www.chedong.com/phpMan.php/man/rpcctl/8/markdown)                              System Manager's Manual                             [_rpcctl_(8)](https://www.chedong.com/phpMan.php/man/rpcctl/8/markdown)

## NAME
       rpcctl - Displays SunRPC connection information

## 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 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
       The  **rpcctl  **command  displays information collected in the SunRPC sysfs files about the sys‐
       tem's SunRPC objects.

   **rpcctl client **- **Commands operating on RPC clients**
       **show **[ _CLIENT_ ] **(default)**
              Show detailed information about the RPC clients on this system.  If  _CLIENT_  was  pro‐
              vided, then only show information about a single RPC client.

   **rpcctl switch **- **Commands operating on groups of transports**
       **set _**SWITCH_ **dstaddr _**NEWADDR_
              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)](https://www.chedong.com/phpMan.php/man/gethostbyname/3/markdown).

       **show **[ _SWITCH_ ] **(default)**
              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**
       **remove _**XPRT_
              Removes the specified _XPRT_ from the system.  Note that "main" transports cannot be re‐
              moved.

       **set _**XPRT_ **dstaddr _**NEWADDR_
              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)](https://www.chedong.com/phpMan.php/man/gethostbyname/3/markdown).

       **set _**XPRT_ **offline**
              Sets the specified _XPRT_'s state to offline.

       **set _**XPRT_ **online**
              Sets the specified _XPRT_'s state to online.

       **show **[ _XPRT_ ] **(default)**
              Show detailed information about this system's transports.  If _XPRT_ was provided,  then
              only show information about a single transport.

## EXAMPLES
### rpcctl switch show switch-2
              Show details about the RPC switch named "switch-2".

### rpcctl xprt remove xprt-4
              Remove the xprt named "xprt-4" from the system.

### rpcctl xprt set xprt-3 dstaddr <https://linux-nfs.org>
              Change the dstaddr of the xprt named "xprt-3" to point to linux-nfs.org

## DIRECTORY
### /sys/kernel/sunrpc/

## AUTHOR
       Anna Schumaker <<Anna.Schumaker@Netapp.com>>

                                             15 Feb 2022                                   [_rpcctl_(8)](https://www.chedong.com/phpMan.php/man/rpcctl/8/markdown)