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

一个完整的Windows应用程序（C++程序）通常由五种类型的文件组成：源程序文件，头文件，资源描述文件，项目文件，模块定义文件。本文主要讲解模块定义文件。

模块定义 (.def)文件为链接器提供有关被链接程序的导出、属性及其他方面的信息。生成 DLL 时，.def文件最有用。由于存在可代替模块定义语句使用的链接器选项，通常不需要.def 文件。也可以将__declspec(dllexport) 用作指定导出函数的手段。  
   
   在链接器阶段可以使用   /DEF（指定模块定义文件）链接器选项调用 .def  文件。  
   
   如果生成的 .exe 文件没有导出，使用 .def 文件将使输出文件较大并降低加载速度。

模块定义语句的规则  
   
   下列语法规则适用于.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)    时有效。

转自：http://blog.163.com/sandan080@126/blog/static/642750732010042258989/