gschedexec Manual

Usage

gschedexec [-dv] [-D debug-level] -c config-file -x executable [-a arg0,arg1,...]

Description

gschedexec is a tool that allows the user to set up a Group Scheduling Hierarchy (GSH) by using a GSH configuration file ##LINK TO GROUP SCHEDULING CONFIGFILE LANGUAGE##. When the GSH configuration file is processed by gschedctrl, the hierarchywill create the Group Scheduling callbacks within CCSM ##CCSM LINK##. Then in your program, when tasks and groups register themselves as part of the approriate CCSM set that is connected to the callback, that Group or Task is then automatically added to the GSH in the manner specified by the file.

After creating the GSH, gschedexec then starts the executable with the arguments [-a arg0,arg1,...]. This becomes a shorthand way of doing the same thing with gschedctrl. With gschedctrl the equivalent would be:

bash> gschedctrl -c config-file
bash> executable arg0 arg1 arg2 arg3

Equivallent gschedexec command:

bash> gschedexec -c config-file -x executable -a arg0,arg1,arg2,arg3

Options

• -a arg0,arg1,... : Defines a comma separated list of arguments

  to use with executing executable.

• -c config-file : The GSH configuration file (.gsh suffix) to use

  to create the CCSM and Group Scheduling callback hierarchy framework.

• -d : Run with the debug level set to 1. This will display a

  considerable amount of information to stdout about the interaction with the Group Scheduling API.

• -D debug-level : Run with the debug level set to

  debug-level. Normal debug-levels are 0, 1, and 2, with no debug infromation, a large amount of debug information, and an extreme amount of debug information – respectively.

• -v : Run with the verbosiy level set at 1. This will provide

  increased output on what the program is doing.

• -x executable: The executable to run immediately after

  creating the GSH with config-file. See -a for specifying arguments which which to run the executable.