最近在用Source Insight（以下简称SI）阅读代码的过程中，发现Linux内核的条件编译太多了，很影响阅读效率。探索了一下SI的界面，发现在“Project->Project Settings...->Conditional Parsing->Conditions...”是有条件解析的配置的，且支持以特定的xml格式导入预编译宏。于是写了一个转换脚本，把Linux内核的.config配置文件转换成SI的.conditions.xml配置文件。导入之后就可以让SI不解析实际上没有被编译进去的内核代码，而且会以特定的格式显示无用代码，减少了阅读代码时的干扰。最终效果，如下图：
按下面的指南操作，你就可以达到一样的效果。
1、转换脚本“lkc2sicx.py”所做的工作
用“make menuconfig”修改内核配置后会生成.config文件。该配置文件中典型的配置项有如下几种：
# CONFIG_LOCALVERSION_AUTO is not set ① 未配置的配置项
CONFIG_PROC_KCORE=y ② 选中的配置项
CONFIG_NF_NAT_IPV4=m ③ 选中并要求编译成模块的配置项
CONFIG_DEFAULT_TCP_CONG="cubic" ④ 字符串配置项
CONFIG_SPLIT_PTLOCK_CPUS=4 ⑤ 数字配置项
再来看看SI的配置文件格式。在SI的“Conditional Parsing”界面，添加了如下的3个配置：
“Export...”这个配置，产生的xml配置文件格式如下：
<?xml version="1.0" encoding="utf-8"?>
<SourceInsightParseConditions
AppVer="4.00.0084"
AppVerMinReader="4.00.0019"
>
<ParseConditions>
<Defines>
<define id="a" value="1" />
<define id="b" value="0" />
<define id="c" value="" />
</Defines>
</ParseConditions>
</SourceInsightParseConditions>
xml格式较为简单。只要进行如下转换即可，
# CONFIG_LOCALVERSION_AUTO is not set => <define id="CONFIG_LOCALVERSION_AUTO" value="" />
CONFIG_PROC_KCORE=y => <define id="CONFIG_PROC_KCORE" value="1" />
CONFIG_NF_NAT_IPV4=m => <define id="CONFIG_NF_NAT_IPV4" value="1" />
CONFIG_DEFAULT_TCP_CONG="cubic" => <define id="CONFIG_DEFAULT_TCP_CONG" value="cubic" />
CONFIG_SPLIT_PTLOCK_CPUS=4 => <define id="CONFIG_SPLIT_PTLOCK_CPUS" value="4" />
.config中未配置的项也要生成是因为，SI默认是忽略条件编译的宏的。如果不显示说明未定义这个宏，SI在解析代码的时候就会忽略条件编译指令，直接解析到宏内部的代码[1]。
2、下载并使用转换脚本
下载 >> lkc2sic_v1.0.zip
下载之后解压，在命令行运行lkc2sicx.py脚本转换配置。用法示例：
$ ./lkc2sicx.py -s kernel.example.config -d example
当前目录下就会生成“example.conditions.xml”的SI条件解析配置文件，在SI中导入该文件，重建项目即可。
3、修改非激活代码显示样式
在SI中未解析的代码被称为未激活代码(Inavtive code)，默认格式是灰色的，没有删除线。为了更加醒目，可以修改一下未激活代码的格式。“Options->Style Properties...->Style Name->Inactive Code”，将字体配置的“Strike-Thru”设置为“ON”即可。如下图：
参考
[1] Source Insight 4.0 用户手册，Source Dynamic.Inc
修订记录
2017-11-01 PM：从网易博客迁移到简书；
2017-10-27 PM：完成初稿；
版权声明：自由转载-非商用-非衍生-保持署名（创意共享3.0许可证）
网友评论