VxWorks Command-Line Tools User's Guide, 6.7 VxWorks® COMMAND-LINE TOOLS USER'S GUIDE 6.7 Copyright © 2008 Wind River Systems, Inc. All rights reserved. No part of this publication may be reproduced or transmitted in any form or by any means without the prior written permission of Wind River Systems, Inc. Wind River, Tornado, and VxWorks are registered trademarks of Wind River Systems, Inc. The Wind River logo is a trademark of Wind River Systems, Inc. Any third-party trademarks referenced are the property of their respective owners. For further information regarding Wind River trademarks, please see: http://www.windriver.com/company/terms/trademark.html This product may include software licensed to Wind River by third parties. Relevant notices (if any) are provided in your product installation at the following location: installDir/product_name/3rd_party_licensor_notice.pdf. Wind River may refer to third-party documentation by listing publications or providing links to third-party Web sites for informational purposes. Wind River accepts no responsibility for the information provided in such third-party documentation. Corporate Headquarters Wind River Systems, Inc. 500 Wind River Way Alameda, CA 94501-1153 U.S.A. toll free (U.S.): (800) 545-WIND telephone: (510) 748-4100 facsimile: (510) 749-2010 For additional contact information, please visit the Wind River URL: http://www.windriver.com For information on how to contact Customer Support, please visit the following URL: http://www.windriver.com/support VxWorks Command-Line Tools User's Guide, 6.7 2 Dec 08 Part #: DOC-16305-ND-00 Contents 1 Overview ............................................................................................... 1 1.1 Introduction ............................................................................................................. 1 1.2 Related Documentation ....................................................................................... 2 2 Setting Environment Variables ........................................................... 5 2.1 Introduction ............................................................................................................. 5 2.2 Setting Environment Variables With wrenv ................................................... 6 Solaris and Linux ...................................................................................... 6 Windows .................................................................................................... 6 Setting Environment Variables Without Spawning a Shell ................ 6 2.3 How wrenv Works ................................................................................................. 7 2.4 wrenv Command Options .................................................................................... 8 3 Configuring and Building VxWorks .................................................... 11 3.1 Introduction ............................................................................................................ 11 3.2 Working With VxWorks Image Projects: VIPs ................................................ 12 3.2.1 Setting Environment Variables ............................................................... 12 iii VxWorks Command-Line Tools User's Guide, 6.7 3.2.2 Creating VxWorks Image Projects ........................................................ 12 Checking the Toolchain ........................................................................... 14 Copying VIPs ............................................................................................ 14 Using Profiles ............................................................................................ 15 3.2.3 Deleting VIPs ........................................................................................... 15 3.2.4 Modifying VIPs ........................................................................................ 16 Adding Components ............................................................................... 16 Removing Components ........................................................................... 17 Setting Configuration Parameter Values .............................................. 17 Changing the Project Makefile Name ................................................... 18 Adding and Removing Individual Application Files ......................... 18 3.2.5 Getting Information About VIPs ........................................................... 18 Listing Components ................................................................................. 18 Listing Bundles ......................................................................................... 19 Listing Profiles .......................................................................................... 19 Comparing Projects .................................................................................. 20 Checking a Component ........................................................................... 20 Checking Component Dependencies .................................................... 20 Listing Configuration Parameters and Values ..................................... 20 Listing the Source Files in a Project ....................................................... 21 3.2.6 Building VIPs ........................................................................................... 22 Build Specifications, Build Rules, and Image Types ........................ 22 Examining Build Specifications and Rules ........................................... 24 Changing Build Specifications ............................................................... 24 Adding and Changing Build Rules ....................................................... 25 Building VxWorks .................................................................................... 25 3.2.7 Example vxprj Session ............................................................................. 26 3.3 Working With VxWorks Source Build Projects: VSBs ................................... 26 3.3.1 Using VSB Projects: Basic Steps ............................................................. 27 3.3.2 Setting Environment Variables ............................................................... 28 3.3.3 Displaying BSP and CPU Options for VSB Projects ........................... 28 3.3.4 Creating VSB Projects ............................................................................. 28 3.3.5 Selecting VSB Options ............................................................................ 30 3.3.6 Reconfiguring a VSB Project ................................................................... 31 iv Contents 3.3.7 Changing the CPU for a VSB Project .................................................... 32 3.3.8 Changing the BSP for a VSB Project ..................................................... 33 3.3.9 Building a VSB Project ............................................................................ 34 3.3.10 Deleting a VSB Project ............................................................................ 35 3.3.11 Using a VSB Project With a VxWorks Image Project .......................... 35 3.3.12 Identifying a VIP-VSB Association ....................................................... 35 3.3.13 Validating a VIP-VSB Association ........................................................ 36 3.4 Building Customized VxWorks Source Code .................................................. 36 3.4.1 Limitations and Restrictions ................................................................... 37 3.4.2 Third-Party Binary Files .......................................................................... 37 3.4.3 VxWorks Library Source Code and Archive Locations ...................... 37 3.4.4 Setting Environment Variables ............................................................... 38 3.4.5 Building Customized Kernel Source Code with VSB Projects .......... 38 3.4.6 Building With Make Directly .................................................................. 38 UP and SMP Kernel Build Commands ................................................. 39 User (RTP) Build Command ................................................................... 39 Building Compiler Intrinsics Libraries ................................................. 39 4 Building Kernel Applications and Libraries ...................................... 41 4.1 Introduction ........................................................................................................... 42 4.2 About Building Kernel Applications and Libraries ....................................... 42 4.3 Setting Environment Variables ............................................................................ 42 4.4 Using the VxWorks Build Environment ........................................................... 43 4.5 Example Makefile for a Kernel Application .................................................... 43 4.6 Setting CPU and TOOL Make Variables .......................................................... 44 4.7 Building Kernel Applications for UP, SMP, and VSB Variants .................... 45 4.7.1 Building Applications With Default VxWorks UP Libraries ............ 45 v VxWorks Command-Line Tools User's Guide, 6.7 4.7.2 Building Applications With Default VxWorks SMP Libraries .......... 46 4.7.3 Building Applications With User-Configured Variant Libraries ...... 46 4.8 Linking Kernel Application Modules ............................................................... 47 4.9 Linking Kernel Application Modules With VxWorks