Specification of Export Files

A user specifies a function to export from the library by including an export file ("library name.exp") in the mod directory. This method is recommended as the automatic extraction may export functions that are not supposed to be exported.

A export file specifies one function per line. If the first character of the line is '#', the line will be annotated.

The following is an example.

# mylibrary
myfunction1
myfunction2
myfunction3

Automatic Extraction of Export Function

Automatically extracts functions to be exported. If the export file is not specified, the function is automatically extracted. Internally, nm is used and a user can redefine the nm script. The script must be written in one line. If the first character of the line is '#', the line will be annotated. If the last character of the line is '\', the line will lead up to the following line. "$(LIB)" is a macro variable that indicates the library name.

The following is an example.

# for HP32
nm $(LIB) | awk -F"|" '{if ($3 == "extern" && $4 == "code   ")
 {print $1}}' | grep -ve "^_"

# for HP64
nm $(LIB) | awk -F"|" '{if ($4 == "FUNC " && $7 == "   .text") 
{print $8}}' | grep -ve "^_"

# for IBM32
nm $(LIB) | awk '{if ($2 == "D") {print $1}}'

# for IBM64
nm -X64 $(LIB) | awk '{if ($2 == "D") {print $1}}'

# for SUN
nm $(LIB) | awk -F"|" '{if ($4 == "FUNC ") {print $8}}' | grep -v "^_"

# for linux
nm $(LIB) | awk '{if ($2 == "T") {print $3}}' | grep -v "^_"

(*But, the above script is noly an example and the modification is needed depending on the actual platform.)

The above script can be used by using the COMMAND parameter of the TDL environment file(tdl.cfg) or the –x option from the management tool. Also, functions that are automatically extracted from the system can be identified in advance through tdlnm.

The following initializes shared memory and modules using a TDL configuration file <tdl.cfg>:

$ tdlinit

The following backs up shared memory from a backup file in the event of a system failure or restart:

$ tdlinit -b

The following removes outdated library files:

$ tdlclean

The following removes library files that were created before 00:00 on February 1st, 2009:

$ tdlclean –d 200902010000

The following removes library files older than five days:

$ tdlclean -D "5 day"

The following removes mylibrary from a TDL shared memory and outdated files:

$ tdlclean -m mylibrary

The following is the basic usage of tdlshm:

$ tdlshm TDLDIR = /home/jeffry/tmax LOGDIR = /home/jeffry/tmax/log/dlog 
- BACKUP = /home/jeffry/tmax/log/dlog/tdl.bak VERSION = 2, SHMKEY = 0x90000, 
- IPCPERM = 0750 MAXMODULES = 256, CURMODULES = 3, Global SEQNO = 45e27d28, 
- MONITOR = Y MODE = SINGLE, DOMAINID = 1 Index = 125, Funcname = myfunction1, 
- Libname = myfunction1, Seqno = 45e27d28, Active = Y Index = 126, 
- Funcname = myfunction2, Libname = myfunction2, Seqno = 45e27d28, Active = Y, 
- Index = 127, Funcname = myfunction3, Libname = myfunction3, Seqno = 45e27d28, 
 Active = Y 

The following retrieves information about TDL statistics:

$ tdlshm -S TDLDIR = /home/jeffry/tmax LOGDIR = /home/jeffry/tmax/log/dlog 
- BACKUP = /home/jeffry/tmax/log/dlog/tdl.bak VERSION = 2, SHMKEY = 0x90000, 
- IPCPERM = 0750 MAXMODULES = 256, CURMODULES = 3, Global SEQNO = 45e27d28, 
- MONITOR = Y MODE = SINGLE, DOMAINID = 1 Index = 125, Funcname = myfunction1, 
- Libname = myfunction1, Seqno = 45e27d28, Active = Y Count = 0 SVC: Avg = 0.000, 
- MinTime = 0.000, Maxtime = 0.000 CPU: Avg = 0.000, MinTime = 0.000, 
- Maxtime = 0.000 Index = 126, Funcname = myfunction2, Libname = myfunction2, 
- Seqno = 45e27d28, Active = Y Count = 0 SVC: Avg = 0.000, MinTime = 0.000, 
- Maxtime = 0.000 CPU: Avg = 0.000, MinTime = 0.000, Maxtime = 0.000 Index = 127, 
- Funcname = myfunction3, Libname = myfunction3, Seqno = 45e27d28, Active = Y 
- Count = 0 SVC: Avg = 0.000, MinTime = 0.000, Maxtime = 0.000 CPU: Avg = 0.000, 
- MinTime = 0.000, Maxtime = 0.000 

The following is the result when [-s] or [-u] options are used:

$ tdlshm -s r
$ tdlshm -s e -m myfunction
$ tdlshm -s d -m myfunction
$ tdlshm -u e -m myfunction
$ tdlshm -u d -m myfunction

The following is the result when [-C] or [-c] options are used:

$ tdlshm -C
$ tdlshm -c 0 1024
$ tdlshm -c 1024

The following updates a <mylibrary.so> file:

$ tdlupdate -m mylibrary

The following updates multiple modules. The delimiter is a comma (,), and spaces are not allowed. There is no limit to the number of modules, but the maximum number is 1024 in a multi-node environment.

$ tdlupdate -m mylibrary,mylibrary2,mylibrary3

The following creates a file that contains a list of modules to be updated, and then updates the modules. There is no limit to the number of modules in the file, but the maximum number is 1024 in a multi-node environment.

$ tdlupdate -l update.list

The following is an <update.list> file. A comma (,) and newline can be used as a delimiter:

mylibrary,mylibrary2
mylibrary3

The following synchronizes nodes when there is an inconsistency in shared memory in a multi-node environment:

$ tdlupdate -c