1IBCCCONFIG(8) OpenIB Diagnostics IBCCCONFIG(8)
2
6 IBCCCONFIG - configure congestion control settings
7
9 ibccconfig [common_options] [-c cckey] <op> <lid|guid> [port]
10
12 ibccconfig supports the configuration of congestion control settings on
13 switches and HCAs.
14 WARNING -- You should understand what you are doing before using this
16 tool. Misuse of this tool could result in a broken fabric.
17
19 Current supported operations and their parameters:
20 CongestionKeyInfo (CK) <lid|guid> <cckey> <cckeyprotectbit>
21 <cckeyleaseperiod> <cckeyviolations> SwitchCongestionSetting
22 (SS) <lid|guid> <controlmap> <victimmask> <creditmask> <thresh‐
23 old> <packetsize> <csthreshold> <csreturndelay> <markingrate>
24 SwitchPortCongestionSetting (SP) <lid|guid> <portnum> <valid>
25 <control_type> <threshold> <packet_size> <cong_parm_mark‐
26 ing_rate> CACongestionSetting (CS) <lid|guid> <port_control>
27 <control_map> <ccti_timer> <ccti_increase> <trigger_threshold>
28 <ccti_min> CongestionControlTable (CT) <lid|guid> <cctilimit>
29 <index> <cctentry> <cctentry> ...
30 --cckey, -c, <cckey> Specify a congestion control (CC) key. If none is
32 specified, a key of 0 is used.
33 Debugging flags
35 -d raise the IB debugging level. May be used several times (-ddd
36 or -d -d -d).
37 -e show send and receive errors (timeouts and others)
39 -h, --help show the usage message
41 -v, --verbose
43 increase the application verbosity level. May be used several
44 times (-vv or -v -v -v)
45 -V, --version show the version info.
47 Addressing Flags
49 -G, --Guid The address specified is a Port GUID
50 -L, --Lid The address specified is a LID
52 -s, --sm_port <smlid> use 'smlid' as the target lid for SA queries.
54 Port Selection flags
56 -C, --Ca <ca_name> use the specified ca_name.
57 -P, --Port <ca_port> use the specified ca_port.
59 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 1. the first port that is ACTIVE.
66 2. if not found, the first port that is UP (physical link up).
68 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 For example:
74 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 Configuration flags
81 -y, --m_key <key>
82 use the specified M_key for requests. If non-numeric value (like
83 'x') is specified then a value will be prompted for.
84 --config, -z <config_file> Specify alternate config file.
86 Default: /etc/infiniband-diags/ibdiag.conf
87
89 ibccconfig SwitchCongestionSetting 2 0x1F 0x1FFFFFFFFF 0x0 0xF 8 0 0:0 1 # Configure Switch Congestion Settings
90 ibccconfig CACongestionSetting 1 0 0x3 150 1 0 0 # Configure CA Congestion Settings to SL 0 and SL 1
91 ibccconfig CACongestionSetting 1 0 0x4 200 1 0 0 # Configure CA Congestion Settings to SL 2
92 ibccconfig CongestionControlTable 1 63 0 0:0 0:1 ... # Configure first block of Congestion Control Table
93 ibccconfig CongestionControlTable 1 127 0 0:64 0:65 ... # Configure second block of Congestion Control Table
94
96 CONFIG FILE
97 /etc/infiniband-diags/ibdiag.conf
98 A global config file is provided to set some of the common options for
100 all tools. See supplied config file for details.
101
103 Albert Chu
104 < chu11@llnl.gov >
105 IBCCCONFIG(8)