Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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)

Check Out this Related Man Page

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

NAME

       Net::DBus::Binding::Message::Signal - a message encoding a signal

SYNOPSIS

	 use Net::DBus::Binding::Message::Signal;

	 my $signal = Net::DBus::Binding::Message::Signal->new(
	     object_path => "/org/example/myobject",
	     interface => "org.example.myobject",
	     signal_name => "foo_changed");

	 $connection->send($signal);

DESCRIPTION

       This module is part of the low-level DBus binding APIs, and should not be used by application code. No guarentees are made about APIs under
       the "Net::DBus::Binding::" namespace being stable across releases.

       This module provides a convenience constructor for creating a message representing a signal.

METHODS

       my $signal = Net::DBus::Binding::Message::Signal->new( object_path => $path, interface => $interface, signal_name => $name);
	   Creates a new message, representing a signal [to be] emitted by the object located under the path given by the "object_path" parameter.
	   The name of the signal is given by the "signal_name" parameter, and is scoped to the interface given by the "interface" parameter.

AUTHOR

       Daniel P. Berrange.

COPYRIGHT

       Copyright (C) 2004-2009 Daniel P. Berrange

SEE ALSO

       Net::DBus::Binding::Message

perl v5.14.2							    2011-06-30				  Net::DBus::Binding::Message::Signal(3pm)
Man Page