Skip to main content

incrementallink

Controls whether incremental linking is enabled for a configuration.

incrementallink ("value")

Incremental linking can improve iteration times during development by only relinking the portions of the binary that have changed. However, it may prevent some optimizations and is typically disabled for release builds.

Parameters

value specifies the incremental linking setting:

ValueDescription
DefaultUse the default incremental linking behavior. Incremental linking is enabled for debug builds and disabled for optimized builds, static libraries, and when link-time optimization is enabled.
OnForce incremental linking to be enabled.
OffForce incremental linking to be disabled.

Applies To

The config scope.

Availability

Premake 5.0-beta8 or later.

Examples

Force incremental linking off for all configurations:

filter "configurations:*"
incrementallink "Off"

Enable incremental linking even in release builds:

filter "configurations:Release"
incrementallink "On"

See Also