You are on page 1of 45

Intel®Library Manager

User’s Manual
March 2003 Revision 1.2

Order Number: 278468-002

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. This document and the software 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, 2003 Intel and Intel XScale are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. * Other names and brands may be claimed as the property of others.

Intel® Library Manager User’s Manual

Contents

Contents
1 Introduction .................................................................................................................................... 5 1.1 1.2 1.3 1.4 2 2.1 2.2 2.3 3 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 3.10 4 4.1 4.2 4.3 4.4 4.5 4.6 5 5.1 5.2 About this Manual ................................................................................................................. 6 Requirements ....................................................................................................................... 7 Related Documentation ........................................................................................................8 Notational Conventions......................................................................................................... 9 Command Line Syntax .......................................................................................................12 Input Files and Output Files................................................................................................13 Overview of Library Manager Options ................................................................................14 Option -add .........................................................................................................................16 Option -delete .....................................................................................................................17 Option -extract ....................................................................................................................18 Option -help ........................................................................................................................19 Option -listmodules .............................................................................................................20 Option -listpublics ...............................................................................................................22 Option -moveafter ...............................................................................................................23 Option -movebefore ............................................................................................................24 Option -restore....................................................................................................................25 Option -verbose ..................................................................................................................26 Creating, Updating, and Modifying Libraries.......................................................................28 Extracting and Deleting Modules ........................................................................................29 Listing Modules and Symbol Tables ...................................................................................30 Moving Modules within the Library .....................................................................................31 Restoring the Symbol Table of the Library .........................................................................33 Printing Additional Information of the Process ....................................................................34 Message Format .................................................................................................................36 Message List.......................................................................................................................37

General Usage ............................................................................................................................11

Library Manager Options ............................................................................................................15

Examples ......................................................................................................................................27

Diagnostic Messages ..................................................................................................................35

Index .......................................................................................................................................................39

Intel® Library Manager User’s Manual

3

Contents

Figures
1 Input and Output Files ................................................................................................................ 13

Tables
1 2 3 Overview of Options ................................................................................................................... 14 Characterization of Diagnostic Messages .................................................................................. 36 Diagnostic Messages ................................................................................................................. 37

Revision History
Date March 2003 Revision 1.2 Description Version for the Intel® Library Manager version 1.2.

4

Intel® Library Manager User’s Manual

The Intel®Library Manager supports the following features: • Creating new libraries • Updating existing libraries by adding or deleting modules • Extracting modules from the library • Displaying information on the library. e. or change library files using the Intel®Library Manager.Introduction 1 The Intel®Library Manager organizes object files (modules) into library files. ELF relocatable files may be generated by compilers.g. It is then possible to create. The format of a created library follows the UNIX AR format. The format of object files is the ELF relocatable object format. assemblers. names of modules. names of public symbols • Moving modules to a specific location within the library • Restoring libraries Intel® Library Manager User’s Manual 5 . examine. or other utilities.

access to customer information. • Chapter 2. • Chapter 3. overview of command line options. and restrictions. “Requirements” on page 7. The manual describes the usage for Windows* host platforms. including command line syntax. “ General Usage” describes the usage of the Intel®Library Manager. input and output files. • Chapter 5.2. “Introduction” includes an overview of requirements. An example for every option helps to understand the usage of each option. “Diagnostic Messages” describes the message format and lists all available diagnostic messages. • Chapter 4. See also Section 1. The manual contains the following chapters: • Chapter 1.1 About this Manual This is a user manual for the Intel®Library Manager for Intel® XScale™ Microarchitecture. and notational conventions. related documentation.Introduction 1. 6 Intel® Library Manager User’s Manual . “Examples” provides a summary of useful examples. “Library Manager Options” describes all available command line options in detail.

2 Requirements To use the Intel®Library Manager the following environment is required: • Intel® Pentium® processor or higher (Intel® Pentium® III recommended) • 128 MB RAM (256 MB recommended) • Microsoft* Windows* 2000 Professional or Windows* XP Professional Intel® Library Manager User’s Manual 7 .Introduction 1.

