Add link to RTD index
[ric-plt/lib/rmr.git] / doc / src / library / rt_tables.xfm
index 0e4b7e6..0b93bdc 100644 (file)
@@ -273,7 +273,7 @@ The connection between RMR and the &RTMGR is also an RMR session and thus
 RMR messages will be used to exchange requests and responses.
 
 &h2(Table Request)
-During initialisation, RMR will establish a wormhole connection to the &RTMGR and sends
+During initialisation, RMR establishes a wormhole connection to the &RTMGR and sends
 a message type of &MT_REQ_TABLE to request a new table.
 RMR will continue to send table requests until a table is received and accepted; in other
 words it is fine for the &RTMGR to ignore the requests if it is not ready to respond.
@@ -299,23 +299,18 @@ Any other response indicates that RMR did not use the table and has dropped it;
 table is still in use.
 
 
+&h2(Using A Static Route Table)
+A static route table can be provided to assist with testing, or to provide a bootstrap set of
+route information until a dynamic table is received from a routing manager.
+The environment variable &cw(RMR_SEED_RT) is checked during RMR initialisation and
+if set is expected to reference a file containing a route table.
+This table will be loaded and used until overlaid by a table sent by the &RTMGR.
+&space
 
-
-&h1(Providing A Static Table)
-For testing, or possibly bootstrapping purposes, a static route table can be supplied.
-During initialisation, RMR will check the &cw(RMR_SEED_RT) environment variable.
-If it exists, and references a file, RMR will open and read the file expecting to find
-a static route table.
-This route table is used until an update is received from a &RTMGR.
-Normally, when the RMR initialisation function is invoked, a listener is started to receive route table information from a route
-manager process.
-During testing it is often useful to supply a static table which is available should no route management process exist,
-or to provide a seed table to use before the first table is delivered.
-The environment variable &cw(RMR_SEED_RT)  can be set to provide the RMR initialisation function with the name
-of the static table to use.
-If a static table is provided, it will be loaded only once, and will be overlaid if
-a dynamically delivered table is received.
-
+For testing, the static table will be reloaded periodically if the &cw(RMR_RTG_SVC) environment
+variable is set to -1.
+When this testing feature is enabled RMR will not listen for &RTMGR connections, nor will it attempt to
+request a dynamic table.
 
 
 &h1(Routing Using MEID)