• 详解模块定义(.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/

  • 相关阅读:
    微信公众平台开发者中心安全模式消息体加解密实现
    AES对称加密算法原理
    Token验证失败
    PaySignKey
    UVA 11732
    lua中的pairs和ipairs差别
    【shell学习笔记】curl命令总结
    视频监控系统:C/S & B/S
    Android app开发中用户协议(使用条款)文字自己主动换行
    uva 10154
  • 原文地址:https://www.cnblogs.com/hnfxs/p/3636159.html
Copyright © 2020-2023  润新知