VSPDL Configuration File (vspd.conf)

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 ==================== -->

&lt;!-- Root directory for the daemon --&gt;

&lt;[root dir](vspl_general_root)="directory"\/&gt;



&lt;!-- Path and prefix for device files --&gt;

&lt;[devprefix value](vspl_general_devprefix)="value"\/&gt;



&lt;!-- Host to bind by default --&gt;

&lt;[bind host](vspl_general_bind)="IP\_address"\/&gt;



&lt;!-- Timeout for basic I\/O operations --&gt;

&lt;[timeout](vspl_general_timeout) \[ **exec**="exec\( **100**\)"\] \[ **priority**="priority\( **10**\)"\]\/&gt;



&lt;!-- VSPdaemon event logging configuration --&gt;

\[&lt;[log](vspl_general_log)  **type**=" **syslog** **|**pipe **|**file"  **level**="EMR **|**ALR **|**CRT **|**ERR **|**WRN **|**NTC **|**INF **|**DBG"  **path**="path"\/&gt;\]

...

...

\[&lt;[log](vspl_general_log)  **type**=" **syslog** **|**pipe **|**file"  **level**="EMR **|**ALR **|**CRT **|**ERR **|**WRN **|**NTC **|**INF **|**DBG"  **path**="path"\/&gt;\]

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

&lt;!-- -------------------- VSP0 CONFIGURATION -------------------- --&gt;



&lt;!-- VSP number --&gt;

&lt;[vsp](vspl_port_config) [num](vspl_port_number)="0"&gt;



    &lt;!-- HOST AND PORT TO BIND --&gt;

    &lt;[bind](vspl_port_bind) [host](vspl_port_bind_host)="\[IP\_address\]" [port](vspl_port_bind_port)="port"\/&gt;



    &lt;!-- Connection parameters --&gt;

    &lt;[connection](vspl_port_connection) \[[rmode](vspl_port_connection_rmode)=" **client** **|**server **|**server\/client"\] \[[proto](vspl_port_connection_proto)=" **udp** **|**tcp"\] \[[conmode](vspl_port_connection_conmode)=" **ondata** **|**immediately"\]

    \[[timeout](vspl_port_connection_timeout)="timeout\( **5**\)"\] \[[onthefly](vspl_port_connection_onthefly)=" **outofband** **|**inband **|**disabled"\] \[[clogin](vspl_port_connection_clogin)="pwd"\] \[[dlogin](vspl_port_connection_dlogin)="pwd"\] \/&gt;



    &lt;!-- Destination device parameters --&gt;

    &lt;[destination](vspl_port_dest) [ip](vspl_port_dest_ip)="IP\_address" **|**[mac](vspl_port_dest_mac)="MAC\_address" \[[port](vspl_port_dest_port)="port\( **1001**\)"\] \[[cport](vspl_port_dest_cport)="cport\( **65535**\)"\] \/&gt;



    &lt;!-- Outbound packet generation options --&gt;

    &lt;[packets](vspl_port_packets) \[[maxlen](vspl_port_packets_maxlen)="len\( **255**\)"\] \[[maxdelay](vspl_port_packets_maxdelay)="delay\( **0**\)"\] \[[starton](vspl_port_packets_starton)=" **any** **|**char"\] \[[startchar](vspl_port_packets_startchar)="hex"\] \[[stopchar](vspl_port_packets_stopchar)="hex"\] \/&gt;



    &lt;!-- Event logging configuration for this VSP --&gt;

    \[&lt;[log](vspl_port_log)  **type**=" **syslog** **|**pipe **|**file"  **level**="EMR **|**ALR **|**CRT **|**ERR **|**WRN **|**NTC **|**INF **|**DBG"  **path**="path"\/&gt;\]

    ...

    ...

    \[&lt;[log](vspl_port_log)  **type**=" **syslog** **|**pipe **|**file"  **level**="EMR **|**ALR **|**CRT **|**ERR **|**WRN **|**NTC **|**INF **|**DBG"  **path**="path"\/&gt;\]



    &lt;!-- Data dump section --&gt;

    \[&lt;[dump](vspl_port_dump)  **port**=" **no** **|**yes"  **path**="path"\/&gt;\]



&lt; **\/vsp**&gt;

&lt;!-- -------------------- END OF VSP0 CONFIGURATION -------------------- --&gt;





&lt;!-- -------------------- VSP1 CONFIGURATION -------------------- --&gt;

    &lt; **vsp**  **num**="1"&gt;

    ...

    ...

    &lt; **\/vsp**&gt;

&lt;!-- -------------------- END OF VSP1 CONFIGURATION -------------------- --&gt;

< /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