Net::D...ng::Bus(3pm) User Contributed Perl Documentation Net::D...ng::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.40.0 2024-10-15 Net::D...ng::Bus(3pm)
Generated by dwww version 1.16 on Tue Dec 16 07:02:34 CET 2025.