Smart Linker Revised 04/29/2003 Metrowerks, the Metrowerks logo, and CodeWarrior are registered trademarks of Metrowerks Corp. in the US and/or other countries. All other tradenames and trademarks are the property of their respective owners. Copyright © Metrowerks Corporation. 2003. ALL RIGHTS RESERVED. The reproduction and use of this document and related materials are governed by a license agreement media, it may be printed for non-commercial personal use only, in accordance with the license agreement related to the product associated with the documentation. Consult that license agreement before use or reproduction of any portion of this document. If you do not have a copy of the license agreement, contact your Metrowerks repre- sentative or call 800-377-5416 (if outside the US call +1-512-996-5300). Subject to the foregoing non-commercial personal use, no portion of this documentation may be reproduced or transmitted in any form or by any means, electronic or mechanical, without prior written permission from Metrowerks. Metrowerks reserves the right to make changes to any product described or referred to in this document without further notice. Metrowerks makes no warranty, representation or guarantee regarding the merchantability or fitness of its prod- ucts for any particular purpose, nor does Metrowerks assume any liability arising out of the application or use of any product described herein and specifically disclaims any and all liability. Metrowerks software is not authorized for and has not been designed, tested, manufactured, or intended for use in developing applications where the fail- ure, malfunction, or any inaccuracy of the application carries a risk of death, serious bodily injury, or damage to tangible property, including, but not limited to, use in factory control systems, medical devices or facilities, nuclear facilities, aircraft navigation or communication, emergency systems, or other applications with a simi- lar degree of potential hazard. USE OF ALL SOFTWARE, DOCUMENTATION AND RELATED MATERIALS ARE SUBJECT TO THE METROWERKS END USER LICENSE AGREEMENT FOR SUCH PRODUCT. How to Contact Metrowerks Corporate Headquarters Metrowerks Corporation 7700 West Parmer Lane Austin, TX 78729 U.S.A. World Wide Web http://www.metrowerks.com Sales Voice: 800-377-5416 Fax: 512-996-4910 Email: [email protected] Technical Support Voice: 800-377-5416 Email: [email protected] Table of Contents 1 Introduction 15 Notation . 15 Structure of this Document . 15 Purpose of a Linker . 16 2 User Interface 17 Tip of The Day Dialog . 17 Main Window . 18 Window Title . 18 Content Area . 19 Tool Bar . 20 Status Bar . 21 Linker Menu Bar . 21 Options Settings Dialog Box . 30 Message Settings Dialog Box . 31 About Box . 33 Retrieving Information about an Error Message . 34 Specifying the Input File . 35 Message/Error Feedback . 36 3 Environment 39 The Current Directory . 40 Global Initialization File (MCUTOOLS.INI) (PC only) . 40 [Installation] Section . 41 [Options] Section . 41 [LINKER] Section . 42 [Editor] Section . 43 Example . 44 Local Configuration File (usually project.ini) . 45 [Editor] Section . 46 [[LINKER] Section . 47 Smart Linker 3 Table of Contents Example . 50 Paths . 51 Line Continuation . 51 Environment Variable Details . 52 .ABSPATH . 53 ABSPATH: Absolute Path . 53 COPYRIGHT . 54 COPYRIGHT: Copyright Entry in Absolute File . 54 DEFAULTDIR . 54 DEFAULTDIR: Default Current Directory . 54 ENVIRONMENT . 55 ENVIRONMENT: Environment File Specification. 55 ERRORFILE. 56 ERRORFILE: Error File Name Specification . 56 GENPATH. 58 GENPATH: Define Paths to search for input Files . 58 INCLUDETIME . 59 INCLUDETIME: Creation Time in Object File . 59 LINKOPTIONS . 60 LINKOPTIONS: Default SmartLinker Options . 60 OBJPATH . 60 OBJPATH: Object File Path . 60 RESETVECTOR . 61 RESETVECTOR: Reset Vector Location . 61 SRECORD . 61 SRECORD: S Record File Format . 61 TEXTPATH . 62 TEXTPATH: Text Path. 62 TMP . 63 TMP: Temporary directory . 63 USERNAME. 63 USERNAME: User Name in Object File. 63 4 Smart Linker Table of Contents 4Files 65 Input Files . 65 Parameter File . 65 Object File . 65 Output Files . 65 Absolute Files . 65 Motorola S Files . 66 Map Files . 66 Error Listing File . 67 5 SmartLinker Options 71 SmartLinker Option Details . 71 -Add . 72 -Add: Additional Object/Library File . 72 -AllocFirst,-AllocNext,-AllocChange . 73 -Alloc: Allocation over segment boundaries (ELF). 73 -AsROMLib . 75 -AsROMLib: Link as ROM Library. 75 -B . 76 -B: Generate S-Record file . 76 -CAllocUnusedOverlap. 76 -CAllocUnusedOverlap: Allocate not referenced overlap variables (HIWARE). 76 -Ci . 77 -Ci: Link Case Insensitive . 77 -Cocc. 78 -Cocc: Optimize Common Code (ELF) . 78 -CRam . 79 -CRam: Allocate non specified const segments in RAM (ELF) . 79 -Dist . 79 -Dist: Enable distribution optimization (ELF) . 79 -DistFile . 80 -DistFile: Specify distribution file name (ELF) . 80 -DistInfo . 80 Smart Linker 5 Table of Contents -DistInfo: Generate distribution information file (ELF) . 80 -DistOpti . 81 -DistOpti: Choose optimizing method (ELF) . 81 -DistSeg. 81 -DistSeg: Specify distribution segment name (ELF) . 81 -E . 82 -E: Define Application Entry Point (ELF) . 82 -Env . 82 -Env: Set Environment Variable . 82 -FA, -FE, -FH -F6 . 83 -FA, -FE, -FH -F6: Object File Format . 83 -H . 84 -H: Prints the List of All Available Options. 84 -L . 84 -L: Add a path to the search path (ELF) . 84 -Lic . 85 -Lic: Print license information . 85 -LicA. 85 -LicA: License Information about every Feature in Directory. 85 -M . 86 -M: Generate Map File. 86 -N . 86 -N: Display Notify Box . 86 -NoBeep . 87 -NoBeep: No Beep in Case of an Error . 87 -NoEnv . 87 -NoEnv: Do not use Environment . 87 -OCopy . 88 -OCopy: Optimize Copy Down (ELF). 88 -O . 89 -O: Define Absolute File Name . 89 -Prod . ..