ngsignals.c File Reference

#include
#include
#include "nntpgrab_utils.h"

Functions
void	ng_signal_connect (void *instance, const char *signal_name, NGCallback cb_handler, void *data)
	Register a signal handler.
void	ng_signal_handlers_block_by_func (void *instance, NGCallback cb_handler, void *data)
	Temporary disable a signal handler for a given callback function.
void	ng_signal_handlers_unblock_by_func (void *instance, NGCallback cb_handler, void *data)
	Re-enable a signal handler for a given callback function.
void	ng_signal_handlers_disconnect_by_func (void *instance, NGCallback cb_handler, void *data)
	Un-register a signal handler.

---

Function Documentation

void ng_signal_connect	(	void *	instance,
		const char *	signal_name,
		NGCallback	cb_handler,
		void *	data
	)

Register a signal handler.

Parameters:

	instance	The instance of an GObject, for example NNTPGrabCore or NNTPGrabAutoImport
	signal_name	The name of the signal for which a signaler handler needs to be registered
	cb_handler	The function which need to be called every time the given signal is emit
	data	Data used as extra argument in the callback functions

Note:

The file nntpgrab_core/marshall.list contains a list of known signals and callback function prototypes for the NNTPGrabCore

void ng_signal_handlers_block_by_func	(	void *	instance,
		NGCallback	cb_handler,
		void *	data
	)

Temporary disable a signal handler for a given callback function.

Parameters:

	instance	The instance of an GObject, for example NNTPGrabCore or NNTPGrabAutoImport
	cb_handler	The callback function which need to be temporary blocked
	data	The callback data used for the given cb_handler

void ng_signal_handlers_disconnect_by_func	(	void *	instance,
		NGCallback	cb_handler,
		void *	data
	)

Un-register a signal handler.

Parameters:

	instance	The instance of an GObject, for example NNTPGrabCore or NNTPGrabAutoImport
	cb_handler	The callback function which need to be unregistered
	data	The callback data used for the given cb_handler

void ng_signal_handlers_unblock_by_func	(	void *	instance,
		NGCallback	cb_handler,
		void *	data
	)

Re-enable a signal handler for a given callback function.

Parameters:

	instance	The instance of an GObject, for example NNTPGrabCore or NNTPGrabAutoImport
	cb_handler	The callback function which need to be un-blocked
	data	The callback data used for the given cb_handler

---