rocklinux/Documentation/Developers/PKG-BUILD-VARS

Variables used in the package build scripts
===========================================

config ........ Name of the active configuration ($base/config/$config/..)
rockver ....... ROCK Linux Version (including rel. date for snapshots)

pkg ........... base name part of the package we are building 
xpkg .......... derived name part of the package we are building
                if a package is not pkgfork'd, pkg == xpkg
ver ........... package Version (from *.desc - until first whitespace)
extraver ...... version text after the first whitespace, defaults to "0"
desc_[A-Z] .... Data from the *.desc file

id ............ unique ID for this Build-Pkg invocation
arch .......... architecture (subdir name in architecture)
target ........ target distribution (subdir name in targets)
stagelevel .... stagelevel (0-1 = crossbuild, 2-8 = native, 9 = rebuild)
crossnative ... has the value 'cross' or 'native'

archprefix .... prefix for binutils and compiler binaries (for cross-building)
arch_sizeof_long_long .... arch setting from architecture/*/archtest.out
arch_sizeof_int .......... arch setting from architecture/*/archtest.out
arch_machine ............. arch setting from architecture/*/archtest.out
arch_sizeof_char_p ....... arch setting from architecture/*/archtest.out
arch_sizeof_long ......... arch setting from architecture/*/archtest.out
arch_bigendian ........... arch setting from architecture/*/archtest.out
arch_sizeof_short ........ arch setting from architecture/*/archtest.out
arch_target .............. arch setting from architecture/*/archtest.out
arch_build ............... like 'arch_target' - but for the build host

archdir ....... directory containing the package tar files (download/..)
confdir ....... directory containing the package build config (package/..)
targetdir ..... directory containing the target config (target/...)

builddir ...... directory in which the package is build (src.$id)
base .......... ROCK Linux sources base directory (/usr/src/rock-src)
xroot ......... real root ($base/build/...)
root .......... root directory (equals $xroot, empty in chroot mode)

build_logs .... Big build log file ...... (Build-Target only)
build_pkgs .... Package files go here .... (Build-Target only)
build_root .... Chroot dir name ......... (Build-Target only)
build_rock .... ROCK build system data .. (Build-Target only)

prefix_auto ... '1' = you may auto-detect a better value for $prefix in *.conf
prefix ........ install prefix (usually '/usr' or '/opt/...')
bindir ........ where the binaries (programs) should be installed
sbindir ....... where the system binaries should be installed
libdir ........ where the library files should be installed
sysconfdir .... where the configuration should be installed (i.e. etc)
localstatedir . where the variable data should be installed (i.e. var)
datadir ....... where the arch-indep. data should be installed (i.e. share)
docdir ........ where the documentation should be installed
mandir ........ where the info man pages should be installed
infodir ....... where the info files should be installed
includedir .... where the header files should be installed

autoextract ... '0' = skip automatic untar
srctar ........ filename of source tar file ('auto' = autodetect)
srcdir ........ directory in source tar file ('auto' = autodetect)
xsrctar ....... filename of source tar file after 'auto' has been processed
xsrcdir ....... directory in source tar file after 'auto' has been processed
taropt ........ tar options for extracting

autopatch ..... '0' = skip automatic patching
patchfiles .... list of patchfiles found in $confdir
patchopt ...... options passed to the patch program

chownsrcdir ... '0' = don't make a chown to root after extracting the $srctar
nocvsinsrcdir . '0' = don't remove CVS and .svn directories in $srcdir
createprefix .. '0' = skip creation for directory skeleton for $prefix
createdocs .... '0' = skip automatic copying of documentation files
autoso2a ...... '1' = automatically create *.a files for all *.so files
forcefpic ..... set to '0' to disable the force -fPIC mechanism
desktopfiles .. filenames of the desktop files to install ($confdir/*.desktop)
		set to an empty string to deactivate desktop file installation
desktopauto ... '0' = disable automatic changes to .desktop files

flistdel ...... regex describing files which shouldn't go to package db
flistrfilter .. regex describing which lines to ignore in flist rlog
flistroot ..... list of top-level directories which should be used for flist

check_shared ...... Check for files which are shared with other packages
check_usrlocal .... Check for files which are installed in usr/local
check_badfiles .... Check for files which are registered 'bad files'


autogen ....... set to '1' if you want to run the autogen script
automakever ... automake version prefix (e.g. "-1.7") for $autogen

runconf ....... set to '0' if you want to skip running configure
confopt ....... options for GNU autoconf './configure'
extraconfopt .. options which should be appended to $confopt by set_confopt()
configprefix .. variable declarations only for GNU autoconf './configure'
configscript .. script file name of the GNU autoconf configure script
configexec .... command for executing $configscript (default=bash)

runcmake ...... set to '0' if you want to skip running 'cmake .'
cmakesrcdir ... set to path of srcdir when requesting an out-of-source build
cmakedefs ..... options passed to cmake

runxmkmf ...... set to '0' if you want to skip running 'xmkmf'
runmkpl ....... set to '0' if you want to skip running 'perl Makefile.PL'

runpysetup .... set to '0' if you want to skip running 'python setup.py'
pyconfopt ..... options for 'setup.py' - Python setup scripts

makeopt ....... options for 'make' (default = ' ')
makeinstopt ... options for 'make install' (default = 'install')


custmain ...... command to execute instead of 'configure, make, make install'
mainfunction .. alternate main function instead of build_this_package()

prepare ....... command to execute before main build-block
prepatch ...... command to execute before automatic patching
postpatch ..... command to execute after automatic patching
preconf ....... command to execute before running configure
premake ....... command to execute before running 'make'
inmake ........ command to execute between 'make' and 'make install'
postmake ...... command to execute after running 'make install'
postflist ..... command to execute after creating the flist
postinstall ... command to execute after finishing all the standard stuff
finish ........ command to execute after everything else outside build-block


BUILDCC ....... C compiler for helper apps (usually that's just 'cc')
BUILD_CC ...... C compiler for helper apps (must be the same as $BUILDCC)
HOSTCC ........ C compiler for helper apps (must be the same as $BUILDCC)
HOST_CC ....... C compiler for helper apps (must be the same as $BUILDCC)

MAKE .......... make executable name (including -j option according to Config)
CC ............ C compiler executable name for target architecture
CXX ........... C++ compiler executable name for target architecture
STRIP ......... strip executable name for target architecture
LD ............ ld executable name for target architecture
AR ............ ar executable name for target architecture
RANLIB ........ ranlib executable name for target architecture
AS ............ as executable name for target architecture
GASP .......... gasp executable name for target architecture
NM ............ nm executable name for target architecture

CC_WRAPPER_* ...... configuration for C compiler wrapper
CXX_WRAPPER_* ..... configuration for C++ compiler wrapper
KCC_WRAPPER_* ..... configuration for Kernel C compiler wrapper
F77_WRAPPER_* ..... configuration for Fortran 77 compiler wrapper
STRIP_WRAPPER_* ... configuration for strip wrapper

ROCK_BUILD_TARGET ... set to '1' in Build-Target

ROCKCFG_* ........... configuration from 'Config' file