LIST(1) (C Programming Language Utilities) LIST(1)
NAME
list - from a common object file produce a C source listing
with line numbers
SYNOPSIS
list [ -V ] [-h] [-F function] source file [ 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 the object file, list will accept
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, will be used.
Line numbers will be 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 number 1
is always the line containing the left curly brace ({) that
begins the function body. 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 executing.
-h Suppress heading output.
-Ffunction List only the named function. The -F option may
be specified multiple times on the command line.
SEE ALSO
as(1), cc(1), ld(1).
CAVEATS
Page 1 May 1989
LIST(1) (C Programming Language Utilities) LIST(1)
Object files given to list must have been compiled with the
-g option of cc(1).
Since list does not use the C preprocessor, it may be unable
to recognize function definitions whose syntax has been
distorted by the use of C preprocessor macro substitutions.
DIAGNOSTICS
If name cannot be read. list will produce the error message
list: name: cannot open
If the source file names do not end in .c , the message is
list: name: invalid C source name.
An invalid object file name will cause the message
list: name: bad magic
If any of the symbolic debugging information is missing, one
of the following messages will be 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 becomes
confused by #ifdefs 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.
When either symbol debugging information is missing, or list
has been confused by C preprocessor statements. it displays
the error message
list: name: missing or inappropriate line numbers
Page 2 May 1989