It is often useful to retrieve some feedback while long running operations are performed.
Progress handler functions have to be of the type
gcry_handler_progress_t, which is defined as:
void (*gcry_handler_progress_t) (void *, const char *, int, int, int)
The following function may be used to register a handler function for this purpose.
This function installs cb as the `Progress handler' function. It may be used only during initialization. cb must be defined as follows:
void my_progress_handler (void *cb_data, const char *what, int printchar, int current, int total) { /* Do something. */ }A description of the arguments of the progress handler function follows.
- cb_data
- The argument provided in the call to
gcry_set_progress_handler.- what
- A string identifying the type of the progress output. The following values for what are defined:
need_entropy- Not enough entropy is available. total holds the number of required bytes.
primegen- Values for printchar:
\n- Prime generated.
!- Need to refresh the pool of prime numbers.
<, >- Number of bits adjusted.
^- Searching for a generator.
.- Fermat test on 10 candidates failed.
:- Restart with a new random value.
+- Rabin Miller test passed.