Intel IXA SDK ACE Programming Framework - Department of ...

More documents

Recommendations

Info

Communication Among ACEs. . . . . . . . . . . . . . . . . . . . . 12 MicroACE Resource Manager . . . . . . . . . . . . . . . . . . . . . 13 Hardware Architecture: The IXP1200 Network Processor . . . . . . . . . . 14 Software Configuration . . . . . . . . . . . . . . . . . . . . . . . . 14 Hardware Configuration . . . . . . . . . . . . . . . . . . . . . . . 15 Deploying Applications. . . . . . . . . . . . . . . . . . . . . . . . 17 Components of the IXA SDK for the IXP1200 . . . . . . . . . . . . . . . . 17 Chapter 2 Elements of an Application . . . . . . . . . . . . . . . . . . . . 19 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 The Object Management System . . . . . . . . . . . . . . . . . . . . . 20 Parts of the OMS. . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Accessing the OMS. . . . . . . . . . . . . . . . . . . . . . . . . . 21 Naming Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 For More Information . . . . . . . . . . . . . . . . . . . . . . . . 21 ACEs and Support Structures. . . . . . . . . . . . . . . . . . . . . . . 22 Creating ACEs. . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Support Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Additional Services . . . . . . . . . . . . . . . . . . . . . . . . . 23 Supporting Languages . . . . . . . . . . . . . . . . . . . . . . . . 23 Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 MicroACE Support Services . . . . . . . . . . . . . . . . . . . . . . . 24 The Application Building Process . . . . . . . . . . . . . . . . . . . . . 25 Chapter 3 Compiling and Testing Applications . . . . . . . . . . . . . . . 29 Overview of the ACE Compilation and Linking Process . . . . . . . . . . . 29 Intermediate Compilation . . . . . . . . . . . . . . . . . . . . . . . 29 Compiling and Linking Source Files . . . . . . . . . . . . . . . . . . 30 Compiling Kernel ACEs . . . . . . . . . . . . . . . . . . . . . . . 31 Compiling MicroACEs. . . . . . . . . . . . . . . . . . . . . . . . . . 32 Using Makefiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Debugging an Application . . . . . . . . . . . . . . . . . . . . . . . . 33 Chapter 4 Configuring and Starting IXA Systems . . . . . . . . . . . . . . 35 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 For Additional Information . . . . . . . . . . . . . . . . . . . . . . 36 Using Startup Scripts and Configuration Files . . . . . . . . . . . . . . . 36 Starting and Initializing Interface ACEs . . . . . . . . . . . . . . . . . 37 Microengine Threads . . . . . . . . . . . . . . . . . . . . . . . . . 37 The System Configuration File . . . . . . . . . . . . . . . . . . . . . . 37 Configuring Network Interfaces . . . . . . . . . . . . . . . . . . . . 38 Identifying Microcode Images . . . . . . . . . . . . . . . . . . . . . 38 Starting and Configuring Aces . . . . . . . . . . . . . . . . . . . . . 38 Setting Up Particular Configurations . . . . . . . . . . . . . . . . . . . 39 Configuring an L2 Bridge . . . . . . . . . . . . . . . . . . . . . . . 40 System Configuration File . . . . . . . . . . . . . . . . . . . . . 40 iv Contents Revision 3.3, August 2001
L2 Bridging Configuration File . . . . . . . . . . . . . . . . . . . 41 Configuring an L3 Forwarder . . . . . . . . . . . . . . . . . . . . . 42 System Configuration File . . . . . . . . . . . . . . . . . . . . . 42 L3 Forwarder Configuration File . . . . . . . . . . . . . . . . . . 43 Configuring an L3 Forwarder with NAT . . . . . . . . . . . . . . . . 44 System Configuration File . . . . . . . . . . . . . . . . . . . . . 44 NAT Configuration File . . . . . . . . . . . . . . . . . . . . . . 45 Launching Application ACEs. . . . . . . . . . . . . . . . . . . . . . . 46 Chapter 5 Controlling Packet Flow . . . . . . . . . . . . . . . . . . . . . . 47 Defining Packet Flow . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Physical Packet Flow . . . . . . . . . . . . . . . . . . . . . . . . . 48 Logical Packet Flow . . . . . . . . . . . . . . . . . . . . . . . . . 48 Binding Targets as Packet Destinations . . . . . . . . . . . . . . . . . . 48 Binding Targets and ACEs . . . . . . . . . . . . . . . . . . . . . . 49 Unbound Targets . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Defining Additional Targets . . . . . . . . . . . . . . . . . . . . . . . 50 Directing Packets to a Target . . . . . . . . . . . . . . . . . . . . . . . 51 Using Targets for Packet Processing . . . . . . . . . . . . . . . . . . . . 51 Serial Packet Flow . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Packet Flow Redirection . . . . . . . . . . . . . . . . . . . . . . . 52 Receiving and Transmitting on Network Interface Ports . . . . . . . . . . . 53 See Also . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Chapter 6 Writing MicroACEs . . . . . . . . . . . . . . . . . . . . . . . . . 55 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 MicroACE Architectural Elements . . . . . . . . . . . . . . . . . . . . 56 Architecture Summary . . . . . . . . . . . . . . . . . . . . . . . . 57 Loading MicroACEs . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Setting Up a Processing Pipeline for MicroACEs . . . . . . . . . . . . . 59 Creating Static Bindings . . . . . . . . . . . . . . . . . . . . . . 60 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Writing the Core Component of a MicroACE . . . . . . . . . . . . . . . . 61 Exception Packet Handling . . . . . . . . . . . . . . . . . . . . . . 62 Initializing a MicroACE . . . . . . . . . . . . . . . . . . . . . . . 62 Initialization Example . . . . . . . . . . . . . . . . . . . . . . . 63 Terminating a MicroACE . . . . . . . . . . . . . . . . . . . . . . . 64 Termination Example . . . . . . . . . . . . . . . . . . . . . . . 64 Writing an Exception Packet Handler. . . . . . . . . . . . . . . . . . 64 Exception Packet Handler Example . . . . . . . . . . . . . . . . . 65 Allocating Memory for Shared Data . . . . . . . . . . . . . . . . . . 65 Shared Memory Table Example . . . . . . . . . . . . . . . . . . . . 66 Microcode Side: Hash Initialization and Table Implementation . . . . . 66 Core Processor Side: Core Component Hashing. . . . . . . . . . . . 67 Configuring MicroACEs with Crosscalls . . . . . . . . . . . . . . . . . . 68 Microblock Types and Groups . . . . . . . . . . . . . . . . . . . . . . 68 Microblock Types . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Contents v Revision 3.3, August 2001
Page 1 and 2: Intel ® IXA SDK ACE Programming Fr
Page 3: Contents About This Guide. . . . .
Page 7 and 8: ICMP Error Packet Handling . . . .
Page 9 and 10: About This Guide This guide introdu
Page 11 and 12: Other Sources of Information Other
Page 13 and 14: Contacting Intel http://support.int
Page 15 and 16: Chapter 1 Introduction and Overview
Page 17 and 18: Logical Elements of an IXA Applicat
Page 19 and 20: The ACE Programming Framework for P
Page 25 and 26: OMS for Global Application Services
Page 27 and 28: OMS for Global Application Services
Page 29 and 30: Hardware Architecture: The IXP1200
Page 31 and 32: Components of the IXA SDK for the I
Page 33 and 34: Chapter 2 Elements of an Applicatio
Page 35 and 36: The Object Management System l The
Page 37 and 38: ACEs and Support Structures To crea
Page 39 and 40: The Application Building Process Th
Page 41 and 42: The Application Building Process c.
Page 43 and 44: Chapter 3 Compiling and Testing App
Page 45 and 46: Overview of the ACE Compilation and
Page 47 and 48: Using Makefiles l The microengine t
Page 49 and 50: Chapter 4 Configuring and Starting
Page 51 and 52: The System Configuration File Start
Page 53 and 54: Setting Up Particular Configuration
Page 55 and 56:
Setting Up Particular Configuration
Page 57 and 58:
Page 59 and 60:
Page 61 and 62:
Chapter 5 Controlling Packet Flow T
Page 63 and 64:
Binding Targets as Packet Destinati
Page 65 and 66:
Directing Packets to a Target //all
Page 67 and 68:
Receiving and Transmitting on Netwo
Page 69 and 70:
Chapter 6 Writing MicroACEs This ch
Page 71 and 72:
MicroACE Architectural Elements Arc
Page 73 and 74:
Loading MicroACEs 8. Start the micr
Page 75 and 76:
Writing the Core Component of a Mic
Page 77 and 78:
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
Microblock Types and Groups You wri
Page 85 and 86:
Writing a Dispatch Loop Block Type
Page 87 and 88:
Writing a Dispatch Loop Defining Ad
Page 89 and 90:
Writing a Microblock DL_SASink#: DL
Page 91 and 92:
MicroACE Design Example .elif (dl_n
Page 93 and 94:
Chapter 7 Interface ACEs This chapt
Page 95 and 96:
Initializing Interface ACEs A compl
Page 97 and 98:
The Input ACE The Input ACE The inp
Page 99 and 100:
The Output ACE l l l l l l Initiali
Page 101 and 102:
Chapter 8 Stack and Library ACEs Th
Page 103 and 104:
The L3 Forwarder Library ACE You ca
Page 105 and 106:
The L2 Bridging Library ACE The L3
Page 107 and 108:
The L2 Bridging Library ACE Conditi
Page 109 and 110:
The NAT Library ACEs — IP masquer
Page 111 and 112:
The NAT Library ACEs ace natc ./nat
Page 113 and 114:
Chapter 9 Classifying Packets Using
Page 115 and 116:
Defining Rules as “the set of all
Page 117 and 118:
How Rules Are Evaluated protocol et
Page 119 and 120:
Chapter 10 Initializing and Acting
Page 121 and 122:
Initializing the ACE Your ACE also
Page 123 and 124:
Defining Action and Utility Functio
Page 125 and 126:
What Action Functions Do Table 1: (
Page 127 and 128:
Chapter 11 Communication Within an
Page 129 and 130:
Overview Each call client or server
Page 131 and 132:
Defining Crosscall Interfaces Use t
Page 133 and 134:
Defining Call Operations Operation
Page 135 and 136:
Invocation Types for Operations l l
Page 137 and 138:
Integrating Crosscalls with Applica
Page 139 and 140:
Initializing and Terminating Interf
Page 141 and 142:
Page 143 and 144:
Page 145 and 146:
Invoking Crosscall Functions ix_err
Page 147 and 148:
Passing Crosscall Arguments } sleep
Page 149 and 150:
Passing Crosscall Arguments — For
Page 151 and 152:
Passing Crosscall Arguments 3. Call
Page 153 and 154:
Chapter 12 Crosscall Example This c
Page 155 and 156:
Example Interface Definition /* Dec
Page 157 and 158:
Example Interface Definition /*****
Page 159 and 160:
Writing the Crosscall Client static
Page 161 and 162:
Writing the Crosscall Client } goto
Page 163 and 164:
Writing the Crosscall Client err =
Page 165 and 166:
Writing the Crosscall Client err_la
Page 167 and 168:
Writing the Crosscall Server This e
Page 169 and 170:
Writing the Crosscall Server } if(r
Page 171 and 172:
Writing the Crosscall Server } /***
Page 173 and 174:
Writing the Crosscall Server // ACE
Page 175 and 176:
Chapter 13 Using Sets of Data to Cl
Page 177 and 178:
Defining Sets and Searches You can
Page 179 and 180:
Initializing and Populating Sets ix
Page 181 and 182:
How to Use Sets and Searches err =
Page 183 and 184:
Index A ACE 5 accelerated 7 action
Page 185 and 186:
D data processing plane 3 data sets
Page 187 and 188:
NAT library ACEs 94 binding targets
Page 189 and 190:
full names of 21 L3 forwarder ACE 9
Page 191 and 192:
Revision 3.3, August 2001 177
show all

Intel IXA SDK ACE Programming Framework - Department of ...

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?