DOCUMENT:Q113065  06-MAY-2001  [utilities]
TITLE   :PRB: Extra Copies of Function Added to Library
PRODUCT :Microsoft Programming Utilities
PROD/VER:1.0 2.0 5.0
OPER/SYS:
KEYWORDS:kbVC100 kbVC200 kbVC500 kbVC600

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - The Library Manager (LIB.EXE), included with:
    - Microsoft Visual C++, 32-bit Editions, versions 1.0, 2.0, 5.0 
-------------------------------------------------------------------------------

SYMPTOMS
========

If a function is contained in a library being added to another library, and that
function already exists in the library being added to, LIB.EXE adds it anyway.
The following warning is generated:

   LNK4006: <function name> already defined in <library name>
   <object module name>; second definition ignored

The .OBJ file is added to the library, and can be added multiple times.

CAUSE
=====

This behavior is by design.

RESOLUTION
==========

If you add an object module that is already in the library, the new object
module replaces the old one. However, if you combine libraries, they are always
combined because there could be similarly named object modules in several
different libraries that don't have any of the same functions. The above warning
is generated to indicate conflicting function names.

MORE INFORMATION
================

Examining the contents of the library with the DUMPBIN utility

   DUMPBIN <library name> /symbols

shows multiple copies of the function exist in the library. The DUMPBIN utility
is in the \MSVCNT\BIN directory.

Sample Code
-----------

   /* FILE A.C
      Compile options needed: /c
   */ 

   #include <stdio.h>
   void amain(void)
   {
       printf("a");
   }

   /* FILE B.C
      Compile options needed: /c
   */ 

   #include <stdio.h>
   void bmain(void)
   {
       printf("b");
   }

   /* Lib commands needed: */ 
   /* Create the libraries TEST.LIB and TESTB.LIB   */ 

      lib /out:test.lib a.obj
      lib /out:testb.lib b.obj

   /* Add the contents of TESTB.LIB (B.OBJ) to TEST.LIB:     */ 

      lib test.lib testb.lib

   /* List the current contents of TEST.LIB;                   */ 
   /* it will show one copy of A.OBJ and one copy of B.OBJ.    */ 

      lib test.lib /list

   /* Add the contents of TESTB.LIB (B.OBJ) to TEST.LIB again. */ 
   /* This step generates the above warning.                   */ 

      lib test.lib testb.lib

   /* List the current contents of TEST.LIB;            */ 
   /* it will show two copies of B.OBJ in the library.  */ 

      lib test.lib /list

Additional query words:

======================================================================
Keywords          : kbVC100 kbVC200 kbVC500 kbVC600 
Technology        : kbVCsearch kbAudDeveloper kbLibSearch kbLibManExe
Version           : 1.0 2.0 5.0
Issue type        : kbprb

=============================================================================

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.

Copyright Microsoft Corporation 2001.