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

More documents

Recommendations

Info

Revision History Revision Date Revision Description August 2001 3.3 SDK 2.0 release. Information in this document is provided in connection with Intel ® products. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. Except as provided in Intel’s Terms and Conditions of Sale for such products, Intel assumes no liability whatsoever, and Intel disclaims any express or implied warranty, relating to sale and/or use of Intel products including liability or warranties relating to fitness for a particular purpose, merchantability, or infringement of any patent, copyright or other intellectual property right. Intel products are not intended for use in medical, life saving, or life sustaining applications. Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked “reserved” or “undefined.” Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The product may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Intel Corporation might have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give any license to these patents. This document as well as the software and hardware described in it are furnished under license and may only be used or copied in accordance with the terms of the license. The information in this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means without the express written consent of Intel Corporation. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. Copies of documents which have an ordering number and are referenced in this document, or other Intel literature may be obtained by calling 1-800-548-4725 or by visiting Intel’s website at http://www.intel.com Copyright © Intel Corporation, 2001. All rights reserved. *Other names and brands may be claimed as the property of others. This product includes software developed by parties other than Intel. See the back page of this document for a list of copyrights and license agreements.
Contents About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . ix Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix In This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Other Sources of Information . . . . . . . . . . . . . . . . . . . . . . . xi Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . xi Installation Path . . . . . . . . . . . . . . . . . . . . . . . . . . . xii Syntax Example . . . . . . . . . . . . . . . . . . . . . . . . . . . xii Contacting Intel . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii Web and Internet Sites . . . . . . . . . . . . . . . . . . . . . . . . xii Customer Support Technicians . . . . . . . . . . . . . . . . . . . . xiii Chapter 1 Introduction and Overview . . . . . . . . . . . . . . . . . . . . 1 Network Service Applications . . . . . . . . . . . . . . . . . . . . . . . 1 Packet Classification . . . . . . . . . . . . . . . . . . . . . . . . . . 2 The IXA Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Logical Elements of an IXA Application . . . . . . . . . . . . . . . . . . . 3 The Data Plane . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 The Control Plane . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 The Management Plane . . . . . . . . . . . . . . . . . . . . . . . . 4 Dividing Tasks Among Code Modules . . . . . . . . . . . . . . . . . . 5 The ACE Programming Framework for Packet Handling. . . . . . . . . . . . 5 Packet Processing and ACEs . . . . . . . . . . . . . . . . . . . . . . 5 Writing ACEs using C, NCL and IXA IDL. . . . . . . . . . . . . . . . . 6 Predefined ACEs . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Accelerated ACEs . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Dividing Tasks Among ACE Types . . . . . . . . . . . . . . . . . . . 8 Using Stack ACEs . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 OMS for Global Application Services . . . . . . . . . . . . . . . . . . . 10 Creating ACEs . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Defining the Traffic Flow Path with Targets . . . . . . . . . . . . . . . 11 Contents iii Revision 3.3, August 2001
Page 1: Intel ® IXA SDK ACE Programming Fr
Page 5 and 6: L2 Bridging Configuration File . .
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:
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 ...

Create successful ePaper yourself

Delete template?

Save as template?