# IPO for Large Programs

In most cases, IPO generates a single true object file for the link-time compilation. This behavior is not optimal for very large programs, perhaps even making it impossible to use [Q]ipo compiler option on the application.

The compiler provides two methods to avoid this problem. The first method is an automatic size-based heuristic, which causes the compiler to generate multiple true object files for large link-time compilations. The second method is to manually instruct the compiler to perform multi-object IPO.

- Use the [Q]ipo N compiler option and pass an integer value in the place of N.

Regardless of the method used, it is best to use the compiler defaults first and examine the results. If the defaults do not provide the desired results then experiment with generating a different number of object files.

## Using [Q]ipo N to Create Multiple Object Files

If you specify [Q]ipo0, which is the same as not specifying a value, the compiler uses heuristics to determine whether to create one or more object files based on the expected size of the application. The compiler generates one object file for small applications, and two or more object files for large applications. If you specify any value greater than 0, the compiler generates that number of object files, unless the value you pass a value that exceeds the number of source files. In that case, the compiler creates one object file for each source file then stops generating object files.

The following example commands demonstrate how to use [Q]ipo2 option to compile large programs.

Operating System | Example Command
--- | ---
Windows* | `dpcpp-cl /Qipo2 /c a.cpp b.cpp`
Linux* | `dpcpp -ipo2 -c a.cpp b.cpp`

In executing the above commands, the compiler generates object files using an OS-dependent naming convention. On Linux*, the example command results in object files named ipo_out.o, ipo_out1.o, and ipo_out2.o. On Windows*, the file names follow the same convention; however, the file extensions will be .obj.

Link the resulting object files as shown in Using IPO.

Parent topic: Interprocedural Optimization (IPO)

## See Also

ipo, Qipo compiler option