Changes between Version 15 and Version 16 of CondorBoinc

Timestamp:

Mar 7, 2013, 12:12:25 PM (12 years ago)

Author:

davea

Comment:

--

CondorBoinc

@@ -114 +114 @@
 
 Result:
-  NULL|<err msg> <job1> <status1> ...
-}}}
-Notes:
- * status is either NOT_STARTED, IN_PROGRESS, DONE, or ERROR
-
-Retrieve a job's output files:
-{{{
-BOINC_FETCH_OUTPUT <req id> <job name> <dir> <stderr name>
+  <err msg> | NULL <job name 1> <status1> ...
+}}}
+Status is either IN_PROGRESS, DONE, or ERROR
+
+Retrieve the outputs of a job that's completed
+(i.e. its status is DONE or ERROR).
+{{{
+BOINC_FETCH_OUTPUT <req id> <job name> <dir> <stderr filename>
     ALL|<#files>
     <src name> <dst name>
     ...
 Result:
-  error_msg | NULL <exit status> <runtime stats and ???>
-}}}
-Notes:
+  error_msg | NULL <exit status> <elapsed time> <CPU time>
+}}}
+
  * <dir> is a directory on the local machine to be used to
    resolve relative pathnames.
@@ -134 +134 @@
  * <dst name> is a filename on the local machine where the
    corresponding <src name> file's contents should be written
- * If 'ALL' is given instead of <#files>,
-   then no filenames will follow.
- * The exact format of runtime stats and related data is yet
-   to be determined.
+ * If 'ALL' is given instead of <#files>, then no filenames will follow.
+
+BOINC may replicate jobs to ensure that results are valid.
+One replica, the "canonical instance", is designated as the authoritative result.
+A job can fail for various reasons: e.g. all the instances crash,
+or there is no consensus among the instances,
+or no instances could be dispatched.
+
+If the status is DONE, then the output files of the canonical instance,
+and its stderr output, are fetched.
+<exit status> will be zero in this case.
+
+If the status is ERROR, the BOINC GAHP will look for an instance
+for which some information is available (e.g., exit status and stderr output),
+and will return this information.
+If there is no such instance, it will return an error message.
 
 Abort the given jobs: