Man page of Net::DBus::Binding::Bus

Net::DBus::Binding::Bus

Section: User Contributed Perl Documentation (3pm)

Updated: 2011-06-30

Index?action=index Return to Main Contents


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


Index

NAME

SYNOPSIS

DESCRIPTION

METHODS

AUTHOR

COPYRIGHT

SEE ALSO