pamxy

为了那么丁点的兴趣,你懂的...

导航

.def

转自:百度百科http://baike.baidu.com/view/3306332.htm


这个狠重要,因为不知道有这个东西,搞了一天!~



编辑本段简介

模块定义文件(.def) 模块定义文件是一个有着.def文件扩展名的文本文件。它被用于导出一个DLL的函数,和__declspec(dllexport)很相似,但是.def文件并不是Microsoft定义的。

编辑本段文件详解

一个.def文件中只有两个必需的部分:LIBRARY 和 EXPORTS。
让我们先看一个基本的.def文件稍后我将解析之。
LIBRARY dll_tutorial
DESCRIPTION "our simple DLL"
EXPORTS Add @1 Function @2
第一行,''LIBRARY''是一个必需的部分它告诉链接器(linker)如何命名你的DLL。下面被标识为''DESCRIPTION''的部分并不是必需的,但是我喜欢把它放进去。该语句将字符串写入 .rdata 节[据 MSDN],它告诉人们谁可能使用这个DLL,这个DLL做什么或它为了什么(存在)。在下面的部分标识为''EXPORTS''是另一个必需的部分;这个部分使得该函数可以被其它应用程序访问到并且它创建一个导入库。当你生成这个项目时,不仅是一个.dll文件被创建,而且一个文件扩展名为.lib的导出库也被创建了。除了前面的部分以外,这里还有其它四个部分标识为:NAME, STACKSIZE, SECTIONS, 和 VERSION。我将不再在本文中涉及这些内容,但是如果你在Internet上搜索,我想你将找到一些东西(译注: MSDN2003上对模板定义文件各部分内容有详尽解释,请参阅)。另外,一个分号(;)开始一个注解
以下摘自MSDN,希望有帮助。不过在VC下编程好像用不着自己定义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
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)   时有效。

posted on 2013-03-07 21:23  pamxy  阅读(276)  评论(0编辑  收藏  举报