---
name: "Net::DBus::Binding::Bus"
section: "3pm"
platform: "linux"
package: "perl-net-dbus"
version: "1.2.0-9"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Net::DBus::Binding::Bus"
---

# Net::DBus::Binding::Bus(3pm)

Handle to a well-known message bus instance

## 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