符号表初始化
符号表用于建立符号名称、类型和值之间的关系。其中,名称为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)
这个宏定义名就是用户要知道的错误信息。
VxWorks 符号表