<prev [index] next>

RendView Manual -- Logger and Admin Port

The logger can save messages RendView normally writes to the terminal so that you can query them using the remote admin port.
The admin port allows you to do more than just querying messages.

Message Logger

The message logger has two history buffers for logging messages: One for errors, warnings and special verbose messages and one for any messages. Both buffers have a limited size; if more messages are to be stored than the limit, the oldest messages get overwritten. Note that messages stored in both buffers consume memory only once.

The idea behind the two-buffer-system is that you may wish to use a fairly large history size for the errors and warnings (and special verbose) and a smaller one which holds all messages (normal verbose and errors, warnings). Hence, you will get all errors and only the last couple of all messages kept in order.

Note that the message history is completely useless if you do not use the remote admin port.
Note that the message logger can only log those messages actually generated. Hence, if you use -verbose=-all, then no verbose messages will ever get displayed or logged irrespective of what settings you specify at the message logger.

Parameters for the message logger

These parameters are understood by the message logger:
-m-tty=SPEC
What messages to write to the terminal. Turn on/off different types of messages using + and - prefixes, possible flags are:
e: error messages
w: warning messages
s: special (verbose) messages
v: normal verbose messages
d: debug (verbose) messages
a: all of the above messages
P: also write a message prefix
The message prefix (+P) is E: for error messages, W: for warnings and S: for special verbose messages.
The default is +ewsvd-P.
-m-ehist-size=NUM
Size in number of messages for the error/warning/special verbose message history.
Default size is 0.
-m-hist-size=NUM
Size in number of messages for the general message history buffer.
Default size is 0.
-m-hist-msg=SPEC
What messages to store in the general message buffer. The SPEC is just like for the -m-tty parameter above but without the P flag.
Default is +a.

Remote Admin Port

The remote admin port lets you stay informed about the state of RendView while it is running and allows you to tune some settings at runtime.
Note that you have to explicitly enable the admin port to make it available and that you must specify a password.

Parameters for the admin port

The admin port understands the following parameters:
-a-enable
Enable the admin port. Must be set to make it usable at all; otherwise RendView will not open the TCP admin port.
Default: disabled (-no-a-enable)
-a-port=NUM
Specify TCP port number to be used for the admin port.
Default: 3105
-a-password=SPEC
Specify access password for remote admin port. The usual password spec is supprted. (Either literal password or none for none, prompt to ask for one at startup, file:PATH to read it from a file.)
Default: Unset; you need to specify one.
-a-itimeout=MSEC
Idle time in seconds: Discommect the admin shell after being idle for more than this time. Note that the idle shell can take care to send appropriate idle commands even if you do not type in any commands. The idle timeout is transferred to the shell upon connect.
Use -1 to disable.
Default: 600 sec
-a-atimeout=MSEC
Time (in msec) for the complete authentication to take place. Note that this is not the time you need to type in your password.
Use -1 to disable.
Default: 5000 msec


<prev [index] next>
Last modified: 2008-02-11 21:06:45 Copyright © 2003 Wolfgang Wieser