GBS Logo HELP HOME Generic Build Support (GBS) - User Manual
The site.gbs script file 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
Example of a site.gbs.bat

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

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

This file can be used instead of the 'Site' section in the switch.gbs(.bat/.sh) files.

As the Site section in all your switch.gbs(.bat/.sh) files contains the locations of all your plugins on your computer - hence contains the same info -, we can have the definitions in one central place - not inside a System.

The site.gbs script file is located in your $GBS_BASE_PATH directory and it is called by swr before the switch.gbs script file with entry parameter.

To edit the file: gbsedit site.gbs

Notes: Bottom Doc. Button Top Document Button Down Section Button Up Section Button Blank Up Chapter Button

Please note the following:
  1. Do not try to be 'clever' with these files.
  2. Placing any 'clever' stuff in these files may cause GBS to malfunction.
    If not today: definitely in the future.

Example of a site.gbs.bat: Bottom Doc. Button Top Document Button Down Section Button Up Section Button

Example of a site.gbs.bat: Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Blank

    
    @ECHO OFF
    ::================================================
    ::  File:     %FILE%
    ::  Path:     %PATH%
    ::================================================
    
    echo GBSSITE_: Setup GBS Development environment ***
    
    ::
    ::  The following settings define where the roots of your plugins are located on this PC
    ::  This file is called before the switch.gbs.bat
    ::  When you use this file there is no need for the 'ROOT' or 'SITE' section in the switch.gbs.bat file
    ::  Only GBSEXT_*_ROOT EnvVars in this file!
    ::
    
    ::
    ::  Version Control
    ::
    ::set GBSEXT_GIT_ROOT=C:\Program Files\Git
    
    ::set GBSEXT_SVN_ROOT=C:\Program Files\Subversion
    
    ::
    ::  Builds
    ::
    ::set GBSEXT_MSVS2012_ROOT=C:\Program Files (x86)\Microsoft Visual Studio 11.0
    ::set GBSEXT_MSVS2012_KIT_ROOT=C:\Program Files (x86)\Windows Kits
    ::set GBSEXT_MSBUILD_ROOT=C:\Windows\Microsoft.NET\Framework
    
    ::set GBSEXT_MINGW_ROOT=C:\MinGW
    
    ::
    ::  Audits
    ::
    ::set GBSEXT_QAC_ROOT=C:\MyPrograms\PRQA\QAC
    
    ::set GBSEXT_QACPP_ROOT=C:\MyPrograms\PRQA\QACPP
    
    ::set GBSEXT_PCLINT_ROOT=C:\MyPrograms\PC-Lint
    
    ::set GBSEXT_CPPTEST_ROOT=C:\MyPrograms\Parasoft\C++test
    
    ::
    ::  Tools
    ::
    ::set GBSEXT_DOXYGEN_ROOT=C:\MyPrograms\doxygen
    
    ::
    ::  My Settings
    ::
    ::  Place your stuff here...
    
    ::: EOF :::
    
    

Example of a site.gbs.sh: Bottom Doc. Button Top Document Button Blank Up Section Button Blank Up Chapter Button

    
    #!must_be_sourced
    #=================================================
    #   File:     %FILE%
    #   Path:     %PATH%
    #=================================================
    
    echo "GBSSITE_: Setup GBS Development environment ***"
    
    #
    #   The following settings define where the roots of your plugins are located on this PC
    #   This file is called before the switch.gbs.sh
    #   When you use this file there is no need for the 'ROOT' or 'SITE' section in the switch.gbs.sh file
    #   Only GBSEXT_*_ROOT EnvVars in this file!
    #
    
    #
    #   Version Control
    #
    #export GBSEXT_GIT_ROOT=/usr/lib/git-core
    
    #export GBSEXT_SVN_ROOT=/usr/lib/svn
    
    #
    #   Builds
    #
    #export GBSEXT_LGNU_CPP_ROOT=/usr/lib/gcc/x86_64-linux-gnu
    #export GBSEXT_LGNU_GCC_ROOT=/usr/lib/gcc/x86_64-linux-gnu
    
    #
    #   Audits
    #
    #export GBSEXT_QAC_ROOT=/apl/cadappl_linux_ia32/qac
    #export GBSEXT_QACPP_ROOT=/apl/cadappl_linux_ia32/qac++
    
    #
    #   Tools
    #
    
    #
    #   My Settings
    #
    #   Place your stuff here...
    
    
    ### EOF ###
    
    

site.html