net::dbus::binding::pendingcall(3pm) [debian man page]

Net::DBus::Binding::PendingCall(3pm)			User Contributed Perl Documentation		      Net::DBus::Binding::PendingCall(3pm)

NAME

       Net::DBus::Binding::PendingCall - A handler for pending method replies

SYNOPSIS

	 my $call = Net::DBus::Binding::PendingCall->new(method_call => $call,
							 pending_call => $reply);

	 # Wait for completion
	 $call->block;

	 # And get the reply message
	 my $msg = $call->get_reply;

DESCRIPTION

       This object is used when it is necessary to make asynchronous method calls. It provides the means to be notified when the reply is finally
       received.

METHODS

       my $call = Net::DBus::Binding::PendingCall->new(method_call => $method_call, pending_call => $pending_call);
	   Creates a new pending call object, with the "method_call" parameter being a reference to the "Net::DBus::Binding::Message::MethodCall"
	   object whose reply is being waiting for. The "pending_call" parameter is a reference to the raw C pending call object.

       $call->cancel
	   Cancel the pending call, causing any reply that is later received to be discarded.

       my $boolean = $call->get_completed
	   Returns a true value if the pending call has received its reply, or a timeout has occurred.

       $call->block
	   Block the caller until the reply is received or a timeout occurrs.

       my $msg = $call->get_reply;
	   Retrieves the "Net::DBus::Binding::Message" object associated with the complete call.

       $call->set_notify($coderef);
	   Sets a notification function to be invoked when the pending call completes. The callback will be passed a single argument which is this
	   pending call object.

AUTHOR

       Daniel P. Berrange

COPYRIGHT

       Copyright (C) 2006-2011 Daniel P. Berrange

SEE ALSO

       Net::DBus::Binding::Connection, Net::DBus::Binding::Message, Net::DBus::ASyncReply

perl v5.14.2							    2011-06-30				      Net::DBus::Binding::PendingCall(3pm)

Net::DBus::Binding::Bus(3pm)				User Contributed Perl Documentation			      Net::DBus::Binding::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.14.2							    2011-06-30					      Net::DBus::Binding::Bus(3pm)