GBS Logo HELP HOME Generic Build Support (GBS) - User Manual
Customisations (Session) Bottom Doc. Button
Release RMC-06.02
(2024-04-29)


- Home
Getting Started
- Quick Start
- Release Notes
- Install Notes
- Create a GBS-WA/System
- FAQ
- Terms and Conditions (The Fine Print)
Basics
- Definitions & Acronyms
- Introduction
- Top Level Directory Structure
- Full Directory Structure
- Handling SubSystems & Steps
- Procedures
- Software Configuration Management Support

Manual Pages
- The Command-Line Interface
- All Commands
- The gbssys... Commands
- Generating Code (Building)
- Libraries & Executables and Testing
- Exporting Deliverables
- Auditing
- Customisations (Session)
- Customisations (User)
- Customisations (Admin)
- Integration with other Tools
- Plugins (Admin)
- Environment Variables (EnvVars)
User Files
- The GLKBT (glk/glb/glt) Files
Internal (.gbs) Files
- GBS Files - General
- audit.gbs
- broadcast.gbs
- build.gbs
- export.gbs
- flags_*.gbs
- subsys.gbs (.bat/.sh)
- incs_*.gbs
- owners.gbs
- sca_*.gbs
- scope.gbs
- site.gbs (.bat/.sh)
- steps.gbs
- switch.gbs (.bat/.sh)
- system.gbs
- tool.gbs
Various
- Development
- About
- Metrics Help

Full Documentation
- All Docs - Printable


Contents Bottom Doc. Button Top Document Button Down Section Button Blank

Description

Description Bottom Doc. Button Top Document Button Down Section Button Up Section Button

These customisations give (extra) control over the gbsaudit, gbsbuild and gbsmake commands (and to some extent: gbssystool).
The following EnvVars can be set: There are 4 levels of session-control:
  • Permanent
    Place the EnvVar in site.gbs(.sh|.bat)
    GBS_APP_anyname only.
  • System Place the EnvVar in switch.gbs(.sh|.bat)
    GBS_APP_anyname only.
  • Command-line Set the EnvVar on the Command-line
    E.g.: set GBS_FLAGS_C=-x
  • Command Add the EnvVar in the command
    You may leave out the leading 'GBS_'
    E.g.: gbsbuild *.c APP_TEST=yes
All settings override in the order above except GBS_FLAGS_type, which is added.

GBS_DEBUGGER Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Blank

Name:

GBS_DEBUGGER

Purpose:

To predefine the GBS_DEBUGGER (include debugging information) setting during a session

Possible Values:

YES NO

Define:

Linux
export GBS_DEBUGGER=value
Windows
SET GBS_DEBUGGER=value

GBS_MAP Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

Name:

GBS_MAP

Purpose:

To predefine the GBS_MAP (generate memory-map) setting during a session

Possible Values:

YES NO

Define:

Linux
export GBS_MAP=value
Windows
SET GBS_MAP=value

GBS_MODE Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

Name:

GBS_MODE

Purpose:

To predefine the GBS_MODE settings during a session

Possible Values:

FINAL ASSERT DEBUG PROFILING

Define:

Linux
export GBS_MODE=value
Windows
SET GBS_MODE=value

GBS_OPT Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

Name:

GBS_OPT

Purpose:

To predefine the GBS_OPT (optimisation) settings during a session

Possible Values:

YES SPEED SIZE DEBUG NO

Define:

Linux
export GBS_OPT=value
Windows
SET GBS_OPT=value

GBS_FLAGS_type Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

Name:

GBS_FLAGS_type

Purpose:

To predefine flags (-options) for a specific type (E.g.: .c or .glk).
Specify the type without the '.' (dot)

Possible Values:

Depend on builder / audit

Define:

Linux
export GBS_FLAGS_type_without_dot=values
Windows
SET GBS_FLAGS_type_without_dot=values

GBS_APP_anyname Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

Name:

GBS_APP_anyname

Purpose:

To define an EnvVar that is used by a specific Application (audit, build or tool) to change its behaviour, not defined by FLAGs.

Possible Values:

Anything valid in the SHELL and of interest of the called Application, except GBS_APP_PATH.
GBS_APP_PATH is used for the 'app' directory in non-GBS SubSystems

Define:

Linux
export GBS_APP_anyname=value
Windows
SET GBS_APP_anyname=value

custom_session.html