order number 278467-003 Furthermore.Introduction 1. Release Notes are included in the documentation set of your installation. order number 278496-005 • Intel® Assembler Reference Manual.2 8 Intel® Library Manager User’s Manual . Release Notes contain features or changes of the product that are not documented in the corresponding manual. Release Notes may be provided.3 Related Documentation This section provides an overview of documentation which supplements this manual: • Intel® C++ Compiler User’s Manual. 1995. There are other documents which provide related information. 1998 Archive File Format • TIS Commitee. order number 278586-004 • Intel® Linker Manual. Tool Interface Standard (TIS) Executable and Linking Format (ELF) Specification Version 1. These are: • AT&T.

. Used to specify written code. Writing a metacharacter in quotation marks negates the syntactical meaning stated above.. Convention Italics Bold Plain Courier Italic Courier GUI-elements <> | . Used to specify an alternative between several items. Intel® Library Manager User’s Manual 9 . The following table explains these conventions. Used to specify an optional item which may be repeated. Titles of manuals are in italic font. the character is taken as a literal. [] {} "[" "]" "{" "}" "|" Description Italics identify variables and introduce new terminology.Introduction 1. the line "[" X "]" [ Y ] denotes the letter X enclosed in brackets.. Italics are used for emphasis. Filenames and function names to be defined are delimited by <>. Used to specify parameters.4 Notational Conventions This manual uses several notational and typographical conventions to visually differentiate text. Elements of the graphical user interface are written in this style. Used to specify something important. Used to specify optional items. For example. optionally followed by the letter Y. Used to specify an item which may be repeated.

10 Intel® Library Manager User’s Manual .Introduction This page intentionally left blank.

including: 2 • Section 2. • Section 2. • Section 2. “Input Files and Output Files” on page 13 provides an overview of input and output files.General Usage This chapter provides the general usage of the Intel®Library Manager.3.2. “Command Line Syntax” on page 12 describes the command line syntax and shows a usage example. “Overview of Library Manager Options” on page 14 provides an overview of command line options. Intel® Library Manager User’s Manual 11 .1.

Actually.3.o The Intel®Library Manager adds the object file mymodule. an option and filenames are accepted in any order. option input-files Example 1. All files are assumed to be in the same working directory.General Usage 2. including a path if required and a filename extension.2. If the library mylib does not exist.o to the library mylib. The parameter input-files contains a library file and. Creating or Modifying a New Library libxsc -add mylib mymodule. whereas new modules are added after the last existing module. a library file with this name is created. If a new library is created. Specifies one option listed in Section 2.3. If the library is modified. modules are placed one after the other. Refer also to Section 2. optionally.1 Command Line Syntax The Intel®Library Manager is started using the following call: libxsc option lib-name {input-files} where: lib-name Specifies the library file. “Overview of Library Manager Options” on page 14. a list of modules. “Input Files and Output Files” on page 13. “Input Files and Output Files” on page 13 Section 2. but the first filename which is not the part of an option is interpeted as the name of the library file. Further Information: Section 2. existing modules are replaced by the same modules at the same place. The number of files is unlimited.2. “Overview of Library Manager Options” on page 14 12 Intel® Library Manager User’s Manual .

For example. Input and Output Files Input files Output files ELF relocatable files Intel®Library Manager Library files Library files Intel® Library Manager User’s Manual 13 . A library file may contain modules with common characteristics (i. An ELF relocatable file is an object file which contains code and data for linking.2 Input Files and Output Files The Intel®Library Manager accepts the following input files: • ELF relocatable files • Library files The Intel®Library Manager produces library files as output files. An ELF relocatable file may be generated using a compiler.General Usage 2.e. or other tools. a library might contain modules that perform mathematical functions and another might contain modules that perform I/O routines. modules that perform similar functions or are required for a particular system). assembler. Figure 1.

