rb

模块

RB

模块摘要

报表浏览器工具

描述

报告浏览器（RB）工具用于浏览和格式化错误记录器处理程序log_mf_h在STDLIB中编写的错误报告。

出口

filter(Filters)filter(Filters, Dates)

类型

显示与提供的筛选器匹配的报表。

当筛选器包括no原子，它排除了与筛选器匹配的报表。

使用proplists模块在STDLIB中。报告必须是与任何过滤器相匹配的产品。

如果筛选器具有以下形式{Key, RegExp, re}，则报表必须包含一个键为Key并且该值必须与正则表达式匹配。RegExp...

IF参数Dates指定时，将根据报告发生的日期对报表进行筛选。如果Dates有表格{DateFrom, from}之后发生的报告DateFrom都会显示。

如果Dates有表格{DateTo, to}，以前发生的报告DateTo都会显示。

如果两个Dates指定，则返回在这些日期之间发生的报告。

若要仅按日期筛选，请将空列表指定为Filters参数。

有关参数的详细信息RegExp，请参阅rb:grep/1。

有关数据类型的详细信息mp()，请参阅re:mp()。

有关数据类型的详细信息datetime()，请参阅calendar:datetime()。

grep(RegExp)

类型

所有与正则表达式匹配的报表RegExp都会显示。RegExp可以是下列任何一种：

• 包含正则表达式的字符串。

• 包含字符串和编译选项的元组。

• 编译的正则表达式

• 编译的正则表达式和运行它的选项。

有关有效正则表达式和选项的定义，请参见reSTDLIB中的模块，特别是函数re:run/3。

有关数据类型的详细信息mp()，请参阅re:mp()。

h()help()

显示联机帮助信息。

list()list(Type)

类型

列出加载的所有报告rb_server。每个报告都有一个唯一的编号，可用作功能中报告的参考show/1。

如果没有Type指定时，将列出所有报告。

log_list()log_list(Type)

类型

相同的功能list/0或list/1，但结果打印到一个日志文件，如果设置; 否则standard_io。

如果没有Type指定时，将列出所有报告。

rescan()rescan(Options)

类型

重新扫描报告目录。Options与功能相同start/1。

show()show(Report)

类型

IF论证type指定时，将显示此类型的所有已加载报表。如果指定了整数参数，则显示具有此引用号的报表。如果未指定参数，则显示所有报表。

start()start(Options)

类型

功能start/1开始rb_server使用指定的选项，而start/0从默认选项开始。rb_server必须在浏览报表之前启动。何时rb_server启动时，将扫描指定目录中的文件。其他函数假设服务器已经启动。

备选方案：

{start_log, FileName}

开始记录到文件，注册名称或io_device。所有报告都打印到指定的目的地。默认是standard_io。选项{start_log, standard_error}是不允许的，将被默认取代standard_io。

{max, MaxNoOfReports}

控制rb_server启动时要读取多少个报告。该选项很有用，因为该目录可以包含大量报告。如果指定了此选项，MaxNoOfReports则读取最新的报告。默认是all。

{report_dir, DirString}

定义错误日志文件所在的目录。默认值是由应用程序环境变量指定的目录error_logger_mf_dir，请参阅sasl(6)。

{type, ReportType}

控制rb_server在启动时要读取哪种报告。ReportType是受支持的类型，all或受支持类型的列表。默认是all。

{abort_on_error, Bool}

指定在rb遇到不可打印报告时是否结束记录。（你可以得到一个报告，一个不正确的形式，如果功能error_logger，error_msg或info_msg已调用一个无效的格式字符串）

• 如果Bool是true，则在遇到格式不正确的报告时rb停止记录（并输出错误消息stdout）。如果启用日志记录功能，则还会向日志文件追加错误消息。

• 如果Bool是false（缺省值），rb则会stdout为遇到的每个错误报告输出错误消息，但记录过程永远不会结束。所有可打印的报告都被写入。如果记录到文件中被启用，rb打印* UNPRINTABLE REPORT *日志文件以不可打印报告的位置。

start_log(FileName)

类型

将RB工具的所有报告输出重定向到指定的文件，注册名称或io_device。

stop()

停止rb_server。

stop_log()

关闭日志文件。RB工具的输出指向standard_io。