Glib::Signal man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

Glib::Signal(3pm)     User Contributed Perl Documentation    Glib::Signal(3pm)

       Glib::Signal -  Object customization and general purpose notification

       This page describes some functions related to signals in Glib.  Since
       most things you can do with signals are tied to Glib::Object instances,
       the majority of the signal functions are documented there.

   Thread safety
       Some libraries, most notably GStreamer, sometimes invoke signal
       handlers from a foreign thread that has no Perl interpreter associated
       with it.	 When this happens, we have no choice but to hand the
       marshalling over to the main loop which in turn later wakes up the main
       thread and lets it handle the request.  We cannot invoke the signal
       handler from the foreign thread since the Perl interpreter may not be
       used concurrently.

       The downside to this approach is that the foreign thread is blocked
       until the main thread has finished executing the signal handler.	 This
       might lead to deadlocks.	 It might help in this case to wrap the
       crucial parts of the signal handler inside a Glib::Idle callback so
       that the signal handler can return directly.

   integer = Glib->install_exception_handler ($func, $data=undef)
       ·   $func (subroutine)

       ·   $data (scalar)

       Install a subroutine to be executed when a signal emission traps an
       exception (a croak or die).  $func should return boolean (true if the
       handler should remain installed) and expect to receive a single scalar.
       This scalar will be a private copy of $@ which the handler can mangle
       to its heart's content.

       Returns an identifier that may be used with "remove_exception_handler".

       See "gperl_install_exception_handler()" in Glib::xsapi.

   Glib->remove_exception_handler ($tag)
       ·   $tag (integer)

       Remove the exception handler identified by $tag, as returned by
       "install_exception_handler".  If $tag cannot be found, this does

       WARNING:	 Do not call this function from within an exception handler.
       If you want to remove your handler during its execution just have it
       return false.

       See "gperl_remove_exception_handler()" in Glib::xsapi.

   flags Glib::SignalFlags
       ·   'run-first' / 'G_SIGNAL_RUN_FIRST'

       ·   'run-last' / 'G_SIGNAL_RUN_LAST'

       ·   'run-cleanup' / 'G_SIGNAL_RUN_CLEANUP'

       ·   'no-recurse' / 'G_SIGNAL_NO_RECURSE'

       ·   'detailed' / 'G_SIGNAL_DETAILED'

       ·   'action' / 'G_SIGNAL_ACTION'

       ·   'no-hooks' / 'G_SIGNAL_NO_HOOKS'

       Glib, Glib::Object

       Copyright (C) 2003-2011 by the gtk2-perl team.

       This software is licensed under the LGPL.  See Glib for a full notice.

perl v5.18.1			  2014-01-08		     Glib::Signal(3pm)

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net