GBS Logo HOME Generic Build Support (GBS) - User Manual
Customisations (User) Bottom Doc. Button

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

Description
Perl Directory (GBS_PERL_PATH)| gbssettings command| GBS Command Prompt Window (gbscmd.bat / .sh)

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

GBS has a few user customisation possibilities.
Most are set by the gbssettings command
Index

Perl Directory (GBS_PERL_PATH) Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Blank

Name:

GBS_PERL_PATH

Purpose:

Define an specific directory to find the Perl executable
To be used when (the wanted) perl is not in the PATH
Specifies the top-directory of the Perl installation (the directory containing 'bin')

Default:

Empty (Find Perl via PATH)

Where:

In Registry (Windows) My Computer → Properties → Advanced → Environment Variables
or ~/.profile or ~/.bash_profile

Define:

Linux
export GBS_PERL_PATH=your_perl_path
Windows
SET GBS_PERL_PATH=your_perl_path

gbssettings command Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

With the gbssettings command you can set/change:
  1. Change Profile Settings
    1. Basics:
    2. General
    3. Programs
    4. Terminal Settings
    5. Special
    6. Advanced
  2. Fix Startup Settings (Shortcuts)
  3. Switch GBS Version
  4. Change GBS_ROOT_PATH
  5. Move GBS_BASE_PATH

Site-ID

Basic
GBS_SITE

Purpose:

To identify the location where the user works
It is used in the switch.gbs to cater for different IT infrastructures (e.g. different locations of compilers, network drives, etc)
You will only really need it if people work from different site-locations on the same code.
A good name is an abbreviation of the town or site. Just make sure it is unique for the future.
Keep the name short and in uppercase. Consider using the 3-letter IATA Airport Code of a nearby airport.

Default:

MAIN

LogRoot

Basic
GBS_LOG_ROOT

Purpose:

To define the location of the logfile-directories per System
GBS_LOG_PATH=$GBS_LOG_ROOT/$GBS_SYSTEM_PARENT

Defaults:

Linux
~/GBSLogs
Windows
%MY_DOCUMENTS%\GBSLogs

Home

Basic
GBS_HOME_PATH

Purpose:

Set the CWD when no current System

Default:

Linux
~/
Windows
%MY_DOCUMENTS%

Beeps

General
GBS_BEEBS

Purpose:

To switch the 'beep' on the command-line on or off

Default:

YES

Notify

General
GBS_NOTIFY

Purpose:

To provide a different default for the --n (notify) option in the gbssys* functions

Default:

YES

Editor

Programs
GBS_EDITOR

Purpose:

Define a text-editor (for gbsedit and gbsmaint 9 ('Owners-file' Maintenance)

Defaults:

Linux
$EDITOR, gedit, nano, vim
Windows
Notepad

Browser

Programs
GBS_BROWSER

Purpose:

Define a HTML Browser (for gbshelp and gbsaudit)

Defaults:

Linux
Firefox, links2, links
Windows
Default HTML Browser (Internet Explorer)
Programs
GBS_NAVIGATOR

Purpose:

Define a program to navigate directory structure
Used by gbsgui

Defaults:

Linux
Default Navigator (Gnome Files)
Windows
Windows Explorer

Viewer

Programs
GBS_VIEWER

Purpose:

Define a text-viewer (for viewing batch log-files)

Defaults:

Linux
less
Windows
Notepad

Terminal

Terminal Settings
GBS_TERM

Purpose:

Define Terminal settings for when a new Terminal window is opened
You can set:

Default:

Linux
xterm/gnome-terminal white black 120 45
Windows
console white black 120 45

Administrator

Special
GBS_ADMINISTRATOR

Purpose:

Define/Remove the current user as Administrator for this System
Administrator privilege is required for all changes to the infrastructure. E.g.: create a new component.
It is just a token privilege. You will be warned every time you try to do a privileged action. You can always override.
This is a safety issue, warning you that you are changing something special for which you probably need permission of the System / Code Architect.

Default:

None

Integrator

Special
GBS_INTEGRATOR

Purpose:

Define/Remove the current user as Integrator for this System
Integrator privilege is required for the execution of some special functions ad defined in gbsmaint 6: It is just a token privilege. You will be warned every time you try to do a privileged action. You can always override.
This is a safety issue, warning you that you are doing something irreversible.

Default:

None

Switch GBS Version

Switch
GBS_REL

Purpose:

Make an other (installed) version of GBS the current GBS version.
GBS will be restarted.

Defaults:

Current

GBS Command Prompt Window (gbscmd.bat / .sh) Bottom Doc. Button Top Document Button Blank Up Section Button Blank Up Chapter Button

You can customize your GBS Command Prompt DOS-box/xterm by placing shell commands in a private startup file: 'gbscmd.bat / .sh' in your GBS_BASE_PATH directory:
Please note the following:
  1. It is only executed in Interactive sessions.
  2. Do not place any GBS-related items in this file.
  3. Placing any GBS-related items in this file may cause GBS to malfunction.
    If not today: probably in the future.

Generic Build Support (GBS) - User Manual - Customisations (User) Blank Top Document Button
custom_user.html
Copyright © Randy Marques of Randy Marques Consultancy - All rights reserved