NAME

logprogress - Monitor the progress of a job's driver program, updating the status web page for that job.

SYNOPSIS

  logprogress job-id
  job-id: The ID of the job to be monitored.

DESCRIPTION

logprogress monitors the log of a job's driver programming, scanning for special keywords which indicate the progress of the driver. When it detects a change, it runs setprogress, which actually updates the status page.

Status information appears on lines that being with an asterisk character (*), followed by the status keyword, another asterisk, and then the status information. Lines that do not contain status information are ignored.

Status keywords recognized by logprogress are:

PROGRESS percentage message
Indicates that the job is ``percentage'' percent done, and optionally includes a message to display to the user about what is being done right now.
FINISHED message
The job completed succesfully. ``message'' will be displayed to the user, and logprogress will exit.
DIED message
The job died. The string ``PROGRAM DIED'' is displayed to the user, along with ``message'', if supplied. Logprogress exits after seeing this.
CANCELED message
The job was canceled. The string ``JOB CANCELED'' is displayed to the user, along with ``message'', if supplied. Logprogress exits after seeing this.

SEE ALSO

setprogress, CGIBurn::Job, CGIBurn::BurnLog.