Api | Sun Microsystems 3U manual

Using the SunATM API with the Q.93B and the ATM Device Drivers

The architecture illustrated in FIGURE C-1must be established on a SunATM system in order to perform Q.2931 signalling and send data over established connections. The ATM device driver, SSCOP modules, and Q.93B driver are “plumbed” at boot time. The task remaining for application developers is to create the connections between their application and the Q.93B and ATM device drivers.

Both the Q.93B and ATM device driver are STREAMS drivers; connecting to them is for the most part no different than connecting to other STREAMS drivers. The following sections describe the steps required to connect to each driver, use the drivers to establish ATM connections, and send data over those connections.

For examples of applications that use the SunATM API, see the sample programs installed in /opt/SUNWconn/atm/examples.

API

User	Kernel	API
App	App

Q.93B Driver

SSCOP

SSCOP

ATM Device Driver (ma driver)

	0		1

FIGURE C-1ATM Signalling

88 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

Image 110

Sun Microsystems 3U manual Api

Contents

SunATM 3U CompactPCI Adapter Installation and User’s Guide Please Recycle FCC Class B Notice Regulatory Compliance StatementsFCC Class a Notice ICES-003 Class a Notice Avis NMB-003, Classe a ICES-003 Class B Notice Avis NMB-003, Classe B Bsmi Class a Notice Page Declaration of Conformity EMCPage Contents Installing and Extracting the Adapter Configuring the SunATM Interfaces Editing SunATM Configuration Files Plumbing and Unplumbing SunATM Interfaces SunATM and Solaris Networking FeaturesSpecifications Classical IP and LAN Emulation Protocols Application Programmer’s Interface Testing the AdapterTroubleshooting and SunATM Error Messages Page Figures Page Tables SunVTS Documentation Preface How This Book Is Organized Using Unix Commands Solaris on Sun Hardware Platform Guide Table P-1Typographic Conventions Typographic ConventionsShell Prompts Table P-2Shell Prompts Sun Welcomes Your Comments Accessing Sun Documentation OnlineRelated Documentation Table P-3Related Documentation Product Description Software FeaturesProduct Overview Hardware Features SunATM 155 3U CompactPCI Adapter Hardware and Software Requirements SunATM 622 3U CompactPCI Adapter Overview of the Installation Procedure 1Installation Overview Checking the System for SunATM Software Installing the SunATM SoftwareTo Check for Previously Installed SunATM Software Packages Installing the SunATM Software 1SunATM Software Packages To Install the SunATM Software SunATM Interim API SUNWatma goes into To Check the Package Installation Using pkgchk To Remove the Software Packages Using pkgrm Configuring the SunATM Interfaces Page Installing and Extracting Adapter Determining the Type of Adapter Installation Preparing for the InstallationContents of the Ship Kit Tools and Equipment Needed Models of Hot Swap Type the following command Installing the AdapterTo Prepare the System for Hot Installation Start cPCI hot swap Power off the system To Prepare the System for a Cold InstallationTo Install the Adapter 1Opening the Ejection Lever Cfgadm -c configure attachmentpoint Check the hot swap LED on the adapter Attaching the Adapter to the SystemTo Attach the Adapter in a Hot Swap Environment Determining the Type of Adapter Extraction To Power On the System After a Cold InstallationExtracting the Adapter Check that the blue LED is on Detach unconfigure the cPCI card to be removedTo Extract the Adapter from a Hot Swap Environment To Extract the Adapter from a Cold Environment Page Configuring the SunATM Interfaces Using the atmadmin Configuration Program Starting the atmadmin Configuration Program Atmadmin Navigation Commands 1Basic Navigation Commands in atmadmin System Parameter Group Menu ATM Snmp Agent Status Interface Configuration Menu Atmadmin and the SunATM Configuration Files Atmadmin Parameter Groups 2Configurable Parameters in the SunATM Software Lecs indicator Physical-Layer Parameter Group Framing Interface Signalling Parameter Group UNI Version Ilmi Parameter Group Classical IP Parameter Group Classical IP Interface Type Hostname and IP Address Local ATM Address ATM ARP Server Address 3Predefined SunATM Variables LAN Emulation Parameter Group Permanent Virtual Circuit PVC Per-Instance LAN Emulation Hostname or IP Address Lecs ATM Address Page Editing SunATM Configuration Files Editing the atmconfig File Etc/opt/SUNWconn/atm/atmconfig Field Descriptions Changing the Framing Interface in the atmconfig File Example of an atmconfig File Configuring a Classical Internet Protocol Interface Editing the aarconfig File FlagDescription Etc/opt/SUNWconn/atm/aarconfig File Flag Descriptions Using Variables in the aarconfig File 4Predefined SunATM Variables Wild card matching one or two hexadecimal digits within Sample Classical IP Configurations /etc/opt/SUNWconn/atm/aarconfig file on a client On hostb Etc/opt/SUNWconn/atm/aarconfig on hosta Configuring a LAN Emulation Interface Editing the laneconfig File These entry fields are described in Table 7laneconfig Flag Requirements and Options Using Variables in the laneconfig File 8Predefined SunATM Variables Sample LAN Emulation Configurations Example /etc/opt/SUNWconn/atm/atmconfig file Supporting Multiple Emulated LANs on a Single Interface Resulting ifconfig -aoutput Page Plumbing and Unplumbing SunATM Interfaces Starting the SunATM Software for the First Time Plumbing and Unplumbing Individual ATM Interfaces 1Parameter Options for atmifconfig # atmifconfig ba0 unplumb # ifconfig -aPage Classical IP and LAN Emulation Protocols ATM Network Protocols ATM Addresses and Address Registration 1ATM Address Fields ATM Address Registration Daemon ilmid ATM Address ResolutionClassical Internet Protocol ATM ARP Address Resolution Tables LAN Emulation LAN Emulation Server LAN Emulation Configuration ServerLAN Emulation Servers Broadcast and Unknown Address Server Resolving an IP Address to an ATM Connection LAN Emulation Connections 1LAN Emulation Connections SunATM and Solaris Networking Features ATM and Snmp Snmp and Solaris Solaris 2.6, Solaris 7, and Solaris 8 Compatible Software ATM and Logical Interfaces Interface MAC Address ATM Address Specifications Physical Dimensions Environmental Specifications Performance SpecificationsPower Specifications Appendix a Specifications Page Table B-1SunVTS Tests Testing the AdapterUsing the SunVTS Diagnostic Software Using the OpenBoot Prom FCode Self-Test Table B-2SunVTS Documentation Use the show-devscommand to display the list of devices To Run the FCode Self-Test DiagnosticReset the system to activate these parameter changes Ok setenv diag-switch? false ok setenv auto-boot? true Reset and reboot the system Page Application Programmer’s Interface SunATM API Introduction API 93B Driver Interface Establishing a Connection to the Q.93B Driver Table C-1Messages Between the User and the Q.93B Driver Figure C-2Message Format Table C-2Fields in the Mproto mblockPage Call Setup Release Procedure Exception Conditions Release Request Table C-4atmutil Function Overview Raw Mode Connections Dlpi Mode ConnectionsPage Troubleshooting and SunATM Error Messages SunATM and Solstice FireWall-1 Known Issues About the SunATM 5.0 ReleaseRedundant Lane Servers Troubleshooting While Starting a SunATM Interface To Diagnose Generic Configuration Problems Check all of the generic configuration points To Diagnose Classical IP Configuration ProblemsVerify that an address has been registered with the switch Verify the output of ifconfig1M Make sure Classical IP is configured correctly If the serverstate is no-connection or connecting Ping client2 To Diagnose LAN Emulation Configuration Problems Verify that a connection has been made to the BUS Verify that the host has joined the Emulated LAN Ping client2 Common Problems Are you trying to use the /usr/sbin/arp command? Did the atmtest diagnostic fail? Error Messages Error Messages from S00sunatm Please install SUNWatm Page Error Messages From aarsetup and lanesetup Undefined variable Error Messages From the Kernel Drivers Page Symbols Index CIPHost field Snmp