HOME
Generic Build Support (GBS) - User Manual
Generating Code
Contents
Description
Description
The difference between GBSGEN and GBSMAKE
- You specify the source (e.g. file.c)
- Only the specified file(s) will be generated
- All the specified files will be generated
- You specify the resulting file (e.g. file.o), Component-name or 'all'
- Other files (even in other Components) may be generated
- Specified files may or may not be (re-)generated
Specifying Files in GBSGEN, GBSMAKE and GBSAUDIT
Syntax
The generic syntax to specify files in GBSGEN, GBSMAKE and GBSAUDIT is:
[options1]... [ [[Component:][file]... [options2] ]...
The string is parsed left-to-right, setting the 'current-Component' as specified with Component:
Both Component and file may contain wild-cards.
file may be a comma-list, binding it to a possibly prefixed Component
- e.g.: gbsbuild *_test:*.c
- Will generate all *.c files in all Components suffixed with '_test'
- e.g.: gbsbuild *_test:*.c,*.cpp main: *.glk *.glb
- Will generate all *.c and *.cpp files in all Components suffixed with '_test' then
all *.glk in 'main' and then all *.glb in 'main'.
- e.g.: gbsbuild *:*.*
- Will generate all files in all Components (within the SubSystem), in the proper order.
For this particular purpose however you should use gbssysbuild SubSystem.
options1 if present, will be passed to all file-generations
options2 if present, will be passed to all file-generations preceding the options2
options1 if present, will be passed to 'make'
options2 cannot be present in gbsmake.
Use the GBS_FLAGS_type to specify options with gbsmake.
Typical use of GBSGEN:
gbsbuild my_file.c -DTEST comp1.c comp2:test.c -DTEST2
This results in:
- Compile my_file.c in the current Component with options -DTEST
- Compile comp1.c in the current Component
- Compile test.c in Component comp2 with options -DTEST2
Specifying FLAGS (-D)
There are predefined FLAGS for Debug-Mode, Debugger, Optimizer and Map-files
- Do not specify -G but DEBUGGER=YES
- Do not specify -DDEBUG but MODE=DEBUG
More information here.
Full list:
- MODE = FINAL | ASSERT | DEBUG
- DEBUGGER = NO | YES
- OPT = YES | SPEED | SIZE | DEBUG | NO
- MAP = YES | NO
Flags will be placed behind the generation scripts own flags in the following order
- (generation-scripts own flags)
- Flags in $GBS_BUILD_PATH/flags_type.gbs
- Flags in $GBS_BUILD_PATH/$GBS_BUILD/flags_type.gbs
- Flags in $GBS_COMPONENT_OPT_PATH/flags_type.gbs
- Flags in $GBS_COMPONENT_OPT_PATH/$GBS_BUILD/flags_type.gbs
- Flags in Env. variable GBS_FLAGS_TYPE (either pre-set or on command-line)
- Flags in GBS Command-line
Specifying Derived Filetypes (.o)
For 'make', GLKBT,
gbsexport and script files a platform/tool independent notation is used.
For each src-type (e.g.: .c) an EnvVar is defined containing the derived filetype (e.g: .o).
The syntax is GBS_BLD_src-type
They are set by the gbsswb command.
Expamples:
file1$GBS_BLD_C → file1.o or file1.obj
file2$GBS_BLD_ASM → file2.o or file2.obj
file3$GBS_BLD_GLB → file3.a or file3.lib
Specifying Search Paths (for -I and -L)
Include Paths are passed to the generation scripts in the following order
- ../loc
- ../inc
- ../bld/$GBS_BUILD (Only for glkbt builds)
- as specified in $GBS_COMPONENT_PATH/scope.gbs:
Component/inc or
Component/inc and Component/bld/$GBS_BUILD
- as specified in $GBS_COMPONENT_OPT_PATH/$GBS_BUILD/incs_type.gbs
- as specified in $GBS_COMPONENT_OPT_PATH/incs_type.gbs
- as specified in $GBS_BUILD_PATH/incs_TYPE.gbs
- as specified in $GBS_BUILD_PATH/$GBS_BUILD/incs_TYPE.gbs
- as specified in $GBS_SYSBUILD_PATH/incs_TYPE.gbs
- as specified in $GBS_SYSBUILD_PATH/$GBS_BUILD/incs_TYPE.gbs
- as specified in the generation-script
Note that the contents of the incs_TYPE.gbs files must refer to directories outside the current (Sub)System.
Do not prefix directories (with -I or -L)
generating_code.html
Copyright © Randy Marques of Randy Marques Consultancy - All rights reserved