addLinkFlags - Add link options to model build information

Syntax

addLinkFlags(buildinfo, options, groups)

groups is optional.

Arguments

buildinfo

Build information returned by RTW.BuildInfo.

options

A character array or cell array of character arrays that specifies the linker options to be added to the build information. The function adds each option to the end of a linker option vector. If you specify multiple options within a single character array, for example '-MD -Gy', the function adds the string to the vector as a single element. For example, if you add '-MD -Gy' and then '-T', the vector consists of two elements, as shown below.

'-MD -Gy'    '-T'

groups (optional)

A character array or cell array of character arrays that groups specified linker options. You can use groups to

Document the use of specific linker options
Retrieve or apply groups of linker options

You can apply

A single group name to one or more linker options
Multiple group names to collections of linker options (available for nonmakefile build environments only)

To... Specify groups as a...

Apply one group name to all linker options Character array.

Apply different group names to linker options Cell array of character arrays such that the number of group names matches the number of elements you specify for options.

To...	Specify `groups` as a...
Apply one group name to all linker options	Character array.
Apply different group names to linker options	Cell array of character arrays such that the number of group names matches the number of elements you specify for `options`.

Note To specify linker options to be used in the standard Simulink Coder makefile build process, specify groups as either 'OPTS' or 'OPT_OPTS'.

Description

The addLinkFlags function adds specified linker options to the model build information. The Simulink Coder software stores the linker options in a vector. The function adds options to the end of the vector based on the order in which you specify them.

In addition to the required buildinfo and options arguments, you can use an optional groups argument to group your options.

Examples

Add the linker -T option to build information myModelBuildInfo and place the option in the group OPTS.
```
myModelBuildInfo = RTW.BuildInfo;
addLinkFlags(myModelBuildInfo, '-T', 'OPTS');
```
Add the linker options -MD and -Gy to build information myModelBuildInfo and place the options in the group OPT_OPTS.
```
myModelBuildInfo = RTW.BuildInfo;
addLinkFlags(myModelBuildInfo, '-MD -Gy', 'OPT_OPTS');
```
For a nonmakefile build environment, add the linker options -MD, -Gy, and -T to build information myModelBuildInfo. Place the options -MD and-Gy in the group Debug and the option -T in the groupTemp.
```
myModelBuildInfo = RTW.BuildInfo;
addLinkFlags(myModelBuildInfo, {'-MD -Gy' '-T'}, ...
  {'Debug' 'Temp'});
```