NuDB Logo

PrevUpHomeNext

Progress

A Progress object provides feedback to callers on the progress of long running operations such as calls to verify or rekey which can take days or weeks for database that measure in the terabytes. These objects are used by passing them as parameters to the appropriate functions, where the will be called periodically with numbers that indicate the amount of work completed, versus the total amount of work required.

In the table below:

Table 3. Progress requirements

operation

type

semantics, pre/post-conditions

a(p, q)

Indicates to the progress object that work has been performed and intermediate results calculated. p represents the amount of work completed from the beginning of the operation. q represents the total amount of work required. The fraction of completed work is therefore p/q, with zero representing no work complete, and one represents all work complete. p and q are unitless.



PrevUpHomeNext