Using the LINK32 -DUMP Command

 Last reviewed: July 20, 1995
Article ID: Q100085
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 command line options that display information about a library or an executable file and how to use them.

FORTRAN PowerStation 32 comes with a different linker, LINK. For more information on LINK.EXE, please see the documentation.

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 -DUMP option provides access to information in COFF object files, libraries, and PE executable files.

The LINK32 -DUMP options are as follows: 

   -ALL                 Provides all information available as
                        formatted output
   -ARCHIVEMEMBERS      Name and size of each object file in a library
   -DISASM              Disassembles the contents of the file
   -EXPORTS             Do Not Use
   -FPO                 Do Not Use
   -HEADERS             Displays header information from each section
                        in the file
   -IMPORTS             Do Not Use
   -LINENUMBERS         Displays line number information in the
                        symbolic information
   -LINKERMEMBER:[1|2]  Displays names of routines in a library
   -MAP                 Symbol maps of libraries
   -OUT:filename        Do Not Use - Use output redirection to store
                        output in a file
   -RAWDATA             Displays requested information in raw,
                        unformatted, form
   -RELOCATIONS         Displays relocation information
   -SECTION:name        Displays section-specific information
   -S                   Shorthand notation for -SUMMARY and -SYMBOLS
   -SUMMARY             Displays header information summary
   -SYMBOLS             Displays symbol information in object files
                        and libraries
The following examples demonstrate using these options to perform common library management tasks.

Example #1

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

   LINK32 -LIB -LIST TEST.LIB >TEST.LST

Example #2

To create a file that contains a listing of the code routines in a library, use the following command line: 

   LINK32 -DUMP -LINKERMEMBER:2 TEST.LIB > TEST.LST
The -LINKERMEMBER:1 option lists the routines in the order in which they occur in the library. The -LINKERMEMBER:2 option lists the routines in alphabetical order. The -LINKERMEMBER option generates both lists.

Example #3

To create a file that contains a listing of the routines and the modules in which they appear, use the following command line: 

   LINK32 -DUMP -SYMBOLS TEST.LIB > TEST.LST

Example #4

To create a file that contains summary information listing the size (in hexadecimal notation) of the sections in an executable file, use the following command line: 

   LINK32 -DUMP -SUMMARY TEST.EXE
This command produces output such as the following: 

   Summary
     .text     9200   Code
      .bss    F4600   Uninitialized static data
    .rdata      200   Resource data
    .const      200   Constant data
     .data     2400   Initialized static data
      .CRT      200   Runtime data
    .idata      600   Import data
    .reloc     2200   Relocation data

Example #5

The following command fails to direct all of its output to the TEST.LST file: 

   LINK32 -DUMP -LINKERMEMBER TEST.LIB -OUT:TEST.LST
This command sends only its initial output to the file; the remainder appears on the screen. Redirect the output of the command into a file to work around this problem.

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.