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

模块定义(.def)文件  
模块定义(.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
iDATA
当对同一导出使用PRIVATE和DATA时,PRIVATE必须位于DATA的前面。
有三种导出定义的方法,按照建议的使用顺序依次为:
源代码中的__declspec(dllexport)关键字
.def文件中的XPORTS语句
LINK命令中的/EXPORT规范
所有这三种方法可以用在同一个程序中。LINK在生成包含导出的程序时还创建导入库,除非生成中使用了.exp文件。  
以下是EXPORTS节的示例:

EXPORTS
   DllCanUnloadNow @1 PRIVATEDATA
   DllWindowName = Name DATA
  DllGetClassObject @4 NONAMEPRIVATE
  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_namespecifier
此处,.section_name为程序图像中的节名,specifier为下列一个或多个访问修饰符:
EXECUTE
READ
SHARED
WRITE
用空格分开修饰符名。例如:
SECTIONS
.rdata READ WRITE
SECTIONS标记definitions节列表的开始位置。每个定义必须在单独一行上。SECTIONS关键字可以在第一个定义所在的同一行或前一行上。.def文件可以包含一个或多个SECTIONS语句。支持SEGMENTS关键字作为SECTIONS的同义词。

VisualC++的早期版本支持:
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)时有效。

发布了77 篇原创文章 · 获赞 5 · 访问量 38万+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章