The ANALYZE/IMAGE command provides a description of the
components of an executable image file or shareable image file on
OpenVMS VAX and Alpha systems, and of an Executable and Linkable
Format (ELF) image file or sharable image file on OpenVMS I64
systems. It also verifies that the structure of the major parts
of the image file is correct. However, the ANALYZE/IMAGE command
cannot ensure that program execution is error free.
On OpenVMS I64 systems, the ANALYZE/IMAGE command automatically
distinguishes between I64, Alpha, and VAX images by examining the
header information.
If errors are found, the first error of the worst severity is
returned. For example, if a warning (A) and two errors (B and
C) are found, the first error (B) is returned as the image exit
status. The image exit status is placed in the DCL symbol $STATUS
at image exit.
NOTES
For I64 images and objects, the Analyze utility determines
whether the file it analyzes is an image file or object
file. Although Analyze allows you to specify ANALYZE/OJBECT
on an ELF image file, use ANALYZE/IMAGE for ELF image files
and ANALYZE/OJBECT for ELF object files.
When parsing output from ANALYZE/IMAGE, be aware that the
output for ELF images may change.
When using ANALYZE without a qualifier, the default is /OBJECT.
Therefore, when using this default to analyze an image in the
output file, the utility correctly identifies itself as "Analyze
Object File".
The OpenVMS VAX and Alpha versions of ANALYZE/IMAGE do not have
the capability of analyzing all non-platform images. For example,
ANALYZE/IMAGE cannot analyze I64 images on VAX or Alpha images on
older versions of VAX.
When you analyze I64 images on I64 platforms, ANALYZE/IMAGE
accepts VAX-only or Alpha-only qualifiers, but ignores any effect
of these qualifiers.
Depending on the platform, the ANALYZE/IMAGE command
distinguishes I64 images from VAX and ALpha images by examining
the meta information (e.g., ELF, EIHD, or IHD).
The ANALYZE/IMAGE command provides the following information for
image files:
o Image architecture and type - The OpenVMS platform and whether
the image is executable or shareable.
o Image name - The name of the image or shareable image.
o Image identification - The identification given in a link
operation.
o Creating linker identification - The linker that generated the
image.
o Link date and time - The date and time of the link operation.
o Image transfer addresses - The addresses to which control is
passed at image execution time.
o Image version - The revision level (major ID and minor ID) of
the image.
o Location and size of the image's symbol vector (Alpha and I64
only).
o List of required sharable images - The dependencies on
sharable images.
o Location of the debugger symbol table (DST)-Identifies the
location of the DST in the image file. DST information is
present only in executable images that have been linked with
the /DEBUG or the /TRACEBACK command qualifier. (VAX and Alpha
only.)
o Location and interpretation of the debug and traceback
information - The sections that contain the information and
formats the data (DWARF) (I64 only).
o Location of the global symbol table (GST)- The location of
the GST in the image file. GST information is present only in
shareable image files. (VAX and Alpha only.)
o Location of the global symbol table (.symtab) - The location
of the GST in the image file. GST informaton is present only
in sharable image files (I64 only.)
o Patch information-Indicates whether the image has been patched
(changed without having been recompiled or reassembled and
relinked). If a patch is present, the actual patch code can be
displayed. (VAX and Alpha only.)
o Image section descriptors (ISD)-Identify portions of the image
binary contents that are grouped in OpenVMS Cluster systems
according to their attributes. An ISD contains information
that the image activator needs when it initializes the address
space for an image. For example, an ISD tells whether the ISD
is shareable, whether it is readable or writable, whether it
is based or position independent, and how much memory should
be allocated. (VAX only.)
o Summary of internal tables - Lists the program segments and
sections of which the image consists. (I64 only.)
o Fixup vectors-Contain information that the image activator
needs to ensure the position independence of shareable image
references. (VAX and Alpha only.)
o Fixup information-Information that the image activator
needs to ensure the position independence of sharable image
references. (I64 only.)
o System version categories-For an image that is linked against
the executive (the system shareable image on I64 and Alpha or
the system symbol table on VAX), displays both the values of
the system version categories for which the image was linked
originally and the values for the system that is currently
running. You can use these values to identify changes in the
system since the image was linked last.
The ANALYZE/IMAGE command has command qualifiers and positional
qualifiers. For VAX and Alpha images, by default, if you do not
specify any positional qualifiers (for example, /GST or /HEADER),
the entire image is analyzed. If you do specify a positional
qualifier, the analysis excludes all other positional qualifiers
except the /HEADER qualifier (which is always enabled) and any
qualifier that you request explicitly.
The default behavior for analyzing ELF images differs from the
behavior for analyzing Alpha or VAX images. For ELF images,
a summary of the major ELF tables is displayed. With this
information, you can select specific segments and/or sections for
analysis. To locate errors, analyze the entire image by selecting
all sections and segments.