# rpcctl

## 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 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



           The **rpcctl** command displays information collected in the SunRPC
           sysfs files about the system'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 provided, then only show information
                  about a single RPC client.
    
       **rpcctl switch** - **Commands operating on groups of transports**
           **add-xprt** _SWITCH_
                  Add an aditional transport to the _SWITCH_.  Note that the
                  new transport will take its values from the "main"
                  transport.
    
           **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).
    
           **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 removed.
    
           **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).
    
           **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 dstaddrhttps://linux-nfs.org**
                  Change the dstaddr of the xprt named "xprt-3" to point to
                  linux-nfs.org
    


## DIRECTORY



           **/sys/kernel/sunrpc/**
    


* * *