PK_ERROR_code_t                     PK_DEBUG_report_start
(
--- received arguments ---
const char                         *key,        --- key string
const PK_DEBUG_report_start_o_t    *options     --- report options
)


Initialises and starts the output of debug information. Any PK calls made
between a call to this function and PK_DEBUG_report_stop will have debug
information output to the file specified by 'key'.


Specific Errors:
    PK_ERROR_bad_filename           character string is not a valid file name
                                    (MILD)
    PK_ERROR_cant_open_file         unable to open the given file for output
                                    (MILD)
    PK_ERROR_journalling_on         debug output cannot be enabled if
                                    journalling is switched on (MILD)
    PK_ERROR_dbg_rprt_not_stopped   debug output has already been started
                                    (MILD)
    PK_ERROR_not_implemented        option not implemented (MILD)