3 Overview of Library Manager Options The following options are available and are listed with their abbreviations. Prints all messages. -delete -d -extract -help -listmodules -listpublics -e -? -lm -lp -moveafter modulename -ma modulename -movebefore modulename -restore -verbose -mb modulename -r -v 14 Intel® Library Manager User’s Manual . warning. For a detailed description of options. Restores the library. Reorganizes the library by moving all modules which are specified as input files on the command line before the module modulename. Lists all public symbols contained in the library on the screen. “Library Manager Options”. Extracts all modules which are specified as input files on the command line from the library. Lists all modules contained in the library on the screen. refer to Chapter 3. Table 1. This option must be used when a new library is created or modified. These modules are not deleted from the library. Overview of Options Option -add Abbreviation -a Description Adds all input files which are specified on the command line to the library. Prints usage help. including notes. Reorganizes the library by moving all modules which are specified as input files on the command line after the module modulename. and error messages to the screen. Note: The Intel®Library Manager accepts only one option with one exception: the option -verbose must be used together with one of the other options of the Intel®Library Manager.General Usage 2. Deletes all modules which are specified as input files on the command line from the library.

Intel® Library Manager User’s Manual 15 . a description and examples are provided. “Overview of Library Manager Options” on page 14. refer to Section 2. refer to Chapter 4.3. The syntax. For an overview of options. the abbreviation of the syntax. “Examples”. For a summary of examples.Library Manager Options 3 This chapter describes all available command line options in detail.

Option -add libxsc mylib. The modules are specified on the command line as input files and separated by white spaces.Library Manager Options 3.3.lib is created if it does not exist.o and a. “Option -delete” on page 17 Section 3.2. Example 2.o a.lib. The updated module is then placed at the same position in the library the older module was placed before. This option is also used to add an newer update of a module to the library. Further Information: Section 3.o are added to the library mylib.o The modules new.1 Option -add Syntax: Abbreviation: Description: -add -a The -add option is used to add one or several modules to the library. The library mylib.lib -add new. “Option -extract” on page 18 16 Intel® Library Manager User’s Manual .

a fatal error message occurs.lib.3.1.lib -d test. Further Information: Section 3. “Option -add” on page 16 Section 3.o is deleted from the library mylib. “Option -extract” on page 18 Intel® Library Manager User’s Manual 17 . Examples 3. If more than one module is to be deleted and one module does not exist.2 Option -delete Syntax: Abbreviation: Description: -delete -d The option -delete deletes the modules that are specified as input files on the command line from the library.Library Manager Options 3. Option -delete libxsc mylib. Otherwise all existing modules are deleted from the library.o The module test.

lib.Library Manager Options 3. “Option -delete” on page 17 18 Intel® Library Manager User’s Manual .2.o The module test. it is replaced by the extracted module. Further Information: Section 3. The module test.3 Option -extract Syntax: Abbreviation: Description: -extract -e The option -extract extracts the modules that are specified as input files on the command line from the library to the current working directory.lib test.o is extracted from the library mylib. Option -extract libxsc -extract mylib.o is not deleted! If a module with this name exits in the directory. This option is useful to restore modules. Extracted modules are not deleted from the library. Example 4.

All rights reserved.4 Option -help Syntax: Abbreviation: Description: -help -? The option -help prints an overview of all available command line options on the screen.2. Example 5. Version 1.Library Manager Options 3. LIBXSC [<options>] <libraryname> [<modulename>] [-(add|a)] add modules to the library (default) [-(extract|e)] extract modules from the library [-(delete|d)] delete modules from the library [-(listmodules|lm)] list modules in the library [-(listpublics|lp)] list publics in the library [-(moveafter|ma) <arg>] move listed modules after module <arg> [-(movebefore|mb) <arg>] move listed modules before module <arg> [-(restore|r)] restore archive symbol table [-(verbose|v)] print progress messages Intel® Library Manager User’s Manual 19 .10 Copyright (C) 2001-2002 Intel Corporation. Option -help libxsc -? The command above prints the following output to the screen: Intel(R) Library Manager for Intel(R) XScale(TM) Microarchitecture.

