B.2.91 -xinline=list (Sun Studio 12: C User's Guide)

Sun Studio 12: C User's Guide

B.2.91 `-xinline=list`

The format of the list for -xinline is as follows: [{%auto,func_name,no%func_name}[,{%auto,func_name,no%func_name}]...]

-xinline tries to inline only those functions specified in the optional list. The list is either empty, or comprised of a comma-separated list of func_name, no%func_name, or %auto, where func_name is a function name. -xinline only has an effect at -xO3 or higher.

Table B–24 The -xinline Flags


Flag	Meaning
`%auto`	Specifies that the compiler is to attempt to automatically inline all functions in the source file. `%auto` only takes effect at `-xO4` or higher optimization levels. `%auto` is silently ignored at `-xO3` or lower optimization levels.
`func_name`	Specifies that the compiler is to attempt to inline the named function.
`no%func_name`	Specifies that the compiler is not to inline the named function.

The list of values accumulates from left to right. So for a specification of -xinline=%auto,no%foo the compiler attempts to inline all functions except foo. For a specification of -xinline=%bar,%myfunc,no%bar the compiler only tries to inline myfunc.

When you compile with optimization set at -xO4 or above, the compiler normally tries to inline all references to functions defined in the source file. You can restrict the set of functions the compiler attempts to inline by specifying the -xinline option. If you specify only -xinline=, that is you do not name any functions or %auto, this indicates that none of the routines in the source files are to be inlined. If you specify a list of func_name and no%func_name without specifying %auto, the compiler only attempts to inline those functions specified in the list. If %auto is specified in the list of values with the -xinline option at optimization level set at -xO4 or above, the compiler attempts to inline all functions that are not explicitly excluded by no%func_name.

A function is not inlined if any of the following conditions apply. No warning is issued.

Optimization is less than -xO3.
The routine cannot be found.
Inlining the routine does not look practicable to the optimizer.
The source for the routine is not in the file being compiled (however, see -xcrossfile).

If you specify multiple -xinline options on the command line, they do not accumulate. The last -xinline on the command line specifies what functions the compiler attempts to inline.