HP 3000 Manuals HP 3000 Manuals
LISTOBJ
This command displays (on LINKLIST) the symbols in a relocatable object
file.
If you do not specify which symbols to display using the parameters
listed below, the following types of symbols are displayed:
* Procedure and program entry points.
* Imported code symbols.
* HP COBOL II chunk symbols.
* Exported data symbols, except compiler-generated symbols beginning
with $, S$, or C$.
* Certain compiler-generated static data symbols, beginning with M$,
which appear in HP COBOL II listings.
* Storage requests (for example, HP FORTRAN 77 COMMON).
* Module symbols.
Syntax
LISTOBJ OBJFILE= relocatable_object_file
[;ALL]
[;CODE]
[;DATA]
[;ENTRYSYM]
[;MILLICODE]
Parameters
relocatable_object_file Names the relocatable object file to display.
ALL Displays the symbols in the relocatable object
file, including compiler-generated local
symbols.
CODE Displays all imported and exported (not local)
code symbols.
DATA Displays all exported data symbols and storage
requests.
ENTRYSYM Displays all procedure and program entry
points.
MILLICODE Displays all millicode symbols.
Example
LinkEd> LISTOBJ EX1OBJ
This command displays symbols in the relocatable object file, EX1OBJ.
(The source program for EX1OBJ is EX1SRC and is shown in figure 2-11.)
The first part of the listing is a header that gives general information
about the relocatable object module. MODULE NAME shows the name of the
relocatable object module and VERSION gives its format version. LENGTH
shows the number of bytes (in hexadecimal) in the relocatable object
module. Symbols in the relocatable object module are listed after the
header. See the next section "Understanding the Symbol Listing" for an
explanation of the symbols and columns in the symbol portion of the
listing. If there are other relocatable object modules in the
relocatable object file, they follow and are listed in the same format as
the first.
MODULE NAME : EX1SRC
VERSION : 85082112
LENGTH : 00000CD4
Sym C H X P Sym Sym Lset
Name Type Scope Name
---- - - - - ---- ----- ----
_start 0 3 3 sec_p univ
ex1 0 3 3 pri_p univ
M$1 0 data local
COB_ACCEPT 0 code unsat
COB_CLOSE 0 code unsat
COB_CLOSE_FILES 0 code unsat
COB_OPEN 0 code unsat
COB_READSEQ 0 code unsat
COB_WRITE 0 code unsat
TERMINATE 0 code unsat
U_EXIT 0 code unsat
coboltrap 0 code unsat
Understanding the Symbol Listing
This section describes the fields that appear in the symbol listing
produced by this command.
Column Description
Sym Name Contains the name of the symbol. If the name
exceeds 25 characters, it is truncated and an
asterisk appears in the first truncated position.
C Contains the type checking level of the symbol.
See the PARMCHECK= check_level parameter of the
ADDXL and LINK commands for a definition of the
values that appear in this column.
H Specifies whether the symbol is hidden or not. If
an H appears in this column, the symbol was hidden
by the HIDERL command. If the column is blank, the
symbol is not hidden.
X Specifies the xleast level of the symbol. See the
XLEAST= xleast_level parameter of the ADDXL command
for a definition of the values that appear in this
column.
P Specifies the privilege or execution level at which
this symbol runs. See the PRIVLEV= priv_level
parameter of the ADDXL and LINK commands for a
definition of the values that appear in this
column.
Sym Type Contains the symbol type. The symbol types are
shown below (see Table 4-1 for the relationship
of Sym Type values to Sym Scope values).
abs - Absolute
code - Code
data - Data
entry - Entry
milli - Millicode
mod - HP Pascal module name
null - Null
plab - Procedure label
pri_p - Primary program entry point
s_req - Storage request
sec_p - Secondary program entry point
Sym Scope Specifies the symbol's scope. The symbol scopes
are shown below (see Table 4-1 for the
relationship of Sym Scope values to Sym Type
values).
local - Local
univ - Universal
unsat - Unsatisfied
Lset Name Specifies the name of the locality set to which
this symbol belongs. Only user-defined locality
sets are listed.
Table 4-1. Symbol Types and Scopes (LISTOBJ)
-----------------------------------------------------------------------------------------------
| | | |
| Sym Type | Sym Scope | Description |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| abs | univ | A symbol that defines a non-relocatable symbol or |
| | | value and is visible to other object modules. |
| | | |
| abs | local | A symbol that defines a non-relocatable symbol or |
| | | value and is invisible to other object modules. |
| | | |
| abs | unsat | A symbol that references a non-relocatable symbol. |
| | | |
| code | local | A local label generated by the compiler, a user |
| | | label or a local label within a millicode routine. |
| | | |
| code | univ | The actual starting point of the code of a level |
| | | one procedure or function. An entry univ symbol |
| | | must exist for this symbol in order for other |
| | | object modules to reference the procedure or |
| | | function. (This symbol appears most frequently in |
| | | LISTPROG and LISTXL listings.) |
| | | |
| code | unsat | A symbol which is referenced by an object module, |
| | | but not defined by it. |
| | | |
| data | local | A data symbol which is visible inside an object |
| | | module, but invisible to other object modules. |
| | | |
| data | univ | A data symbol defined in an object module that is |
| | | visible to other object modules. |
| | | |
| data | unsat | A data symbol that is referenced by an object |
| | | module but not defined in it. |
| | | |
| entry | univ | The export stub for a level one procedure or |
| | | function. It is visible to other object modules. |
| | | |
| entry | local | The entry point to a nested procedure or program, |
| | | referenceable only within the module. |
| | | |
| milli | univ | A millicode routine linked into an object module. |
| | | |
| milli | unsat | A reference to a millicode routine that will be |
| | | linked into a relocatable object module. |
| | | |
-----------------------------------------------------------------------------------------------
Table 4-1. Symbol Types and Scopes (LISTOBJ) (cont.)
-----------------------------------------------------------------------------------------------
| | | |
| Sym Type | Sym Scope | Description |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| mod | local | An HP Pascal module name. |
| | | |
| null | univ | Internal symbol. |
| | | |
| null | local | Internal symbol. |
| | | |
| null | unsat | Internal symbol. |
| | | |
| plab | local | An export stub created for a procedure or function |
| | | (declared in a relocatable object module) whose |
| | | address has been taken. |
| | | |
| pri_p | univ | The main entry point into an outer block of a |
| | | program file. |
| | | |
| s_req | unsat | A symbol created when an uninitialized HP FORTRAN |
| | | 77 common block is declared. This symbol is also |
| | | created for Pascal global data and C globals. |
| | | |
| sec_p | univ | The secondary entry point into an outer block of a |
| | | program file. |
| | | |
-----------------------------------------------------------------------------------------------