o are added to the library mylib.lib.o and module3. the following output appears on the screen: MODULE NAME module1. Lists the byte start address of the module as hexadecimal value. Description Example 6. Option -listmodules libxsc -add mylib.lib The modules module1. and execute access of the group. When the Intel®Library Manager is called with the -lm option.o libxsc -lm mylib.o module3.o POSITION 00000d0 0000528 0000a08 LENGTH OWNER GROUP 000041c 0 0 00004a4 0 0 000026d 0 0 MOD.o module3. and execute access of the owner.TIME where: Item MODULE NAME POSITION LENGTH OWNER GROUP MOD. Lists the module length as hexadecimal value. Shows the bit encoding for read. module2.o module2.TIME Mon Jan 13 11:32:14 2003 Mon Jan 13 11:32:18 2003 Mon Feb 24 13:40:09 2003 20 Intel® Library Manager User’s Manual . Lists the time the module was created.Library Manager Options 3. Shows the bit encoding for read. write. The list of modules starts at a file position greater than 0x0 because the table starts with the public symbol table.o.o module2.lib module1. write. The output contains the following information: MODULE NAME POSITION LENGTH OWNER GROUP MOD.5 Option -listmodules Syntax: Abbreviation: Description: -listmodules -lm The option -listmodules prints all modules which are contained in the library to the screen.TIME Lists the name of the module.

o starts at the address 528H. and it was created on Monday. and it was created on Monday. it’s length is 41CH.o.6. it’s owner and group are 0. it’s owner and group are 0. “Option -listpublics” on page 22 Intel® Library Manager User’s Manual 21 . February 24th 2003 at 13:30:09.o. module1. it’s length is 4A4H.o. January 13th 2003 at 11:32:18. • The module module1. • The module module3. and module3. module2.o starts at the address D0H. and it was created on Monday. it’s owner and group are 0.Library Manager Options The output provides the following information: • The library contains three modules. it’s length is 26DH.o starts at the address A08H. January 13th 2003 at 11:32:14. • The module module2. Further Information: Section 3.

Lists the module which contains the public symbol. _init.o module2.o module1. Further Information: Section 3.Library Manager Options 3. Example 7. the following output appears on the screen: PUBLIC ___crt_dummy__ _start __environ environ _init _fini : : : : : : : MODULE module1.o The output provides the following information: • The library contains the public symbols ___crt_dummy__. _start. “Option -listmodules” on page 20 22 Intel® Library Manager User’s Manual . The output contains the following information: PUBLIC : MODULE where: Item PUBLIC MODULE Description Lists the name of the public symbol. environ.o module1. All other public symbols are contained in module1.o.o.5. __environ.lib When the Intel®Library Manager is called with the -lp option. _fini. Option -listpublics libxsc -lp mylib.o module2.6 Option -listpublics Syntax: Abbreviation: Description: -listpublics -lp The option -listpublics prints all public symbols which are contained in the library to the screen.o module1. • _init and _fini are contained in the module2.

lib module1.8.o in the library.TIME Mon Jan 13 11:32:18 2003 Mon Feb 24 13:40:09 2003 Mon Jan 13 11:32:14 2003 Further Information: Section 3. Option -moveafter The library mylib.Library Manager Options 3.o POSITION 00000d0 00005b0 000085a LENGTH 00004a4 000026d 000041c OWNER 0 0 0 GROUP 0 0 0 MOD.o is moved after module3. The option relates only to modules being in the library.o module1.7 Option -moveafter Syntax: -moveafter modulename Abbreviation: -ma modulename Note: A module that is to be moved must be in the library! Description: The option -moveafter reorganizes the library by moving all modules specified as input files after the module modulename.o module3.lib contains the following modules: MODULE NAME module1. Example 8.TIME Mon Jan 13 11:32:14 2003 Mon Jan 13 11:32:18 2003 Mon Feb 24 13:40:09 2003 The library is called with the option -ma: libxsc -ma module3.o POSITION 00000d0 0000528 0000a08 LENGTH OWNER GROUP 000041c 0 0 00004a4 0 0 000026d 0 0 MOD.o module2. Listed modules are neither added nor updated.o module1. The list of modules changes as follows: MODULE NAME module2. “Option -movebefore” on page 24 Intel® Library Manager User’s Manual 23 .o mylib. an error message appears.o module3. If the specified modules are not in the library.

