VxWorks 符号表

符号表初始化

          符号表用于建立符号名称、类型和值之间的关系。其中，名称为null结尾的任意字符串；类型为标识各种符号的整数；值为一个字符指针。符号表主要用来作为目标模块加载的基础，但在需要名称和值关联的任何时候都看使用。

          运行系统中一般存在两个符号表结构sysSymTbl和statSymTbl。sysSymTbl为目标机的系统符号表，通过程序或tShell动态加载的目标模块的符号模块的符号都添加到该符号表中，sysSymTbl和statSymTbl两个标识本身页包含在该系统符号表中。statSymTbl中包含errno的信息，若相在tShell中使用printErrno命令，就必须包含该符号表。

         主机的Target Server只使用一个符号表，看通过全局变量tgtSymTbl访问。

         vxWorks中符号表函数库symLib,提供用于符号表操作的相关函数。系统符号表允许同名冲突，同名符号回加入符号表而不报错，当引用符号时，系统缺省使用symFindByName查找，所以最新加入的符号总会先找到，代替老符号完成引用。同名符号的存在还带来另一个问题，不能确保查找到的符号是自己加载模块的，即不能保证group号。主机symlib库中函数用于维护主机符号表tgtSymTbl。

          vxWorks的符号表与编译器的符号表吧同，vxWorks的符号表时动态存在系统中的，由symLib提供的函数进行维护，在运行过程中可以增加和删除符号，主要用于目标模块的动态加载，与目标模块的格式无关。而编译器中的符号表时静态的，由编译器和连接器在建立程序映像时生成并使用，主要用于符号的静态解析，帮助建立映像，它们的格式和目标类型有关。交叉调试器中源代码调试，页时由静态符号表支持的，这种符号表占用很大的程序映像空间，当程序发布时，可以去掉（不使用 -g 选项）。

        vxWorks需要主机工具在映像生成时完成一些准备工作来建立系统符号表，sysSymTbl和statSymTbl对应两个主机工具makeSymTbl.exe和makeStatTbl.exe，用于生成符号数组以编译进入程序映像。工具makeSymTbl.exe用于创建包含SYMBOL类型数组的symTbl.c文件，包含目标模块中所有全局符号的名称、地址和类型，该全局数组名称为standTbl,其大小为standTblSize,存放在程序映像的data段中。工具makeStatTbl.exe用于创建状态代码SYMBOL数组，包含一些头文件中定义的所有状态代码的名称和值，所有状态代码以“S-”开头，一般库头文件中都有这样的定义。，该全局数组名成为statTbl，其大小为statTblSize,statSymTbl主要由printErrno函数使用，也可以由应用程序使用，输出确定意义的状态信息，存放在程序映像的data段中。

         符号表初始方式有build-in和downloaded两种方式，使用内建符号表时，符号时Vxworks程序映像的一部分；下载符号表则和VxWorks映像分离，由目标机单独下载Sym文件获得符号。若使用下载符号表，使用主机工具xsym，生成符号模块文件VxWorks.sym，该文件和普通目标模块一样，只是没有data和bss段，下载到目标机后，和普通目标模块一样动态加载，模块中的符号会添加到系统符号表。

         目标机符号表时完成动态加载、连接，以及调试的辅助机制，映像有没有符号表都不影响程序正常运行，调试时，只要不从目标机上动态加载目标模块，程序映像符号都静态连接解析，目标机上也可以没有符号，主机开发工具都使用主机符号表tgtSymTbl来完成交叉调试。

      符号表同步

         主机和目标机使用不同的符号表，在主机上使用的各种工具并不能访问目标机上所有的内容，工具都是通过主机上Target Server和目标机上Target Agent进行通信的，主机和目标机都不能直接访问对方的符号信息。主机和目标机都维护着自己的符号表，当添加符号时，将符号加入到其中一个表中，在wShell上添加的符号到了主机符号表，而tShell上添加的符号就到了目标机符号表中，缺省时两个表互不共享，可以通过添加符号表同步组件------INCLUDE_SYM_TBL_SYNC，这样符号会在主机和目标机之间福祉，两符号表会同步更新。

          主机和目标机使用不同的符号表，系统启动时两个符号表的内容是一样的，当动态加载目标模块后，两个符号表就不一致了，从wShell中加载目标模块后，却想从tShell引用该模块符号，或者从tShell加载后，想用主机工具调试该模块，因为wShell或tShell都看不见对方加载的模块，可能出现下面错误：

           Error:module contains undefined symbol

           Unresolved symbol

           Fatal Error: unresolvable symbol

         要解决此问题就需要使用符号表同步机制，Vxworks提供了symSyncLib库来完成符号表同步，系统运行中，从主机或目标机添加的符号都可以被对方看见，symSyncLib会在目标机创建同步任务tSymSyc,该任务被当作WTX工具与主机的Target Server相连，任务启动时，会立即同步符号表。如果不再需要同步符号表，可以手动将tSymSync悬挂起来，以提高目标机性能。

     

       错误状态

          若VxWorks库函数执行出现问题，函数会返回ERROR值，并设置错误状态表示具体的原因和位置。

          错误状态库errnoLib用于获取和设置任务和中断的错误状态值errno，VxWorks每个任务和中断都有自己的errno，任务的errno存放在TCB中，为任务私有，中断的errno存放在中断栈中，只要字啊中断处理函数中errno都有效。

         VxWorks的errno值由4byte构成，高字表明发生错误的库，各库对应的值在“taget/h/vwModNum.h”中定义，低字表示该库发生的具体错误，在相应库的头文件中定义。约定VxWorks系统模块使用高字值，范围为1～500，其他值可以由应用模块使用，对低字值没有规定。

         usrLib提供printErrno函数来显示具体错误信息，printErrno根据输入的errno值，在statSymTbl中查找到对应的错误信息，并显示在标准输出上。

         ----> printErrno 0xd0003

         0xd0003 = S_iosLib_INVALID_FILE_DESCRIPTOR

         "S_"表示状态，iosLib为发生错误的库名称，INVALID_FILE_DESCRIPTOR表示该库具体的错误。

         若想在tShell或程序中调用printErrno来显示错误信息，程序映像中需包含错误代码组件---INCLUDE_STAT_SYM_TBL ,以在目标机建立statSymTbl。‘

         如果不能使用printErrno,也可以手动查找头文件得到错误信息，比如“d0003”,先在vwModNum.h查找“d”对应的库，“d”换算成十进制“13”，查到M_iosLib:              #define M_iosLib        (13 << 16)

         再到iosLib库自己的头文件iosLib.h中查找具体错误，其中“0003”对应的宏定义为：

           # define S_iosLib_INVALID_FILE_DESCRIPTOR     (M_iosLIb | 3)

          这个宏定义名就是用户要知道的错误信息。