HP Webcam 5991-7955 User's Manual
Contents
1. 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 anew 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 with2. the driver and setup a fastpath These ioctls are specific to HP UX Since they New LAN Command 17 were introduced in HP UX 11 00 the semantics of the ioctls has not changed However the information provided to the DLS user has changed The interface was originally intended for IP only but it is DLS user independent in HP UX 11i v3 A NOTE Information on how options negotiations are done between a transport layer entity and HP DLPI is described in the Understanding OOP and Transport IOCTLs chapter in the HP UX 11i v3 Driver Development Guide A native driver will act like HP DLPI when it conducts option negotiation with a transport layer entity 18 Native STREAMS DLPI LAN Driver Migration 3 Non Native HP DLPI LAN Driver Migration A non native Networking driver relies on the HP DLPI layer to interface with the transport layer A driver has to conform to the DLPI driver interface specifications Descriptions of how to write a non native driver are provided in the Writing a LAN Driver Under HP DLPI chapter in the HP UX 111 v3 Driver Development Guide For information on the HP DLPI interfaces see the HP DLPI manpages in the HP UX 111 v3 Driver Development Reference 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 e dhc features one cap e dhc f
3. 11i Releases About This Document A This manual lists and describes the changes between HP UX 11i v2 and 11i v3 that affect a network driver migration It also provides information on how to migrate your network driver from HP UX 11i v2 to 11i v3 The document printing date and part number indicate the document s current edition The printing date will change when a new edition is printed Minor changes may be made at reprint without changing the printing date The document part number will change when extensive changes are made Document updates may be issued between editions to correct errors or document product changes To ensure that you receive the updated or new editions you should subscribe to the appropriate product support service See your HP sales representative for details The latest version of this document can be found on line at http www hp com go hpux ddk NOTE This book contains many examples of C programs to help design device drivers Because of page width restrictions some long lines of code exceed the space available and break in unintended places Treat these broken lines as one line We recommend that you use the sample files included with this manual when possible rather than retyping the examples Intended Audience This document is intended for system administrators or developers responsible for porting or writing drivers Developers are expected to e Have experience writing programs
4. HP Integrity Computer Systems HP UX 111 v2 to 11i v3 Network Driver Migration Guide ber 5991 7955 Invent O Copyright 2003 2007 Hewlett Packard Co All rights reserved Legal Notices This document contains information which is protected by copyright All rights are reserved Reproduction adaption or translation without prior written permission is prohibited except as allowed under the copyright laws Restricted Rights Legend Use duplication or disclosure by the U S Government Department of Defense is subject to restrictions as set forth in paragraph b 3 ii of the Rights in Technical Data and Software clause in FAR 52 227 703 Copyright O 1988 The Santa Cruz Operation Copyright O 1979 1980 1983 1986 1993 The Regents of the University of California Copyright O 1980 1984 AT amp T Inc Copyright O 1986 1992 Sun Microsystems Inc Copyright O 1980 1984 1986 Novell Inc This software and documentation is based in part on the Fourth Berkeley Software Distribution under license from the Regents of the University of California Warranty A copy of the specific warranty terms applicable to your Hewlett Packard product and replacement parts can be obtained from your local Sales and Service Office Hewlett Packard makes no warranty of any kind with regard to this manual including but not limited to the implied warranties of merchantability and fitness for a particular purpose Hewlett Packard shall not be li
5. able for errors contained herein or direct indirect special incidental or consequential damages in connection with the furnishing performance or use of this material Printing History New editions of this manual will incorporate all material updated since the previous edition The manual printing date and part number indicate its current edition The printing date changes when a new edition is printed Minor corrections that are incorporated at a reprinting do not cause the date to change The manual part number changes when extensive technical changes are incorporated Edition Part Number Date First 5187 4493 September 2003 Table of Contents About This DO UM ici 9 WO laa ia 13 LAN Driver Architect ib as 13 HP DEPIL LAN Driver Ar a an 13 Native STREAMS DLPI LAN Driver Architecture coocccnncononocnnnocnnnacinonoconorononocinnnrcnnarinonaccnncinonoss 14 2 Native STREAMS DUPI LAN Driver Migration eesesessnenesessnnnnnenenenenennn 17 New LAN Command 2 sc eet oe Oa e en E A 17 New Graphical User Inte ace ices ti Ba Elche 17 Opt ns Nes on HON se 17 3 Non Native HP DLPI LAN Driver Migration esesseenenenenensnenenenenenenenenenenener 19 NENA NE o AA A AN a ahs 19 New Graphical User Interface ae A E AI EA AA AAA A A 19 Table of Contents 3 List of Figures 1 1 1 2 HP DLPI LAN Driver Architecture Native LAN Driver Architecture List of Tables 1 2 Publishing History Details HP UX
6. ardware is not at fault and HP software firmware is not at fault by removing user written kernel drivers When HP hardware software and firmware are not at fault you should seek help from the third party from whom you obtained software or hardware 11 12 1 Overview The HP UX 111 v2 to 11i v3 Network Driver Migration Guide provides 3rd party developers a resource to understand the HP UX network stack architecture and network API changes between HP UX 11i v2 and 11i v3 and an overview for migrating network drivers from HP UX 11i v2 to 11i v3 This document describes how to migrate HP DLPI based LAN drivers and native STREAMS DLPI based LAN drivers HP strongly encourages developers to write HP DLPI based LAN drivers instead of native STREAMSDLPIbased LAN drivers because of the many advantages of the HP DLPIbased LAN drivers model The developers save time by using the HP DLPI implemention they do not have to write one of their own This results in a better time to market for their product and reduced maintance costs LAN Driver Architecture HP UX 11i v3 exports HP DLPI interfaces for network drivers A driver written to the HP DLPI interface is called a non native HP DLPI driver also referred to as a tightly coupled driver A driver that includes its own implementation of the data link layer written to DLPI standards is called a native STREAMS DLPI driver also referred to as a loosely coupled driver HP DLPI LAN Driv
7. as the central repository of all networking interfaces installed on the system The native STREAMS DLPI driver has its own DLPI implements e Inform HP DLPI every time its hardware state changes 14 Overview e Inform HP DLPI each time the MAC address changes This is required for LAN commands to display the current MAC address e Support specific ioctls standard DLPI primitives and specific HP extensions of DLPI primitives This ensures the driver will work with standard HP UX LAN commands and SMH For information on writing a Native driver see the HP UX 11i v3 Driver Development Guide Key native to native driver migration issues are noted in the next section of this document Figure 1 2 shows the native driver architecture Figure 1 2 Native LAN Driver Architecture Upper layers of the HP UX Network Interface Architecture DLPI 2 0 API with HP Extensions via STREAMS Interfaces Loosely Coupled Driver STREAMS Services STREAMS driver with native DLPI HP UX HP DLPI Implementation Kernel to Services Driver Interface Data Link Layer WSIO Network Interface Driver for any MAC type NetTL Services WSIO Services LAN Driver Architecture 15 16 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
8. be set appropriately before registering with HP DLPI e dhc features one cap e dhc features two cap e 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 reqroutine in the ENET sample driver for detailed information on how to modify your driver for 11i v3 to support this primitive A NOTE TheDL HP USAGE INFO REQand 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 anew LAN command replacing the lanadmin lanscan and 1inkloop 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
9. ding documentation that meets your needs Please send comments to feedback cup hp com Please include document title manufacturing part number and any comment error found or suggestion for improvement you have concerning this document Also please include what we did right so we can incorporate it into other documents 10 About This Document Email amp Internet Resources Interface program and developer resource materials are available at the following locations Interface Program E mail at interface fc hp com Developer Resource at http devresource hp com Support and Compatibility Disclaimers Because drivers function at the level of the kernel HP reminds you of the following Adding your own driver to HP UX requires relinking the driver into HP UX With each new release you should plan on recompiling your driver in order to reinstall it into the new HP UX kernel Many header files do not change However drivers typically use some header files that could change across releases you might have some system dependencies HP provides support services for HP products including HP UX Products including drivers from non HP parties receive no support other than the support of those parts of a driver that rely on the documented behavior of supported HP products If difficulties arise during the development and test phases of writing a driver HP may provide assistance in isolating problems to determine if HP h
10. eatures two cap e dhe features three cap The dhc_ version data field must be set to 3 in 11i v3 Starting with 11i v3 registration of version 2 drivers will fail Starting with HP UX 11i v3 non native DLPI LAN drivers can set the following new features bits in the dhc_features_one field if the relevant functionality is supported in the driver e DL HP DRV_USAGE_ INFO DL HP DRV SUPP CRA The HP DLPI event entry point now supports a new event DL_HP_EVENT_OLD Drivers that support online deletion can now use this event to ensure that all outbound data path and control requests from DLPI to the driver are quiesced prior to the deletion of a driver instance Non native HP DLPI based drivers must ensure that the cause information that is passed on DL_HP_EVENT_LINK_DOWNis correct as this information could be retrieved and used by nwmgr the SMH NIC Tool GUI and Critical Resource Analysis CRA tools New LAN Command Starting with HP UX 11i v3 the nwmgr command is anew LAN command replacing the lanadmin lanscan and 1inkloop commands which have been obsoleted in 11i v3 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 G
11. er Architecture HP DLPI LAN drivers utilize HP DLPI for the following operations and features e HP DLPlis the interface between the transport and driver layer An advantage of writing a non native driver is that HP DLPI assumes the responsibility of interacting with the transport layer e Support for SMH and LAN commands is provided in the non native driver architecture e HP DLPI provides support for Out of Packet OOP and Checksum offload CKO Figure 1 1 shows the HP UX 11i v3 HP DLPI LAN driver architecture LAN Driver Architecture 13 Figure 1 1 HP DLPI LAN Driver Architecture Upper layers of the HP UX Network Interface Architecture DLPI 2 0 API with HP Extensions via STREAMS Interfaces Data Link STREAMS Layer Services HP DLPI to Driver Interface HP UX m Kernel Services NetTL Services WSIO Services For information on writing an HP DLPI LAN driver see the HP UX 11i v3 Driver Development Guide Native STREAMS DLPI LAN Driver Architecture Native STREAMS DLPI LAN drivers are also known as loosely coupled drivers Developers can continue to have the option of providing a native DLPI implementation for HP UX 11i v3 This requires the developer to provide a full DLPI 2 0 HP extensions for example DL_HP_PPA_REQ support module A native LAN driver must do the following e Register with HP DLPI during initialization This is required because on HP UX the HP DLPI module also acts
12. in the C language e Have working knowledge of the basic concepts of writing a driver e Understand the functionality of the hardware for which the driver is being written e Understand the HP UX System Administration Tasks manual and performed system administration e Have working knowledge of the virtual memory I O and file system areas in the HP UX and or UNIX operating systems This document is not a tutorial Publishing History Table 1 Publishing History Details Document Manufacturing Part Operating Systems Supported Supported Product Versions Publication Date a 5 5187 4493 4493 11i ive 11 CET 02 February 2007 2007 Typographical Conventions This document uses the following conventions audit 5 An HP UX manpage In this example audit is the name and 5 is the section in the HP UX Reference On the web and on the Instant Information CD it may be a hot link to the manpage itself From the HP UX command line you can enter man audit or man 5 audit to view the manpage See man 1 Book Title The title of a book On the web and on the Instant Information CD it may be a hot link to the book itself KeyCap The name of a keyboard key Note that Return and Enter both refer to the same key Emphasis Text that is emphasized Bold Text that is strongly emphasized Bold The defined use of an important word or phrase ComputerOut Text displayed by the computer UserInput Commands and other text that you ty
13. pe Command A command name or qualified command phrase Variable The name of a variable that you may replace in a command or function or information in a display that represents several possible values The contents are optional in formats and command descriptions If the contents are a list separated by you must choose one of the items The contents are required in formats and command descriptions If the contents are a list separated by you must choose one of the items The preceding element may be repeated an arbitrary number of times Separates items in a list of choices HP UX Release Name and Release Identifier Each HP UX 11i release has an associated release name and release identifier The uname command with the r option returns the release identifier This table shows the releases available for HP UX 11i Table 2 HP UX Tli Releases Release Release Name Supported Processor Architecture Identifier B 11 31 02 HP UX 11i v3 PA RISC and Itanium A A FE Related Documents You can find additional information about migration from HP UX 11i v2 to HP UX 11i v3 at http www hp com go hpux_ddk Other documents in this collection include e DDK FAQ e HP UX 11i v3 Driver Development Guide e HP UX 11i v3 Driver Development Reference e HP UX 11i v3 Driver Development Getting Started Guide HP Encourages Your Comments HP encourages your comments concerning this document We are truly committed to provi
14. uide 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 anew 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 New LAN Command 19 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 20 Non Native HP DLPI LAN Driver Migration
Download Pdf Manuals
Related Search