Changes between Version 9 and Version 10 of AppPlan

Timestamp:

Jan 22, 2009, 11:44:19 AM (15 years ago)

Author:

davea

Comment:

--

AppPlan

@@ -7 +7 @@
 It works as follows.
 
-An app_version record (in the server DB) has a character string field '''plan_class'''.
-This identifies the range of processing resources that the application
-requires and is able to use.
-You can define these however you like,
-e.g. "cuda_1.1" apps require a CUDA-enabled GPU,
-"mt32" is a multithreaded app able to use 32 CPUs, etc.
+An app version has an associated '''plan_class''': a character string, possibly empty.
+The plan class is encoded in the app version's directory name,
+as used by [UpdateVersions update_versions].
 
-The scheduler is linked with a project-supplied function
+The scheduler is linked with a function
 {{{
 bool app_plan(SCHEDULER_REQUEST &sreq, char* plan_class, HOST_USAGE&);
 }}}
-The '''sreq''' argument contains various data:
+The '''sreq''' argument contains:
  * in '''sreq.host''' field, a description of the host's processors and memory
- * in '''sreq.global_prefs''' field, a parsed version of the user's global preferences
- * in '''sreq.coprocs''', a list of its coprocessors.
+ * in '''sreq.global_prefs''' field, the user's global preferences
+ * in '''sreq.coprocs''', a list of the hosts's coprocessors.
 
 When called with a particular SCHEDULER_REQUEST and plan class,
@@ -43 +40 @@
 The client uses '''flops''' to estimate job completion times.
 
-The scheduler reply includes, for each job, an XML encoding of HOST_USAGE.
+You are free to define your own set of plan classes,
+and to link your own '''app_plan()''' function with the scheduler.
+The BOINC scheduler comes with a default '''app_plan()''' (in sched/sched_plan.cpp).
+This defines the following plan classes:
+
+ '''mt''':: An application that can use anywhere from 1 to 64 threads, and whose speedup with N CPUs is .95N.  It is passed a command-line argument '''--nthreads N'''.
+ '''cuda''':: A CUDA application that requires 254MB of GPU RAM, and that uses .5% as many CPU FLOPS as GPU FLOPS.
+ '''nci''':: A non-CPU-intensive application that uses 1% of a CPU (this will cause the BOINC client 6.7+ to run it at non-idle priority).
+