z/TPF Program Management - IBM

|
|
|
|
|
|
Contents
Part 1. Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
MakeTPF build solution . . . . . . . . . . . . . . . . . . . . . 3
Configuration files . . . . . . . . . . . . . . . . . . . . . . . . 3
Environment files . . . . . . . . . . . . . . . . . . . . . . . . 3
Makefiles . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Control files . . . . . . . . . . . . . . . . . . . . . . . . . . 4
bldtpf utility . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
fctbval utility . . . . . . . . . . . . . . . . . . . . . . . . . . 5
loadtpf utility . . . . . . . . . . . . . . . . . . . . . . . . . . 6
maketpf_cntl_tdmdd_checker utility . . . . . . . . . . . . . . . . . . 6
maketpf utility . . . . . . . . . . . . . . . . . . . . . . . . . . 6
tpfObjectConverter utility . . . . . . . . . . . . . . . . . . . . . . 7
Local modifications . . . . . . . . . . . . . . . . . . . . . . . . 7
Assemble, compile, and link options . . . . . . . . . . . . . . . . . 7
LDFLAGS link options. . . . . . . . . . . . . . . . . . . . . . . 9
z/TPF program types and linkage . . . . . . . . . . . . . . . . . 11
Assembler and C program packaging. . . . . . . . . . . . . . . . . 11
Entry points . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Executable and linking format (ELF) . . . . . . . . . . . . . . . . . 12
Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Visibility in shared objects . . . . . . . . . . . . . . . . . . . . . 13
Stubs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Transfer vectors . . . . . . . . . . . . . . . . . . . . . . . . 16
Program linkage . . . . . . . . . . . . . . . . . . . . . . . . 16
z/TPF loaders . . . . . . . . . . . . . . . . . . . . . . . . . 19
Loader general file . . . . . . . . . . . . . . . . . . . . . . . 19
Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Loadsets . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Version control file index . . . . . . . . . . . . . . . . . . . . . 21
VCFX programming considerations . . . . . . . . . . . . . . . . 21
Where programs are loaded . . . . . . . . . . . . . . . . . . . . 21
Offline general file loader component (ALDR). . . . . . . . . . . . . . 22
Online general file loader component (ACPL). . . . . . . . . . . . . . 23
Offline image loader component (TLDR) . . . . . . . . . . . . . . . 23
Online image loader component (ZTPLD) . . . . . . . . . . . . . . . 24
Offline E-type loader component (OLDR) . . . . . . . . . . . . . . . 25
Online E-type loader component (OLDR) . . . . . . . . . . . . . . . 26
E-type loader recycle interface . . . . . . . . . . . . . . . . . . . 27
Data loader . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Offline loader support on Linux . . . . . . . . . . . . . . . . . . . 28
Programming considerations . . . . . . . . . . . . . . . . . . . 29
Alternate FCTB loader overview . . . . . . . . . . . . . . . . . . 29
Alternate FCTB loader benefits . . . . . . . . . . . . . . . . . . 30
Alternate FCTB loader programming considerations . . . . . . . . . . 30
Alternate FCTB compatibility checking . . . . . . . . . . . . . . . 31
Compiler overview for z/TPF C/C++ support . . . . . . . . . . . . . 33
GCC ELF-compatible compilers. . . . . . . . . . . . . . . . . . . 33
Systems/C and Systems/C++ ELF-compatible compilers . . . . . . . . . 34
© Copyright IBM Corp. 2005, 2012 iii