diff --git a/src/server/distrenjob.h b/src/server/distrenjob.h --- a/src/server/distrenjob.h +++ b/src/server/distrenjob.h @@ -25,7 +25,7 @@ This file stores the distrenjob and frameset structs and prototypes for some functions to manipulate/use these. */ -#include /* clock_t, time_t */ +#include /*< clock_t, time_t */ typedef unsigned int jobnum_t; @@ -34,21 +34,21 @@ typedef unsigned int jobnum_t; */ struct distrenjob { struct distrenjob *next; /*< next will be NULL unless if there is another distrenjob */ - short int type; // 1:Blender, 2:something else + short int type; /*< 1:Blender, 2:something else */ char *name; char *submitter; char *email; /*< This should be looked up based on the value of submitter, not stored in this struct */ jobnum_t jobnum; - int width; // width in pixels of the frames to be rendered - int height; //height in pixels of the frames to be rendered - int priority; // 1 is lowest, 10 is highest, 0 means the job is done - int completed_frames; // number of completed frames for stats/etc - int assigned_frames; // number of assigned frames (that are not yet completed) for stats/etc - int total_frames; // how many frames are in the animation for stats/etc (unassigned frames) - int watchdog_forgiveness; // how many seconds till the frame is re-assigned (if client computer crashes etc); + int width; /*< width in pixels of the frames to be rendered */ + int height; /*< height in pixels of the frames to be rendered */ + int priority; /*< 1 is lowest, 10 is highest, 0 means the job is done */ + int completed_frames; /*< number of completed frames for stats/etc */ + int assigned_frames; /*< number of assigned frames (that are not yet completed) for stats/etc */ + int total_frames; /*< how many frames are in the animation for stats/etc (unassigned frames) */ + int watchdog_forgiveness; /*< how many seconds till the frame is re-assigned (if client computer crashes etc); */ short int hibernate; - int prev_frame_index; // the position in the array of the last frame that was assigned - time_t total_render_time; // total seconds of time spent on all the completed frames + int prev_frame_index; /*< the position in the array of the last frame that was assigned */ + time_t total_render_time; /*< total seconds of time spent on all the completed frames */ char *output_format; /*< currently is the file extension of the request output format. @todo make this mime-type based/not a string */ unsigned long int assigned_render_power; struct frameset *frameset; @@ -72,11 +72,10 @@ struct frameset { char slave_name; /*< user that frame is assigned to */ enum framesetstatus status; /*< status of frame, 0= unassigned, 1= taken, 2= done */ clock_t start_time; /*< time the frame was started */ -}; /* Frameset array is generated by status_report_generator() */ - +}; /* -related functions + related functions */ /**