138 lines
3.2 KiB
HTML
138 lines
3.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of Net::DBus::Binding::Bus</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>Net::DBus::Binding::Bus</H1>
|
|
Section: User Contributed Perl Documentation (3pm)<BR>Updated: 2019-12-26<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
Net::DBus::Binding::Bus - Handle to a well-known message bus instance
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
|
|
|
|
|
|
|
|
<PRE>
|
|
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);
|
|
|
|
</PRE>
|
|
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
|
|
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 <TT>"session"</TT> or
|
|
<TT>"system"</TT> methods in Net::DBus.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>METHODS</H2>
|
|
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="1">my $bus = Net::DBus::Binding::Bus->new(type => $type);<DD>
|
|
|
|
|
|
|
|
|
|
|
|
<DT id="2">my $bus = Net::DBus::Binding::Bus->new(address => $addr);<DD>
|
|
|
|
|
|
|
|
|
|
|
|
Open a connection to a message bus, either a well known bus type
|
|
specified using the <TT>"type"</TT> parameter, or an arbitrary bus specified
|
|
using the <TT>"address"</TT> parameter. If the <TT>"private"</TT> 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.
|
|
<DT id="3">$bus->request_name($service_name)<DD>
|
|
|
|
|
|
|
|
|
|
Send a request to the bus registering the well known name
|
|
specified in the <TT>$service_name</TT> parameter. If another client
|
|
already owns the name, registration will be queued up, pending
|
|
the exit of the other client.
|
|
<DT id="4">my $name = $bus->get_unique_name<DD>
|
|
|
|
|
|
|
|
|
|
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.
|
|
<DT id="5">$bus->add_match($rule)<DD>
|
|
|
|
|
|
|
|
|
|
Register a signal match rule with the bus controller, allowing
|
|
matching broadcast signals to routed to this client.
|
|
<DT id="6">$bus->remove_match($rule)<DD>
|
|
|
|
|
|
|
|
|
|
Unregister a signal match rule with the bus controller, preventing
|
|
further broadcast signals being routed to this client
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
|
|
|
|
Daniel P. Berrange
|
|
<A NAME="lbAG"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
|
|
|
|
Copyright (C) 2004-2011 Daniel P. Berrange
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
|
|
|
|
Net::DBus::Binding::Connection, Net::DBus
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="10"><A HREF="#lbAE">METHODS</A><DD>
|
|
<DT id="11"><A HREF="#lbAF">AUTHOR</A><DD>
|
|
<DT id="12"><A HREF="#lbAG">COPYRIGHT</A><DD>
|
|
<DT id="13"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:48 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|