C 如何显示所有未使用的函数（包括在 h 文件中定义的函数）

Question

Somewhat related to this, but it still doesn't quite answer my question

我有一个 C 项目，我想枚举所有 unreferenced 函数（包括非静态函数，因此为 werror=unused-function 设置编译器选项只能部分起作用。 ..) 以便识别和清理代码库。

我想的一种方法是枚举项目中的所有函数，然后制作一个脚本来遍历每个函数并查看它是否通过 cscope 调用...但我不确定如何获得列表- 首先是所有功能的形式。上面的 link 有一个解决方案对我来说是失败的。

欢迎任何其他想法。

Answer 1

我会使用静态代码分析工具，例如 lint。它是发现代码中潜在问题以及保持代码整洁的好工具，因为它可以配置为指出未使用的 functions/variables/etc.

其他人建议 Cppcheck 这是一个免费的替代品，但我没有使用过，所以我个人不能保证。

Answer 2

有g++编译器选项可以去除或不去除未使用的代码，您可以使用符号表的差异来指向未使用的非虚拟方法。 虚拟方法是 "used"，因为它们被链接到 vtable 中，即使它们从未被调用，所以找到它们的唯一方法是通过覆盖工具或 lint。动态链接库方法是一个不同的问题，因为您应该只需要检查有限数量的已发布入口点。无论如何，您必须决定其他客户是否需要这些入口点。

Answer 3

我在 ncurses 中执行此操作，以查看（自定义）脚本 list-used.sh 使用了哪些 库 符号，该脚本列出了从其库中导出的符号以及哪些从链接到库的程序中使用（或不使用）。

脚本的输出是构成 test/README 文件大部分的报告。

在其他答案中，建议的工具要么 (a) 不可用，要么 (b) 需要对构建结构进行大量返工（按照这些工具的要求将数百个文件放入单个命令行中） ).

Answer 4

知道一个函数是否会被调用是一个不可判定的问题（类似于图灵机的停止问题）。由于您可以通过指针调用一个函数（就像通过回调完成的那样），您无法真正确定一个函数是否会被调用，直到您真正从代码中取出它并 运行 代码。

链接器只链接代码中引用的函数，并不知道它们是否属于不会被调用的死代码。

如果您想知道代码中所有引用的函数，只需 grep 在所有 .o 文件上执行 nm(1) 命令的输出，即可获得所有 U 未定义的引用（这是必须外部链接到您的代码的函数列表）。这将列出所有必须由链接器解析的函数的外部引用。如果您的功能不存在，则该模块不使用它。您可以将此列表与要检查的 .o 文件（或共享对象 .so) 并且您将看到（如同链接器所做的那样）哪些已发布到链接器但未在您的代码中引用。请三思，因为这仅代表直接引用，您还必须管理间接引用（您的模块在另一个模块中请求一个函数，最终请求您尝试检查的函数）。

如果您的函数是 static（仅文件可见性），只需用 #if 0 指令围绕函数定义，您将了解该函数是否在某处被引用。

我再说一遍，你无法轻易知道一个函数是否会在你的代码中被调用，你可以知道它是否在某处被引用。

我不知道你想用这个问题确定什么，但你可以运行进入XY问题实例（你问的不是你试图解决的问题）

顺便说一下，.h 头文件中定义的函数通常由开发人员声明 inline 以优化函数 call/return 的执行。由于这个原因，它们将在使用它们的地方内联，因此，在链接时不会出现对它们的引用，因此您必须在代码中搜索它们（增加了宏扩展的问题，因此您需要 运行预处理器首先找到对那些函数的引用）

Answer 5

您可以尝试CppDepend，它会为您提供代码库中所有未使用的功能。