1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
.TH rb 3 "sasl 2.1.5.3" "Ericsson AB" "ERLANG MODULE DEFINITION"
.SH MODULE
rb \- The Report Browser Tool
.SH DESCRIPTION
.LP
The Report Browser (RB) tool makes it possible to browse and format error reports written by the error logger handler \fIlog_mf_h\fR\&.
.SH EXPORTS
.LP
.B
grep(RegExp)
.br
.RS
.TP
Types
RegExp = string()
.br
.RE
.RS
.LP
All reports containing the regular expression \fIRegExp\fR are printed\&.
.LP
\fIRegExp\fR is a string containing the regular expression\&. Refer to the module \fIregexp\fR in the STDLIB reference manual for a definition of valid regular expressions\&. They are essentially the same as the UNIX command \fIegrep\fR\&.
.RE
.LP
.B
h()
.br
.B
help()
.br
.RS
.LP
Prints the on-line help information\&.
.RE
.LP
.B
list()
.br
.B
list(Type)
.br
.RS
.TP
Types
Type = type()
.br
type() = crash_report | supervisor_report | error | progress
.br
.RE
.RS
.LP
This function lists all reports loaded in the \fIrb_server\fR\&. Each report is given a unique number that can be used as a reference to the report in the \fIshow/1\fR function\&.
.LP
If no \fIType\fR is given, all reports are listed\&.
.RE
.LP
.B
rescan()
.br
.B
rescan(Options)
.br
.RS
.TP
Types
Options = [opt()]
.br
.RE
.RS
.LP
Rescans the report directory\&. \fIOptions\fR is the same as for \fIstart()\fR\&.
.RE
.LP
.B
show()
.br
.B
show(Report)
.br
.RS
.TP
Types
Report = int() | type()
.br
.RE
.RS
.LP
If a type argument is given, all loaded reports of this type are printed\&. If an integer argument is given, the report with this reference number is printed\&. If no argument is given, all reports are shown\&.
.RE
.LP
.B
start()
.br
.B
start(Options)
.br
.RS
.TP
Types
Options = [opt()]
.br
opt() = {start_log, FileName} | {max, MaxNoOfReports} | {report_dir, DirString} | {type, ReportType} | {abort_on_error, Bool}
.br
FileName = string() | standard_io
.br
MaxNoOfReports = int() | all
.br
DirString = string()
.br
ReportType = type() | [type()] | all
.br
Bool = true | false
.br
.RE
.RS
.LP
The function \fIstart/1\fR starts the \fIrb_server\fR with the specified options, while \fIstart/0\fR starts with default options\&. The \fIrb_server\fR must be started before reports can be browsed\&. When the \fIrb_server\fR is started, the files in the specified directory are scanned\&. The other functions assume that the server has started\&.
.LP
\fI{start_log, FileName}\fR starts logging to file\&. All reports will be printed to the named file\&. The default is \fIstandard_io\fR\&.
.LP
\fI{max, MaxNoOfReports}\fR\&. Controls how many reports the \fIrb_server\fR should read on start-up\&. This option is useful as the directory may contain 20\&.000 reports\&. If this option is given, the \fIMaxNoOfReports\fR latest reports will be read\&. The default is \&'all\&'\&.
.LP
\fI{report_dir, DirString}\fR\&. Defines the directory where the error log files are located\&. The default is \fI{sasl, error_logger_mf_dir}\fR\&.
.LP
\fI{type, ReportType}\fR\&. Controls what kind of reports the \fIrb_server\fR should read on start-up\&. \fIReportType\fR is a supported type, \&'all\&', or a list of supported types\&. The default is \&'all\&'\&.
.LP
\fI{abort_on_error, Bool}\fR\&. This option specifies whether or not logging should be aborted if rb encounters an unprintable report\&. (You may get a report on incorrect form if the \fIerror_logger\fR function \fIerror_msg\fR or \fIinfo_msg\fR has been called with an invalid format string)\&. If \fIBool\fR is \fItrue\fR, rb will stop logging (and print an error message to stdout) if it encounters a badly formatted report\&. If logging to file is enabled, an error message will be appended to the log file as well\&. If \fIBool\fR is \fIfalse\fR (which is the default value), rb will print an error message to stdout for every bad report it encounters, but the logging process is never aborted\&. All printable reports will be written\&. If logging to file is enabled, rb prints \fI* UNPRINTABLE REPORT *\fR in the log file at the location of an unprintable report\&.
.RE
.LP
.B
start_log(FileName)
.br
.RS
.TP
Types
FileName = string()
.br
.RE
.RS
.LP
Redirects all report output from the RB tool to the specified file\&.
.RE
.LP
.B
stop()
.br
.RS
.LP
Stops the \fIrb_server\fR\&.
.RE
.LP
.B
stop_log()
.br
.RS
.LP
Closes the log file\&. The output from the RB tool will be directed to \fIstandard_io\fR\&.
.RE
|
