sox, Qsox

Tells the compiler to save the compilation options and version number in the Linux* OS executable or the Windows* OS object file. It also lets you choose whether to include lists of certain functions.

IDE Equivalent

None

Architectures

IA-32, Intel® 64 architectures

Syntax

Linux:

-sox[=keyword[,keyword]]

-no-sox

Mac OS X:

None

Windows:

/Qsox[:keyword[,keyword]]

/Qsox-

Arguments

keyword

Is the function information to include. Possible values are:

inline	Includes a list of the functions that were compiled with -prof-use (Linux* OS) or /Qprof-use (Windows*) and for which the .dpi file had profile information, and an indication for each as to whether the profile information was USED (matched) or IGNORED (mismatched).
profile	Includes a list of the functions that were inlined in each object.

Default

-no-sox
or/Qsox-

The compiler does not save these informational strings in the executable or object file.

Description

This option tells the compiler to save the compilation options and version number in the Linux* OS executable or the Windows* OS object file. It also lets you choose whether to include lists of certain functions. The information is embedded as a string in each object file or assembly output.

If you specify -sox or /Qsox with no argument, the compiler saves the compiler options and version number used in the compilation of the objects that make up the executable.

If you specify this option on Linux systems, the size of the executable on disk is increased slightly. Each keyword you specify increases the size of the executable. When you link the object files into an executable file, the linker places each of the information strings into the header of the executable. It is then possible to use a tool, such as a strings utility, to determine what options were used to build the executable file.

If you specify this option on Windows systems, the information stays in the object file.

Alternate Options

None

Example

The following commands are equivalent on Linux* OS:

-sox=profile -sox=inline          ! Linux OS

-sox=profile,inline               ! Linux OS

The following commands are equivalent on Windows* OS:

/Qsox:profile /Qsox:inline        ! Windows OS

/Qsox:profile,inline              ! Windows OS

You can use the negative form of the option to disable and reset the option. For example:

-sox=profile -no-sox -sox=inline      ! This means -sox=inline on Linux OS

/Qsox:profile /Qsox- /Qsox:inline     ! This means /Qsox:inline on Windows OS

sox, Qsox

IDE Equivalent

Architectures

Syntax

Arguments

Default

Description

Alternate Options

Example

See Also