Using the LINK32 -LIB Command

 Last reviewed: July 20, 1995
Article ID: Q100084
The information in this article applies to:
  • Microsoft FORTRAN PowerStation for MS-DOS, version 1.0 and 1.0a

SUMMARY

The text below presents the LINK32 librarian, its command line options, and how to use the utility.

This information differs somewhat for the FORTRAN PowerStation 32 for Windows NT linker, LINK. Please see the documentation for that product for more details.

MORE INFORMATION

LINK32.EXE performs several functions, specified by one of the following command-line options: 

   -LINK   Create an executable file (linking)
   -LIB    Create or modify a library (librarian)
   -DUMP   Display information about a library
The LINK32 librarian is a fairly simple tool that adds, removes, and extracts COFF object files from libraries.

The LINK32 -LIB options are as follows: 

   -DEBUGTYPE:{COFF|CV|BOTH}  Do not use
   -DEF:[filename]            Create an import library
   -EXTRACT:membername        Extract an object file from a library
   -LIST                      List object files in a library
   -MACHINE:i386              Required with the -DEF option,
                                 not used otherwise
   -OUT:filename              Specifies library name
   -REMOVE:membername         Remove object module from library
   -SUBSYSTEM                 Do not use
   -VERBOSE                   Do not use
The following examples demonstrate using these options to perform common library management tasks.

Example #1

To build the library TEST.LIB that contains the modules A.OBJ and B.OBJ, use the following command line: 

   LINK32 -LIB -OUT:TEST.LIB A.OBJ B.OBJ

Example #2

To modify the existing library TEST.LIB to add the modules A.OBJ and B.OBJ, use the following command line: 

   LINK32 -LIB TEST.LIB A.OBJ B.OBJ

Example #3

To create a file that lists the object modules in a library, use the following command line: 

   LINK32 -LIB -LIST TEST.LIB >TEST.LST
This command line generates a listing that contains the names of the object files in the library; the listing does not list the routines in each object file. To retrieve this information, use the -DUMP option.

Example #4

To update a library with a new version of an object module, use the following command lines: 

   LINK32 -LIB TEST.LIB -REMOVE:A.OBJ
   LINK32 -LIB TEST.LIB A.OBJ
No single command can do this. Avoid the following commands: 

   LINK32 -LIB TEST.LIB A.OBJ             !if A.OBJ is in TEST.LIB
   LINK32 -LIB TEST.LIB A.OBJ -OUT:TEST.LIB
   LINK32 -LIB TEST.LIB -REMOVE:A.OBJ A.OBJ
NOTE: Modules cannot be added to a library which has had all of the modules removed.

NOTE: The object module specified by -REMOVE:obj_name must have the same case as shown by: 

   LINK32 -LIB -LIST
In other words, -REMOVE is case sensitive.

Additional reference words: kbinf 1.00 1.00a
KBCategory: kbusage kbtool
KBSubcategory: LnkIss

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.

Last reviewed: July 20, 1995
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.