IBM
Contents Index Previous Next



File Structure


The runtime library is structured into a number of files. These are:

On UNIX, all files can be found in the directory $telelogic/sdt/sdtdir/<machine dependent dir>/INCLUDE where <machine dependent dir> is for example sunos5sdtdir on SunOS 5.

In Windows, all files can be found in the directory <installation directory>\sdt\sdtdir\wini386\include.

Description of Files

scttypes.h

This file contains type definitions and extern declarations of variables and functions. The file is included by sctsdl.c, sctpred.c, sctutil.c, sctmon.c, sctpost.c, sctos.c, and by each generated C file.

sctlocal.h

This file contains type definitions and extern declarations of variables and functions that are used only in the kernel. This file is not included in generated code.

sctpred.h

This file contains type definitions and extern declarations handling the predefined data types in SDL (except PId, which is in scttypes.h). This file is included in generated code via scttypes.h.

sctsdt.c

In this file the implementation of the SDL operations can be found, together with the functions used for scheduling. In more detail, this file contains groups of functions for:

sctpred.c

The functions implementing the operations defined in the SDL predefined data types can be fund in this file. Operators for PId is implemented in sctsdl.c.

sctutil.c

This file contains basic read and write functions together with functions to handle reading and writing of values of abstract data types, including the predefined data types. It also contains the functions for MSC trace.

sctmon.c

The sctmon.c file contains the functions that implement the monitor interface, that is, interpreting and executing monitor commands.

sctpost.c

This file contains all the basic functions that are used to connect a simulator with the other parts of the SDL Suite.

sctos.c

In this file, some functions that represent the dependencies of hardware, operating system and compiler are placed.

The basic functions necessary for an application are a function to read the clock and a function to allocate memory.

To move a generated C program plus the runtime library to a new platform (including a new compiler), the major changes are to be made in this file, together with writing a new section in scttypes.h to describe the properties of the new compiler.

post.h and sdt.h

These files are included in sctpost.c if the communication mechanism with other the SDL Suite applications should be part of the actual object code version of the library. The file post.h contains the function interface, while sdt.h contains message definitions.

Caution!

Windows only: When linking with the PostMaster's dynamically linked libraries (post.lib and post.dll), the environment variable USING_DLL must be defined before including post.h. Example:

#define USING_DLL

#include "post.h"

#undef USING_DLL

post.o (post64.o for solaris 64-bit, post.lib in Windows)

This file contains the implementation of functions needed to send messages, via the Postmaster, to other tools in the SDL Suite.


http://www.ibm.com/rational
Contents Index Previous Next