12.3. c29ofd - Object File Display Utility

The object file display utility, c29ofd, can be used to print the contents of object files, executable files, and/or archive libraries in both text and XML formats.

12.3.1. Usage

c29ofd [options] filename

  • c29ofd - is the command used to invoke the object file display utility.

  • options - affect the behavior of c29ofd.

  • filename - identifies an ELF input object file to be read by c29ofd. If an archive file is specified as an input file, then c29ofd processes each object file member of the archive as if it was passed on the command line. The object files are processed in the order in which they appear in the archive file.

If the -o option is not used to identify a file to write the c29ofd output into, then the output is written to stdout.

Note

Object File Display Format

The object file display utility produces data in a text format by default. This data is not intended to be used as input to programs for further processing of the information. Use the -x option to generate output in XML format that is appropriate for mechanical processing.

12.3.2. Options

--call_graph, -cg

Print function stack usage and callee information in XML format. While the XML output may be accessed by a developer, the function stack usage and callee information XML output was designed to be used by tools such as Code Composer Studio to display an application’s worst case stack usage. See Stack Usage View in CCS for more information.

Note

This feature requires that source code be built with debug enabled.

--diag_wrap[=on|off]

Wrap diagnostic messages in the output display. This option is enabled by default.

--dwarf, -g

Append DWARF debug information to the c29ofd output.

--dwarf_display=<attr1>[,<attr2>, ...]

The DWARF display settings can be controlled by specifying a comma-separated list of one or more <attrN> arguments. A list of the available <attrN> values that can be specified are displayed if you invoke c29ofd with the --dwarf_display=help option.

For the following <attrN> values, when prefixed with the word no, the specified attribute is disabled:

  • dabbrev - display .debug_abbrev section information (on by default)

  • daranges - display .debug_aranges section information (on by default)

  • dframe - display .debug_frame section information (on by default)

  • dinfo - display .debug_info section information (on by default)

  • dline - display .debug_line section information (on by default)

  • dloc - display .debug_loc section information (on by default)

  • dmacinfo - display .debug_macinfo section information (on by default)

  • dpubnames - display .debug_pubnames section information (on by default)

  • dpubtypes - display .debug_pubtypes section information (on by default)

  • dranges - display .debug_ranges section information (on by default)

  • dstr - display .debug_str section information (on by default)

  • dtypes - display .debug_types section information (on by default)

  • regtable - display register table information (on by default)

  • types - display type information (on by default)

The following attribute values can be used to help manage the overall state of the DWARF display attributes:

  • all - enable all attributes

  • none - disable all attributes

Examples

In this example, the dabbrev attribute is enabled and the daranges attribute is disabled:

--dwarf_display=dabbrev,nodaranges

In this example, all of the DWARF debug display attributes are enabled except for the dabbrev attribute:

--dwarf_display=all,nodabbrev

In this example, all DWARF debug attributes are disabled except for the daranges attribute:

--dwarf_display=none,daranges
--dynamic_info

Display dynamic linking information.

--emit_warnings_as_errors, -pdew

Treat warnings as errors.

--func_info

Display function information.

--help, -h

Display summary of c29ofd usage and options information.

--obj_display=<attr1>[,<attr2>, ...]

The object file display settings can be controlled by specifying a comma-separated list of one or more <attrN> arguments. A list of the available <attrN> values that can be specified are displayed if you invoke c29ofd with the --obj_display=help option.

For the following <attrN> values, when prefixed with the word no, the specified attribute is disabled:

  • battrs - display information about build attributes (on by default)

  • dynamic - display .dynamic section information (on by default)

  • groups - display information about ELF groups (on by default)

  • header - display file header information (on by default)

  • rawdata - display section raw data (off by default)

  • relocs - display information about relocation entries (on by default)

  • sections - display section information (on by default)

  • segments - display information about ELF segments (on by default)

  • strings - display string table information (on by default)

  • symbols - display symbol table information (on by default)

  • symhash - display information about ELF symbol hash table (on by default)

  • symver - display symbol version information (on by default)

The following attribute values can be used to help manage the overall state of the object file display attributes:

  • all - enable all attributes

  • none - disable all attributes

Examples

In this example, the battrs attribute is enabled and the dynamic attribute is disabled:

--obj_display=battrs,nodynamic

In this example, all of the object file display attributes are enabled except for the battrs attribute:

--obj_display=all,nobattrs

In this example, all object file display attributes are disabled except for the symbols attribute:

--obj_display=none,symbols
--output=<file>, -o=<file>

Write c29ofd output to specified <file>.

--verbose, -v

Print verbose text output.

--xml, -x

Display output in XML format.

--xml_indent=<N>

Set the number of spaces, <N>, to indent nested XML tags.

12.3.3. Exit Status

c29ofd returns 1 if the command is omitted or is invalid, if it cannot read input files, or if there is a mismatch between their data.