Tornado Reference : Tornado Tools
evtRecv - receive WindView event data (UNIX)
evtRecv [-o file] [-p port] [-f] [-q] [-r]
This tool receives event data from an instrumented VxWorks target system and saves the data in a file on the host. This file can then be loaded into WindView by selecting the Analyze item from the File menu of the main WindView window.
The evtRecv tool must be started on the host system prior to enabling event logging on the target system from which the event data is to be captured. When invoked, evtRecv binds to a TCP port on the host (by default port 6164, but this can be overridden via the -p option), and awaits a connection from the target system. The routine wvEvtLogEnable( ) is then invoked on the target (either from the VxWorks shell by the user, or from within application code); this establishes a connection with the evtRecv process on the host, and initiates the transfer of event data. Under normal circumstances, the connection is closed by a subsequent invocation of wvEvtLogDisable( ). If, however, the target application generates event data at a rate that exceeds the network bandwidth, the target system will terminate the event transfer automatically, and evtRecv will print a message warning of target event buffer overflow. In either case, unless the -r option has been specified (see below), the evtRecv process on the host will exit when the logging session has been terminated.
- -o file
- store the event data in file. If file does not end in .wvr, evtRecv appends this suffix automatically. If file is -, the event data is written to standard output, and repetitive receive mode is silently disabled, even if -r is specified. If -o is not present, eventLog.wvr is used by default. (See also the description of the -r option below.)
- -p port
- listen for connections on port port, instead of the default port 6164. Note that it might be necessary to set the port number on the target system as well; use the VxWorks routine wvHostInfoShow( ) to display the current port number setting on the target, and wvHostInfoInit( ) to change the port number.
- -f
- overwrite the output event data file if it already exists.
- -q
- quiet mode; do not print informational messages.
- -r
- repetitive receive mode. When this option is specified, evtRecv does not exit when the event data transfer is complete; instead, it awaits a new connection from the target. Each event log received in this manner is stored in file.logNo.wvr, where file is the argument given to the -o option (eventLog by default), and logNo is the position of the log in question within the sequence of event logs received. This process continues until the user terminates the evtRecv process on the host by typing the interrupt key (e.g., Ctrl-C) or by sending SIGTERM to the process. Note that repetitive receive mode is always disabled when the event stream is sent to standard output, even when -r is specified (see the description of the -o option above).
The Windows tool is similar in function but is accessed through a GUI. For information see the WindView User's Guide.
evtRecv, wvLib, wvEvtLogEnable( ), wvEvtLogDisable( ), wvHostLib, wvHostInfoShow( ), wvHostInfoInit( )