Gem5模拟器，源码调用溯源记录（十三）

救命，我这个🐋🧠，七秒钟的记忆，看完就忘了，每次又去找太麻烦了（我在visual studio中打开，没有装相应的环境，没法通过快捷键找到，只能在整个解决方案中搜索，如果很多文件调用的话就会找很久🆒），我决定把常用到的函数调用所在的源文件记一下，方便回顾，/(ㄒoㄒ)/~~，不定时更新，我看哪儿就记哪儿：

1. 常用的root/gem5/configs/common/Simulation.py中包含：

• cpt_starttick, checkpoint_dir = findCptDir(options, cptdir, testsys), 根据指定的检查点编号（-r），搜索检查点文件夹（--checkpoint-dir）中的所有检查点文件，并找到指定编号的检查点文件。如果找到了指定编号的检查点文件，则返回该检查点文件的开始时钟周期和检查点文件的路径；否则，抛出致命错误
• exit_event=benchCheckpoints(options, m:wqfaxtick, cptdir)，捕捉在checkpoint目录下的一系列检查点文件或者时间到达后退出simulate，并返回退出事件对象
• Simulation.run(options, root, test_sys, FutureClass)，用于

2. 常用的root/gem5/src/python/m5/simulate.py中包含：

• m5.instantiate(checkpoint_dir)，实例化模拟系统，主要用于初始化全局信息，包括统计信息、全局对象等，统计信息：ini/json/dot等，创建C++ sim对象并连接端口，初始化对象或者通过checkpoint重新加载对象（如果存在）
• exit_event = m5.simulate(maxtick - m5.curTick())，用于获取root对象、注册退出函数（输出统计信息和清空模拟器资源），最后返回_m5.event.simulate(*args, **kwargs)的返回值，这个simulate调用的是C++层面的实现（在gem5/src/sim/simulate.cc文件中），后面这个函数用来具体控制Gem5模拟器的运行。

3. 常用的root/gem5/src/python/m5/SimObject.py中包含：

• root.apply_config(options.param)， 获取SimObjects的字典表示，然后迭代params中的每个代码字符串，并使用内置的exec语句（exec 执行储存在字符串或文件中的 Python 语句）在SimObjects的字典上下文中执行代码。执行完代码后，SimObjects的参数将被相应修改。

4. 常用的root/gem5/src/python/m5/main.py中包含：

• parse_options()，定义了一系列的可选参数，包括help option、base simulator、Statistics options（stats.txt在这里指定）、Configuration Options（config.ini，config.json，config.dot均在这里指定，如果有pydot包，这些都会默认输出）、Debugging options（和debug相关的参数）

在绘制dot图时，会调用以下两个函数，分别来自：

• do_dot(root, options.outdir, options.dot_config)，root/gem5/src/python/m5/util/dot_writer.py
• do_ruby_dot(root, options.outdir, options.dot_config),  ~/src/python/m5/util/dot_writer_ruby.py

其它常用函数：

• updateEvents()，root/gem5/src/sim/stat_control.cc，该函数用于更新所有当前统计事件的时间戳，以便它们反映出从检查点恢复后的时间。
• m5.Tick('MaxAddr', 'MaxTick', 'Int32', 'UInt32', 'Int64', 'Param', 'VectorParam')等m5的一系列参数来自于root/gem5/src/python/m5/params.py，m5.Tick和m5.MaxTick=2 ** 64 - 1