SWB 附录 C：Sentaurus Workbench 文件

来源：swb_ug.pdf Appendix C（W-2024.09） 原文标题：Sentaurus Workbench Files 说明：本页按 2024 版附录 C 的原分组顺序整理，尽量完整保留各类 SWB 文件的名称、位置与用途。

本附录目录

• 附录说明
• 项目文件
• 隐藏文件
• 用户配置文件
• 全局配置文件
• 站点配置文件
• 典型输入输出文件

---

附录说明

本附录列出与 Sentaurus Workbench 相关的各类文件。它的价值在于把“文件名”“所在目录”“作用”三件事放到同一页里，便于在排障、迁移、站点配置和项目整理时快速对照。

从内容组织上看，附录 C 覆盖了三层信息：

• 项目目录中直接可见的 SWB 文件
• 项目或用户环境中可能默认隐藏的文件
• 用户级、全局级、站点级配置文件

最后，手册还给出了一组典型输入输出文件命名模式，用来说明工具模板、预处理后节点输入文件和节点输出文件之间的关系。

项目文件

手册先列出了一组“项目专属”的 SWB 文件，也就是通常直接出现在项目目录里的文件。

项目文件总表

文件名	作用
gcomments.dat	保存项目工具步骤的注释
genopt.py	Optimization Framework 的输入文件
gexec.cmd	作业执行图
glog.txt	项目日志数据
gopt.log	Optimization Framework 的日志文件
gqueues.dat	队列配置文件
greadme.pdf	项目的 PDF 文档文件
greadme.txt	项目的文本说明文件
gsummary.txt	项目摘要
gtooldb.tcl	项目的工具数据库
gtree.dat	仿真树
gvars.dat	项目全部变量
preprocessor.log	预处理日志数据
runlimits.txt	项目 run limits 设置

使用理解

这一组文件里，最常被直接查看或排障引用的通常有：

• glog.txt
• gsummary.txt
• preprocessor.log
• gexec.cmd

而更偏“配置载体”的则是：

• gqueues.dat
• gtooldb.tcl
• runlimits.txt

如果把它和前面正文关联起来：

• Chapter 6 会频繁关联 preprocessor.log
• Chapter 7、Chapter 11 会频繁关联 gexec.cmd、glog.txt、gqueues.dat
• Chapter 9 会关联 gtooldb.tcl 与 runlimits.txt

隐藏文件

手册接着说明，一些文件不一定会在项目目录的常规列表中显示，它们属于“隐藏文件”。这意味着即使项目实际依赖这些文件，用户在普通目录浏览器里也未必能第一眼看到它们。

这一点在迁移项目、比对项目差异或手工排障时尤其重要，因为“看不到”不代表“没有”。

用户配置文件

手册说明，这一组文件都位于 env(STDB) 目录下，也就是用户当前 SWB 工作根目录中。

用户级文件总表

文件名	作用
.database	项目视图设置数据库
.history	项目事件历史，包括预处理、运行和清理
.organization	项目组织方式，取值为 traditional 或 hierarchical
.project	空文件，用于标记当前目录是项目目录
.status	项目状态
gqueues_<user>.dat	用户级队列配置文件
tooldb_<user>	用户级工具数据库
runlimits_<user>.xml	用户级 run limits 设置
gpref2_<user>.<release>.xml	用户首选项文件

gpref2_<user>.<release>.xml 的版本行为

手册特别指出，首选项文件是按 TCAD Sentaurus 版本分别保存的，而且这里的版本不仅区分大版本，也区分 feature / service pack 版本。

手册给出的例子是：

• Sentaurus Workbench U-2022.12 对应 gpref2_jsmith.U-2022.12.xml
• Sentaurus Workbench U-2022.12-SP1 对应 gpref2_jsmith.U-2022.12-SP1.xml

也就是说，不同发布版本之间通常不会共享同一份首选项 XML。

使用理解

这一组文件里，最值得记住的是前面那几个点文件：

• .database 关系到项目视图设置
• .history 关系到项目事件轨迹
• .organization 直接决定项目是传统组织还是层级组织
• .project 是“这个目录是不是 SWB 项目”的标志

如果你在做项目迁移、目录修复或版本兼容性检查，这几个文件通常比 greadme.txt 一类说明文件更关键。

全局配置文件

手册把全局配置文件分成两个位置说明。

目录位置

• $STROOT/queues
• $STROOT/tcad/$STRELEASE/lib/glib2

全局级文件总表

位置	文件名	作用
$STROOT/queues 或 $STROOT/tcad/$STRELEASE/lib/glib2	gqueues.dat	全局队列配置文件
$STROOT/tcad/$STRELEASE/lib/glib2	tooldb.tcl	全局工具数据库
$STROOT/tcad/$STRELEASE/lib/glib2	runlimits.xml	全局 run limits 设置
$STROOT/tcad/$STRELEASE/lib/glib2	gpref2.$STRELEASE.xml	全局首选项

使用理解

这一层是 SWB 的“系统默认层”。如果用户级和项目级没有覆盖，很多默认行为都从这里来。

因此：

• gqueues.dat 决定默认可见队列
• tooldb.tcl 决定默认工具数据库定义
• runlimits.xml 决定默认运行限制
• gpref2.$STRELEASE.xml 决定默认首选项

它和 Chapter 9、Chapter 11 的关系非常直接。

站点配置文件

附录 C 接着列出站点级配置文件。手册说明，这些文件都位于 SWB_SITE_SETTINGS_DIR 指向的目录中。

站点级文件总表

文件名	作用
gqueues.dat	站点级队列配置文件
tooldb.tcl	站点级工具数据库
runlimits.xml	站点级 run limits 设置
gpref2.$STRELEASE.xml	站点级首选项

使用理解

站点级配置文件的意义，不在于定义“最底层默认值”，而在于给企业、团队或实验室统一注入一套受控配置。

也就是说：

• 如果全局层是软件安装自带默认值
• 那么站点层就是组织内部真正希望统一推广的配置

正文中我们已经在 Chapter 9、Chapter 11 多次碰到这一层；附录 C 的作用，就是把文件名和路径位置补齐。

典型输入输出文件

附录 C 最后一节给出了一组项目里常见的文件模式。手册提醒，这些只是典型模式，实际文件名仍然取决于工具数据库中的定义。

典型文件模式

模式	含义
<tool_label>_<tool_acronym>.cmd	输入文件模板，也就是某个工具的命令文件
<tool_label>_<tool_acronym>.*	某工具的其他输入文件，这些文件在工具数据库中配置
pp<node_number>_<tool_acronym>.*	预处理后生成的节点输入文件
n<node_number>_<tool_acronym>.*	节点输出文件

使用理解

这一组模式能帮助你快速区分三个层级：

1. 工具模板输入文件
2. 预处理后、已带节点上下文的输入文件
3. 真正运行产生的节点输出文件

在日常排障中，这个区分非常有用：

• 想看“原始模板怎么写”，通常去找 <tool_label>_<tool_acronym>.cmd
• 想看“预处理后到底替换成了什么”，通常去找 pp<node_number>_<tool_acronym>.*
• 想看“运行结果是什么”，则看 n<node_number>_<tool_acronym>.*

---

附录 C 的核心价值，在于把 SWB 的文件体系从“零散记忆”变成“可查目录”。以后如果继续细化，这一页最值得再补的两块是：

1. 给高频文件补“常见查看场景”，例如排障、迁移、调度、视图配置
2. 把用户级 / 全局级 / 站点级这三层文件做成一张并排对照表