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::Service(3pm) 				User Contributed Perl Documentation				   Net::DBus::Service(3pm)

NAME

       Net::DBus::Service - Provide a service to the bus for clients to use

SYNOPSIS

	 package main;

	 use Net::DBus;

	 # Attach to the bus
	 my $bus = Net::DBus->find;

	 # Acquire a service 'org.demo.Hello'
	 my $service = $bus->export_service("org.demo.Hello");

	 # Export our object within the service
	 my $object = Demo::HelloWorld->new($service);

	 ....rest of program...

DESCRIPTION

       This module represents a service which is exported to the message bus. Once a service has been exported, it is possible to create and
       export objects to the bus.

METHODS

       my $service = Net::DBus::Service->new($bus, $name);
	   Create a new service, attaching to the bus provided in the $bus parameter, which should be an instance of the Net::DBus object. The
	   $name parameter is the qualified service name. It is not usually neccessary to use this constructor, since services can be created via
	   the "export_service" method on the Net::DBus object.

       my $bus = $service->get_bus;
	   Retrieves the Net::DBus object to which this service is attached.

       my $name = $service->get_service_name
	   Retrieves the qualified name by which this service is known on the bus.

AUTHOR

       Daniel P. Berrange

COPYRIGHT

       Copyright (C) 2005-2011 Daniel P. Berrange

SEE ALSO

       Net::DBus, Net::DBus::Object, Net::DBus::RemoteService

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