Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

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)

Check Out this Related Man Page

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

NAME

       Net::DBus::RemoteService - Access services provided on the bus

SYNOPSIS

	 my $bus = Net::DBus->find;
	 my $service = $bus->get_service("org.freedesktop.DBus");

	 my $object = $service->get_object("/org/freedesktop/DBus");
	 foreach (@{$object->ListNames}) {
	   print "$_
";
	 }

DESCRIPTION

       This object provides a handle to a remote service on the bus. From this handle it is possible to access objects associated with the
       service. If a service is not running, an attempt will be made to activate it the first time a method is called against one of its objects.

METHODS

       my $service = Net::DBus::RemoteService->new($bus, $owner, $service_name);
	   Creates a new handle for a remote service. The $bus parameter is an instance of Net::DBus, $owner is the name of the client providing
	   the service, while $service_name is the well known name of the  service on the bus. Service names consist of two or more tokens,
	   separated by periods, while the tokens comprise the letters a-z, A-Z, 0-9 and _, for example "org.freedesktop.DBus". There is generally
	   no need to call this constructor, instead the "get_service" method on Net::DBus should be used. This caches handles to remote services,
	   eliminating repeated retrieval of introspection data.

       my $bus = $service->get_bus;
	   Retrieves a handle for the bus to which this service is attached.  The returned object will be an instance of Net::DBus.

       my $service_name = $service->get_service_name
	   Retrieves the name of the remote service as known to the bus.

       my $owner_name = $service->get_owner_name;
	   Retrieves the name of the client owning the service at the time it was connected to.

       my $object = $service->get_object($object_path[, $interface]);
	   Retrieves a handle to the remote object provided by the service  with the name of $object_path. If the optional $interface parameter is
	   provided, the object will immediately be cast to the designated interface. NB, it is only neccessary to cast an object to a specific
	   interface if there are multiple interfaces on the object providing methods with the same name, or the remote object does support
	   introspection. The returned object will be an instance of Net::DBus::RemoteObject.

AUTHOR

       Daniel Berrange <dan@berrange.com>

COPYRIGHT

       Copright (C) 2004-2011, Daniel Berrange.

SEE ALSO

       Net::DBus::RemoteObject, Net::DBus::Service, Net::DBus

perl v5.14.2							    2011-06-30					     Net::DBus::RemoteService(3pm)
Man Page