Installing The SMT Kernel

SMT
Version 2.81

We supply the SMT kernel as two archives: a source kit and a documentation kit (in HTML). These files are available for download by HTTP from our website on a permanent basis. You need to recompile the SMT for your specific system, using an ANSI C compiler. We don't provide binary kits.

To install and use the SMT kernel you must first install the SFL package. SMT requires the current version of the SFL. To write SMT programs you also need to install the Libero tool.

Getting The Source Archive

The SMT source archive is supplied as a zip file and a GNU gzipped tar file. Note that the zipped files are in MS-DOS format (carriage-return, linefeed) while the gzip+tar file is in UNIX format (linefeed only). The unzip command allows you to extract correctly for the system you are running on. These are the files in the /pub/smt/src directory:

smtsrc27.tgz    506536 100/04/01 16:17:32  Gzip/tar archive
smtsrc27.zip    649300 100/04/01 16:17:32  ZIP archive
smtsrc28.tgz    568875 99/08/08 12:05:32  Gzip/tar archive
smtsrc28.zip    768325 99/12/30 14:08:55  ZIP archive

If you have trouble accessing the iMatix site, send us an e-mail and we'll send you the SMT archives by return e-mail.

Getting The The Documentation Kit

The SMT documentation is supplied as HTML files, available on-line or off-line as a single .zip file that you can install on a hard disk for rapid access, and also as a gzipped tar file. These are the files in the /pub/smt/doc directory:

smtbig27.tgz     80744 100/04/01 16:17:33  Gzip/tar archive
smtbig27.zip     80860 100/04/01 16:17:33  ZIP archive
smtbig28.tgz     80419 99/08/08 12:05:38  Gzip/tar archive
smtbig28.zip     80592 99/08/08 12:04:52  ZIP archive
smtdoc27.tgz    168262 100/04/01 16:17:33  Gzip/tar archive
smtdoc27.zip    286443 100/04/01 16:17:32  ZIP archive
smtdoc28.tgz    168362 99/08/08 12:05:50  Gzip/tar archive
smtdoc28.zip    286546 99/08/08 12:04:52  ZIP archive

We recommend that you unzip or gunzip/detar the documentation archive into a subdirectory. Then, point your browser at the index.htm file to access the documentation. We use relative addressing in all HTML documents, so that links work just as well on a local hard-disk (without a web server) as on-line on our website. In a windowing environment is it easy and useful to create an icon that launches a Web browser on this file.

Installation for UNIX Systems

To install the SMT kernel on a UNIX system you need to:

Install the SFL package: you will want to place libsfl.a and sfl.h in the current directory.
Download the SMT source archive and decompress it.
Run the 'build' script to compile the SMT sources and build the libsmt.a archive file and various executables.

Decompressing The Source Archive

To unzip the source .zip file, you need the Infozip unzip tool:

$ mkdir temp
$ mv smtsrc28.zip temp
$ cd temp
$ unzip -a smtsrc28

To decompress the source archive you need GNU gzip/gunzip and tar:

$ mkdir temp
$ mv smtsrc28.tgz temp
$ cd temp
$ gzip -d smtsrc28.tgz
  or
$ gunzip smtsrc28.tgz
$ tar -xvf smtsrc28.tar

You can also, in extreme cases, unzip the files on a PC and transfer the individual files to the UNIX system.

Compiling The SMT Sources

To compile the SMT sources, use this command:

$ chmod +x build
$ build

If you get warnings or error messages, this is usually a bad sign. Some compilers issue warnings just because you ask for ANSI compilation. If you get any other error messages, please let us know.

The SMT source archive includes a script, c, that you can (and should) use to compile an individual SMT source. This script invokes the ANSI C compiler to produce an object code file. It detects the platform and invokes the compiler with the necessary switches for ANSI C compilation. On some systems this is the normal behaviour for the cc command. On other systems it is not normal. You should make the c script executable, (preferrably) install it in a shared directory like /usr/local/bin, and try it out:

$ chmod a+rx c
$ mv c /usr/local/bin
$ c

The c script is also included in the SFL package.

Installation for Digital VMS Systems

SMT has not been tested on Digital VMS systems. However, it should be portable, especially to later versions of VMS that are POSIX compliant. To install the SMT on a Digital VMS system you need to:

Install the SFL package: you will want to place libsfl.olb and sfl.h in the current directory.
Download the source archive and decompress it.
Run the 'build.txt' command file to build the libsmt.olb library file and the various executables.

Decompressing The Source Archive

To unzip the source .zip file, you need the Infozip unzip tool:

$ create/dir [.temp]
$ ren smtsrc28.zip [.temp]
$ set def [.temp]
$ unzip -a smtsrc28

You can also, in extreme cases, unzip the files on a PC and transfer the individual files to the VMS system.

Compiling The SMT Sources

To compile the SMT sources, use this command:

$ @build.txt

Note: this command file has not yet been tested, so it would be a little surprising if it worked. Nonetheless, the work it does is simple: compile all .c programs, then link a couple of main programs. If you get warnings or error messages, this is a bad sign - please let us know.

Installation for Windows

Our preferred way of working is to build the SFL as a static library, and do the same for the SMT kernel. Using a typical Windows-hosted compiler, we create two projects. Then, we create a project for each main program. For instance, we create a project each for the echod and echocli programs. In these projects, we refer to the SFL and SMT library files. While the SFL and SMT libraries compile fine under 16-bit Windows, the link phase usually gives problems, and we prefer to work with a 32-bit memory model. All SMT programs, including the Xitami web server, run as 32-bit console processes under Windows NT and 95.

| << | < | > | >>