KnowledgeBase Archive

An Archive of Early Microsoft KnowledgeBase Articles

View on GitHub

Q29836: C 5.10 MTDYNA.DOC: Sample MT Program/Compiling and Linking

Article: Q29836
Product(s): See article
Version(s): 5.10   | 5.10
Operating System(s): MS-DOS | OS/2
Keyword(s): ENDUSER | | mspl13_c
Last Modified: 15-JAN-1991

The following information is from "Section 4: Sample Multiple-Thread C
Program" of the Microsoft C version 5.10 MTDYNA.DOC file.

4.2   Compiling and Linking a Multiple-Thread Program

The program mhello.c is a statically linked multiple-thread program.
The process of compiling and linking this program is given below:

1. Ensure that the files LLIBCMT.LIB and DOSCALLS.LIB are available.

   The file LLIBCMT.LIB takes the place of the regular *.LIB files
   used in linking. It is a large-model library that supports the
   creation of statically linked multiple-thread programs. A
   multiple-thread program created with this library can be any memory
   model, although all calls to the C run-time library must use the
   large-model calling interface.

   The file DOSCALLS.LIB provides support for any OS/2 calls made in
   the multiple-thread program. In this example, the DosSleep function
   is used.

2. Ensure that the special multiple-thread include files are used.
   These are normally stored in the MT subdirectory of the normal
   \INCLUDE directory. In this example, this is done by explicitly
   specifying them within the mhello.c program as shown below:

      #include <mt\malloc.h>

   The multiple-thread files may also be specified by using the \I
   option on the CL command line. The multiple-thread dynamic-link
   library example (Section 5.2.3) uses this method to specify an
   alternate include directory path.

3. Compile the program with the following conditions set:

   a. Large code-pointer size
   b. Far data-pointer size
   c. Segment setup of SS not equal to DS; DS fixed

   These conditions are specified by setting up a customized memory
   model using the following CL command option:

      /Alfw

   The complete CL invocation is shown below:

      CL  /Alfw /c  mhello.c

4. Link the resulting object file with LLIBCMT.LIB and DOSCALLS.LIB
   only. The default .LIB file should not be used. Specify the
   /NODEFAULTLIBRARY search option (/NOD) to ignore the default
   libraries.

   The complete LINK invocation is shown below:

      LINK  /NOD thread LLIBCMT.LIB DOSCALLS.LIB;

   An alternative invocation that invokes both the compiler and linker
   is shown below:

      CL /Alfw /Zl mhello.c /link llibcmt doscalls

5. Run the program under OS/2.

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.