mirror of
https://github.com/nasa/trick.git
synced 2024-12-25 15:51:05 +00:00
72 lines
3.1 KiB
Plaintext
72 lines
3.1 KiB
Plaintext
|
/**
|
|||
|
|
@page LEVEL1 S_main_${TRICK_HOST_CPU}.exe
|
|||
|
|
|
|||
|
|
S_main_${TRICK_HOST_CPU}.exe is generated by the CP and is the simulation main executable
|
|||
|
|
program.
|
|||
|
|
|
|||
|
|
The runtime configuration of the executive and its associated support utilities may be
|
|||
|
|
manipulated through entries in the simulation input file. The input file is described
|
|||
|
|
in detail in @ref Input_File.
|
|||
|
|
|
|||
|
|
The command line for the runtime executive is:
|
|||
|
|
|
|||
|
|
@verbatim
|
|||
|
|
S_main_<TRICK_HOST_CPU>.exe [trick_version] [sie]
|
|||
|
|
RUN_<name>/<input_file_name> [-d]
|
|||
|
|
[-O <output_file_path>]
|
|||
|
|
[-OO <output_file_path>]
|
|||
|
|
[-u <user_defined_arguments>]
|
|||
|
|
@endverbatim
|
|||
|
|
|
|||
|
|
- <TRICK_HOST_CPU> is the same as the ${TRICK_HOST_CPU} gte variable
|
|||
|
|
- The first argument in the command line must be the simulation input file name. The
|
|||
|
|
input file name can be in the form of a full path name but MUST have a RUN_<name>
|
|||
|
|
directory immediately above the input file name. By default, all the simulation
|
|||
|
|
output is directed to this RUN_<name> directory. The standard <input_file_name> is
|
|||
|
|
input; however, a simulation could be started from a checkpoint file by substituting
|
|||
|
|
chkpnt_<time> in for <input_file_name> for non-Master/Slave and non-Import/Export
|
|||
|
|
simulations. For Master/Slave and Import/Export simulations you must have the
|
|||
|
|
simulation running, and the simulation must be in a freeze state before reloading a
|
|||
|
|
checkpoint.
|
|||
|
|
- The trick_version option will tell what version of Trick built the S_main executable.
|
|||
|
|
- The sie option will generate the smart input editor (SIE) resource file (CP will by
|
|||
|
|
default invoke the S_main executable with the sie option to generate this file).
|
|||
|
|
- The ‘-d’ argument is optional and, if specified, starts the simulation in an input
|
|||
|
|
file verification mode. In this mode the entire input file is read, echoed to
|
|||
|
|
standard out, and then the simulation exits without calling any jobs listed in the
|
|||
|
|
S_define file. This mode helps debug input file syntax errors.
|
|||
|
|
- The ‘-O <output_file_path>‘ option allows the user to specify the directory to which
|
|||
|
|
simulation data log files will be written. If this option is omitted, the RUN_<name>
|
|||
|
|
directory is used.
|
|||
|
|
- The ‘-OO <output_file_path>’ option allows the user to specify the directory to
|
|||
|
|
which ALL simulation output files will be written. If this option is omitted, the
|
|||
|
|
RUN_<name> directory is used.
|
|||
|
|
- The ‘-u’ option specifies that all remaining arguments are meant to be used by
|
|||
|
|
user supplied jobs. All arguments after the -u can be accessed internal to the
|
|||
|
|
simulation jobs by calling the get_cmnd_args() function of the executive as
|
|||
|
|
illustrated below. In a master/slave simulation, the master’s -u args will be passed
|
|||
|
|
to the slave.
|
|||
|
|
|
|||
|
|
The following code example shows how a function can access the command line
|
|||
|
|
arguments during execution.
|
|||
|
|
|
|||
|
|
@code
|
|||
|
|
#include “sim_services/CommandLineArguments/include/command_line_protos.h”
|
|||
|
|
|
|||
|
|
void test_job( void )
|
|||
|
|
{
|
|||
|
|
int num_args ;
|
|||
|
|
char **args ;
|
|||
|
|
int ii ;
|
|||
|
|
|
|||
|
|
num_args = command_line_args_get_argc() ;
|
|||
|
|
args = command_line_args_get_argv() ;
|
|||
|
|
for( ii = 0 ; ii < num_args ; ii++ )
|
|||
|
|
printf( “argument #%d = %s\n” , ii , args[ii] ) ;
|
|||
|
|
|
|||
|
|
return ;
|
|||
|
|
}
|
|||
|
|
@endcode
|
|||
|
|
|
|||
|
|
*/
|