-mxcoff-build-id

Purpose

Allows you to embed a hexadecimal ID in your binary file, which will be saved as an ASCII string at the beginning of the string table in the loader section of the XCOFF file. The ID is readable by the profile runtime to match the binary file to profile files.

Syntax

Read syntax diagramSkip visual syntax diagram-mxcoff-build-id=0xHEXSTRING

Defaults

None

Usage

0xHEXSTRING is a unique ID to identify the binary file. This option passes -bdbg:ldrinfo:xcoff_binary_id:0xhexstring to the linker.

Be aware of the following rules when you specify 0xHEXSTRING:
  • You can input a readable string as the build ID in 0xHEXSTRING, which allows hexadecimal characters, colons, and commas. The compiler will ignore colons and commas, and convert the rest of 0xHEXSTRING to lowercase.
  • The length of 0xHEXSTRING is arbitrary, but it must be even. If an odd number of digits is specified, add a 0 on the left to make it even.
  • -mxcoff-build-id=0x is equivalent to -mxcoff-build-id=0x00.