commands/chkdeps/chkdeps.cif
changeset 0 7f656887cf89
equal deleted inserted replaced
-1:000000000000 0:7f656887cf89
       
     1 # chkdeps.cif
       
     2 # 
       
     3 # Copyright (c) 2010 Accenture. All rights reserved.
       
     4 # This component and the accompanying materials are made available
       
     5 # under the terms of the "Eclipse Public License v1.0"
       
     6 # which accompanies this distribution, and is available
       
     7 # at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     8 # 
       
     9 # Initial Contributors:
       
    10 # Accenture - Initial contribution
       
    11 #
       
    12 ==name chkdeps
       
    13 
       
    14 ==short-description
       
    15 
       
    16 Checks the DLL dependancies of a DLL or EXE.
       
    17 
       
    18 ==long-description
       
    19 
       
    20 Outputs the names of any DLLs that this links against that could not be located. In addition the following criteria are checked to ensure the DLLs would load correctly. This is not an exhaustive list of everything that can cause a DLL to fail to link but it attempts to catch most of the common errors:
       
    21 
       
    22 =over 5
       
    23 
       
    24 =item *
       
    25 
       
    26 The UID3 of the DLL matches what is expected.
       
    27 
       
    28 =item *
       
    29 
       
    30 The capabilities are such that the DLL would be allowed to be loaded (only checked if the argument is an EXE).
       
    31 
       
    32 =item *
       
    33 
       
    34 The major version of the DLL matches what is expected. (This does not actually appear to be strictly enforced by the loader but it is checked for anyway).
       
    35 
       
    36 =item *
       
    37 
       
    38 All the ordinals that are being imported are actually present in the DLL.
       
    39 
       
    40 =back
       
    41 
       
    42 ==argument filename file_name
       
    43 
       
    44 The path to a DLL or EXE to check.
       
    45 
       
    46 ==option bool v verbose
       
    47 
       
    48 Display all linked DLLs, not just missing ones.
       
    49 
       
    50 ==option bool d debug
       
    51 
       
    52 Enable debug tracing (only useful for debugging chkdeps itself).
       
    53 
       
    54 ==copyright
       
    55 
       
    56 Copyright (c) 2009-2010 Accenture. All rights reserved.