Upload
userscrybd
View
236
Download
0
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