op_vuerr
打印函数调用栈回溯以及其它程序错误信息的实用程序。错误信息提取自由 OPNET 提供的程序或基于 OPNET 目标代码库的程序所维护的错误日志。
描述
大多数 OPNET 提供的程序使用统一的错误处理包来处理错误状况与程序崩溃。该包通过更新消息区域(如果程序具有图形用户界面)或在标准输出设备上打印消息来向用户指示错误。在所有情况下,错误也会记录到管理目录(<HOME>/op_admin)中名为 err_log 的 ASCII 文件中。
err_log 中的每个条目包含以下组成部分:
- 错误分类,指示错误的严重程度。可能的分类列举如下:
- Warning(警告)– 可能导致问题、应由用户检查的状况
- Recoverable Error(可恢复错误)– 不妨碍程序继续运行、但可能导致当前操作被取消的问题。
- Program Abort(程序中止)– 妨碍程序可靠地继续运行、并导致程序立即中止的问题
- Program Fault(程序故障)– 导致 Linux 内核以不可控方式立即中止程序的问题
- 错误发生的日期与时间
- 发生错误的程序
- 发生错误的函数包
- 发生错误的函数
- 错误描述,包括变量取值及相关信息,可用于识别错误的原因
- 程序维护的函数栈内容,技术支持可用它帮助识别错误的位置与原因
随着程序错误的发生并把回溯信息添加到文件中,错误日志持续增长。错误日志之所以是累积的,是为了提供:
- 一份关于近期错误序列的可靠描述,用户或技术支持可用它调查错误的原因
- 一份关于有问题的用户/程序交互的综合摘要,技术支持可定期分析它以改进用户界面
通常,在大量使用一个月之后,错误日志会增长到数千行,因此在磁盘空间紧张时应定期检查日志的大小。用户可以随时删除错误日志文件以减少磁盘空间占用;当下一次错误被记录时,它会按需重新创建。
op_vuerr 程序提供了一种直接查看最近记录的错误的方式。它打开错误日志,找出最后一个错误(或指定的最后 N 个错误),并在标准输出设备上打印回溯信息。op_vuerr 可以从任何目录执行,这使它更加方便。
偏好
本程序支持以下偏好集:
本程序还支持以下附加偏好。
num_err
指定要从错误日志中提取并打印到标准输出设备的错误数量。op_vuerr 打印最近的 N 个错误(即错误日志中最后的 n 个条目),其中 N 是本偏好的取值。
| 类型 | 单位 | 默认值 |
|---|---|---|
| integer | errors | 1 |
示例用法
% op_vuerr
<<< Program Abort >>>
* Time: Fri May 17 17:31:48 1996
* Program: op_runsim (Version 3.0.A)
* Package: Simulation Kernel
* Function: sim_err_print (severity_level, str0, str1)
* Error: Error encountered rebuilding repository -- unable to proceed
T (0), EV (-1), MOD (NONE), PROC (sim_load_repos_load)
* Function call stack: (builds down)
------------------------------------------------------------
Call Block
Count Line# Function
------------------------------------------------------------
0) 1 267 main (argc, argv, envp)
1) 1 204 sim_init (argc, argv, envp)
2) 1 148 sim_load_models (net_name)
3) 1 571 sim_load_repos_load (net_name)
4) 2 171 sim_err_print (severity_level, str0, str1)
5) 3 224 Vos_Error_Print (level, package, error0, error1, error2)
------------------------------------------------------------
%
函数调用栈中的每一行除函数名与参数外,还包含调用计数和块行号。调用计数指定自程序执行开始以来该函数被调用的总次数。块行号指定在错误发生时已知在该函数内执行过的最后一个源代码行号。块行号不是细粒度的度量,也不一定列出错误发生时该函数内实际执行的确切行号。
下面的示例使这一点更清楚。它包含一段带行号的示例代码片段和四个假设的错误位置:
1 int function()
2 {
3 int x, y, z;
4 int *ptr;
5
6 z = 0; A
7 for (x = 0; x < 10; x++)
8 {
9 for (y = 0; y < 10; y++) B
10 {
11 z += y;
12 z += x; C
13 }
14 }
15 return z; D
16 }
下表列出 op_vuerr 针对前面示例中每个位置将返回的行号:
表 23:op_vuerr 针对每个错误位置返回的行号
| 位置 | 报告的行号 |
|---|---|
| A | 2 |
| B | 8 |
| C | 10 |
| D | 14 |