net::dbus::tutorial(3pm) [debian man page]

Net::DBus::Tutorial(3pm)				User Contributed Perl Documentation				  Net::DBus::Tutorial(3pm)

NAME

       Net::DBus::Tutorial - tutorials on the Perl DBus APIs

DESCRIPTION

       This section includes tutorials on the Perl DBus APIs. Current topics include providing a service, by exporting objects to the bus, and
       accessing a service, by calling objects on the bus.

       Net::DBus::Tutorial::ExportingObjects
	   This tutorial covers how to provide a service to the bus by exporting objects. The topics covered include basics of creating objects
	   and methods, emitting signals, exporting properties, registering services for automatic activation.

       Net::DBus::Tutorial::UsingObjects
	   This tutorial cover how to use a service provided on the bus by another application. The topics covered include the basics of calling
	   methods on remote objects, explicitly calling methods in particular interfaces, listening for signals.

	   NB This tutorial is yet to be written.

SEE ALSO

       Net::DBus, Net::DBus::Object, Net::DBus::RemoteObject, <http://freedesktop.org/>

AUTHORS

       Daniel P. Berrange <mailto:dan@berrange.com>

COPYRIGHT

       Copyright 2005 Daniel P. Berrange

perl v5.14.2							    2011-06-30						  Net::DBus::Tutorial(3pm)

Net::DBus::GLib(3pm)					User Contributed Perl Documentation				      Net::DBus::GLib(3pm)

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 of "context". This can be a reference to
	   an instance of the "Glib::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 the
	   "Glib::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 the
	   "Glib::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

perl v5.14.2							    2008-01-08						      Net::DBus::GLib(3pm)