![]() | Generic Build Support (GBS) - User Manual | HOME | |
All Commands |
|
command --h | will give you short help | ||
command --h option... | will give you short help on the specified option(s) | ||
command --help | will give you more extensive help | ||
command --help option... | will give you long help on the specified option(s) | ||
--inc file | will take the contents of file file as if it were typed on the commandline. Empty lines and lines starting with '#' are ignored. Multiple occurrence and nesting is allowed. |
agrep
,
bgpids
,
detab
,
egrep
,
filerep
,
fixeol
,
gbs
,
gbsaudit
,
gbsbldaudit
,
gbsedit
,
gbsexit
,
gbsexport
,
gbsgen
,
gbshelp
,
gbsinit
,
gbslocate
,
gbsmaint
,
gbsmake
,
gbsmakemake
,
gbsman
,
gbsscm
,
gbssetup
,
gbsshow
,
gbssilo
,
gbsstart
,
gbsstats
,
gbsswc
,
gbsswr
,
gbssws
,
gbsswt
,
gbssysaudit
,
gbssysgen
,
gbssysmake
,
gbswhich
,
gbsxref
,
grep
,
proto
,
swc
,
swr
,
sws
,
swt
,
tail
,
touch
,
win2unix
,
wordrep
![]() | ![]() |
bgpids [ USERS ]...
- [ -a | -a+ | -a- ]
- [ -f | -f+ | -f- ]
- [ -k=process_to_kill ]
USERS
| string array optional | <empty> == current user Default= |
-a[+|-]
| do_all boolean scalar optional | Include all processes Default=0 |
-f[+|-]
| do_fg boolean scalar optional | Include parent (foreground) processes Default=0 |
-k=process_to_kill
| integer scalar optional | Kill specified process-tree Default= |
![]() | ![]() |
fixeol files...
files
| string array mandatory | Files to process Default= |
![]() | ![]() |
![]() | ![]() |
gbsinit
- [ --rel=rel ]
- [ --noroot | --noroot+ | --noroot- ]
--rel=rel
| string scalar optional | Specific GBS release Default=. |
--noroot[+|-]
| noroot boolean scalar optional | Do not implicitly swr to current root Default=0 |
![]() | ![]() |
gbsaudit
- [ Environment_Variable=Value ]...
(GBS_) LOG_PATH | (GBS_) MODE | (GBS_) FLAGS_* |
(GBS_) APP_* |
![]() | ![]() |
gbsbldaudit [ subsystems ]...
- [ --m=max_missing ]
- [ --targets=targets,... ]...
subsystems
| string array optional | Specific SubSystems Default= |
--m=max_missing
| integer scalar optional | Cancel after this many missing files Default=50 |
--targets=targets
| string array optional | (wild-)Targets to Build-Audit. '' or '*' == All, '.' == Current Default= |
![]() | ![]() |
gbsedit file [ editor_opt ]
- [ --nco | --nco+ | --nco- ]
file
| string scalar mandatory | [[[subsys:]component:]subdir:[<subpath>/]]file Default= |
editor_opt
| string scalar optional | Editor option. e.g. Line-nr to jump to Default= |
--nco[+|-]
| no_checkout boolean scalar optional | .usr files will always be forced to no_checkout Default=0 |
![]() | ![]() |
gbsexit
![]() | ![]() |
gbsexport [ export_file_locations ]...
- [ --i | --i+ | --i- ]
- [ --c | --c+ | --c- ]
- [ --verbose | --verbose+ | --verbose- ]
- [ --target=target ]
- [ Environment_Variable=Value ]...
export_file_locations
| string array optional | <Component>... and/or GEN: or SUB: . == Current Component. <empty> == <all> Default= |
--i[+|-]
| ignore_errors boolean scalar optional | Continue generation after error(s) Default=0 |
--c[+|-]
| cleanup_all boolean scalar optional | Delete all, independent from target Default=0 |
--verbose[+|-]
| verbose boolean scalar optional | Extensive messaging Default=0 |
--target=target
| string scalar optional choice: $GBS_TARGETS | Target Default=$GBS_TARGET |
(GBS_) APP_* |
![]() | ![]() |
gbsgen comp_file_opts...
- [ --i | --i+ | --i- ]
- [ --export | --export+ | --export- ]
- [ --mm | --mm+ | --mm- ]
- [ --jobs=jobs ]
- [ Environment_Variable=Value ]...
comp_file_opts
| string array mandatory | src files to generate with 'generate' options Default= |
--i[+|-]
| ignore_errors boolean scalar optional | Continue generation regardless of error(s) Default=0 |
--export[+|-]
| run_gbsexport boolean scalar optional | Run 'gbsexport' on completion Default=0 |
--mm[+|-]
| run_makemake boolean scalar optional | Run 'makemake' on completion Default=0 |
--jobs=jobs
| integer scalar optional range 1..9 | Max nr parallel jobs Default=2 |
(GBS_) DEBUGGER | (GBS_) MODE | (GBS_) OPT |
(GBS_) MAP | (GBS_) FLAGS_* | (GBS_) APP_* |
![]() | ![]() |
gbshelp
![]() | ![]() |
gbslocate env_name file prefix path-list...
env_name
| string scalar mandatory | Env Variable to contain the filespec Default= |
file
| string scalar mandatory | The file to search Default= |
prefix
| string scalar mandatory | prefix string preceding all path-list elements. e.g: -I Default= |
path-list
| string array mandatory | The directories to search preceded by <prefix> Default= |
![]() | ![]() |
gbsmaint [ menu_entry_1 ] [ menu_entry_2 ] [ menu_entry_3 ] [ menu_entry_4 ] [ menu_entry_5 ]
menu_entry_1
| integer scalar optional range 1..9 | Primary menu entry for single immediate execution Default=0 |
menu_entry_2
| integer scalar optional greater 0 | Secondary menu entry for single immediate execution Default=0 |
menu_entry_3
| integer scalar optional greater 0 | 3rd menu entry for single immediate execution Default=0 |
menu_entry_4
| integer scalar optional greater 0 | 4th menu entry for single immediate execution Default=0 |
menu_entry_5
| integer scalar optional greater 0 | 5th menu entry for single immediate execution Default=0 |
![]() | ![]() |
gbsmake [ comp_file_opts ]...
- [ --r | --r+ | --r- ]
- [ --i | --i+ | --i- ]
- [ --smm | --smm+ | --smm- ]
- [ --export | --export+ | --export- ]
- [ --mm | --mm+ | --mm- ]
- [ --jobs=jobs ]
- [ Environment_Variable=Value ]...
comp_file_opts
| string array optional | bld files to make with 'make' options Default= |
--r[+|-]
| reverse_type boolean scalar optional | Specify source-types instead of build-types Default=0 |
--i[+|-]
| ignore_errors boolean scalar optional | Continue generation after error(s) Default=0 |
--smm[+|-]
| start_makemake boolean scalar optional | Pre-generate the make-file Default=0 |
--export[+|-]
| run_gbsexport boolean scalar optional | Run 'gbsexport' on completion Default=0 |
--mm[+|-]
| run_makemake boolean scalar optional | Run 'makemake' on completion Default=0 |
--jobs=jobs
| integer scalar optional range 1..9 | Max nr parallel jobs Default=2 |
(GBS_) DEBUGGER | (GBS_) MODE | (GBS_) OPT |
(GBS_) MAP | (GBS_) FLAGS_* | (GBS_) APP_* |
![]() | ![]() |
gbsmakemake [ components ]...
- [ --i | --i+ | --i- ]
- [ --target=target ]
components
| string array optional | . == current component, <empty> == all Default= |
--i[+|-]
| ignore_errors boolean scalar optional | Continue generation after error(s) Default=0 |
--target=target
| string scalar optional choice: $GBS_TARGETS | Target Default=$GBS_TARGET |
![]() | ![]() |
gbsman
![]() | ![]() |
gbssetup [ menu_entry_1 ]
menu_entry_1
| integer scalar optional range 1..7 | Menu entry for immediate execution Default=0 |
![]() | ![]() |
gbsshow
- [ --brief | --brief+ | --brief- ]
--brief[+|-]
| brief boolean scalar optional | Brief (short) listing Default=0 |
![]() | ![]() |
gbssilo
- [ --ci | --ci+ | --ci- ]
- [ --vi | --vi+ | --vi- ]
--ci[+|-]
| create_index boolean scalar optional | Create the HTML index Default=1 |
--vi[+|-]
| view_index boolean scalar optional | View index in HTML browser Default=1 |
![]() | ![]() |
gbssysaudit [ steps ]...
- [ --i | --i+ | --i- ]
- [ --vs | --vs+ | --vs- ]
- [ --audits=audit_names,... ]...
- [ --targets=targets,... ]...
- [ --files=files,... ]...
- [ --aud | --aud+ | --aud- ]
- [ --sum | --sum+ | --sum- ]
- [ --fg | --fg+ | --fg- ]
- [ --at=delay ]
- [ --sm | --sm+ | --sm- ]
- [ --n | --n+ | --n- ]
- [ --wait | --wait+ | --wait- ]
- [ --jobs=jobs ]
- [ --c=comment ]
- [ Environment_Variable=Value ]...
steps
| string array optional | Steps and/or Aliases. <empty> == all select steps, 'ALL' == force all steps, '?' == show steps Default= |
--i[+|-]
| ignore_errors boolean scalar optional | Continue generation after error(s) Default=0 |
--vs[+|-]
| view_sum boolean scalar optional | View summary at completion Default=1 |
--audits=audit_names
| string array optional | (wild-)Audits to run. '' or '*' == All, '.' == Current, '-' == NonSpecific Default=-,* |
--targets=targets
| string array optional | (wild-)Targets to Audit. '' or '*' == All, '.' == Current, '-' == NonSpecific Default=-,* |
--files=files
| string array optional | Files to audit Default=*:*.* |
--aud[+|-]
| audit boolean scalar optional | Run audit Default=1 |
--sum[+|-]
| summary boolean scalar optional | Create summary Default=1 |
--fg[+|-]
| foreground boolean scalar optional | Runs in the foreground if set Default=0 |
--at=delay
| time ([+=]hh:mm or [+=]mm) scalar optional | Starting time (10:20), delta (+10:10) or now Default=now |
--sm[+|-]
| mail boolean scalar optional | Send mail on completion Default=0 |
--n[+|-]
| notify boolean scalar optional | Notify user on completion (bg/nowait only) Default=1 |
--wait[+|-]
| wait boolean scalar optional | Wait for completion of bg jobs Default=0 |
--jobs=jobs
| integer scalar optional range 1..9 | Max nr parallel jobs within a submitted job Default=2 |
--c=comment
| string scalar optional | Comments - will be shown in Summary - Specify %20 for space Default= |
(GBS_) LOG_PATH | (GBS_) FLAGS_* | (GBS_) APP_* |
![]() | ![]() |
gbssysgen [ steps ]...
- [ --i | --i+ | --i- ]
- [ --mm | --mm+ | --mm- ]
- [ --targets=targets,... ]...
- [ --fg | --fg+ | --fg- ]
- [ --files=files,... ]...
- [ --at=delay ]
- [ --sm | --sm+ | --sm- ]
- [ --n | --n+ | --n- ]
- [ --wait | --wait+ | --wait- ]
- [ --jobs=jobs ]
- [ --c=comment ]
- [ Environment_Variable=Value ]...
steps
| string array optional | Steps and/or Aliases. <empty> == all select steps, 'ALL' == force all steps, '?' == show steps Default= |
--i[+|-]
| ignore_errors boolean scalar optional | Continue generation after error(s) Default=0 |
--mm[+|-]
| run_makemake boolean scalar optional | Run 'gbsmakemake' on completion of Full GBS SubSystems Default=1 |
--targets=targets
| string array optional | (wild-)Targets to Audit. '' or '*' == All, '.' == Current, '-' == NonSpecific Default=-,* |
--fg[+|-]
| foreground boolean scalar optional | Runs in the foreground if set Default=0 |
--files=files
| string array optional | Files to gen Default=*:*.* |
--at=delay
| time ([+=]hh:mm or [+=]mm) scalar optional | Starting time (10:20), delta (+10:10) or now Default=now |
--sm[+|-]
| mail boolean scalar optional | Send mail on completion Default=0 |
--n[+|-]
| notify boolean scalar optional | Notify user on completion (bg/nowait only) Default=1 |
--wait[+|-]
| wait boolean scalar optional | Wait for completion of bg jobs Default=0 |
--jobs=jobs
| integer scalar optional range 1..9 | Max nr parallel jobs within a submitted job Default=2 |
--c=comment
| string scalar optional | Comments - will be shown in Summary - Specify %20 for space Default= |
(GBS_) LOG_PATH | (GBS_) DEBUGGER | (GBS_) MODE |
(GBS_) OPT | (GBS_) MAP | (GBS_) FLAGS_* |
(GBS_) APP_* |
![]() | ![]() |
gbssysmake [ steps ]...
- [ --i | --i+ | --i- ]
- [ --smm | --smm+ | --smm- ]
- [ --mm | --mm+ | --mm- ]
- [ --targets=targets,... ]...
- [ --files=files,... ]...
- [ --fg | --fg+ | --fg- ]
- [ --at=delay ]
- [ --sm | --sm+ | --sm- ]
- [ --n | --n+ | --n- ]
- [ --wait | --wait+ | --wait- ]
- [ --jobs=jobs ]
- [ --c=comment ]
- [ Environment_Variable=Value ]...
steps
| string array optional | Steps and/or Aliases. <empty> == all select steps, 'ALL' == force all steps, '?' == show steps Default= |
--i[+|-]
| ignore_errors boolean scalar optional | Continue generation after error(s) Default=0 |
--smm[+|-]
| start_makemake boolean scalar optional | Pre-generate the make-file Default=1 |
--mm[+|-]
| run_makemake boolean scalar optional | Run 'gbsmakemake' on completion of Full GBS SubSystems Default=1 |
--targets=targets
| string array optional | (wild-)Targets to Audit. '' or '*' == All, '.' == Current, '-' == NonSpecific Default=-,* |
--files=files
| string array optional | Files to make Default=*:*.* |
--fg[+|-]
| foreground boolean scalar optional | Runs in the foreground if set Default=0 |
--at=delay
| time ([+=]hh:mm or [+=]mm) scalar optional | Starting time (10:20), delta (+10:10) or now Default=now |
--sm[+|-]
| mail boolean scalar optional | Send mail on completion Default=0 |
--n[+|-]
| notify boolean scalar optional | Notify user on completion (bg/nowait only) Default=1 |
--wait[+|-]
| wait boolean scalar optional | Wait for completion of bg jobs Default=0 |
--jobs=jobs
| integer scalar optional range 1..9 | Max nr parallel jobs within a submitted job Default=2 |
--c=comment
| string scalar optional | Comments - will be shown in Summary - Specify %20 for space Default= |
(GBS_) LOG_PATH | (GBS_) DEBUGGER | (GBS_) MODE |
(GBS_) OPT | (GBS_) MAP | (GBS_) FLAGS_* |
(GBS_) APP_* |
![]() | ![]() |
gbsstart root [ subsystem ] [ component ]
- [ --target=target ]
- --exec=execute_command
- [ --rel=rel ]
root
| string scalar mandatory | System / Root: '-' == none, '.' == current, '!' == CWD, '!<abs_file/dir_spec>', '!!' == CWD = GBS_ROOT_PATH Default=! |
subsystem
| string scalar optional | SubSystem: '-' == none, '.' or '' == current Default= |
component
| string scalar optional | Component: '-' == none, '.' or '' == current Default= |
--target=target
| string scalar optional | Target: '-' == none, '.' or '' == current Default=. |
--exec=execute_command
| string scalar mandatory | (GBS-)Command to execute. 'none' = OK Default= |
--rel=rel
| string scalar optional | Specific GBS release Default=. |
![]() | ![]() |
gbsstats
- [ --lines | --lines+ | --lines- ]
--lines[+|-]
| count_lines boolean scalar optional | Count lines in src, inc and loc Default=0 |
![]() | ![]() |
gbsswc [ component ]
- [ --target=target ]
- [ --new | --new+ | --new- ]
- [ --nocd | --nocd+ | --nocd- ]
component
| string scalar optional | Component: '' == ASK, '-' == none, '.' == current Default= |
--target=target
| string scalar optional | Target: '-' == none, '.' == current Default= |
--new[+|-]
| create_new_component boolean scalar optional | Create a new Component Default=0 |
--nocd[+|-]
| no_cd boolean scalar optional | Do not 'cd' to the selected directories Default=0 |
![]() | ![]() |
gbsswr [ root ] [ subsystem ] [ component ]
- [ --target=target ]
- [ --new | --new+ | --new- ]
- [ --add | --add+ | --add- ]
- [ --remove | --remove+ | --remove- ]
- [ --show | --show+ | --show- ]
- [ --exec=execute_command ]
- [ --nocd | --nocd+ | --nocd- ]
root
| string scalar optional | System / Root: '' == ASK, '-' == none, '.' == current, '!' == CWD, '!<abs_file/dir_spec>', '!!' == CWD = GBS_ROOT_PATH Default= |
subsystem
| string scalar optional | SubSystem: '-' == none, '.' == current Default= |
component
| string scalar optional | Component: '-' == none, '.' == current Default= |
--target=target
| string scalar optional | Target: '-' == none, '.' == current Default=. |
--new[+|-]
| create_new_root boolean scalar optional | Create a new System / Root Default=0 |
--add[+|-]
| add_root boolean scalar optional | Add a Root to the Roots List Default=0 |
--remove[+|-]
| remove_root boolean scalar optional | Remove a Root from the Roots List Default=0 |
--show[+|-]
| show_roots boolean scalar optional | Show the Roots List Default=0 |
--exec=execute_command
| string scalar optional | (GBS-)Command(s) to execute. 'none' = OK Default= |
--nocd[+|-]
| no_cd boolean scalar optional | Do not 'cd' to the selected directories Default=0 |
![]() | ![]() |
gbssws [ subsystem ] [ component ]
- [ --target=target ]
- [ --new | --new+ | --new- ]
- [ --nocd | --nocd+ | --nocd- ]
subsystem
| string scalar optional | SubSystem. '' == ASK, '-' == none, '.' == current Default= |
component
| string scalar optional | Component. '-' == none, '.' == current Default= |
--target=target
| string scalar optional | Target. '-' == none, '.' == current Default= |
--new[+|-]
| create_new_subsys boolean scalar optional | Create a new SubSystem Default=0 |
--nocd[+|-]
| no_cd boolean scalar optional | Do not 'cd' to the selected directories Default=0 |
![]() | ![]() |
gbsswt [ target ]
- [ --new | --new+ | --new- ]
- [ --remove | --remove+ | --remove- ]
target
| string scalar optional | Target: '' == ASK, '-' == none, '.' == current Default= |
--new[+|-]
| create_new_target boolean scalar optional | Create a new Target Default=0 |
--remove[+|-]
| remove_target boolean scalar optional | Remove a Target from the Targets List Default=0 |
![]() | ![]() |
gbswhich [ file_or_type_or_comp ] [ search_type ]
- [ --target=target ]
- [ Environment_Variable=Value ]...
file_or_type_or_comp
| string scalar optional | file_type or Component or filename or SubDir/filename or */filename Default= |
search_type
| string scalar optional | file_type to search Default= |
--target=target
| string scalar optional choice: $GBS_TARGETS | Target Default=$GBS_TARGET |
(GBS_) FLAGS_* |
![]() | ![]() |
gbsxref
![]() | ![]() |
grep --help
egrep --help
agrep --help
tail --help
touch --help
![]() | ![]() |
proto [ files ]
files
| string scalar optional | Files to be parsed Default=*.c *.cpp *.oc *.pl *.pm |
![]() | ![]() |
detab [ files ]
- [ -t | -t+ | -t- ]
- [ -r | -r+ | -r- ]
- [ -f=wild_files,... ]...
- [ -m=modulo ]
- [ -s | -s+ | -s- ]
files
| string scalar optional | Files to process or directory in case of -r Default= |
-t[+|-]
| test boolean scalar optional | test only - do not make modifications Default=0 |
-r[+|-]
| recurse boolean scalar optional | recurse directory looking for -f= files Default=0 |
-f=wild_files
| string array optional | wild-card files to process Default= |
-m=modulo
| integer scalar optional | The TAB size the file was created with Default=8 |
-s[+|-]
| smart_tabs boolean scalar optional | retab leading whitespace (modulo 8) Default=0 |
![]() | ![]() |
gbsscm info|state|co|ci|unco|mkdir|mktxt|add|move|ignore|remove|import|connect|stop|select [ files ]...
- [ --r | --r+ | --r- ]
command
| string scalar mandatory choice: info state co ci unco mkdir mktxt add move ignore remove import connect stop select | Basic SCM Command Default= |
files
| string array optional | File / Directory List Default= |
--r[+|-]
| recursive boolean scalar optional | Add whole directory tree Default=0 |
info state <file-dir>... co <file-dir>... ci <file-dir>... unco <file-dir>... mkdir <dir>... mktxt <file>... add <file-dir>... ignore <file-dir>... remove <file-dir>... import <from-dir> [<to-dir>] connect stop select
![]() | ![]() |
win2unix files...
files
| string array mandatory | Files to convert Default= |
![]() | ![]() |
fixeol files...
files
| string array mandatory | Files to be fixed Default= |
![]() | ![]() |
wordrep command_or_commandsfile [ files ]
- [ -t | -t+ | -t- ]
- [ -r | -r+ | -r- ]
- [ -f=wild-files,... ]...
command_or_commandsfile
| string scalar mandatory | Replace Command or filespec of file containing Replace Commands Replace Command: <delim><find><delim><replace><delim>[w|b|e|a|r][i] - w = find word, b = find begin word, e = find end word - a = find any, r = find Perl regular expression - i = ignore case of search string - \s in replace string is converted to single space commandsfile: Empty lines and lines beginning with '#' are ignored Default= |
files
| string scalar optional | Files to process Default= |
-t[+|-]
| test boolean scalar optional | test only - do not make modifications Default=0 |
-r[+|-]
| recurse boolean scalar optional | recurse directory looking for -f= files Default=0 |
-f=wild-files
| string array optional | wild-card files to process Default= |
![]() | ![]() |
filerep command_or_commandsfile [ files ]
- [ -t | -t+ | -t- ]
- [ -r | -r+ | -r- ]
- [ -f=wild-files,... ]...
command_or_commandsfile
| string scalar mandatory | Rename/Delete Command or filespec of file containing Rename/Delete Commands Rename/Delete Command: <delim><find><delim><replace><delim>[g|r][i] - g = glob rename (default) - r = Perl regular expression rename - i = ignore case of search string Empty <replace> deletes the file commandsfile: Empty lines and lines beginning with '#' are ignored Default= |
files
| string scalar optional | Files to process Default= |
-t[+|-]
| test boolean scalar optional | test only - do not make modifications Default=0 |
-r[+|-]
| recurse boolean scalar optional | recurse directory looking for -f= files Default=0 |
-f=wild-files
| string array optional | wild-card files to process Default= |