User Manual

InfiniBand Fabric UtilitiesRev 2.2-1.0.1
Mellanox Technologies
240
9.4.14 ibportstate
Enables querying the logical (link) and physical port states of an InfiniBand port. It also allows
adjusting the link speed that is enabled on any InfiniBand port.
If the queried port is a switch port, then ibportstate can be used to
• disable, enable or reset the port
• validate the port’s link width and speed against the peer port
Synopsis
ibportstate [options] <dest dr_path|lid|guid> <portnum> [<op>]
Output Files
-L, --Lid The address specified is a LID
-G, --Guid The address specified is a Port GUID
-D, --Direct The address specified is a directed route
-s, --sm_port <smlid> Use 'smlid' as the target lid for SA queries.
-C, --Ca <ca_name> use the specified ca_name.
-P, --Port <ca_port> Use the specified ca_port:
Local port Selection
Multiple port/Multiple CA support: when no IB device or port
is specified (see the "local umad parameters" below), the
libibumad library selects the port to use by the following
criteria:
1. the first port that is ACTIVE.
2. if not found, the first port that is UP (physical link
up).
If a port and/or CA name is specified, the libibumad library
attempts to fulfill the user request, and will fail if it is
not possible.
--config, -z <config_file> Specify alternate config file. Default: /etc/infiniband-
diags/ibdiag.conf
-t, --timeout <timeout_ms> override the default timeout for the solicited mads.
-y, --m_key <key> Use the specified M_key for requests. If non-numeric value
(like 'x') is specified then a value will be prompted for.
-h, --help show the usage message
-d Raise the IB debugging level. May be used several times (-
ddd or -d -d -d).
-e Show send and receive errors (timeouts and others)
-K, --show_keys Show security keys (mkey, smkey, etc.) associated with the
request.
-v, --verbose Increase the application verbosity level. May be used sev-
eral times (-vv or -v -v -v)
-V, --version Show the version info.