8 Option -movebefore Syntax: Abbreviation: -movebefore modulename -mb name Note: A module that is to be moved must be in the library! Description: The option -movebefore reorganizes the library by moving all modules specified as input files before the module modulename. an error message appears. If the specified modules are not in the library. Option -movebefore The library mylib.o is moved before module1.o module2.o POSITION 00000d0 000037a 00007d2 LENGTH 000026d 000041c 00004a4 OWNER 0 0 0 GROUP 0 0 0 MOD. The option relates only to modules being in the library.o module1.o mylib. Example 9.7.lib module3. The list of modules changes as follows: MODULE NAME module3. Listed modules are neither added nor updated.o module3.o module2.TIME Mon Jan 13 11:32:14 2003 Mon Jan 13 11:32:18 2003 Mon Feb 24 13:40:09 2003 The library is called with the option -mb: libxsc -mb module1.o module3.o in the library.TIME Mon Feb 24 13:40:09 2003 Mon Jan 13 11:32:14 2003 Mon Jan 13 11:32:18 2003 Further Information: Section 3.o POSITION 00000d0 0000528 0000a08 LENGTH OWNER GROUP 000041c 0 0 00004a4 0 0 000026d 0 0 MOD. “Option -moveafter” on page 23 24 Intel® Library Manager User’s Manual .Library Manager Options 3.lib contains the following modules: MODULE NAME module1.

This option is useful if the symbol table contained in the library is faulty or does not exist. Intel® Library Manager User’s Manual 25 .Library Manager Options 3. Option -restore libxsc -restore mylib.9 Option -restore Syntax: Abbreviation: Description: -restore -r The option -restore restores the symbol table of the library. Note: The symbol table is required for the link process! Example 10.lib The symbol table of the library mylib.lib is restored.

lib does not exist.o module1.10 Option -verbose Syntax: Abbreviation: -verbose -v Note: This option must be used together with one of the other options of the Intel®Library Manager. e.lib module3. notes. warning. NO ERRORS. Using this option alone. Option -verbose libxsc -add -v mylib.o is added to the library and module1. Description: The option -verbose prints information on the process. The option can be appended to another option.o will be updated prepare new module list and symbol table write new (updated) library NO FATALS.g. NO WARNINGS 26 Intel® Library Manager User’s Manual . The following output appears on the screen: module module3. NO WARNINGS libxsc -av mylib.o module2. and error messages to the screen. Examples 11. -av is the same as -add -v on the command line.o Assuming that the library mylib.o will be added prepare new module list and symbol table write new (updated) library NO FATALS.lib module1. produces no output. NO ERRORS.o will be added module module1.o will be added module module2.o is updated.o The module module3.Library Manager Options 3. the following output appears on the screen if the above command line is used: module module1.

6. “Listing Modules and Symbol Tables” on page 30 • Section 4. “Restoring the Symbol Table of the Library” on page 33 • Section 4.4.Examples This chapter provides a set of examples on how you can use the Intel®Library Manager. “Moving Modules within the Library” on page 31 • Section 4.3. “Printing Additional Information of the Process” on page 34 Intel® Library Manager User’s Manual 27 . “Creating. Updating.5.2. The chapter describes the following: 4 • Section 4.1. and Modifying Libraries” on page 28 • Section 4. “Extracting and Deleting Modules” on page 29 • Section 4.

they are replaced by the new version of new.o. The same option is also used to update and modify a library.o and a.o a.o exist in the library.Examples 4. Updating.1 Creating.o and a.o are added to the library mylib. Further Information: Section 3.lib -add new.lib.lib is created if it does not exist. and Modifying Libraries A new library is created using the command line option -add.o and a. libxsc mylib. The library mylib.o The modules new. If new. “Option -add” on page 16 28 Intel® Library Manager User’s Manual .1.

use the -delete option. libxsc -extract mylib.lib -delete test.lib test. The module is not deleted from the library. it is replaced by the extracted module. use the -extract option.o The module test. To delete a module from a library.3. “Option -delete” on page 17 Section 3. The module test.2. Further Information: Section 3.o is extracted from the library mylib.o is deleted from the library mylib. “Option -extract” on page 18 Intel® Library Manager User’s Manual 29 .lib.Examples 4.lib.2 Extracting and Deleting Modules To extract modules from a library. libxsc mylib.o is not deleted! If the name of the extracted module exists in the directory.o The module test.

