rds-info
(1)
Name
rds-info - display information from the RDS kernel module
Synopsis
rds-info [-cknrstIT]
Description
User Commands RDS-INFO(1)
NAME
rds-info - display information from the RDS kernel module
SYNOPSIS
rds-info [-cknrstIT]
DESCRIPTION
The utility presents various sources of information that the
RDS kernel module maintains. When run without any optional
arguments will output all the information it knows of. When
options are specified then only the information associated
with those options is displayed.
The options are as follows:
OPTIONS
-v Requests verbose output. When this option is given,
some classes of information will display additional
data.
-c Display global counters. Each counter increments as
its event occurs. The counters may not be reset.
The set of supported counters may change over time.
CounterName
The name of the counter. These names come from the
kernel and can change depending on the capability of
the kernel module.
Value
The number of times that the counter has been incre-
mented since the kernel module was loaded.
-k Display all the RDS sockets in the system. There
will always be one socket listed that is neither
bound to nor connected to any addresses because
itself uses an unbound socket to collect information.
BoundAddr,
The IP address and port that the socket is bound to.
0.0.0.0 0 indicates that the socket has not been
bound.
ConnAddr,
The IP address and port that the socket is connected
to. 0.0.0.0 0 indicates that the socket has not been
connected.
SunOS 5.11 Last change: October 30, 2006 1
User Commands RDS-INFO(1)
SndBuf,
The number of bytes of message payload which can be
queued for sending or receiving on the socket,
respectively.
Inode
The number of the inode object associated with the
socket. Can be used to locate the process owning a
given socket by searching /proc/*/fd for open files
referencing a socket with this inode number.
-n Display all RDS connections. RDS connections are
maintained between nodes by transports.
LocalAddr
The IP address of this node. For connections that
originate and terminate on the same node the local
address indicates which address initiated the connec-
tion establishment.
RemoteAddr
The IP address of the remote end of the connection.
NextTX
The sequence number that will be given to the next
message that is sent over the connection.
NextRX
The sequence number that is expected from the next
message to arrive over the connection. Any incoming
messages with sequence numbers less than this will be
dropped.
Flg
Flags which indicate the state of the connection.
s
A process is currently sending a message down
the connection.
c
The transport is attempting to connect to the
remote address.
C
The connection to the remote host is connected
and active.
SunOS 5.11 Last change: October 30, 2006 2
User Commands RDS-INFO(1)
-r, -s, -t
Display the messages in the receive, send, or
retransmit queues respectively.
LocalAddr,
The local IP address and port on this node associated
with the message. For sent messages this is the
source address, for receive messages it is the desti-
nation address.
RemoteAddr,
The remote IP address and port associated with the
message. For sent messages this is the destination
address, for receive messages it is the source
address.
Seq
The sequence number of the message.
Bytes
The number of bytes in the message payload.
The following information sources are dependent on specific
transports which may not always be available.
-I Display the IB connections which the IB transport is
using to provide RDS connections.
LocalAddr
The local IP address of this connection.
RemoteAddr
The remote IP address of this connection.
LocalDev
The local IB Global Identifier, printed in IPv6
address syntax.
RemoteDev
The remote IB Global Identifier, printed in IPv6
address syntax.
If verbose output is requested, per-connection set-
tings such as the maximum number of send and receive
work requests will be displayed in addition.
SunOS 5.11 Last change: October 30, 2006 3
User Commands RDS-INFO(1)
-T Display the TCP sockets which the TCP transport is
using to provide RDS connections.
LocalAddr,
The local IP address and port of this socket.
RemoteAddr,
The remote IP address and port that this socket is
connected to.
HdrRemain
The number of bytes that must be read off the socket
to complete the next full RDS header.
DataRemain
The number of bytes that must be read off the socket
to complete the data payload of the message which is
being received.
SentNxt
The TCP sequence number of the first byte of the last
message that we sent down the connection.
ExpectedUna
The TCP sequence number of the byte past the last
byte of the last message that we sent down the con-
nection. When we see that the remote side has acked
up to this byte then we know that the remote side has
received all our RDS messages.
SeenUna
The TCP sequence number of the byte past the last
byte which has been acked by the remote host.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+----------------------+
|Availability | network/open-fabrics |
+---------------+----------------------+
|Stability | Volatile |
+---------------+----------------------+
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
SunOS 5.11 Last change: October 30, 2006 4
User Commands RDS-INFO(1)
['http://www.openfabrics.org/downloads/ibutils/ibu-
tils-1.5.7.tar.gz', 'http://www.openfabrics.org/down-
loads/libibverbs/libibverbs-1.1.4-1.22.g7257cd3.tar.gz',
'http://www.openfabrics.org/down-
loads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz',
'http://www.openfabrics.org/downloads/libsdp/lib-
sdp-1.1.108-0.15.gd7fdb72.tar.gz', 'http://www.openfab-
rics.org/downloads/management/infiniband-
diags-1.5.8.tar.gz', 'http://www.openfabrics.org/down-
loads/management/libibmad-1.3.7.tar.gz', 'http://www.open-
fabrics.org/downloads/management/libibumad-1.3.7.tar.gz',
'http://www.openfabrics.org/downloads/manage-
ment/opensm-3.3.9.tar.gz', 'http://www.openfabrics.org/down-
loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz',
'http://www.openfabrics.org/down-
loads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz',
'http://www.openfabrics.org/downloads/rdmacm/librd-
macm-1.0.14.1.tar.gz', 'http://www.openfabrics.org/down-
loads/rds-tools/rds-tools-2.0.4.tar.gz']
Further information about this software can be found on the
open source community website at http://www.openfab-
rics.org/.
SunOS 5.11 Last change: October 30, 2006 5