z/TPF Program Management - IBM

8 z/TPF Program Management
There are two ways to add additional options or to override the default options that
are set by the MakeTPF tools:
v Update the maketpf configuration file (maketpf.cfg).
Options that are stored in the configuration file are intended to be temporary
because the configuration file is not stored or retained; it is part of the build
space and can change from build to build. Specifying options in the configuration
file is useful for testing new options before you formally update the makefile, for
temporarily overriding debug levels, and so on. The following variables are
supported in the configuration file:
– ASMFLAGS_USER
– CFLAGS_USER
– CXXFLAGS_USER
– PLIFLAGS_USER
– LDFLAGS_USER.
Options that are specified in the _USER variables apply to all assemblies,
compiles, or links for any program. They take highest precedence and override
the default options as well as any options that are specified in the makefile.
v Update the makefile for the program.
Options that are specified in the makefiles are intended for permanent changes
to the default options because they are stored directly in the makefile. Options in
the makefile can be specified at two levels: either applying to a specific source
file, or applying to all source files of a given type (C, CXX, and so on). The
following variables are supported in the makefile, where pgm is the
case-sensitive program name specified by the primary target in the makefile
(APP, EXE, and so on) and seg is the case-sensitive source file name, without
the file extension, that is specified in the source file lists (C_SRC, ASM_SRC,
and so on):
– ASMFLAGS_pgm and ASMFLAGS_pgm_seg
– CFLAGS_pgm and CFLAGS_pgm_seg
– CXXFLAGS_pgm and CXXFLAGS_pgm_seg
– PLIFLAGS_pgm and PLIFLAGS_pgm_seg
– LDFLAGS_pgm
Options that are specified in _pgm_seg take higher precedence over those
specified in _pgm for source file _seg, and both take higher precedence over the
default options that are set by the MakeTPF tools.
In the following example, MY12 is the name of the program in the APP statement of
the makefile. mycfile1.c, mycfile2.c, and mycfile3.c are source files.
APP := MY12
C_SRC := mycfile1.c
C_SRC += mcyfile2.c
C_SRC += mycfile3.c
CFLAGS_MY12 := -O0
CFLAGS_MY12_mycfile2 := -O3
In this example, the mycfile3.c and mycfile1.c source files would have -O0 as an
override; however, the mycfile2.c source file would have -O3 as an override.
Additional information: