|
|
If multiple C source files were used to create the object file, list(CP) accepts multiple file names. The object file is taken to be the last non-C source file argument. If no object file is specified, the default object file, a.out, is used.
This utility operates only on COFF executables. Object files given to list must have been compiled with the -g option of cc(CP).
Line numbers are printed for each line marked as breakpoint inserted by the compiler (generally, each executable C statement that begins a new line of source). Line numbering begins anew for each function. Line 1 is always the line containing the left curly brace, {, that begins the function body. Line numbers are also supplied for inner block redeclarations of local variables so that they can be distinguished by the symbolic debugger.
The following options are interpreted by list and can be given in any order:
list: name: cannot open if it cannot read name.
If the source file names do not end in .c,
the message is list: name: invalid C source name.
An invalid object file causes the message
list: name: bad magic.
If some or all of the symbolic debugging information is missing,
one of the following messages is printed:
list: name: symbols have been stripped, cannot proceed
list: name: cannot read line numbers
list: name: not in symbol table
The following messages are produced when list
has become confused by #ifdef's in the source file:
list: name: cannot find function in symbol table
list: name: out of sync: too many }
list: name: unexpected end-of-file
The error message list: name: missing or inappropriate line numbers
means that either symbol debugging information is missing, or
list has been confused by C preprocessor statements.