Intel utility - processor

Embed Size (px)

Citation preview

  • 8/13/2019 Intel utility - processor

    1/45

    Intel Library Manager Users Manual

    March 2003

    Revision 1.2

    Order Number: 278468-002

  • 8/13/2019 Intel utility - processor

    2/45

    Intel Library Manager Users Manual

    Information in this document is provided in connection with Intel Products. No license, express or implied, by estoppel or otherwise, to anyintellectual property rights is granted by this document. Except as provided in Intel's Terms and Conditions of Sale for such products, Intel assumes noliability whatsoever, and Intel disclaims any express or implied warranty, relating to sale and/or use of Intel products including liability or warrantiesrelating to fitness for a particular purpose, merchantability, or infringement of any patent, copyright or other intellectual property right. Intel products arenot 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 forfuture 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 thelicense. The information in this document is furnished for informational use only, is subject to change without notice, and should not be construed as acommitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in thisdocument or any software that may be provided in association with this document. Except as permitted by such license, no part of this document maybe 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 calling1-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.

  • 8/13/2019 Intel utility - processor

    3/45

  • 8/13/2019 Intel utility - processor

    4/45

    4 Intel Library Manager Users Manual

    Contents

    Figures1 Input and Output Files ................................................................................................................ 13

    Tables1 Overview of Options ................................................................................................................... 142 Characterization of Diagnostic Messages ..................................................................................363 Diagnostic Messages ................................................................................................................. 37

    Revision History

    Date Revision Description

    March 2003 1.2 Version for the Intel Library Manager version 1.2.

  • 8/13/2019 Intel utility - processor

    5/45

    Intel Library Manager Users Manual 5

    Introduction 1

    The Intel Library Manager organizes object files (modules) into library files. The format of objectfiles is the ELF relocatable object format. The format of a created library follows the UNIX ARformat. ELF relocatable files may be generated by compilers, assemblers, or other utilities. It isthen possible to create, examine, or change library files using the Intel Library Manager.

    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.g. names of modules, names of public symbols

    Moving modules to a specific location within the library

    Restoring libraries

  • 8/13/2019 Intel utility - processor

    6/45

    6 Intel Library Manager Users Manual

    Introduction

    1.1 About this Manual

    This is a user manual for the Intel Library Manager for Intel XScale Microarchitecture. Themanual describes the usage for Windows* host platforms. See also Section 1.2, Requirements on

    page 7 .

    The manual contains the following chapters:

    Chapter 1, Introduction includes an overview of requirements, related documentation,access to customer information, and notational conventions.

    Chapter 2, General Usage describes the usage of the Intel Library Manager, includingcommand line syntax, input and output files, overview of command line options, andrestrictions.

    Chapter 3, Library Manager Options describes all available command line options in detail.

    An example for every option helps to understand the usage of each option. Chapter 4, Examples provides a summary of useful examples.

    Chapter 5, Diagnostic Messages describes the message format and lists all availablediagnostic messages.

  • 8/13/2019 Intel utility - processor

    7/45

    Intel Library Manager Users Manual 7

    Introduction

    1.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

  • 8/13/2019 Intel utility - processor

    8/45

    8 Intel Library Manager Users Manual

    Introduction

    1.3 Related Documentation

    This section provides an overview of documentation which supplements this manual:

    Intel C++ Compiler Users Manual , order number 278496-005

    Intel Assembler Reference Manual , order number 278586-004

    Intel Linker Manual , order number 278467-003

    Furthermore, Release Notes may be provided. Release Notes contain features or changes of the product that are not documented in the corresponding manual. Release Notes are included in thedocumentation set of your installation.

    There are other documents which provide related information. These are:

    AT&T, 1998 Archive File Format

    TIS Commitee, 1995, Tool Interface Standard (TIS) Executable and Linking Format (ELF)Specification Version 1.2

  • 8/13/2019 Intel utility - processor

    9/45

    Intel Library Manager Users Manual 9

    Introduction

    1.4 Notational Conventions

    This manual uses several notational and typographical conventions to visually differentiate text.The following table explains these conventions.

    Convention Description

    Italics Italics identify variables and introduce new terminology. Titles of manuals are initalic font. Italics are used for emphasis.

    Bold Used to specify something important.

    Plain Courier Used to specify written code.

    Italic Courier Used to specify parameters.

    GUI-elements Elements of the graphical user interface are written in this style.

    Filenames and function names to be defined are delimited by .

    | Used to specify an alternative between several items.

    ,... Used to specify an item which may be repeated.[ ] Used to specify optional items.

    { } Used to specify an optional item which may be repeated.

    "[" "]" "{" "}" "|" Writing a metacharacter in quotation marks negates the syntactical meaningstated above; the character is taken as a li teral. For example, the line"[" X "]" [ Y ]denotes the letter X enclosed in brackets, optionally followed by the letter Y.

  • 8/13/2019 Intel utility - processor

    10/45

    10 Intel Library Manager Users Manual

    Introduction

    This page intentionally left blank.

  • 8/13/2019 Intel utility - processor

    11/45

    Intel Library Manager Users Manual 11

    General Usage 2

    This chapter provides the general usage of the Intel Library Manager, including:

    Section 2.1, Command Line Syntax on page 12 describes the command line syntax andshows a usage example.

    Section 2.2, Input Files and Output Files on page 13 provides an overview of input andoutput files.

    Section 2.3, Overview of Library Manager Options on page 14 provides an overview ofcommand line options.

  • 8/13/2019 Intel utility - processor

    12/45

    12 Intel Library Manager Users Manual

    General Usage

    2.1 Command Line Syntax

    The Intel Library Manager is started using the following call:

    libxsc option lib-name { input-files }

    where:

    Example 1. Creating or Modifying a New Library

    libxsc -add mylib mymodule.o

    The Intel Library Manager adds the object file mymodule.o to the library mylib. If the librarymylib does not exist, a library file with this name is created.

    Further Information:Section 2.2, Input Files and Output Files on page 13

    Section 2.3, Overview of Library Manager Options on page 14

    lib-name Specifies the library file, including a path if required and a filename extension.

    option

    Specifies one option listed in Section 2.3, Overview of Library Manager Options onpage 14 . Actually, an option and filenames are accepted in any order, but the firstfilename which is not the part of an option is interpeted as the name of the libraryfile.

    input-files

    The parameter input-files contains a library file and, optionally, a list ofmodules. All files are assumed to be in the same working directory. The number offiles is unlimited. If a new library is created, modules are placed one after the other.If the library is modified, existing modules are replaced by the same modules at the

    same place; whereas new modules are added after the last existing module. Referalso to Section 2.2, Input Files and Output Files on page 13 .

  • 8/13/2019 Intel utility - processor

    13/45

    Intel Library Manager Users Manual 13

    General Usage

    2.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 is an object file which contains code and data for linking. An ELFrelocatable file may be generated using a compiler, assembler, or other tools.

    A library file may contain modules with common characteristics (i.e. modules that perform similarfunctions or are required for a particular system). For example, a library might contain modulesthat perform mathematical functions and another might contain modules that perform I/O routines.

    Figure 1. Input and Output Files

    IntelLibraryManager

    Library files

    ELFrelocatable

    files

    Library files

    Output filesInput files

  • 8/13/2019 Intel utility - processor

    14/45

    14 Intel Library Manager Users Manual

    General Usage

    2.3 Overview of Library Manager Options

    The following options are available and are listed with their abbreviations. For a detaileddescription of options, refer to Chapter 3, Library Manager Options .

    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.

    Table 1. Overview of Options

    Option Abbreviation Description

    -add -a Adds all input files which are specified on the commandline to the library. This option must be used when a newlibrary is created or modified.

    -delete -d Deletes all modules which are specified as input files onthe command line from the library.

    -extract -eExtracts all modules which are specified as input f iles onthe command line from the library. These modules arenot deleted from the library.

    -help -? Prints usage help.

    -listmodules -lm Lists all modules contained in the library on the screen.

    -listpublics -lp Lists all public symbols contained in the library on thescreen.

    -moveafter modulename -ma modulenameReorganizes the library by moving all modules whichare specified as input files on the command line afterthe module modulename .

    -movebefore modulename -mb modulenameReorganizes the library by moving all modules whichare specified as input files on the command line beforethe module modulename .

    -restore -r Restores the library.

    -verbose -v Prints all messages, including notes, warning, and errormessages to the screen.

  • 8/13/2019 Intel utility - processor

    15/45

  • 8/13/2019 Intel utility - processor

    16/45

    16 Intel Library Manager Users Manual

    Library Manager Options

    3.1 Option -add

    Syntax: -add

    Abbreviation: -a

    Description:The -add option is used to add one or several modules to the library. The modules are specified onthe command line as input files and separated by white spaces. This option is also used to add annewer update of a module to the library. The updated module is then placed at the same position inthe library the older module was placed before.

    Example 2. Option -add

    libxsc mylib.lib -add new.o a.o

    The modules new.o and a.o are added to the library mylib.lib. The library mylib.lib is created if itdoes not exist.

    Further Information:Section 3.2, Option -delete on page 17Section 3.3, Option -extract on page 18

  • 8/13/2019 Intel utility - processor

    17/45

    Intel Library Manager Users Manual 17

    Library Manager Options

    3.2 Option -delete

    Syntax: -delete

    Abbreviation: -d

    Description:The option -delete deletes the modules that are specified as input files on the command line fromthe library. If more than one module is to be deleted and one module does not exist, a fatal errormessage occurs. Otherwise all existing modules are deleted from the library.

    Examples 3. Option -delete

    libxsc mylib.lib -d test.o

    The module test.o is deleted from the library mylib.lib.

    Further Information:Section 3.1, Option -add on page 16Section 3.3, Option -extract on page 18

  • 8/13/2019 Intel utility - processor

    18/45

    18 Intel Library Manager Users Manual

    Library Manager Options

    3.3 Option -extract

    Syntax: -extract

    Abbreviation: -e

    Description:The option -extract extracts the modules that are specified as input files on the command linefrom the library to the current working directory. Extracted modules are not deleted from the library.This option is useful to restore modules.

    Example 4. Option -extract

    libxsc -extract mylib.lib test.o

    The module test.o is extracted from the library mylib.lib. The module test.o is not deleted! If a

    module with this name exits in the directory, it is replaced by the extracted module.

    Further Information:Section 3.2, Option -delete on page 17

  • 8/13/2019 Intel utility - processor

    19/45

    Intel Library Manager Users Manual 19

    Library Manager Options

    3.4 Option -help

    Syntax: -help

    Abbreviation: -?

    Description:The option -help prints an overview of all available command line options on the screen.

    Example 5. Option -help

    libxsc -?

    The command above prints the following output to the screen:

    Intel(R) Library Manager for Intel(R) XScale(TM) Microarchitecture, Version 1.2.10Copyright (C) 2001-2002 Intel Corporation. All rights reserved.

    LIBXSC [] [][-(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) ] move listed modules after module [-(movebefore|mb) ] move listed modules before module [-(restore|r)] restore archive symbol table[-(verbose|v)] print progress messages

  • 8/13/2019 Intel utility - processor

    20/45

    20 Intel Library Manager Users Manual

    Library Manager Options

    3.5 Option -listmodules

    Syntax: -listmodules

    Abbreviation: -lm

    Description:The option -listmodules prints all modules which are contained in the library to the screen. Thelist of modules starts at a file position greater than 0x0 because the table starts with the publicsymbol table. The output contains the following information:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIME

    where:

    Example 6. Option -listmoduleslibxsc -add mylib.lib module1.o module2.o module3.olibxsc -lm mylib.lib

    The modules module1.o, module2.o and module3.o are added to the library mylib.lib. When theIntel Library Manager is called with the -lm option, the following output appears on the screen:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIMEmodule1.o 00000d0 000041c 0 0 Mon Jan 13 11:32:14 2003module2.o 0000528 00004a4 0 0 Mon Jan 13 11:32:18 2003module3.o 0000a08 000026d 0 0 Mon Feb 24 13:40:09 2003

    Item Description

    MODULE NAME Lists the name of the module.

    POSITION Lists the byte start address of the module as hexadecimal value.

    LENGTH Lists the module length as hexadecimal value.

    OWNER Shows the bit encoding for read, write, and execute access of the owner.

    GROUP Shows the bit encoding for read, write, and execute access of the group.

    MOD.TIME Lists the time the module was created.

  • 8/13/2019 Intel utility - processor

    21/45

    Intel Library Manager Users Manual 21

    Library Manager Options

    The output provides the following information:

    The library contains three modules, module1.o, module2.o, and module3.o.

    The module module1.o starts at the address D0H, its length is 41CH, its owner and group are0, and it was created on Monday, January 13th 2003 at 11:32:14.

    The module module2.o starts at the address 528H, its length is 4A4H, its owner and groupare 0, and it was created on Monday, January 13th 2003 at 11:32:18.

    The module module3.o starts at the address A08H, its length is 26DH, its owner and groupare 0, and it was created on Monday, February 24th 2003 at 13:30:09.

    Further Information:Section 3.6, Option -listpublics on page 22

  • 8/13/2019 Intel utility - processor

    22/45

    22 Intel Library Manager Users Manual

    Library Manager Options

    3.6 Option -listpublics

    Syntax: -listpublics

    Abbreviation: -lp

    Description:The option -listpublics prints all public symbols which are contained in the library to thescreen. The output contains the following information:

    PUBLIC : MODULE

    where:

    Example 7. Option -listpublics

    libxsc -lp mylib.lib

    When the Intel Library Manager is called with the -lp option, the following output appears onthe screen:

    PUBLIC : MODULE ___crt_dummy__ : module1.o _start : module1.o __environ : module1.o environ : module1.o _init : module2.o _fini : module2.o

    The output provides the following information:

    The library contains the public symbols ___crt_dummy__ , _start , __environ ,environ , _init , _fini .

    _init and _fini are contained in the module2.o. All other public symbols are contained inmodule1.o.

    Further Information:Section 3.5, Option -listmodules on page 20

    Item Description

    PUBLIC Lists the name of the public symbol.

    MODULE Lists the module which contains the public symbol.

  • 8/13/2019 Intel utility - processor

    23/45

    Intel Library Manager Users Manual 23

    Library Manager Options

    3.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 filesafter the module modulename . The option relates only to modules being in the library. Listedmodules are neither added nor updated. If the specified modules are not in the library, an errormessage appears.

    Example 8. Option -moveafter

    The library mylib.lib contains the following modules:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIMEmodule1.o 00000d0 000041c 0 0 Mon Jan 13 11:32:14 2003module2.o 0000528 00004a4 0 0 Mon Jan 13 11:32:18 2003module3.o 0000a08 000026d 0 0 Mon Feb 24 13:40:09 2003

    The library is called with the option -ma :

    libxsc -ma module3.o mylib.lib module1.o

    module1.o is moved after module3.o in the library. The list of modules changes as follows:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIME module2.o 00000d0 00004a4 0 0 Mon Jan 13 11:32:18 2003 module3.o 00005b0 000026d 0 0 Mon Feb 24 13:40:09 2003 module1.o 000085a 000041c 0 0 Mon Jan 13 11:32:14 2003

    Further Information:Section 3.8, Option -movebefore on page 24

  • 8/13/2019 Intel utility - processor

    24/45

    24 Intel Library Manager Users Manual

    Library Manager Options

    3.8 Option -movebefore

    Syntax: -movebefore modulename

    Abbreviation: -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 . The option relates only to modules being in the library. Listedmodules are neither added nor updated. If the specified modules are not in the library, an errormessage appears.

    Example 9. Option -movebefore

    The library mylib.lib contains the following modules:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIMEmodule1.o 00000d0 000041c 0 0 Mon Jan 13 11:32:14 2003module2.o 0000528 00004a4 0 0 Mon Jan 13 11:32:18 2003module3.o 0000a08 000026d 0 0 Mon Feb 24 13:40:09 2003

    The library is called with the option -mb :

    libxsc -mb module1.o mylib.lib module3.o

    module3.o is moved before module1.o in the library. The list of modules changes as follows:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIME module3.o 00000d0 000026d 0 0 Mon Feb 24 13:40:09 2003 module1.o 000037a 000041c 0 0 Mon Jan 13 11:32:14 2003 module2.o 00007d2 00004a4 0 0 Mon Jan 13 11:32:18 2003

    Further Information:Section 3.7, Option -moveafter on page 23

  • 8/13/2019 Intel utility - processor

    25/45

    Intel Library Manager Users Manual 25

    Library Manager Options

    3.9 Option -restore

    Syntax: -restore

    Abbreviation: -r

    Description:The option -restore restores the symbol table of the library. This option is useful if the symboltable contained in the library is faulty or does not exist.

    Note: The symbol table is required for the link process!

    Example 10. Option -restore

    libxsc -restore mylib.lib

    The symbol table of the library mylib.lib is restored.

  • 8/13/2019 Intel utility - processor

    26/45

    26 Intel Library Manager Users Manual

    Library Manager Options

    3.10 Option -verbose

    Syntax: -verbose

    Abbreviation: -v

    Note: This option must be used together with one of the other options of the Intel Library Manager.Using this option alone, produces no output. The option can be appended to another option, e.g.-av is the same as -add -v on the command line.

    Description:The option -verbose prints information on the process, notes, warning, and error messages to thescreen.

    Examples 11. Option -verboselibxsc -add -v mylib.lib module1.o module2.o

    Assuming that the library mylib.lib does not exist, the following output appears on the screen if theabove command line is used:

    module module1.o will be added module module2.o will be added prepare new module list and symbol table write new (updated) libraryNO FATALS, NO ERRORS, NO WARNINGS

    libxsc -a v mylib.lib module3.o module1.o

    The module module3.o is added to the library and module1.o is updated. The following outputappears on the screen:

    module module3.o will be added module module1.o will be updated prepare new module list and symbol table write new (updated) libraryNO FATALS, NO ERRORS, NO WARNINGS

  • 8/13/2019 Intel utility - processor

    27/45

    Intel Library Manager Users Manual 27

    Examples 4

    This chapter provides a set of examples on how you can use the Intel Library Manager.

    The chapter describes the following:

    Section 4.1, Creating, Updating, and Modifying Libraries on page 28

    Section 4.2, Extracting and Deleting Modules on page 29

    Section 4.3, Listing Modules and Symbol Tables on page 30

    Section 4.4, Moving Modules within the Library on page 31

    Section 4.5, Restoring the Symbol Table of the Library on page 33 Section 4.6, Printing Additional Information of the Process on page 34

  • 8/13/2019 Intel utility - processor

    28/45

    28 Intel Library Manager Users Manual

    Examples

    4.1 Creating, Updating, and Modifying Libraries

    A new library is created using the command line option -add . The same option is also used toupdate and modify a library.

    libxsc mylib.lib -add new.o a.o

    The modules new.o and a.o are added to the library mylib.lib . The library mylib.lib iscreated if it does not exist. If new.o and a.o exist in the library, they are replaced by the newversion of new.o and a.o .

    Further Information:Section 3.1, Option -add on page 16

  • 8/13/2019 Intel utility - processor

    29/45

    Intel Library Manager Users Manual 29

    Examples

    4.2 Extracting and Deleting Modules

    To extract modules from a l ibrary, use the -extract option. The module is not deleted from thelibrary. To delete a module from a library, use the -delete option.

    libxsc -extract mylib.lib test.o

    The module test.o is extracted from the library mylib.lib . The module test.o is not deleted!If the name of the extracted module exists in the directory, it is replaced by the extracted module.

    libxsc mylib.lib -delete test.o

    The module test.o is deleted from the library mylib.lib .

    Further Information:Section 3.2, Option -delete on page 17Section 3.3, Option -extract on page 18

  • 8/13/2019 Intel utility - processor

    30/45

    30 Intel Library Manager Users Manual

    Examples

    4.3 Listing Modules and Symbol Tables

    To view the modules and public symbols that are contained in a library, use the options-listmodules and -listpublics .

    libxsc -add mylib.lib module1.o module2.o module3.olibxsc -listmodules mylib.lib

    The modules module1.o , module2.o and module3.o are added to the library mylib.lib .When the Intel Library Manager is called with the option -listmodules , the following outputappears on the screen:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIMEmodule1.o 00000d0 000041c 0 0 Mon Jan 13 11:32:14 2003module2.o 0000528 00004a4 0 0 Mon Jan 13 11:32:18 2003module3.o 0000a08 000026d 0 0 Mon Feb 24 13:40:09 2003

    libxsc -listpublics mylib.lib

    The command line above lists all public symbols which are contained in the library. The followingoutput appears on the screen:

    PUBLIC : MODULE ___crt_dummy__ : module1.o _start : module1.o __environ : module1.o

    environ : module1.o _init : module2.o _fini : module2.o

    The output provides the following information:

    The library contains the public symbols ___crt_dummy__ , _start , __environ ,environ , _init , _fini .

    _init and _fini are contained in the module2.o. All other public symbols are contained inmodule1.o.

    Further Information:Section 3.5, Option -listmodules on page 20Section 3.6, Option -listpublics on page 22

  • 8/13/2019 Intel utility - processor

    31/45

  • 8/13/2019 Intel utility - processor

    32/45

    32 Intel Library Manager Users Manual

    Examples

    Supposed the library mylib.lib contains the following modules:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIME

    module1.o 00000d0 000041c 0 0 Mon Jan 13 11:32:14 2003module2.o 0000528 00004a4 0 0 Mon Jan 13 11:32:18 2003module3.o 0000a08 000026d 0 0 Mon Feb 24 13:40:09 2003

    The Intel Library Manager is called with the option -movebefore :

    libxsc -movebefore module1.o mylib.lib module3.o

    module3.o is moved before module1.o in the library. The list of modules changes as follows:

    MODULE NAME POSITION LENGTH OWNER GROUP MOD.TIME module3.o 00000d0 000026d 0 0 Mon Feb 24 13:40:09 2003 module1.o 000037a 000041c 0 0 Mon Jan 13 11:32:14 2003 module2.o 00007d2 00004a4 0 0 Mon Jan 13 11:32:18 2003

    Further Information:Section 3.7, Option -moveafter on page 23Section 3.8, Option -movebefore on page 24

  • 8/13/2019 Intel utility - processor

    33/45

    Intel Library Manager Users Manual 33

    Examples

    4.5 Restoring the Symbol Table of the Library

    To restore the symbol table of the library, use the -restore option.

    libxsc -restore mylib.lib

    The symbol table of the library mylib.lib is restored.

    Further Information:Section 3.9, Option -restore on page 25

  • 8/13/2019 Intel utility - processor

    34/45

    34 Intel Library Manager Users Manual

    Examples

    4.6 Printing Additional Information of the Process

    To print additional information on the process, e.g. to display note, warning, or error messages, usethe -verbose option.

    Note: The option -verbose must be used together with one of the other options of the Intel LibraryManager!

    libxsc -add -verbose mylib.lib module1.o module2.o

    Assuming that the library mylib.lib does not exist, the following output appears on the screenif the above command line is used:

    module module1.o will be added module module2.o will be added prepare new module list and symbol table write new (updated) libraryNO FATALS, NO ERRORS, NO WARNINGS

    Further Information:Section 3.10, Option -verbose on page 26

  • 8/13/2019 Intel utility - processor

    35/45

    Intel Library Manager Users Manual 35

    Diagnostic Messages 5

    The Intel Library Manager generates diagnostic messages when a problem is encountered. Thischapter comprises the following sections:

    Section 5.1, Message Format on page 36 describes the format of messages.

    Section 5.2, Message List on page 37 provides a list of all messages with a short description.

  • 8/13/2019 Intel utility - processor

    36/45

    36 Intel Library Manager Users Manual

    Diagnostic Messages

    5.1 Message Format

    The diagnostic message format is as follows:

    LIBXSC- qualifier : message

    where:

    The following table lists the qualifier with a short description:

    qualifier

    Specifies the type of message and the error number:W-NOTE errornumber W-WARNING errornumber E-ERROR errornumber E-FATAL errornumber

    errornumber Specifies the error number.

    message Is a short description of the error.

    Table 2. Characterization of Diagnostic Messages

    Qualifier Description

    W-NOTE Specifies a note message. This message provides information for the user and is onlyprinted if the -verbose option is specified. This message does not indicate a problem.

    W-WARNING Specifies a warning message. This message informs the user about a problem within theapplication.

    E-ERROR Specifies a non-fatal error message. An error during the execution of the IntelLibrary

    Manager has been reported. This problem must be solved.

    E-FATAL Specifies a fatal error message. The reported error is more significant and has preventedthe Intel Library Manager from continuing its work. This problem must be solved beforeanything else can be done to the library.

  • 8/13/2019 Intel utility - processor

    37/45

    Intel Library Manager Users Manual 37

    Diagnostic Messages

    5.2 Message List

    The following diagnostic messages can be generated:

    Table 3. Diagnostic Messages

    Number Type Message Further Information

    000 FATAL Internal Fatal Message Program fails to perform the task. ContactIntel support .

    001 FATAL No module modulename Module with name modulename was notfound in the working directory.

    002 FATAL

    Incorrect symbols order in thelibrary libraryname symboltable. Use the option -r(reconstruct) to create newtable

    Order of publics in the library symbol tableis different from module order. Executelibxsc with the option " -r" to restore thesymbol table.

    003 FATAL No module modulename in the

    library libraryname

    Module with modulename name does not

    exist in the library libraryname .

    004 FATALInput parameters incomplete:no module list for optionoption

    Input parameters are not complete.Execute program with correct parameters.

    005 FATAL Input parameters incomplete:clarificationInput parameters are not complete.Execute program with correct parameters.

    006 FATAL Unrecognized type of modulemodulenameModule with name modulename does nothave ELF object format.

    007 FATALModule name modulename mustnot be qualified by directoryname

    Module name modulename is extendedby directory name or (and) drive letter.

    008 FATAL File filename is not arlibraryFile filename is not a library in the ARformat

    009 FATAL Can not write the filefilenameFile filename cannot be written due toaccess permissions, missing space onthe drive, etc.

    010 FATAL Erroneous options Execute libxsc with correct options.

  • 8/13/2019 Intel utility - processor

    38/45

    38 Intel Library Manager Users Manual

    Diagnostic Messages

    This page intentionally left blank.

  • 8/13/2019 Intel utility - processor

    39/45

    Intel Library Manager Users Manual 39

    Index

    Symbols-?, library option 14, 19-a, library option 14, 16-add, library option 14, 16-d, library option 14, 17-delete, library option 14, 17-e, library option 14, 18-extract, library option 14, 18-help, library option 14, 19-listmodules, library option 14, 20-listpublics, library option 14, 22-lm, library option 14, 20-lp, library option 14, 22

    -ma, library option 14, 23-mb, library option 14, 24-moveafter, library option 14, 23-movebefore, library option 14, 24-r, library option 14, 25-restore, library option 14, 25-v, library option 14, 26-verbose, library option 14, 26

    Aadding modules to a library 16

    Ccommand line

    input files 12library name 12option 12

    command line syntaxLibrary Manager 12

    conventionsof this manual 9

    creatinga library 12, 28

    Ddeleting modules from a library 17diagnostic messages, library manager 35 37

    message format 36message list 37

    documentation, related 8

    EELF re-locatable files 13examples, library manager 27 34

    extracting modules 18, 29

    Ffeatures of

    Library Manager 5files

    ELF re-locatable file 13input and output files 13library file 13

    Hhelp list 19

    Iinput files 12, 13introduction to

    Library Manager 5

    Llibrary

    adding modules 16creating 12, 28deleting modules 17extracting modules 18, 29input and output files 13moving modules 23, 24, 31

    printing modules 20, 30 printing symbol table 22, 30restoring symbol table 25, 33

    library file 13Library Manager

    introduction 5command line syntax 12diagnostic messages 35 37examples 27 34general usage 11 ??option overview 14options 15 26requirements 7

    library name 12listing modules and symbol tables 30

    Mmessage format, library manager 36message list, library manager 37modules

    extracting from a library 29

  • 8/13/2019 Intel utility - processor

    40/45

    40 Intel Library Manager Users Manual

    listing 20moving 24, 31

    printing 30moving modules 23, 24, 31

    Ooption, command line 12options, library manager 15 26

    overview 14-? 14, 19-a 14, 16-add 14, 16-d 14, 17-delete 14, 17-e 14, 18-extract 14, 18-help 14, 19-listmodules 14, 20-listpublics 14, 22

    -lm 14, 20-lp 14, 22-ma 14, 23-mb 14, 24-moveafter 14, 23-movebefore 14, 24-r 14, 25-restore 14, 25-v 14, 26-verbose 14, 26

    output files 13

    P printing

    additional information 26, 34help list 19modules 20symbol table 22

    publics, list 22

    Rrelated documentation 8requirements 7restoring symbol table 25, 33

    Ssymbol table printing 30

    restoring 25, 33

    Uusage of

    Library Manager 11 ??

  • 8/13/2019 Intel utility - processor

    41/45

    Intel Library Manager Users Manual 1Intel Confidential

    Contents

    1 Overview of Options ...................................................................................................................142 Characterization of Diagnostic Messages ..................................................................................363 Diagnostic Messages..................................................................................................................37

  • 8/13/2019 Intel utility - processor

    42/45

    2 Intel Library Manager Users Manual Intel Confidential

    Contents

  • 8/13/2019 Intel utility - processor

    43/45

    Intel Library Manager Users Manual 1Intel Confidential

    Contents

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

  • 8/13/2019 Intel utility - processor

    44/45

    2 Intel Library Manager Users Manual Intel Confidential

    Contents

  • 8/13/2019 Intel utility - processor

    45/45

    Contents

    1 Introduction ....................................................................................................................................51.1 About this Manual .................................................................................................................61.2 Requirements .......................................................................................................................71.3 Related Documentation ........................................................................................................81.4 Notational Conventions.........................................................................................................9

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

    2.1 Command Line Syntax .......................................................................................................122.2 Input Files and Output Files................................................................................................132.3 Overview of Library Manager Options ................................................................................14

    3 Library Manager Options ............................................................................................................153.1 Option -add.........................................................................................................................163.2 Option -delete .....................................................................................................................173.3 Option -extract ....................................................................................................................183.4 Option -help ........................................................................................................................193.5 Option -listmodules.............................................................................................................203.6 Option -listpublics ...............................................................................................................223.7 Option -moveafter...............................................................................................................233.8 Option -movebefore............................................................................................................243.9 Option -restore....................................................................................................................253.10 Option -verbose ..................................................................................................................26

    4 Exampl es ......................................................................................................................................274.1 Creating, Updating, and Modifying Libraries.......................................................................284.2 Extracting and Deleting Modules ........................................................................................294.3 Listing Modules and Symbol Tables...................................................................................304.4 Moving Modules within the Library .....................................................................................314.5 Restoring the Symbol Table of the Library .........................................................................334.6 Printing Additional Information of the Process....................................................................34

    5 Diagnostic Messages ..................................................................................................................355.1 Message Format.................................................................................................................365.2 Message List.......................................................................................................................37

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