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

Net::DBus::Binding::Bus(3pm)				User Contributed Perl Documentation			      Net::DBus::Binding::Bus(3pm)

NAME

       Net::DBus::Binding::Bus - Handle to a well-known message bus instance

SYNOPSIS

	 use Net::DBus::Binding::Bus;

	 # Get a handle to the system bus
	 my $bus = Net::DBus::Binding::Bus->new(type => &Net::DBus::Binding::Bus::SYSTEM);

DESCRIPTION

       This is a specialization of the Net::DBus::Binding::Connection module providing convenience constructor for connecting to one of the well-
       known bus types. There is no reason to use this module directly, instead get a handle to the bus with the "session" or "system" methods in
       Net::DBus.

METHODS

       my $bus = Net::DBus::Binding::Bus->new(type => $type);
       my $bus = Net::DBus::Binding::Bus->new(address => $addr);
	   Open a connection to a message bus, either a well known bus type specified using the "type" parameter, or an arbitrary bus specified
	   using the "address" parameter. If the "private" parameter is set to a true value, then a private connection to the bus is obtained.
	   The caller must explicitly disconnect this bus instance before releasing the last instance of the object.

       $bus->request_name($service_name)
	   Send a request to the bus registering the well known name specified in the $service_name parameter. If another client already owns the
	   name, registration will be queued up, pending the exit of the other client.

       my $name = $bus->get_unique_name
	   Returns the unique name by which this processes' connection to the bus is known. Unique names are never re-used for the entire lifetime
	   of the bus daemon.

       $bus->add_match($rule)
	   Register a signal match rule with the bus controller, allowing matching broadcast signals to routed to this client.

       $bus->remove_match($rule)
	   Unregister a signal match rule with the bus controller, preventing further broadcast signals being routed to this client

AUTHOR

       Daniel P. Berrange

COPYRIGHT

       Copyright (C) 2004-2011 Daniel P. Berrange

SEE ALSO

       Net::DBus::Binding::Connection, Net::DBus

perl v5.14.2							    2011-06-30					      Net::DBus::Binding::Bus(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)