2 Native STREAMS DLPI LAN Driver Migration
The dl_hp_create_info_t data structure that is used during registration of the driver with
HP-DLPI has been extended with the following new fields. These new fields must be set
appropriately before registering with HP-DLPI:
• dhc_features_one_cap
• dhc_features_two_cap
• dhc_features_three_cap
To accommodate the new fields in the dl_hp_create_info_t structure in HP-UX 11i v3, the
dhc_version data field must be set to 3; registration of version 2 drivers will fail.
The DL_HP_USAGE_INFO_REQ and DL_HP_USAGE_INFO_ACK primitives and data structures
associated with them have been modified in 11i v3. The 11i v3 method of implementing this
primitive is provided in the ENET sample driver. See the enet_dlpi_usage_info_req routine
in the ENET sample driver for detailed information on how to modify your driver for 11i v3 to
support this primitive.
NOTE: The DL_HP_USAGE_INFO_REQ and DL_HP_USAGE_INFO_ACK primitives are HP
extension to the DLPI standard. The definitions and structures associated with these primitives
are likely to undergo modifications in immediate future releases to HP-UX 11i v3. Use this
information in your network interface driver for HP-UX 11i v3.
New LAN Command
Starting with HP-UX 11i v3, the nwmgr command is a new LAN command, replacing the
lanadmin, lanscan, and linkloop commands, which have been obsoleted.
The nwmgr command supports driver-specific shared libraries. In addition, it comes with a
common services shared library that provides most of the services required by a driver specific
shared library. For information on how to develop a driver-specific shared library for your
networking driver, see the “LAN Commands” chapter in the HP-UX 11i v3 Driver Development
Guide.
A fully functional nwmgr driver-specific shared library for a Native STREAMS DLPI driver is
provided as part of the ENET sample driver under the misc/netmgr directory in the ENET
driver sources. HP recommends that you use this shared library as a starting point instead of
writing one from scratch.
New Graphical User Interface
Starting with HP-UX 11i v3, a new Graphical User Interface (GUI) has been introduced to discover
and configure network interface cards. It is part of the new HP System Management Homepage
(SMH) web-based GUI and replaces the legacy SAM GUI, which have been obsoleted in 11i v3.
The SMH NIC Tool supports driver-specific shared libraries to enable IHVs to provide
driver-specific extensions. For information on how to develop a driver-specific shared library
for your networking driver, see the “Supporting the HP SMH NIC Tool in LAN Drivers” chapter
in the HP-UX 11i v3 Driver Development Guide. In addition, a fully functional SMH NIC Tool
driver specific shared library for a Native STREAMS DLPI driver is provided as part of the ENET
sample driver under the misc/ncweb directory in the ENET driver sources. HP recommends
that you use this shared library as a starting point instead of writing one from scratch.
Options Negotiations
HP -DLPI provides a set of ioctls for the in-kernel STREAMS DLS user (for example, IP) to
negotiate with the driver and setup a fastpath. These ioctls are specific to HP-UX. Since they
New LAN Command 17