NAME
toolbus - ToolBus Interpreter
SYNOPSIS
toolbus [ -help ] [ -version ] [ -verbose ] [ -logger ] [ -viewer ] [ -controller ] [ -gentifs ] [ -fixed-seed ] [ -TB_PORT N ] [ -Dmacro ] [ -Dmacro=defn ] [ -Idir ] [ script.tb ]
DESCRIPTION
This manual page briefly describes the toolbus commands.
toolbus interconnect software tools as described in a "T script"
The script_name given as argument to toolbus is always preprocessed by the C preprocessor before it is parsed as a T script. In this way, e.g, #define, #include and #ifdef can be used freely in T scripts.
OPTIONS
- -help
-
print a description of all arguments of the toolbus or tool
- -verbose
-
produce a log of steps taken by toolbus or tools that may be useful to debug your script or tool. The same effect may be obtained by setting the environment variable TB_VERBOSE to true and export it. In the Korn shell this can, for instance, be achieved by :
export TB_VERBOSE=true
- -version
-
print the version number and exit
- -TB_PORT port_name
-
defines the "well known socket" port_name to which all tools temporarily connect in order to set up their own private socket that connects them to the ToolBus interpreter. When ommited, socket 8998 will be used
Note that explicit arguments defining the sockets are only needed when several ToolBus interpreters are running simultaneously in the same host machine.
- -Idir
-
append directory dit to the list of directories searched for include files.
- -Dmacro
-
define macro with the string "1" as its definition.
- -Dmacro=defn
-
define macro with defn as definition.
- -logger
-
execute a logger tool that will be attached to all processes in the ToolBus. If the script contains a tool definition for a tool named "logger", that will be used for executing the logger. Otherwise a default tool definition is used.
- -viewer
-
similar as above, for a viewer tool. The default viewer is the "ToolBus viewer" (previously known as the ToolBus debugger)
- -controller
-
similar as above, for a controller tool. Currently, no default controller tool is provided
- -gentifs
-
only generate tool interfaces for all tools used in the script in a language independent format. For a script file named script.tb the tool interfaces are written to script.tifs. Do not execute the script.
- -fixed-seed
-
use a fixed seed for the random generator used by the interpreter for scheduling processes and selecting alternatives in processes. By default, the random generator is initialized with the current time the toolbus command is given. Using the -fixed-seed option makes the execution of the script reproducible acrosss multiple runs of the toolbus command.
SEE ALSO
AUTHOR
This manual page was written by Julien LEMOINE <[email protected]>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.