Intel® IXP400 Software
Contents
Programmer’s Guide IXP400 Software Version 2.0 April 2005
Document Number: 252539, Revision: 007
Contents
1 Introduction.................................................................................................. ................................19
1.1 Versions Supported by this Document ............................................................................ ...19
1.2 Hardware Supported by this Release.................... .............................................................19
1.3 Intended Audience.................................................... ..........................................................19
1.4 How to Use this Document .............................................................................................. ...20
1.5 About the Processors .................................................................. .......................................20
1.6 Related Documents ......................................................................................................... ...21
1.7 Acronyms..................................................... ....................................................................... 22
2 Software Architecture Overview ...................................................................... ..........................27
2.1 High-Level Overview........................................................................... ................................27
2.2 Deliverable Model........................... .................................................................................... 28
2.3 Operating System Support .............................................................................. ... ... ... .... ... ... 29
2.4 Development Tools...................................................... .......................................................29
2.5 Access Library Source Code Documentation.............. .......................................................29
2.6 Release Directory Structure................................................................................ ................30
2.7 Threading and Locking Policy................................................................................... ..........32
2.8 Polled and Interrupt Operation.................................................................................. ..........32
2.9 Statistics and MIBs ............................................................................................................. 32
2.10 Global Dependency Chart ............................................................................... ... ... ... .... ... ... 33
3 Buffer Management........................................... .......................................................................... 35
3.1 What’s New............................................................................... ..........................................35
3.2 Overview................................................... .......................................................................... 35
3.3 IXP_BUF Structure ....................................................................................................... ......38
3.3.1 IXP_BUF Structure and Macros ...................................................................... ......38
3.4 Mapping of IX_MBUF to Shared Structure ......................................................................... 43
3.5 IX_MBUF Structure................................................................................... ..........................44
3.6 Mapping to OS Native Buffer Types ................................................................................... 46
3.6.1 VxWorks* M_BLK Buffer..................................................................... ...................46
3.6.2 Linux* skbuff Buffer............................................................................. ...................47
3.7 Caching Strategy .......................................................................................................... ......49
3.7.1 Tx Path .................................................................. ................................................49
3.7.2 Rx Path.............. ... .... ... ... ... ... .... ............................................................................. 50
3.7.3 Caching Strategy Summary...................................... .............................................50
4 Access-Layer Components:
ATM Driver Access (IxAtmdAcc) API......................................................................... ................53
4.1 What’s New............................................................................... ..........................................53
4.2 Overview................................................... .......................................................................... 53
4.3 IxAtmdAcc Component Features........................................... .............................................53
4.4 Configuration Services.................................................................................. ......................55
4.4.1 UTOPIA Port-Configuration Service ...................................................................... 55
4.4.2 ATM Traffic-Shaping Services............... ................................................................ 55
4.4.3 VC-Configuration Services ................................................................. ... ... ... .... ... ... 56
4.5 Transmission Services........................................................................ ................................57