Net::DB...ing::Bus(3)

💖 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 🦋

Okay bestie, welcome to Net::DB...ing::Bus(3) — that's the page from User Contributed Perl Documentation, and we're talking about Net::DBus::Binding::Bus 🫶. This module is a specialization of Net::DBus::Binding::Connection, and it gives you a 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. Periodt. ✨

🎀 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. No skipping that part, bestie. 💀
• $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. iykyk.
• my $name = $bus->get_unique_name — returns the unique name by which this process's connection to the bus is known. Unique names are never re-used for the entire lifetime of the bus daemon. Iconic.
• $bus->add_match($rule) — register a signal match rule with the bus controller, allowing matching broadcast signals to be routed to this client. ✨
• $bus->remove_match($rule) — unregister a signal match rule with the bus controller, preventing further broadcast signals from 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

---

Mwah 💖 this lil' page is from perl v5.42.0, dated 2019-12-17, and it lives under Net::DB...ing::Bus(3). Bestie, you're all caught up. 🎀✨