HP eld Manual page 113

Output Listings and Error Handling
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 field 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,
eld Manual—527255-009
6-3
General Information