o The output provides the following information: • The library contains the public symbols ___crt_dummy__.lib. When the Intel®Library Manager is called with the option -listmodules.lib The command line above lists all public symbols which are contained in the library.o module3.o POSITION 00000d0 0000528 0000a08 LENGTH OWNER GROUP 000041c 0 0 00004a4 0 0 000026d 0 0 MOD. module2.TIME Mon Jan 13 11:32:14 2003 Mon Jan 13 11:32:18 2003 Mon Feb 24 13:40:09 2003 libxsc -listpublics mylib.o and module3. libxsc -add mylib.o module3.o module2.o module1.5. _fini. _start.o module2.o.o are added to the library mylib.lib module1. use the options -listmodules and -listpublics.o libxsc -listmodules mylib.6.Examples 4. “Option -listpublics” on page 22 30 Intel® Library Manager User’s Manual .o.o module1. “Option -listmodules” on page 20 Section 3. the following output appears on the screen: MODULE NAME module1.o module1. __environ. • _init and _fini are contained in the module2.lib The modules module1.o. All other public symbols are contained in module1.o module2.o module2. environ.3 Listing Modules and Symbol Tables To view the modules and public symbols that are contained in a library. The following output appears on the screen: PUBLIC ___crt_dummy__ _start __environ environ _init _fini : : : : : : : MODULE module1. Further Information: Section 3. _init.

Supposed the library mylib.TIME Mon Jan 13 11:32:18 2003 Mon Feb 24 13:40:09 2003 Mon Jan 13 11:32:14 2003 Intel® Library Manager User’s Manual 31 .o module1.o POSITION 00000d0 0000528 0000a08 LENGTH OWNER GROUP 000041c 0 0 00004a4 0 0 000026d 0 0 MOD. use -moveafter or -movebefore.lib contains the following modules: MODULE NAME module1. The list of modules changes as follows: MODULE NAME module2.o module3.Examples 4.lib module1.o module3.o mylib.o is moved after module3.4 Moving Modules within the Library To move a module within the library to another location.o in the library.o module1.TIME Mon Jan 13 11:32:14 2003 Mon Jan 13 11:32:18 2003 Mon Feb 24 13:40:09 2003 The Intel®Library Manager is called with the option -moveafter: libxsc -moveafter module3.o POSITION 00000d0 00005b0 000085a LENGTH 00004a4 000026d 000041c OWNER 0 0 0 GROUP 0 0 0 MOD.o module2.

TIME Mon Jan 13 11:32:14 2003 Mon Jan 13 11:32:18 2003 Mon Feb 24 13:40:09 2003 The Intel®Library Manager is called with the option -movebefore: libxsc -movebefore module1. “Option -moveafter” on page 23 Section 3.o POSITION 00000d0 000037a 00007d2 LENGTH 000026d 000041c 00004a4 OWNER 0 0 0 GROUP 0 0 0 MOD.7.o mylib.TIME Mon Feb 24 13:40:09 2003 Mon Jan 13 11:32:14 2003 Mon Jan 13 11:32:18 2003 Further Information: Section 3.o module2.Examples Supposed the library mylib.o module3.o in the library.o module2.lib contains the following modules: MODULE NAME module1.o POSITION 00000d0 0000528 0000a08 LENGTH OWNER GROUP 000041c 0 0 00004a4 0 0 000026d 0 0 MOD. The list of modules changes as follows: MODULE NAME module3. “Option -movebefore” on page 24 32 Intel® Library Manager User’s Manual .o module1.8.o is moved before module1.o module3.lib module3.

Further Information: Section 3.lib The symbol table of the library mylib. use the -restore option.lib is restored.9.Examples 4.5 Restoring the Symbol Table of the Library To restore the symbol table of the library. libxsc -restore mylib. “Option -restore” on page 25 Intel® Library Manager User’s Manual 33 .

