Changes between Version 3 and Version 4 of WorkGeneration


Ignore:
Timestamp:
Apr 18, 2007, 4:12:43 PM (17 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WorkGeneration

    v3 v4  
    55
    66    * Write XML 'template files' that describe the job's input and outputs (typically the same template files will be used for many jobs).
    7     * Create the job's input file(s) in the download directory.
     7    * Create the job's input file(s), and put them in the right places in the [http://boinc.berkeley.edu/hier_dir.php download directory hierarchy].
    88    * Invoke a BOINC function or script that submits the job.
    99
     
    8484    * <UPLOAD_URL/> is replaced with the upload URL.
    8585
    86 == Moving input files to the download directory ==
    87 If you're using a flat download directory, just put input files in that directory. If you're using [http://boinc.berkeley.edu/hier_dir.php hierarchical upload/download directories], you must put each input file in the appropriate directory; the directory is determined by the file's name. To find this directory, call the C++ function
    88 {{{
    89 dir_hier_path(
    90     const char* filename,
    91     const char* root,       // root of download directory
    92     int fanout,             // from config.xml
    93     char* result,           // path of file in hierarchy
    94     bool create_dir=false   // create dir if it's not there
    95 );
    96 }}}
    97 If you're using scripts, you can invoke the program
     86== Submitting a job manually ==
     87
    9888{{{
    9989dir_hier_path filename
     
    10494}}}
    10595copies an input file from the test_workunits directory to the download directory hierarchy.
    106 
    107 == Creating workunit records ==
    108 
    109 Workunits can be created using either a script (using the create_work program) or a program (using the create_work() function). The input files must already be in the download hierarchy.
    11096
    11197The utility program is
     
    141127}}}
    142128The program must be run in the project root directory. The workunit parameters are documented [http://boinc.berkeley.edu/work.php here]. The -additional_xml argument can be used to supply, for example, <credit>12.4</credit>.
     129
     130You must put each input file in the appropriate directory; the directory is determined by the file's name. To find this directory, call the C++ function
     131{{{
     132dir_hier_path(
     133    const char* filename,
     134    const char* root,       // root of download directory
     135    int fanout,             // from config.xml
     136    char* result,           // path of file in hierarchy
     137    bool create_dir=false   // create dir if it's not there
     138);
     139}}}
     140
     141
     142
     143== Submitting jobs from a C++ program ==
    143144
    144145BOINC's library (backend_lib.C,h) provides the functions:
     
    263264    }
    264265}}}
    265 Again, you only need one workunit template file and one result template file.
     266Again, you only need one input template file and one output template file.