app config - 2021.2 English

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)

Document ID
UG1400
ft:locale
English (United States)
Release Date
2021-12-15
Version
2021.2 English

Configure C/C++ build settings of the application

Syntax

Configure C/C++ build settings for the specified application. The following settings can be configured for applications.

assembler-flags
Miscellaneous flags for assembler.
build-config
Get/set build configuration.
compiler-misc
Compiler miscellaneous flags.
compiler-optimization
Optimization level.
define-compiler-symbols
Define symbols (for example, MYSYMBOL).
include-path
Include path for header files.
libraries
Libraries to be added while linking.
library-search-path
Search path for the libraries added.
linker-misc
Linker miscellaneous flags.
linker-script
Linker script for linking.
undef-compiler-symbols
Undefine symbols (for example, MYSYMBOL).
app config -name <app-name> <param-name>

Get the value of configuration parameter <param-name> for the application specified by <app-name>.

app config [OPTIONS] -name <app-name> <param-name> <value>

Set/modify/remove the value of configuration parameter <param-name> for the application specified by <app-name>.

Options

Option Description
-name Name of the application.
-set Set the configuration parameter value to new <value>.
-get Get the configuration parameter value.
-add Append the new <value> to configuration parameter value. Add option is not supported for ,compiler-optimization
-info Displays more information like possible values and possible operations about the configuration parameter. A parameter name must be specified when this option is used.
-remove Remove <value> from the configuration parameter value. Remove option is not supported for assembler-flags, build-config, compiler-misc, compiler-optimization, linker-misc and linker-script.

Returns

Depends on the arguments specified. <none> List of parameters available for configuration and description of each parameter.

<parameter name>: Parameter value, or error, if unsupported parameter is specified.

<parameter name> <paramater value>: Nothing if the value is set successfully, or error, if unsupported parameter is specified.

Example(s)

app config -name test build-config

Return the current build configuration for the application named test.

app config -name test define-compiler-symbols FSBL_DEBUG_INFO

Add -DFSBL_DEBUG_INFO to the compiler options, while building the test application.

app config -name test -remove define-compiler-symbols FSBL_DEBUG_INFO

Remove -DFSBL_DEBUG_INFO from the compiler options, while building the test application.

app config -name test -set compiler-misc {-c -fmessage-length=0 -MT"$@"}

Set {-c -fmessage-length=0 -MT"$@"} as compiler miscellaneous flags for the test application.

app config -name test -append compiler-misc {-pg}

Add {-pg} to compiler miscellaneous flags for the test application.

app config -name test -info compiler-optimization

Display more information about possible values and default values for compiler optimization level.