NO WARNINGS Further Information: Section 3. “Option -verbose” on page 26 34 Intel® Library Manager User’s Manual .o Assuming that the library mylib. or error messages.10.o module2. Note: The option -verbose must be used together with one of the other options of the Intel®Library Manager! libxsc -add -verbose mylib.Examples 4. NO ERRORS.lib module1. warning.6 Printing Additional Information of the Process To print additional information on the process.g. use the -verbose option.o will be added prepare new module list and symbol table write new (updated) library NO FATALS. to display note.lib does not exist.o will be added module module2. the following output appears on the screen if the above command line is used: module module1. e.

“Message Format” on page 36 describes the format of messages. Intel® Library Manager User’s Manual 35 .Diagnostic Messages 5 The Intel®Library Manager generates diagnostic messages when a problem is encountered.1. • Section 5. “Message List” on page 37 provides a list of all messages with a short description. This chapter comprises the following sections: • Section 5.2.

E-FATAL 36 Intel® Library Manager User’s Manual . Characterization of Diagnostic Messages Qualifier W-NOTE W-WARNING E-ERROR Description Specifies a note message. Is a short description of the error. Specifies a warning message. This problem must be solved. Specifies a non-fatal error message. An error during the execution of the Intel®Library Manager has been reported. Specifies a fatal error message. This message informs the user about a problem within the application.Diagnostic Messages 5. This problem must be solved before anything else can be done to the library. This message does not indicate a problem. This message provides information for the user and is only printed if the -verbose option is specified. The reported error is more significant and has prevented the Intel®Library Manager from continuing its work.1 Message Format The diagnostic message format is as follows: LIBXSC-qualifier:message where: Specifies the type of message and the error number: W-NOTEerrornumber W-WARNINGerrornumber E-ERRORerrornumber E-FATALerrornumber Specifies the error number. qualifier errornumber message The following table lists the qualifier with a short description: Table 2.

etc. 002 FATAL 003 FATAL 004 FATAL 005 006 FATAL FATAL 007 FATAL 008 FATAL 009 010 FATAL FATAL Intel® Library Manager User’s Manual 37 . Execute libxsc with correct options. Execute libxsc with the option " -r" to restore the symbol table. Execute program with correct parameters. Module name modulename is extended by directory name or (and) drive letter. Diagnostic Messages Number 000 001 Type FATAL FATAL Message Internal Fatal Message No module modulename Incorrect symbols order in the library libraryname symbol table. Contact Intel® support . Execute program with correct parameters. File filename is not a library in the AR format File filename cannot be written due to access permissions.2 Message List The following diagnostic messages can be generated: Table 3. Input parameters are not complete. Module with name modulename was not found in the working directory. Order of publics in the library symbol table is different from module order. missing space on the drive. Module with modulename name does not exist in the library libraryname. Module with name modulename does not have ELF object format. Use the option -r (reconstruct) to create new table No module modulename in the library libraryname Input parameters incomplete: no module list for option option Input parameters incomplete: clarification Unrecognized type of module modulename Module name modulename must not be qualified by directory name File filename is not ar library Can not write the file filename Erroneous options Further Information Program fails to perform the task. Input parameters are not complete.Diagnostic Messages 5.

38 Intel® Library Manager User’s Manual .Diagnostic Messages This page intentionally left blank.

