Boost.Build

variables

Introduction

Boost.Build's behaviour can be controlled by setting of variables either from the shell environment or using the "-sVARIABLE_NAME=value" Jam command line option. Most of these variables are used internally and don't need to be manipulated by the user.

Variables

Variable Name	Semantics	Notes
`AS`	Command to compile assermbler source files.
`ASFLAGS`	Flags to pass to As command.
`AWK`	Command to process awk commands.
`CHMOD`	Command to set the permissions of files.
`CP`	Command used to copy files.
`CRELIB`	?
`DLLMODE`	Permissions to set for generated shared library files.
`DLL_AS_LIB`	Platform flag indicating that when linking the platform treats shared libraries as link libraries when linking. Notably Win32 type platforms.
`DOT`	Representation of current directory in a path.
`DOTDOT`	Represetation of parent directory in a path.
`EXEMODE`	Permissions to set for generated executable files.
`FILEMODE`	Permissions to set for generated regular files.
`FORTRAN`	Command to compile Fortran source files.
`FORTRANFLAGS`	Flags to pass to FORTRAN command.
`HDRS`	Default list of directories of platform headers.
`HDRPATTERN`	Regex pattern used to match the file part of CPP include directives.
`JAMFILE`	File to read build instructions/descriptions from.	Default is "Jamfile".
`JAMRULES`	File to read for global rules and variable.	Default is "Jamrules".
`JAMSHELL`	See Perforce/Jam documentation.
`LEX`	Command for processing Lex compatible parsers.
`LEX_OUTPUT`	LEX option to directly specify the output files to generate.
`LN`	Command to create a hard-link to a file.
`MANDIR`	Directory to install MAN documentation files.
`MKDIR`	Command to create a directory.
`MV`	Command to rename files.
`NOARSCAN`	Platforms archive format does not support scanning.
`OSFULL`	List of all the variations of the OS platform name and version.
`PREDLL`	Prefix for generated shared library files.
`PRELIB`	Prefix for generated link library files.
`RANLIB`	Command to post-process archives or link libraries.	Set to empty ("") if there is no command.
`RELOCATE`	Flag to indicate that the platform compiler does not support placing generated object files, so we must move them.
`RM`	Command used to delete files.
`SED`	Command to execute sed scripts.
`SHELLHEADER`	Header to prepend in generated shell scripts.
`SHELLMODE`	Permissions to set for generated shell script files.
`SHELL_EXPORT`	Command for exporting variables set by Boost.Build to the shell. Not set if there is no command.
`SHELL_SET`	Comamnd for setting variables in the shell. Includes trailing " " as needed. Set to empty ("") if there is no command.
`SLASH`	Directory and file separator of the platform.
`SOURCE_GENERATING_EXTENSIONS`	A list of all file extensions which generate source files when built.
`SPLITPATH`	Separator of the platform for variables that hold a list of paths.
`STDHDRS`	Directory location of standard C/C++ headers.
`SUFDLL`	Suffix for generated shared library files.	Includes any "." as needed.
`SUFFEXE`	Suffix for generated executable files.	Includes any "." as needed.
`SUFLIB`	Suffix for generated link library files.	Includes any "." as needed.
`SUFOBJ`	Suffix for generated compiled object files.	Includes any "." as needed.
`YACC`	Command for processing Yacc compatible grammars.
`YACCFILES`	The filenames that the YACC command produces.
`YACCFLAGS`	Extra flags to pass to the YACC command.
`YACC_OUTPUT`	YACC option to directly specify the output files to generate.

Revised 14 May, 2002

Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at www.boost.org/LICENSE_1_0.txt)