man/man4/ib.4

         te
 Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 ib 4 "19 Feb 2004" "SunOS 5.11" "File Formats"
 NAME
ib - InfiniBand device driver configuration files
 DESCRIPTION

The InfiniBand (IB) bus is an I/O transport based on switched fabrics. IB
devices are managed by the ib(7D) nexus driver. There are three
categories of InfiniBand devices:


IB port/IB VPPA/IB HCA_SVC devices


IB IOC devices


IB Pseudo devices


The IB port/IB VPPA/IB HCA_SVC devices are enumerated by way of the
ib.conf file. See ib(7D).

The IB IOC devices are enumerated using the InfiniBand Device management class.
See ibdm(7D).

For devices not in these two categories, most notably IB Pseudo devices, the
driver must provide configuration files to inform the system of the IB devices
to be created. Configuration parameters are represented in the form of name
value pairs you can retrieve using the DDI property interfaces. See
ddi_prop_op(9F) for details.

Configuration files for IB device drivers must identify the parent driver
explicitly as ib, and must create a string array property called
unit-address which is unique to this entry in the configuration file.
Drivers name ibport and ioc are reserved by ib(7D) and should
not be used.

Each entry in the configuration file creates a prototype devinfo node.
Each node is assigned a unit address which is determined by the value of the
unit-address property. This property is only applicable to children of
the IB parent and is required. See driver.conf(4) for further details on
configuration file syntax.
 EXAMPLES

Example 1: Sample configuration file

Here is a configuration file called ibgen.conf for an IB device driver
that implements a generic IB driver. This file creates a node called
ibgen.
 #
 # Copyright 2002-2003 Sun Microsystems, Inc. All rights reserved.
 # Use is subject to license terms.
 #
 #ident "@(#)ibgen.conf 1.3 03/05/01 SMI"
 name="ibgen" parent="ib" unit-address="0";


 SEE ALSO

driver.conf(4), ib(7D), ibtl(7D), ddi_prop_op(9F)