README.fb_shutdown (Firebird-3.0.2.32703-0.tar.bz2) | : | README.fb_shutdown (Firebird-3.0.4.33054-0.tar.bz2) | ||
---|---|---|---|---|
skipping to change at line 48 | skipping to change at line 48 | |||
place during shutdown. You should consult firebird.log for more information. | place during shutdown. You should consult firebird.log for more information. | |||
fb_shutdown_callback() setups callback function, which will be called during shu tdown. It has 4 | fb_shutdown_callback() setups callback function, which will be called during shu tdown. It has 4 | |||
parameters - status vector, pointer to callback function, call mask and argumnet to be passed | parameters - status vector, pointer to callback function, call mask and argumnet to be passed | |||
to callback function. Call mask can have the following values: | to callback function. Call mask can have the following values: | |||
fb_shut_confirmation - callback function may return non-zero value to abort shut down | fb_shut_confirmation - callback function may return non-zero value to abort shut down | |||
fb_shut_preproviders - callback function will be called before shutting down eng ine | fb_shut_preproviders - callback function will be called before shutting down eng ine | |||
fb_shut_postproviders - callback function will be called after shutting down eng ine | fb_shut_postproviders - callback function will be called after shutting down eng ine | |||
fb_shut_finish - final step, callback function may wait for some activity to be terminated | fb_shut_finish - final step, callback function may wait for some activity to be terminated | |||
or ORed combination of them (to make same function be called in required cases). | or ORed combination of them (to make same function be called in required cases). | |||
Non-zero mask passed to callback will be ORed with mask used in previous call (i | ||||
f any). Mask also | ||||
may have special value 0 - in that case previous mask is reset and callback will | ||||
never be called. | ||||
Callback function has 3 parameters - reason of shutdown, actual value of mask wi th which it was | Callback function has 3 parameters - reason of shutdown, actual value of mask wi th which it was | |||
called and argument passed by user to fb_shutdown_callback(). There are 2 specia lly interesting | called and argument passed by user to fb_shutdown_callback(). There are 2 specia lly interesting | |||
shutdown reasons: | shutdown reasons: | |||
fb_shutrsn_exit_called - Firebird is closing due to exit() or unloaded client/em bedded library | fb_shutrsn_exit_called - Firebird is closing due to exit() or unloaded client/em bedded library | |||
fb_shutrsn_signal - signal SIGINT or SIGTERM was caught (posix only) | fb_shutrsn_signal - signal SIGINT or SIGTERM was caught (posix only) | |||
Second parameter (actual value of mask) helps to distinguish if callback was inv oked before or after | Second parameter (actual value of mask) helps to distinguish if callback was inv oked before or after | |||
engine shutdown. | engine shutdown. | |||
First and second parameters help you decide what action to be taken in your call back. Third can | First and second parameters help you decide what action to be taken in your call back. Third can | |||
be used for any purporse you like and may be NULL. | be used for any purporse you like and may be NULL. | |||
End of changes. 1 change blocks. | ||||
0 lines changed or deleted | 4 lines changed or added |