The C-library UUDeview generates some messages about its progress as well as more serious warnings and errors.
A php script should provide a Message Callback function that displays them. The function might also choose to ignore
informative messages and only display the fatal ones.
A Message Callback function takes two parameters.
The first one is a string containing the library message. The second one is an indicator of the message seriousness.
So the following integer constants simply describe the seriousness of a library message :
- UUMSG_MESSAGE : This is just a plain informative message, nothing important.
- UUMSG_NOTE : Still an informative message, meaning that the library made a decision on its own that might interest the user.
- UUMSG_WARNING : A warning indicates that a non-serious problem occurred which did not stop the library from proceeding
with the current action. One example is a temporary file that could not be removed. Warnings should be displayed.
- UUMSG_ERROR : A problem occurred that caused termination of the current request, for example if the library tried to access
a non-existing file. After an error has occurred, the php script should closely examine the resulting return code of the operation.
- UUMSG_FATAL : This would indicate that a serious problem has occurred that prevents the library from processing any more
requests. Currently unused.
- UUMSG_PANIC : Such a message would indicate a panic condition. Unused so far.