paradyn/h/dyninstRPC.I

   1 #define MetStyleEventCounter    0
   2 #define MetStyleSampledFunction 1
   3
   4
   5 /* descriptive information about a metric */
   6 $remote typedef struct {
   7     String name;
   8     int style;
   9     String units;
  10 } metricInfo;
  11
  12 /*
  13  * Create a paradynd process.
  14  *
  15  */
  16 int createDaemon(String machine,
  17                  String login,
  18                  String name,
  19                  int argc,
  20                  char *argv[]);
  21
  22
  23 $remote dynRPC {
  24     $base 4000;
  25     $version 4;
  26
  27     //
  28     // Define a program to run.
  29     int addExecutable(int argc, $array String argv);
  30
  31     //
  32     // Connect up with a running program (not possible on all platforms).
  33     //
  34     Boolean attachProgram(int pid);
  35
  36     //
  37     // Start an application running (This starts the actual execution).
  38     //
  39     Boolean startProgram(int program);
  40
  41     //
  42     //   Stop all processes associted with the application.
  43     //
  44     Boolean pauseProgram(int program);
  45
  46     //
  47     // Continue a paused application.
  48     //
  49     void continueProgram(int program);
  50
  51
  52     //
  53     // Disconnect the tool from the process.
  54     //    pause - leave the process in a stopped state.
  55     //
  56     //
  57     Boolean detachProgram(int program, Boolean pause);
  58
  59     //
  60     // Gets called when a new application is started that is not visible to
  61     //   paradyn (e.g. pvm_spawn).
  62     //
  63     $upcall $async void newProgramCallbackFunc(int program);
  64
  65     //
  66     // Handler that gets called when new sample data is delivered.
  67     //
  68     //   p - a program from addProgram
  69     //   mi - a metricInstance returned by enableDataCollection
  70     //   startTimeStamp - starting time of the interval covered by this sample.
  71     //   endTimeStamp - ending time of the interval covered by this sample.
  72     //   value - the value of this sample
  73     //
  74     //
  75     $upcall $async void sampleDataCallbackFunc(int program,
  76                                            int mi,
  77                                            double startTimeStamp,
  78                                            double endTimeStamp,
  79                                            double value);
  80
  81     //
  82     // Handler that gets called when a new resource is defined.
  83     //
  84     // performanceStream        - a stream returned by createPerformanceStream
  85     // parent           - parent of new resource
  86     // newResource              - new resource being created (full name)
  87     // name                     - short name of the new resource
  88     //
  89     $upcall $async void resourceInfoCallback(int program,
  90                                               String parent,
  91                                               String newResource,
  92                                               String name);
  93
  94     void setSampleRate(double sampleInterval);
  95
  96     //
  97     // Routines to control data collection on a performanceStream.
  98     //
  99     // resourceList     - a list of resources
 100     // metric   - what metric to collect data for
 101     //
 102     int enableDataCollection($array String resourceList, String metric);
 103
 104     //
 105     // stop collecting data for the named mi.
 106     //     mi           - a metricInstance returned by enableDataCollection.
 107     //
 108     void disableDataCollection(int mi);
 109
 110     //
 111     // Return the expected cost of collecting performance data for a single
 112     //    metric at a given focus.  The value returned is the fraction of
 113     //    perturbation expected (i.e. 0.10 == 10% slow down expected).
 114     //
 115     double getPredictedDataCost($array String resourceList, String metric);
 116
 117     //
 118     // Get the static configuration information.
 119     //
 120     $array metricInfo getAvailableMetrics();
 121
 122     //
 123     // Debugger style calls.
 124     //
 125     //
 126     String getStatus(int pid);
 127     void coreProcess(int pid);
 128 };