Parameters related to simulation input/output

In this section, we distinguish between ``simulation'' input and output and ``standard'' input and output. Standard input and output refer to the standard input and output streams provided to the application being simulated. By default, these are the same as the input and output streams used by the simulator. However, the simulator input and output streams can be redirected separately from the application input and output, as described below.

-0 file

Redirects standard input to file. Defaults to stdin.

-1 file

Redirects standard output to file. Defaults to stdout.

-2 file

Redirects standard error to file. The simulator outputs its concise statistics to this file. Defaults to stderr.

-3 file

Redirects simulator detailed statistics to file. This option can be used (either alone or in conjunction with ``-1'') to redirect detailed statistics separately from the output produced by the application. (If ``-1'' is used without ``-3'', both detailed statistics and application output are written to the same file.) Defaults to stdout.

-D dir

Directory for output files. This option can only be used in conjunction with the ``-S'' option. Unused by default.

-S subj

Subject to use in output filenames. This option overrides ``-1'', ``-2'', and ``-3'', and can only be used in conjunction with ``-D.'' When this option is used, RSIM redirects application standard output to a file titled dir/subj_out, redirects application standard error and simulator concise statistics to dir/subj_err, and redirects simulator detailed statistics to dir/subj_stat. Unused by default.

-z file

Redirects simulator input (configuration file) to file. This option can be used (either alone or in conjunction with ``-0'') to redirect the input required by the simulator (such as the configuration file) separately from the input required by the application. (If ``-0'' is used without ``-z'', both the simulator input and application input come from the same file.) Note: to use the default values of all configuration file parameters, file should be set to /dev/null. Defaults to stdin.

-e emailaddr

Send an email notification to the specified address upon completion of this simulation. The notification tells the user the location of the various output files and is sent using the subject specified in ``-S''. Unused by default.