contrib/ofed/management/infiniband-diags/man/ibsysstat.8

   1 .TH IBSYSSTAT 8 "August 11, 2006" "OpenIB" "OpenIB Diagnostics"
   2
   3 .SH NAME
   4 ibsysstat \- system status on an InfiniBand address
   5
   6 .SH SYNOPSIS
   7 .B ibsysstat
   8 [\-d(ebug)] [\-e(rr_show)] [\-v(erbose)] [\-G(uid)] [\-C ca_name] [\-P ca_port] [\-s smlid] [\-t(imeout) timeout_ms] [\-V(ersion)] [\-o oui] [\-S(erver)] [\-h(elp)] <dest lid | guid> [<op>]
   9
  10 .SH DESCRIPTION
  11 .PP
  12 ibsysstat uses vendor mads to validate connectivity between IB nodes
  13 and obtain other information about the IB node. ibsysstat is run as
  14 client/server. Default is to run as client.
  15
  16 .SH OPTIONS
  17
  18 .PP
  19 .TP
  20 Current supported operations:
  21  ping \- verify connectivity to server (default)
  22  host \- obtain host information from server
  23  cpu  \- obtain cpu information from server
  24 .TP
  25 \fB\-o\fR, \fB\-\-oui\fR
  26 use specified OUI number to multiplex vendor mads
  27 .TP
  28 \fB\-S\fR, \fB\-\-Server\fR
  29 start in server mode (do not return)
  30
  31
  32 .SH COMMON OPTIONS
  33
  34 Most OpenIB diagnostics take the following common flags. The exact list of
  35 supported flags per utility can be found in the usage message and can be shown
  36 using the util_name -h syntax.
  37
  38 # Debugging flags
  39 .PP
  40 \-d      raise the IB debugging level.
  41         May be used several times (-ddd or -d -d -d).
  42 .PP
  43 \-e      show send and receive errors (timeouts and others)
  44 .PP
  45 \-h      show the usage message
  46 .PP
  47 \-v      increase the application verbosity level.
  48         May be used several times (-vv or -v -v -v)
  49 .PP
  50 \-V      show the version info.
  51
  52 # Addressing flags
  53 .PP
  54 \-G      use GUID address argument. In most cases, it is the Port GUID.
  55         Example:
  56         "0x08f1040023"
  57 .PP
  58 \-s <smlid>      use 'smlid' as the target lid for SM/SA queries.
  59
  60 # Other common flags:
  61 .PP
  62 \-C <ca_name>    use the specified ca_name.
  63 .PP
  64 \-P <ca_port>    use the specified ca_port.
  65 .PP
  66 \-t <timeout_ms> override the default timeout for the solicited mads.
  67
  68 Multiple CA/Multiple Port Support
  69
  70 When no IB device or port is specified, the port to use is selected
  71 by the following criteria:
  72 .PP
  73 1. the first port that is ACTIVE.
  74 .PP
  75 2. if not found, the first port that is UP (physical link up).
  76
  77 If a port and/or CA name is specified, the user request is
  78 attempted to be fulfilled, and will fail if it is not possible.
  79
  80 .SH AUTHOR
  81 .TP
  82 Hal Rosenstock
  83 .RI < halr@voltaire.com >