Blame doc/rst/common/sec_portselection.rst

Packit db064d
.. Explanation of local port selection
Packit db064d
Packit db064d
Local port Selection
Packit db064d
--------------------
Packit db064d
Packit db064d
Multiple port/Multiple CA support: when no IB device or port is specified
Packit db064d
(see the "local umad parameters" below), the libibumad library
Packit db064d
selects the port to use by the following criteria:
Packit db064d
Packit db064d
	1. the first port that is ACTIVE.
Packit db064d
	2. if not found, the first port that is UP (physical link up).
Packit db064d
Packit db064d
	If a port and/or CA name is specified, the libibumad library attempts
Packit db064d
	to fulfill the user request, and will fail if it is not possible.
Packit db064d
Packit db064d
	For example:
Packit db064d
Packit db064d
        ::
Packit db064d
Packit db064d
	    ibaddr                 # use the first port (criteria #1 above)
Packit db064d
	    ibaddr -C mthca1       # pick the best port from "mthca1" only.
Packit db064d
	    ibaddr -P 2            # use the second (active/up) port from the first available IB device.
Packit db064d
	    ibaddr -C mthca0 -P 2  # use the specified port only.
Packit db064d