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