User Guide C-WARE SOFTWARE TOOLSET TUTORIAL WORKBOOK C-WARE SOFTWARE TOOLSET VERSION 2.2 CSTTW-UG/D Rev 00 C-Ware Software Toolset Tutorial Workbook C-WARE SOFTWARE TOOLSET, VERSION 2.2 CSTTW-UG/D Rev 00 Copyright © 2003 Motorola, Inc. All rights reserved. No part of this documentation may be reproduced in any form or by any means or used to make any derivative work (such as translation, transformation, or adaptation) without written permission from Motorola. Motorola reserves the right to revise this documentation and to make changes in content from time to time without obligation on the part of Motorola to provide notification of such revision or change. Motorola provides this documentation without warranty, term, or condition of any kind, either implied or expressed, including, but not limited to, the implied warranties, terms or conditions of merchantability, satisfactory quality, and fitness for a particular purpose. Motorola may make improvements or changes in the product(s) and/or the program(s) described in this documentation at any time. C-3e, C-5, C-5e, C-Port, C-Ware, Q-3, and Q-5 are all trademarks of C-Port, a Motorola Company. Motorola and the stylized Motorola logo are registered in the US Patent & Trademark Office. All other product or service names are the property of their respective owners. CSTTW-UG/D Rev 00 CONTENTS About This Guide Guide Overview . 9 Using PDF Documents . 10 Guide Conventions . 11 References to CST Pathnames . 12 Revision History . 13 Related Product Documentation . 14 LESSON 1 Workbook Overview Overview . 17 Lessons . 17 Lessons in This Workbook . 18 CST High-Level Directories . 18 Building C-5 Applications From Programs . 18 Simulating the Execution of C-5 Programs . 19 Debugging C-5 RC Programs . 19 Generating Simulated Ingress Traffic . 20 Post-Processing Simulated Egress Traffic . 20 Programming the C-5 Serial Data Processors . 21 Modifying the Gigabit Ethernet Switch Application . 21 CST Helpful Hints . 22 Referring to CST Directory Pathnames . 22 Windows NT™ File Completion . 23 Setting the CST Environment Variables . 23 Text Editors . 24 LESSON 2 Examining the Toolset’s Top-Level Directories Goals . 25 Prerequisites . 25 MOTOROLA GENERAL BUSINESS INFORMATION CSTTW-UG/D REV 00 4 CONTENTS Top-Level Directory Contents . 25 alliance\ . 26 apps\ . 27 bin\ . 29 contrib\ . 30 diags\ . 30 Documentation\ . 30 drivers\ . 30 libperl\ . 30 mingw\ . 31 services\ . 31 Tools\ . 32 Summary . 32 Exercises . 33 LESSON 3 Building C-Ware Applications Goals . 35 Prerequisites . 35 Source Files Correspond to Network Processor Embedded Processors . 36 Automated Building of Packages . 37 More About Package Files and Build Target Variants . 38 Compiling the Application’s Programs . 39 XPRC Programs . 39 CPRC Programs . 40 Microcode Programs . 40 Dependency Checking . 42 Building Programs That Perform Offline Support for Applications . 43 Summary . 43 Exercises . 44 LESSON 4 Simulating the Execution of a C-Ware Application Goals . 45 Prerequisites . ..