NAME

       rds-info — display information from the RDS kernel module

SYNOPSIS

       rds-info [-v] [-cknrstIT]

DESCRIPTION

       The  rds-info utility presents various sources of information that the RDS kernel module maintains.  When
       run without any optional arguments rds-info 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:

       -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 incremented 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 rds-info itself uses an unbound socket to
               collect information.

               BoundAddr, BPort
                 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, CPort
                 The IP address and port that the socket is connected to.  0.0.0.0 0 indicates that  the  socket
                 has not been connected.

               SndBuf, RcvBuf
                 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 connection 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.

       -r, -s, -t
               Display the messages in the receive, send, or retransmit queues respectively.

               LocalAddr, LPort
                 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 destination address.

               RemoteAddr, RPort
                 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 settings such as the maximum number  of  send  and
               receive work requests will be displayed in addition.

       -T      Display the TCP sockets which the TCP transport is using to provide RDS connections.

               LocalAddr, LPort
                 The local IP address and port of this socket.

               RemoteAddr, RPort
                 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  connection.   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.

Debian                                          October 30, 2006                                     RDS-INFO(1)