Output Listings and Error Handling
eld Manual—527255-009
6-3
General Information
In those cases where the default would be -
verbose
, the listing always begins with
banner information. In other cases, there is banner information at the top of the output
file if -
verbose
is explicitly specified or if any messages need to be written. The
banner information includes the following items:
•
the name of
eld
itself (i.e., as provided to it by the argv [0] string)
•
information that tells when this version of
eld
was built
•
a copyright statement
•
a statement about the GNU license, as required by that license
However, this banner information is omitted if either the -
vslisting
or -
no_banner
option is given. If
eld
encounters a fatal error while processing the command line
then these options need to be earlier on the command line in order to have an effect.
The purpose of the -
vslisting
option is to guarantee that the format of the
eld
listing satisfies the requirements of ETK, the Enterprise Tool Kit, as explained below.
This is a tool that causes
eld
to be invoked and also specifies the
-vslisting
option.
The purpose of the -
no_banner
option is for c89 or c99 to use it at least in cases
where
eld
is in a directory that has a space in its name. In such a case, c89 or c99
does not need to set up argv [0] correctly for
eld
. Instead, c89 or c99 itself may print
out the correct name of
eld
and use the -
no_banner
option to stop
eld
from printing
out the incorrect string that c89 or c99 passed to it.
The next thing in the listing is a copy of the command line, without -
obey
options
expanded.
After that come all the messages in the four categories shown above.
If the listing is not otherwise empty then it concludes with summary information. The
first summary line tells whether the link succeeded and what type of file was created or
updated. The next summary line tells the date when the file was created,
corresponding to the tim_dat fi
eld
of the .tandem_info section.
After that there are counts of the number of errors, number of warnings, and number of
informational messages. This also tells how many warning and informational
messages were suppressed if the mode is not -
verbose
. It also tells the elapsed
time. This portion of the listing is omitted if the -
vslisting
option is given.
Each message that
eld
writes to the listing file occupies some number of lines. The
first line of the message does not begin with white space, while subsequent lines of a
message begin with three blanks. The first line of a numbered message has the
format:
**** <type> **** [number]:
where <type> is one of "FATAL ERROR", "ERROR", "WARNING", or
"INFORMATIONAL MESSAGE". When a message needs to extend over several lines,
Summary of Contents for eld
Page 4: ......
Page 8: ...Contents eld Manual 527255 009 iv ...
Page 12: ...What s New in This Manual eld Manual 527255 009 viii Changes to the 527255 005 Manual ...
Page 34: ...Introduction to eld eld Manual 527255 009 1 14 Example of Use ...
Page 54: ...eld Input and Output eld Manual 527255 009 2 20 Using Archives ...
Page 98: ...Other eld Processing eld Manual 527255 009 4 20 Merging Source RTDUs ...
Page 242: ...Output Listings and Error Handling eld Manual 527255 009 6 132 Glossary of Errors ...