diff --git a/src/client/distren.h b/src/client/distren.h --- a/src/client/distren.h +++ b/src/client/distren.h @@ -48,6 +48,14 @@ int distren_init(distren_t *handle); */ int distren_submit_file(distren_job_t *job, const char *filename); +/** + Retrieve a job-ID that can be used to refer to the job after the client's process has recycled. Currently, this will be the only way to retrieve a job handle (a distren_job_t) and, consequently, the only way to retrieve a finished render. + A job ID is representable using a character string. Hopefully, they will be kept at a reasonably small length. It should be made up of alphanumeric characters so as to be useful in most situations. + @param jobid This will be set to a string allocated by the specified malloc implementation + @param job The distren_job_t from which to retrieve a jobid +*/ +distren_job_getid(distren_job_t job, char **jobid); + /* TODO: extraction of a job-ID, retrieving job handle by job-ID, getting information for a job handle, retrieving results of a job, callbacks for progress (i.e., job_is_finished callback)