Man page generated from reStructuredText.
.
. RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .rstReportMargin post:
.. . RE indent \\n[an-margin]
old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1 new: \\n[rst2man-indent\\n[rst2man-indent-level]]
..
. -C, --Ca <ca_name> use the specified ca_name. Define the common option -P
. -P, --Port <ca_port> use the specified ca_port. Define the common option -t
. -t, --timeout <timeout_ms> override the default timeout for the solicited mads. Define the common option -y
. NDENT 0.0
.
.
.
IBHOSTS 8 "" "" "OpenIB Diagnostics"
NAME
IBHOSTS - show InfiniBand host nodes in topology
.
.nr rst2man-indent-level 0
.
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.rstReportMargin pre:. RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .rstReportMargin post:
.. . RE indent \\n[an-margin]
old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1 new: \\n[rst2man-indent\\n[rst2man-indent-level]]
..
SYNOPSIS
ibhosts [options] [<topology-file>]
DESCRIPTION
ibhosts is a script which either walks the IB subnet topology or uses an
already saved topology file and extracts the CA nodes.
OPTIONS
Define the common option -C. -C, --Ca <ca_name> use the specified ca_name. Define the common option -P
. -P, --Port <ca_port> use the specified ca_port. Define the common option -t
. -t, --timeout <timeout_ms> override the default timeout for the solicited mads. Define the common option -y
. NDENT 0.0
-y, --m_key <key> use the specified M_key for requests. If non-numeric value (like \(aqx\(aq)
is specified then a value will be prompted for.
NINDENT Define the common option -h
.
-h, --help show the usage message
Define the common option -z
.
--config, -z <config_file> Specify alternate config file.
NDENT 0.0 NDENT 3.5 Default: /etc/infiniband-diags/ibdiag.conf
NINDENT NINDENT Explanation of local port selection
.
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:
NDENT 0.0 NDENT 3.5 NDENT 0.0 1. 3
the first port that is ACTIVE.
2. 3
if not found, the first port that is UP (physical link up).
NINDENT 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.
For example:
NDENT 0.0 NDENT 3.5 ibaddr # use the first port (criteria #1 above) ibaddr -C mthca1 # pick the best port from "mthca1" only. ibaddr -P 2 # use the second (active/up) port from the first available IB device. ibaddr -C mthca0 -P 2 # use the specified port only.NINDENT NINDENT NINDENT NINDENT
FILES
Common text for the config file.
CONFIG FILE
/etc/infiniband-diags/ibdiag.conf
A global config file is provided to set some of the common options for all
tools. See supplied config file for details.
Common text to describe the node name map file..
NODE NAME MAP FILE FORMAT
The node name map is used to specify user friendly names for nodes in the
output. GUIDs are used to perform the lookup.
This functionality is provided by the opensm-libs package. See opensm(8)
for the file location for your installation.
Generically:
NDENT 0.0 NDENT 3.5 # comment <guid> "<name>"NINDENT NINDENT Example: NDENT 0.0 NDENT 3.5
# IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D"NINDENT NINDENT
SEE ALSO
ibnetdiscover(8)
DEPENDENCIES
ibnetdiscover, ibnetdiscover format
AUTHOR
NDENT 0.0
Hal Rosenstock < \%halr@voltaire.com >
NINDENT Generated by docutils manpage writer.
.