1VENDSTAT(8)                   Open IB Diagnostics                  VENDSTAT(8)
2
3
4

NAME

6       VENDSTAT -
7

QUERY INFINIBAND VENDOR SPECIFIC FUNCTIONS

9   SYNOPSIS
10       vendstat [options] <lid|guid>
11
12   DESCRIPTION
13       vendstat  uses vendor specific MADs to access beyond the IB spec vendor
14       specific functionality. Currently, there is support for Mellanox Infin‐
15       iSwitch-III (IS3) and InfiniSwitch-IV (IS4).
16
17   OPTIONS
18       -N     show IS3 or IS4 general information.
19
20       -w     show IS3 port xmit wait counters.
21
22       -i     show IS4 counter group info.
23
24       -c <num,num>
25              configure IS4 counter groups.
26
27              Configure  IS4 counter groups 0 and 1. Such configuration is not
28              persistent across IS4 reboot.  First number is for counter group
29              0 and second is for counter group 1.
30
31              Group 0 counter config values:
32
33       ::
34                 0  -  PortXmitDataSL0-7  1  - PortXmitDataSL8-15 2 - PortRcv‐
35                 DataSL0-7
36
37              Group 1 counter config values:
38
39       ::     1  -  PortXmitDataSL8-15  2  -  PortRcvDataSL0-7  8  -  PortRcv‐
40              DataSL8-15
41
42       -R, --Read <addr,mask>
43              Read configuration space record at addr
44
45       -W, --Write <addr,val,mask>
46              Write configuration space record at addr
47
48   Addressing Flags
49       -G, --Guid     The address specified is a Port GUID
50
51       -L, --Lid   The address specified is a LID
52
53       -s, --sm_port <smlid>     use 'smlid' as the target lid for SA queries.
54
55   Port Selection flags
56       -C, --Ca <ca_name>    use the specified ca_name.
57
58       -P, --Port <ca_port>    use the specified ca_port.
59
60   Local port Selection
61       Multiple  port/Multiple CA support: when no IB device or port is speci‐
62       fied (see the "local umad parameters"  below),  the  libibumad  library
63       selects the port to use by the following criteria:
64
65          1. the first port that is ACTIVE.
66
67          2. if not found, the first port that is UP (physical link up).
68
69          If  a  port  and/or  CA  name  is  specified,  the libibumad library
70          attempts to fulfill the user request, and will fail  if  it  is  not
71          possible.
72
73          For example:
74
75              ibaddr                 # use the first port (criteria #1 above)
76              ibaddr -C mthca1       # pick the best port from "mthca1" only.
77              ibaddr -P 2            # use the second (active/up) port from the first available IB device.
78              ibaddr -C mthca0 -P 2  # use the specified port only.
79
80   Debugging flags
81       -d     raise  the  IB debugging level.  May be used several times (-ddd
82              or -d -d -d).
83
84       -e     show send and receive errors (timeouts and others)
85
86       -h, --help      show the usage message
87
88       -v, --verbose
89              increase the application verbosity level.  May be  used  several
90              times (-vv or -v -v -v)
91
92       -V, --version     show the version info.
93
94   Configuration flags
95       -t,  --timeout  <timeout_ms>  override  the  default  timeout  for  the
96       solicited mads.
97
98       --config, -z  <config_file> Specify alternate config file.
99          Default: /etc/infiniband-diags/ibdiag.conf
100
101   FILES
102   CONFIG FILE
103       /etc/infiniband-diags/ibdiag.conf
104
105       A global config file is provided to set some of the common options  for
106       all tools.  See supplied config file for details.
107
108   EXAMPLES
109       ::     vendstat  -N  6            # read IS3 or IS4 general information
110              vendstat -w 6           # read IS3 port xmit wait counters vend‐
111              stat  -i 6 12        # read IS4 port 12 counter group info vend‐
112              stat -c 0,1 6 12    # configure IS4 port 12 counter  groups  for
113              PortXmitDataSL  vendstat  -c 2,8 6 12    # configure IS4 port 12
114              counter groups for PortRcvDataSL
115
116   AUTHOR
117       Hal Rosenstock
118              < hal.rosenstock@gmail.com >
119
120
121
122
123                                                                   VENDSTAT(8)