list(1)
_________________________________________________________________
list Command
produce C source listing from an object or executable file
_________________________________________________________________
SYNTAX
list [ -V ] [-h] [-F function] source-file . . . [object-file]
DESCRIPTION
The list command produces a C source listing with line number
information attached. If multiple C source files were used to
create an executable file, list will accept multiple source file
names. The object file is taken to be the last non-C source file
argument. If no object file is specified, the default executable
file, a.out, will be used.
Line numbers will be printed for each line marked as a potential
breakpoint by the compiler (generally, each executable C
statement that begins anew line of source). Line numbering
begins anew for each source file. Line numbers will also be
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 may be given in
any order:
-V Print, on standard error, the version number of the
list command being executed.
-h Suppress heading output.
-F function List only the named function. The -F option may be
specified multiple times on the command line.
SEE ALSO
cc(1), ls(1), dbx(1), mxdb(1), pld(1).
WARNINGS
Object and executable files given to list must have been compiled
with the -g option of cc(1).
Since plist does not use the C preprocessor, it may be unable to
recognize function definitions whose syntax has been distorted by
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
list(1)
the use of C preprocessor macro substitutions.
DIAGNOSTICS
List produces the following error messages:
``list: name: cannot open''
Name cannot be read.
``list: name: invalid C source name''.
The source file name does not end in .c.
``list: name: bad magic''
The object file name is invalid.
``list: name: symbols have been stripped, cannot proceed''
All of the symbolic debugging information is missing from
object file name.
``list: name: cannot read line numbers''
Some or all of the line number information is missing from
object file name.
``list: name: not in symbol table''.
Some of the symbolic debugging information is missing from
object file name.
``list: name: cannot find function in symbol table'',
List cannot locate name either because symbolic debugging
information is missing or because of preprocessor statements
in the source.
``list: name: out of sync: too many }''
List has become confused by preprocessor statements in the
source.
``list: name: unexpected end-of-file''
List has reached the end of file name before it expected to,
either because the file has been truncated or because list
has become confused by preprocessor statements in the
source.
``list: name: missing or inappropriate line numbers''
Line number information is missing or list has become
confused by preprocessor statements in the source.
CAVEATS
In COFF-based systems, line numbering begins anew for each
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
list(1)
function, while on the DG/UX system, line numbering begins anew
for each source file.
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)