详解VS2005模块定义文件(.def)

 

从VS2005MSDN上翻译的.def文件定义：

1、模块定义    (.def)    文件       
   模块定义    (.def)    文件为链接器提供有关被链接程序的导出、属性及其他方面的信息。生成    DLL    时，.def    文件最有用。由于存在可代替模块定义语句使用的链接器选项，通常不需要    .def    文件。也可以将__declspec(dllexport)    用作指定导出函数的手段。  
   
   在链接器阶段可以使用    /DEF（指定模块定义文件）链接器选项调用    .def    文件。  
   
   如果生成的    .exe    文件没有导出，使用    .def    文件将使输出文件较大并降低加载速度。   
    
2、模块定义语句的规则  
   
   下列语法规则适用于    .def    文件中的所有语句。其他适用于特定语句的规则与各语句一起加以说明。    
   
   语句、属性关键字和用户指定的标识符区分大小写。    
   包含空格或分号    (;)    的长文件名必须用引号    (")    引起。    
   使用一个或多个空格、制表符或换行符，将语句关键字同其参数分开和将各语句分开。指定参数的冒号    (:)    或等号    (=)    两旁有零个或多个空格、制表符或换行符。    
   如果使用    NAME    或    LIBRARY    语句，则这些语句必须位于所有其他语句之前。    
   在    .def    文件中，SECTIONS    和    EXPORTS    语句可以出现多次。每个语句都可以采用多个规范，各规范间必须用一个或多个空格、制表符或换行符分开。语句关键字必须在第一个规范的前面出现一次，并且可以在每个附加规范的前面重复。    
   许多语句都具有等效的    LINK    命令行选项。有关其他详细信息，请参阅相应的    LINK    选项说明。    
   .def    文件中的注释由每个注释行开始处的分号    (;)    指定。注释不能与语句共享一行，但可以在多行语句的规范间出现。（SECTIONS    和    EXPORTS    为多行语句。）    
   以十进制或十六进制为基础指定数值参数。    
   如果字符串参数与保留字匹配，则必须用双引号    (")    将字符串参数引起。  
   
   DESCRIPTION    "text"  
   
   该语句将字符串写入    .rdata    节。将指定的    text    用单引号或双引号（'    或    "）引起。若要在字符串中使用引号（单引号或双引号），请用其他类型的标记括住字符串。  
   
   在模块定义文件中，DESCRIPTION    仅在生成虚拟设备驱动程序    (VxD)    时有效。  
   
   EXETYPE:dynamic    |    dev386  
   
   在模块定义文件中，EXETYPE    仅在生成虚拟设备驱动程序    (VxD)    时有效。如果生成虚拟设备驱动程序时在模块定义文件中没有指定    EXETYPE，并且如果没有指定    /EXETYPE    链接器选项，则静态加载    (dev386)    生效。  
   
   EXPORTS  
   definitions  
   
   EXPORTS    语句引入了一个由一个或多个    definitions（导出的函数或数据）组成的节。每个定义必须在单独一行上。EXPORTS    关键字可以在第一个定义所在的同一行上或在前一行上。.def    文件可以包含一个或多个    EXPORTS    语句。  
   
   导出    definitions    的语法为：  
   
   entryname[=internalname]    [@ordinal    [NONAME]]    [PRIVATE]    [DATA]  
   entryname    是要导出的函数名或变量名。这是必选项。如果导出的名称与    DLL    中的名称不同，则通过    internalname    指定    DLL    中导出的名称。例如，如果    DLL    导出函数    func1()，要将它用作    func2()，则应指定：  
   
   EXPORTS  
   func2=func1  
   @ordinal    允许指定是序号而不是函数名将进入    DLL    的导出表。这有助于最小化    DLL    的大小。.LIB    文件将包含序号与函数之间的映射，这使您得以像通常在使用    DLL    的项目中那样使用函数名。  
   
   可选的    NONAME    关键字允许只按序号导出，并减小结果    DLL    中导出表的大小。但是，如果要在    DLL    上使用    GetProcAddress，则必须知道序号，因为名称将无效。  
   
   可选的    PRIVATE    关键字禁止将    entryname    放到由    LINK    生成的导入库中。它对同样是由    LINK    生成的图像中的导出无效。  
   
   可选的    DATA    关键字指定导出的是数据，而不是代码。例如，可以导出数据变量，如下所示：  
   
   EXPORTS  
   i    DATA  
   当对同一导出使用    PRIVATE    和    DATA    时，PRIVATE    必须位于    DATA    的前面。  
   
   有三种导出定义的方法，按照建议的使用顺序依次为：    
   
   源代码中的    __declspec(dllexport)    关键字    
   .def    文件中的    EXPORTS    语句    
   LINK    命令中的    /EXPORT    规范    
   所有这三种方法可以用在同一个程序中。LINK    在生成包含导出的程序时还创建导入库，除非生成中使用了    .exp    文件。  
   
   以下是    EXPORTS    节的示例：  
   
   EXPORTS  
         DllCanUnloadNow              @1            PRIVATE        DATA  
         DllWindowName    =    Name                  DATA  
         DllGetClassObject          @4    NONAME        PRIVATE  
         DllRegisterServer          @7  
         DllUnregisterServer  
   注意，使用    .def    文件从    DLL    中导出变量时，不需要在变量上指定    __declspec(dllexport)。但是，在任何使用    DLL    的文件中，仍必须在数据声明上使用    __declspec(dllimport)。  
   
   LIBRARY    [library][BASE=address]  
   
   该语句通知    LINK    创建    DLL。LINK    同时还创建导入库，除非生成中使用了    .exp    文件。  
   
   library    参数指定    DLL    的名称。也可以使用    /out    链接器选项指定    DLL    输出名。  
   
   BASE=address    参数设置操作系统用来加载    DLL    的基址。该参数重写    0x10000000    的默认    DLL    位置。有关基址的详细信息，请参阅    /BASE    选项说明。    
   
   请记住，在生成    DLL    时使用    /DLL    链接器选项。  
   
   /HEAP:reserve[,commit]  
   
   HEAPSIZE    所展示的功能与    /HEAP    链接器选项相同。  
   
   NAME    [application][BASE=address]  
   
   该语句指定主输出文件的名称。另一种指定输出文件名的方法是使用    /out    链接器选项，而另一种设置基址的方法是使用    /BASE    链接器选项。如果两种方法都指定了，则    /OUT    重写    NAME。    
   
   如果生成    DLL，NAME    将只影响    DLL    名。  
   
   SECTIONS  
   definitions  
   
   SECTIONS    语句引入了一个由一个或多个    definitions（关于项目输出文件各节的访问说明符）组成的节。每个定义必须在单独一行上。SECTIONS    关键字可以在第一个定义所在的同一行或前一行上。.def    文件可以包含一个或多个    SECTIONS    语句。  
   
   该    SECTIONS    语句为图像文件中的一节或多节设置属性，并可用于重写每种节类型的默认属性。  
   
   definitions    的格式为：  
   
   .section_name    specifier  
   
   此处，.section_name    为程序图像中的节名，specifier    为下列一个或多个访问修饰符：    
   
   EXECUTE    
   READ    
   SHARED    
   WRITE    
   用空格分开修饰符名。例如：  
   
   SECTIONS  
   .rdata    READ    WRITE  
   SECTIONS    标记    definitions    节列表的开始位置。每个定义必须在单独一行上。SECTIONS    关键字可以在第一个定义所在的同一行或前一行上。.def    文件可以包含一个或多个    SECTIONS    语句。支持    SEGMENTS    关键字作为    SECTIONS    的同义词。  
   
   Visual    C++    的早期版本支持：  
   
   section    [CLASS    'classname']    specifier  
   出于兼容性考虑，支持    CLASS    关键字，但忽略了它。  
   
   另一种指定节属性的方法是使用    /SECTION    选项。  
   
   STACKSIZE    reserve[,commit]  
   
   该语句设置堆栈的大小（以字节为单位）。另一种设置堆栈的方法是使用堆栈分配    (/STACK)    选项。有关    reserve    和    commit    参数的详细信息，请参阅关于该选项的文档。    
   
   该选项对    DLL    无效。  
   
   STUB:filename  
   
   当用于生成虚拟设备驱动程序    (VxD)    的模块定义文件时，STUB    允许指定包含将在    VxD    中使用的    IMAGE_DOS_HEADER    结构（在    WINNT.H    中定义）而不是默认头的文件名。  
   
   另一种指定    filename    的方法是使用    /STUB    链接器选项。  
   
   在模块定义文件中，STUB    仅在生成虚拟设备驱动程序    (VxD)    时有效。  
   
   VERSION    major[.minor]  
   
   该语句通知    LINK    将一个数字放到    .exe    文件或    DLL    的头中。major    和    minor    参数是从    0    到    65,535    的范围内的十进制数。默认值为    0.0    版。  
   
   另一种指定版本号的方法是使用版本信息    (/VERSION)    选项。    
   
   VXD    filename  
   
   允许指定虚拟设备驱动程序    (VxD)    的名称。默认情况下，VxD    获取与第一个对象文件相同的名称。  
   
   另一种指定虚拟设备驱动程序版本的方法是使用    /VXD    链接器选项，另一种命名输出文件的方法是使用    /out    选项。  
   
   在模块定义文件中，VXD    仅在生成虚拟设备驱动程序    (VxD)    时有效

3、用DEF文件导出函数可以避免动态库编译时自动把参数加入来修饰函数名，导致调用时出现找不到函数入口点的问题。

参考：http://msdn.microsoft.com/zh-cn/28d6s79h(VS.90).aspx