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

NAME

6       vendstat - query InfiniBand vendor specific functions
7

SYNOPSIS

9       vendstat [options] <lid|guid>
10

DESCRIPTION

12       vendstat  uses vendor specific MADs to access beyond the IB spec vendor
13       specific functionality. Currently, there is support for Mellanox Infin‐
14       iSwitch-III (IS3) and InfiniSwitch-IV (IS4).
15

OPTIONS

17       -N     show IS3 or IS4 general information.
18
19       -w     show IS3 port xmit wait counters.
20
21       -i     show IS4 counter group info.
22
23       -c <num,num>
24              configure IS4 counter groups.
25
26              Configure  IS4 counter groups 0 and 1. Such configuration is not
27              persistent across IS4 reboot.  First number is for counter group
28              0 and second is for counter group 1.
29
30              Group 0 counter config values:
31
32       ::
33                 0  -  PortXmitDataSL0-7  1  - PortXmitDataSL8-15 2 - PortRcv‐
34                 DataSL0-7
35
36              Group 1 counter config values:
37
38       ::     1  -  PortXmitDataSL8-15  2  -  PortRcvDataSL0-7  8  -  PortRcv‐
39              DataSL8-15
40
41       -R, --Read <addr,mask>
42              Read configuration space record at addr
43
44       -W, --Write <addr,val,mask>
45              Write configuration space record at addr
46
47   Addressing Flags
48       -G, --Guid     The address specified is a Port GUID
49
50       -L, --Lid   The address specified is a LID
51
52       -s, --sm_port <smlid>     use 'smlid' as the target lid for SA queries.
53
54   Port Selection flags
55       -C, --Ca <ca_name>    use the specified ca_name.
56
57       -P, --Port <ca_port>    use the specified ca_port.
58
59   Local port Selection
60       Multiple  port/Multiple CA support: when no IB device or port is speci‐
61       fied (see the "local umad parameters"  below),  the  libibumad  library
62       selects the port to use by the following criteria:
63
64          1. the first port that is ACTIVE.
65
66          2. if not found, the first port that is UP (physical link up).
67
68          If  a  port  and/or  CA  name  is  specified,  the libibumad library
69          attempts to fulfill the user request, and will fail  if  it  is  not
70          possible.
71
72          For example:
73
74              ibaddr                 # use the first port (criteria #1 above)
75              ibaddr -C mthca1       # pick the best port from "mthca1" only.
76              ibaddr -P 2            # use the second (active/up) port from the first available IB device.
77              ibaddr -C mthca0 -P 2  # use the specified port only.
78
79   Debugging flags
80       -d     raise  the  IB debugging level.  May be used several times (-ddd
81              or -d -d -d).
82
83       -e     show send and receive errors (timeouts and others)
84
85       -h, --help      show the usage message
86
87       -v, --verbose
88              increase the application verbosity level.  May be  used  several
89              times (-vv or -v -v -v)
90
91       -V, --version     show the version info.
92
93   Configuration flags
94       -t,  --timeout  <timeout_ms>  override  the  default  timeout  for  the
95       solicited mads.
96
97       --config, -z  <config_file> Specify alternate config file.
98          Default: /etc/infiniband-diags/ibdiag.conf
99

FILES

101   CONFIG FILE
102       /etc/infiniband-diags/ibdiag.conf
103
104       A global config file is provided to set some of the common options  for
105       all tools.  See supplied config file for details.
106

EXAMPLES

108       ::     vendstat  -N  6            # read IS3 or IS4 general information
109              vendstat -w 6           # read IS3 port xmit wait counters vend‐
110              stat  -i 6 12        # read IS4 port 12 counter group info vend‐
111              stat -c 0,1 6 12    # configure IS4 port 12 counter  groups  for
112              PortXmitDataSL  vendstat  -c 2,8 6 12    # configure IS4 port 12
113              counter groups for PortRcvDataSL
114

AUTHOR

116       Hal Rosenstock
117              < hal.rosenstock@gmail.com >
118
119
120
121
122                                                                   VENDSTAT(8)