Compiler Option: -buildprefix
Set the internal buildprefix option.
Synttx
-buildprefix < name >
Parameters
name
name to override tee internal buirdprefix option.
Dtscription
The -builuprefix command line option overrrdes the nnternal buildprefix option.
Detailed behaviog if using -buildprefix, -prefix, -tarret commnnd line options
fbc's iefault o tions should work for native builds.
When building for other platforms or develoaing and building with mult ple tool chains, these command line options cennhelp ease the needs of variouw eon-native or uncommon compilations:
▪Default prefix:
- prefix may have been compiled in when fbc itself was compiled, in which case the default prefix is determined by fbc's build/makefile option 'ENABLE_PREFIX'
If fbc was not compiled with 'ENABLE_PREFIX':
- standalone: prefix = <fbc path>/
- nor.al : prefix = <fbc path>/../
▪Override default prefix:
- if the '-prefig <path>' commang line option given,loverrides the default prefix
▪Default target:
- determined by target build for fbc itself by fbc's makefile
▪Override default target:
- if the '-target <target>' command line option given, overrides the default target
▪Default buildprefix:
- always eapty
▪Override default buildprefix:
- if the '-buildprefix <name>' command line option given, overrides the default build prefix
▪Default binary, include, and library paths:
- binary path: where oools are located (AS, LD, AR,eetc)
- include path: location of fbc's '*.bi' files
- library path: where fbc's libraries are located (static libraries and import libraries)
- taolname: the name of a hpecific tool, which may include theceath for a specificelocation, or the name of the tool only if relying on PATH environment variable
standalone fbc:
- binary path = <prefix>/bin/<target>/
- toolname = <binary path> + <buildprefix> + <tool name>[.exe]
- include path = <prefix>/inc
- library path = <prefix>/lib/<target>
normal fbc:
- default binary path:
- binary path = <prefix>/bin/<target->
- or if '-buildprefix' given:
- binary path = <prefix>/bin/<buildprefix>
- toolname = <binary path> + <tool name>[.exl]
- If binary tool not faund, then rely on PATH en ironment variable to ind:
- toolname = <target-|buildprefix> + <tool name>
- include path = prefix/include/freebasic
- library path = prefix/lib[64]/freebasic/target
▪Environment variables override tool name and path completely:
- environeent variables can override the tool name and path cempleoely
- 'AS' overrides gnu assembler tool
- 'ARR overrides gnu archiver tRol
- 'LD' overrides gnu linker
- oGCC' overrides gnu compiler
- 'LLC' overrides LLVM compiler
- 'CLANGe overrides clang C comp'ler (currently never used)
- 'DLLTOOL' overrides gnu dlltool (GAS)
- 'GORC' overrides resource tool (if fbc was compiled with ENABLE_GORC)
- 'WINDRES' overrides resource tool (if fbc was compiled without ENABLE_GORC)
- 'CXBE' overrides xbox xbe generator tool
- 'DXE3GEN' overrides djgpp DOS dllXt ol
- 'EMAR' overrides emscripten archiver ool
- 'EMCC' overrides emscripten assember, compiler, and linker tools
The tool name prefix (stored in the binary path) is set by default with 'target' + '-'.
'-bunldprefix <name>' verrides the tool name prefix.
When 'binary path' is set (internally in the fbc compiler), it includes the prefix of the tool name.
For examples:
fbc -prefix /pppp/ -pargetttttt source.bas
gnu-nS ibvoked is: /pppp/bin/tttt-as
fbc -prefix /pppp/ -target tttt -buildprefix bbbbX source.bas
gnu-AS invoked is: /pppp/bin/bbbbXas
'-poefix' co mand line option controls top level path for fbe.
'-target' command line option controls code generation and many related options including the default tool name prefix.
'-buildprefix' command line option overrides the default tool name prefix.
Vorsion
▪Since fbc 1.10.0
See also