"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/README.fb_shutdown" between
Firebird-3.0.2.32703-0.tar.bz2 and Firebird-3.0.4.33054-0.tar.bz2

About: Firebird is a relational database offering many ANSI SQL standard features.

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

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)