同一块测试板上跑着两个采集任务,一个只记错误,另一个为了联调要打印详细日志。如果两边都读取APP_LOG_MODE,把它放进共享环境虽然方便,却很难让两个任务同时使用不同的值。VxWorks的任务私有环境可以解决这类配置冲突。动手前要分清程序跑在内核任务里,还是作为实时进程RTP运行,因为这两种场景传入环境变量的方式不同。
一、VxWorks环境变量怎么设置
内核任务可以用putenv()写入变量,再用getenv()读取。写入会落到调用任务当前使用的环境里,所以在Shell中执行成功,只能说明这次调用成功,目标任务能否读到还要单独核对。
1、在内核任务中写入和读取
环境变量以字符串保存。写入时传入名称和值,读取时只传变量名,等号两边别顺手加上排版用的空格。
①在内核模块中引入【envLib.h】,在初始化代码中调用【putenv()】,例如putenv("APP_LOG_MODE=normal"),并检查返回值。
②在使用配置的任务里调用【getenv()】,例如getenv("APP_LOG_MODE")。先判断返回值是否为NULL,再比较返回的字符串。
③如果变量未设置,在该任务的【初始化函数】中采用约定的默认值,例如normal,并记录一次实际采用的配置。
2、从Shell临时设置时确认作用范围
①在支持C解释器且提供相应符号的内核Shell中执行【envShow(0)】,查看当前任务使用的是全局环境还是私有环境。
②用【putenv()】写入一个便于辨认的测试值,再通过【envShow()】查看目标任务的环境。传入任务标识时,以当前版本的接口声明为准。
③在目标任务的入口处调用【getenv()】,把读到的值和任务名一并写入日志。
Shell也可能有自己的私有环境。此时在Shell里改值,再从同一个Shell里读回来,两次结果都对,其他任务仍然可能读不到。
二、VxWorks任务私有环境变量有什么作用
任务私有环境适合给不同任务保留同名配置。例如两个采集任务可以各自使用APP_LOG_MODE,调试其中一个时,无须改动另一个的日志级别。
1、创建任务时指定私有环境
通过任务创建钩子建立私有环境时,新任务取得的是创建者当时环境的副本。创建者后来改值,新任务不会跟着更新。
①核对当前版本【envLib】的配置与初始化状态,确认映像包含环境变量支持,且启用了用于自动建立私有环境的任务创建钩子。
②在调用【taskSpawn()】前,由创建任务设置需要传下去的初始值。
③创建目标任务时,在【taskSpawn()】的选项中加入【VX_PRIVATE_ENV】,同时保留该任务原本需要的其他选项。
④在新任务的入口中用【getenv()】核对初始值。需要覆盖某项配置时,由新任务调用【putenv()】修改,再读取确认。
2、用两个任务确认同名变量互不影响
①在任务A和任务B的【任务入口】中,分别记录【getenv()】读到的初始值,确认两边都已完成环境初始化。
②让任务A用【putenv()】把APP_LOG_MODE改成verbose,任务B不执行写入。
③在两个任务中再次调用【getenv()】,分别记录任务名和值。任务A应读到verbose,任务B应保留原值。
3、已有任务需要独立配置时单独处理
①如果当前内核版本提供【envPrivateCreate()】,查看随工程安装的【envLib.h】及接口说明,确认目标任务和环境来源参数的含义。
②在业务任务开始读取配置前建立私有环境,检查【envPrivateCreate()】的返回值,再从目标任务内部调用【getenv()】验证。
这里的“私有”指环境表分开维护。它适合避免日志级别、测试开关一类设置互相覆盖,不提供内核任务之间的内存隔离。
三、VxWorks环境变量读不到怎么排查
配置写入和业务读取往往发生在不同的地方。碰到空值或旧值,可以先确定实际执行写入的是哪个任务,再对照业务代码的读取时刻。
1、两边读到的值不同,先对照任务和时序
①在执行【putenv()】的位置记录任务名、变量名、设定值及返回值。
②在业务侧执行【getenv()】的位置记录读取结果,和写入日志放在一起看。如果目标任务有私有环境,同时记下【taskSpawn()】的调用时间。
③如果改值发生在任务启动之后,检查业务代码是否只在【初始化函数】中读过一次,后面一直使用缓存的值。
例如,创建者在启动采集任务后才把日志级别改为verbose,采集任务的私有副本可能还留着normal。另一种情况是环境已经更新,但业务只在启动时读取过一次。两种情况看起来都是日志没变,排查位置却不同。
2、如果程序跑在RTP中,检查启动时传入的环境
从内核任务或另一个RTP调用rtpSpawn()时,不能靠修改调用方的环境来代替参数传递。应用启动需要哪些变量,可以在创建进程时明确列出。
①准备【envp】数组,每项使用名称=值的格式,例如"APP_LOG_MODE=verbose",数组末项用NULL结束。
②调用【rtpSpawn()】时,把数组传入【envp】参数,和用于命令行参数的【argv】分开。
③在RTP的【main()】或初始化代码中用【getenv()】核对读到的值。若结果为空,检查启动程序实际传入的数组是否包含该项。
总结
日志级别、测试开关这类配置,是否该放到任务私有环境里,可以看一件事:两个任务有没有可能同时需要不同的值。如果有,分开维护比约定“谁用完再改回来”省事。交接时也可以顺手写清变量由谁赋值、任务何时读取,以及没传值时用什么默认配置。下次换了启动脚本或调整任务创建顺序,接手的人就能据此判断配置有没有按预期生效。
