NAME
Net::DBus::GLib - Perl extension for the DBus GLib bindings
SYNOPSIS
####### Attaching to the bus ###########
use
Net::DBus::GLib;
# Find the most appropriate bus
my
$bus
= Net::DBus::GLib->find;
# ... or explicitly go for the session bus
my
$bus
= Net::DBus::GLib->session;
# .... or explicitly go for the system bus
my
$bus
= Net::DBus::GLib->
system
DESCRIPTION
Net::DBus::GLib provides an extension to the Net::DBus module allowing integration with the GLib mainloop. To integrate with the main loop, simply get a connection to the bus via the methods in Net::DBus::GLib rather than the usual Net::DBus module. That's it - every other API remains the same.
EXAMPLE
As an example service using the GLib main loop, assuming that SomeObject inherits from Net::DBus::Service
my
$bus
= Net::DBus::GLib->session();
my
$service
=
$bus
->export_service(
"org.designfu.SampleService"
);
my
$object
= SomeObject->new(
$service
);
Glib::MainLoop->new()->run();
And as an example client
my
$bus
= Net::DBus::GLib->session();
my
$service
=
$bus
->get_service(
"org.designfu.SampleService"
);
my
$object
=
$service
->get_object(
"/SomeObject"
);
my
$list
=
$object
->HelloWorld(
"Hello from example-client.pl!"
);
METHODS
- my $bus = Net::DBus::GLib->find(%params);
-
Search for the most appropriate bus to connect to and return a connection to it. For details of the heuristics used, consult the method of the same name in
Net::DBus
. The %params hash may contain an additional entry with a name ofcontext
. This can be a reference to an instance of theGlib::MainContext
object; if omitted, the default GLib context will be used. - my $bus = Net::DBus::GLib->system(%params);
-
Return a handle for the system message bus. For further details on this method, consult to the method of the same name in Net::DBus. The %params hash may contain an additional entry with a name of
context
. This can be a reference to an instance of theGlib::MainContext
object; if omitted, the default GLib context will be used. - my $bus = Net::DBus::GLib->session(%params);
-
Return a handle for the session message bus. For further details on this method, consult to the method of the same name in Net::DBus. The %params hash may contain an additional entry with a name of
context
. This can be a reference to an instance of theGlib::MainContext
object; if omitted, the default GLib context will be used.
SEE ALSO
Net::DBus, Glib, Glib::MainLoop http://dbus.freedesktop.org
, http://gtk.org
AUTHOR
Daniel Berrange <dan@berrange.com>
COPYRIGHT
Copyright 2006-2008 by Daniel Berrange