next up previous contents index
Next: Command Interface Up: Introduction to MRouter Previous: Theory of Operation   Contents   Index

Use with Xic

Once installed in the standard location, the Xic program from Whiteley Research Inc. will find and load the plug-in on start-up. A message ``Loading MRouter'' will be printed in the console along with the other startup messages.

When Xic starts, it will look for the MRouter plug-in in the following locations, in order.

  1. The value of the MROUTER_PATH environment variable, if found. This is the full path to the shared library. If this variable exists, no other locations are checked.

  2. The MRouter installation location, which defaults to /usr/local/mrouter. If installed in another location, the environment variable MROUTER_HOME can be set to the equivalent path. The library will be found in the lib subdirectory of the installation location.

There is a version compatibility test applied before the plug-in can be loaded. The MRouter version string consists of three integers separated by periods, as

major.minor.release

The major and minor numbers must match the version Xic was built for. If not, the plug-in is not loaded. The release number need not match, consequently there may be differences in behavior seen, but there should be no instability.

If the XIC_PLUGIN_DBG variable is set in the environment, messages are printed in the console tracing the plug-in search and load. This can be used to diagnosae a problem, as the process is otherwise silent.

Presently, the router is controlled exclusively with the !mr text command. The MRouter script function can be used to perform the operations from scripts.


next up previous contents index
Next: Command Interface Up: Introduction to MRouter Previous: Theory of Operation   Contents   Index
Stephen R. Whiteley 2017-02-17