In bundle: saker.clang
Options configuration to be used with saker.clang.link().
The described options will be merged with the linker input configuration based on the option qualifiers. The Identifier field is used as qualifier for the option merging, in which case they are tested for mergeability with the input configuration.
Summary
BinaryName | Specifies the file name of the link output. |
Identifier | Specifies the Identifier to which the options should be merged into. |
LibraryPath | Specifies the library path that will be searched for libraries. |
LinkerInput | Specifies one or more inputs for the link operation. |
SDKs | Specifies the SDKs (Software Development Kits) used by the task. |
SimpleLinkerParameters | Specifies one or more arguments that should be directly passed to the clang. |
Fields
Specifies the file name of the link output.
The specified string will be used as the name of the generated executable or library. An extension is not appended to the binary name automatically.
If not specified, the file name will be generated based on the compilation Identifier.
Specifies the Identifier to which the options should be merged into.
The associated options will only be merged into the target configuration if the target Identifier contains all parts as this Identifier. If no Identifier specified for this options, the Identifier is not considered as a qualifier.
Collection of CompilationPathTaskOption
Specifies the library path that will be searched for libraries.
The values may be simple paths, wildcards, file locations, file collections, or SDK paths.
The link task doesn't specify any library paths by default.
Corresponds to the -L command line option for clang.
Collection of LinkerInputPassTaskOption
Specifies one or more inputs for the link operation.
The inputs may be either simple paths, wildcards, file locations, file collections or task output from saker.clang.compile().
Map of SDKName : SDKDescriptionTaskOption
Specifies the SDKs (Software Development Kits) used by the task.
SDKs represent development kits that are available in the build environment and to the task. SDKs are used to determine the appropriate build environment to execute the task, as well to resolve paths against them (e.g. IncludeDirectory, LibraryPath).
The "Clang" SDK is used to determine the location of the clang executable. If it is not specified, then the task will attempt to determine it automatically.
When merging, duplicate SDK definitions are not overwritten.
Collection of ClangSimpleParameter
Specifies one or more arguments that should be directly passed to the clang.
Any arguments specified will be appended to the clang invocation for the inputs. Take care when using this option as specifying files here may result in incorrect incremental builds.
The order of the specified arguments are kept.
When merging, duplicate parameters are removed automatically.