Devices ib(7D)
NAME
ib - InfiniBand Bus Nexus Driver
DESCRIPTION
The ib (IB nexus) driver is a pseudo nexus driver that sup-
ports enumeration of port devices, VPA (Virtual Physical
Point Attachment), HCASVC (HCA Service) devices, and I/O
controllers (IOC) on the InfiniBand fabric that are visible
to the host and provides interfaces to cfgadmib(1M) to
manage hot-plugging of IB devices. The ib nexus driver
enumerates the port device, VPA devices and HCASVC devices
based on entries specified in the ib.conf file. IOC devices
are enumerated on demand. The IB nexus driver uses Infini-
Band Device Manager services (ibdm(7D)) to enumerate port
devices, VPA devices, HCASVC devices, and IOCs on the IB
fabric.
CONFIGURATION
You configure the ib driver by defining properties in the
ib.conf file. The IB nexus driver supports the following
properties:
PROPERTY NAME DEFAULT POSIBLE VALUES
port-svc-list "" List of service names, for example: srv
vppa-svc-list "" List of service names, for example: ipib
hca-svc-list "" List of service names, for example: hcanfs
The port-svc-list property defines the list of port communi-
cation service names per port. The IB nexus driver creates a
device instance for each entry in this property per Host
Channel Adapter (HCA) port. The ib.conf file contains a
port-svc-list="" entry by default. You update port-svc-list
with service names you want to add to the system.
The vppa-svc-list property defines the list of VPA communi-
cation service names per port per partition key. The IB
nexus driver creates a device instance for each entry in
this property per Host Channel Adapter (HCA) port. The
ib.conf file contains a vppa-svc-list="" entry by default.
You update vppa-svc-list with service names you want to add
to the system.
SunOS 5.11 Last change: 26 Jan 2009 1
Devices ib(7D)
The hca-svc-list property defines the list of HCASVC com-
munication service names per HCA. The IB nexus driver
creates a device instance for each entry in this property
per Host Channel Adapter (HCA). The ib.conf file contains a
hca-svc-list="" entry by default. You update hca-svc-list
with service names you want to add to the system.
The service name specified in port-svc-list, vppa-svc-list
and hca-svc-list must be unique, be a maximum of four char-
acters long, and is limited to digits 0-9 and letters a-z
and A-Z.
IOC drivers (which are parented by the IB nexus driver) may
themselves have .conf files. To distinguish those cases from
pseudo drivers parented by IB nexus, such drivers should
include the "ib-node-type" property with value merge in the
IOC driver.conf file. That property ensures that properties
from the .conf file are merged with other properties found
through hardware probing.
EXAMPLES
Example 1: A sample ib.conf file with one service name
entry for PORT communication services.
#
# Copyright 2001-2003 Sun Microsystems, Inc. All rights reserved.
# Use is subject to license terms.
#
port-svc-list=""
vppa-svc-list="";
hca-svc-list="";
In Example 1, the IB nexus driver does not create any
port/vppa/hcasvc device instances.
Example 2: A sample ib.conf file with one entry for "srv"
service:
port-svc-list="srv"
vppa-svc-list="";
hca-svc-list="";
The IB nexus driver creates one srv service instance for
every HCA port that exists on the host. For example, if
SunOS 5.11 Last change: 26 Jan 2009 2
Devices ib(7D)
there are two HCAs, each with two ports on the host, the IB
nexus driver creates four instances of the srv service.
Example 3: A sample ib.conf file with one service name
entry for each of Port and VPA communication services:
port-svc-list="srv"
vppa-svc-list="ipib";
hca-svc-list="";
If there are two HCAs in the system with two ports each and
each port has two valid PKEY values, the IB nexus driver
creates four instances of srv service (one for each port).
It also creates eight instances of ipd service (one per each
port/PKEY combination).
Example 4: A sample ib.conf file with one service name entry
for each of Port, VPA and HCASVC communication ser-
vices:
port-svc-list="srv";
vppa-svc-list="ipib";
hca-svc-list="hcanfs";
The IB nexus driver creates one instance of hcanfs service
for each HCA in the system.
Example 5: IOC driver .conf
ib-node-type="merge";
enable-special-mode="on";
FILES
/kernel/drv/ib 32-bit x86 ELF kernel module
/kernel/drv/amd64/ib 64-bit x86 ELF kernel module
/kernel/drv/sparcv9/ib 64-bit SPARC ELF kernel module
SunOS 5.11 Last change: 26 Jan 2009 3
Devices ib(7D)
/kernel/drv/ib.conf driver configuration file
ATRIBUTES
See attributes(5) for a description of the following attri-
bute:
ATRIBUTE TYPE ATRIBUTE VALUE
Architecture SPARC, x86
Availability SUNWhea, SUNWib
Interface Stability Consolidation Private
SEE ALSO
cfgadmib(1M), driver.conf(4), ib(4), attributes(5),
ibcm(7D), ibdm(7D), ibtl(7D)
Writing Device Drivers
InfiniBand Architecture Specification, Volume 1: Release 1.1
System Administration Guide: Basic Administration
DIAGNOSTICS
In addition to being logged, the following messages may
appear on the system console. All messages are formatted in
the following manner:
ib: WARNING: Error message...
unit-address property in %s.conf not well-formed.
The driver.conf file does not have a valid "unit-addr"
property defined. This property is an array of strings.
cannot find unit-address in %s.conf.
The driver.conf file does not have a valid "unit-addr"
property defined. This property is an array of strings.
SunOS 5.11 Last change: 26 Jan 2009 4
Devices ib(7D)
Waiting for Port %d initialization.
Waiting for port initialization from subnet manager.
SunOS 5.11 Last change: 26 Jan 2009 5
|