library manager 35–37 message format 36 message list 37 documentation. library option 14. 26 extracting modules 18. 16 -add. library option 14. 23 -movebefore. 23 -mb.Index Symbols -?. library option 14. library option 14. 28 deleting modules 17 extracting modules 18. library option 14. 22 -ma. 18 -help. 24 -r. 20 -listpublics. 28 D deleting modules from a library 17 diagnostic messages. 13 introduction to Library Manager 5 A adding modules to a library 16 L library adding modules 16 creating 12. library option 14. library option 14. 17 -delete. library manager 27–34 M message format. 33 library file 13 Library Manager introduction 5 command line syntax 12 diagnostic messages 35–37 examples 27–34 general usage 11–?? option overview 14 options 15–26 requirements 7 library name 12 listing modules and symbol tables 30 C command line input files 12 library name 12 option 12 command line syntax Library Manager 12 conventions of this manual 9 creating a library 12. library manager 36 message list. 17 -e. 20 -lp. 19 -listmodules. library option 14. related 8 E ELF re-locatable files 13 examples. 24. library option 14. 26 -verbose. 29 input and output files 13 moving modules 23. library option 14. library option 14. 30 printing symbol table 22. library option 14. 29 F features of Library Manager 5 files ELF re-locatable file 13 input and output files 13 library file 13 H help list 19 I input files 12. library option 14. library option 14. library option 14. 22 -lm. library option 14. 25 -restore. 25 -v. 18 -extract. library option 14. library option 14. library manager 37 modules extracting from a library 29 Intel® Library Manager User’s Manual 39 . 19 -a. 24 -moveafter. library option 14. 30 restoring symbol table 25. 31 printing modules 20. 16 -d. library option 14.

33 S symbol table printing 30 restoring 25. 22 -ma 14. 16 -add 14. 18 -help 14. command line 12 options. 31 printing 30 moving modules 23. 23 -movebefore 14. 16 -d 14. 25 -v 14. 34 help list 19 modules 20 symbol table 22 publics. 25 -restore 14. 24 -r 14. 31 output files 13 P printing additional information 26. 20 -lp 14. 26 R related documentation 8 requirements 7 restoring symbol table 25. 22 -lm 14. 17 -e 14. 17 -delete 14. 19 -a 14. list 22 O option. 24 -moveafter 14. 18 -extract 14. 20 -listpublics 14. library manager 15–26 overview 14 -? 14. 23 -mb 14. 24. 33 U usage of Library Manager 11–?? 40 Intel® Library Manager User’s Manual . 26 -verbose 14.listing 20 moving 24. 19 -listmodules 14.

...................................................................36 Diagnostic Messages.................................................Contents 1 2 3 Overview of Options .................................................................................37 Intel® Library Manager User’s Manual 1 Intel Confidential ........................................................................................................14 Characterization of Diagnostic Messages ...........

Contents 2 Intel® Library Manager User’s Manual Intel Confidential .

.........................................................................................13 Intel® Library Manager User’s Manual 1 Intel Confidential ..............Contents 1 Input and Output Files ..........

Contents 2 Intel® Library Manager User’s Manual Intel Confidential .

...........................................17 Option -extract ...16 Option -delete ......................................................................................................................................................8 3.................5 4................................................................................................30 Moving Modules within the Library .................... 9 Command Line Syntax ............................................................ Updating............................................................................................................... 6 Requirements ........................................... 5 1.........................................25 Option -verbose ......................................................19 Option -listmodules .................................................................................20 Option -listpublics ......33 Printing Additional Information of the Process ............1 5..4 3..........37 2 General Usage ............................4 4.........................2 4...................................................28 Extracting and Deleting Modules .............6 3...............................1 1.....................27 4.................................................10 4 Examples ..................................1 2..............................................................................14 Option -add ...................12 Input Files and Output Files...............................................36 Message List................................................................................................................................................................................................................ and Modifying Libraries................................34 Message Format .......................................4 About this Manual ............................................23 Option -movebefore ...........................................26 Creating.................................3 1.................................................................................18 Option -help .........................................3 3..5 3............................................Contents 1 Introduction ...........................................................................................39 Intel® Library Manager User’s Manual 1 Intel Confidential ...............................................................15 3...................................6 5 Diagnostic Messages ..35 5...............................................................................................................9 3.....11 2.......................3 3 Library Manager Options .................................................................1 4.........................................................................................................31 Restoring the Symbol Table of the Library .......................................................................................................24 Option -restore...............................................................................................................................................................8 Notational Conventions.....................................7 3.........................................................................13 Overview of Library Manager Options ............................................... 7 Related Documentation ......1 3..............2 Index ........................................................................................................................................................................................................2 2..................................................................................................................................................................................................................................................2 1...................................................................29 Listing Modules and Symbol Tables ..........................................................................................................................3 4...22 Option -moveafter ....................................2 3.................................