Message Box from Dissector Plugin

There is a possibility to report an error that, IF your dissector is running in Wireshark, will appear as a message box. If it's running in TShark, it will appear as text on the standard output.

The following functions are declared in epan/report_err.h:

To report an arbitrary message, call

report_failure(const char *msg_format, ...);

It takes, as arguments, a printf-style format string and arguments.

To report an error from an attempt to open a file, call

report_open_failure(const char *filename, int err, gboolean for_writing);

It takes, as arguments:

• the pathname of the file being opened
• an errno value
• a Boolean that's TRUE if the failed attempt was to was open the file for writing and FALSE if it was to open the file for reading

To report an error from an attempt to open a file for reading, call

report_read_failure(const char *filename, int err);

It takes the pathname of the file and an errno value as arguments.

To report an error from an attempt to open a file for writing, call

report_write_failure(const char *filename, int err);

It takes the pathname of the file and an errno value as arguments.