VSPDL Configuration File (vspd.conf)

Top  Previous  Next

 

Functioning parameters of the VSPDL, and also configurations of individual VSPs are all defined by a single configuration file vspd.conf. The file usually resides at /usr/local/vsp/etc/. You must be logged in as a superuser to be able to edit this file. Editing can be done with any text editor of your choice.

 

After the file is edited and changes saved you must "update" driver configuration by using the following command:

 

/etc/rc.d/init.d/vspd reloadconf

 

This will make the VSPDL re-read the file and start using new configuration. Configuration can be updated even when the VSPDL is working i.e. some VSPs are opened and in use.

 

Vspd.conf has the following structure* (see a sample file in the next topic for actual configuration example):

 

<!-- **** VIRTUAL SERIAL PORT DRIVER FOR LINUX (VSPDL) CONFIGURATION FILE **** -->

<vspdconfig>

 

<!-- ==================== GENERAL CONFIGURATION ==================== -->

 

   <!-- Root directory for the daemon -->

   <root dir="directory"/>

 

   <!-- Path and prefix for device files -->

   <devprefix value="value"/>

 

   <!-- Host to bind by default -->

   <bind host="IP_address"/>

 

   <!-- Timeout for basic I/O operations -->

   <timeout [exec="exec(100)"] [priority="priority(10)"]/>

 

   <!-- VSPdaemon event logging configuration -->

   [<log type="syslog|pipe|file" level="EMR|ALR|CRT|ERR|WRN|NTC|INF|DBG" path="path"/>]

   ...

   ...

   [<log type="syslog|pipe|file" level="EMR|ALR|CRT|ERR|WRN|NTC|INF|DBG" path="path"/>]

 

<!-- ======= CONFIGURATION OF INDIVIDUAL VIRTUAL SERIAL PORTS (VSPs) ======= -->

 

   <!-- -------------------- VSP0 CONFIGURATION -------------------- -->

 

   <!-- VSP number -->

   <vsp num="0">

 

       <!-- HOST AND PORT TO BIND -->

       <bind host="[IP_address]" port="port"/>

 

       <!-- Connection parameters -->

       <connection [rmode="client|server|server/client"] [proto="udp|tcp"] [conmode="ondata|immediately"]

       [timeout="timeout(5)"] [onthefly="outofband|inband|disabled"] [clogin="pwd"] [dlogin="pwd"] />

 

       <!-- Destination device parameters -->

       <destination ip="IP_address"|mac="MAC_address" [port="port(1001)"] [cport="cport(65535)"] />

 

       <!-- Outbound packet generation options -->

       <packets [maxlen="len(255)"] [maxdelay="delay(0)"] [starton="any|char"] [startchar="hex"] [stopchar="hex"] />

 

       <!-- Event logging configuration for this VSP -->

       [<log type="syslog|pipe|file" level="EMR|ALR|CRT|ERR|WRN|NTC|INF|DBG" path="path"/>]

       ...

       ...

       [<log type="syslog|pipe|file" level="EMR|ALR|CRT|ERR|WRN|NTC|INF|DBG" path="path"/>]

 

       <!-- Data dump section -->

       [<dump port="no|yes" path="path"/>]

 

   </vsp>

   <!-- -------------------- END OF VSP0 CONFIGURATION -------------------- -->

 

 

   <!-- -------------------- VSP1 CONFIGURATION -------------------- -->

       <vsp num="1">

       ...

       ...

       </vsp>

   <!-- -------------------- END OF VSP1 CONFIGURATION -------------------- -->

 

</vspdconfig>

<!-- **** END OF VIRTUAL SERIAL PORT DRIVER FOR LINUX (VSPDL) CONFIGURATION FILE **** -->

 

* Some comments found in the actual vspd.conf that comes with the driver were omitted. Default values for optional parameters are shown in purple