Restoring Symbols When an Instruments Trace Shows Only Addresses

Identify the location of a dSYM path manually when Instruments can’t locate it. When addresses, rather than symbols, are displayed in trace documents generated by the Instruments analysis tool, you can manually provide the missing information. The mapping of addresses to their symbols is contained in a dSYM file. Typically, Instruments finds dSYM files automatically, based on the locations that Spotlight indexes and the paths you specify in Instruments Preferences. However, you can point Instruments in the right direction when it can’t automatically find a dSYM. Once you do, Instruments can map addresses to their associated symbols and line number information.

To locate the dSYM path for a trace document
  1. Choose File > Symbols.

    This option appears only after running a trace or loading a previously saved trace.

  2. Select the executable (binary) or framework that is missing symbols.

  3. Click the Locate button; the “Select dSYM or containing folder” dialog opens.

  4. Select your symbol file or the containing folder.

  5. Click Open.

To correctly display symbols in trace documents, Instruments needs access to the specific symbol files that were generated when the executable you are testing was built. Therefore, you may need to manually locate a dSYM file when you build on one machine and test performance on another.

The filter bar in the Symbols dialog lets you filter by binary/framework or missing information, or you can search for a binary/framework by entering text into the search field.

Definitive Discussion