PK_DEBUG_versioning_t

typedef int PK_DEBUG_versioning_t;

Used in:

PK_DEBUG_behaviours_start_o_t

A token specifying what happens if mixed or incorrect versioning controls are
used.

"Mixed" versioning is when both behaviour versioning controls (set by
PK_SESSION_set_behaviour) and legacy versioning controls (update options or
session software options of the form PK_SESSION_pre_vXXX_switch_0_c) are being
used. This can be used to check that your application is only using one method
of versioning at any one time.

"Incorrect" versioning is when the combination of versioning controls used does
not indicate a consistent version. Examples would be:
- setting the software option PK_SESSION_pre_v281_switch_0_c to 0 and an update
option to _update_v280_c. The session software option indicates a version of
28.1 or later but the update option indicates version 28.0.
- setting the software option PK_SESSION_pre_vXXX_switch_0_c to 1, where XXX is
281 or earlier, and setting the behaviour versioning controls.
- setting the behaviour versioning controls to PK_SESSION_behave_as_latest_c
and setting any legacy version control.

Session software options of the form PK_SESSION_pre_vXXX_switch_N_c with N > 0,
and other session software options that should not be set without advice, are
independent of the behaviour versioning controls and are not considered during
incorrect or mixed versioning checks. A list of such session software options
can be found here.

It has the values:

    PK_DEBUG_versioning_behaviour_c    The behaviours setting is used to
                                       control versioning behaviour if mixed
                                       versioning is detected. Legacy
                                       versioning controls are ignored.

    PK_DEBUG_versioning_incorrect_c    A specific error with code
                                       PK_ERROR_versioning_clash (MILD or
                                       SERIOUS) is returned from any function
                                       at which incorrect versioning is
                                       detected.

    PK_DEBUG_versioning_mixed_c        A specific error with code
                                       PK_ERROR_versioning_mixed (MILD) is
                                       returned from any function at which
                                       mixed versioning is detected.

See also PK_SESSION_set_behaviour.