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

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

NAME

       Net::DBus::Binding::Message::Error - a message encoding a method call error

SYNOPSIS

	 use Net::DBus::Binding::Message::Error;

	 my $error = Net::DBus::Binding::Message::Error->new(
	     replyto => $method_call,
	     name => "org.example.myobject.FooException",
	     description => "Unable to do Foo when updating bar");

	 $connection->send($error);

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 an error condition.

METHODS

       my $error = Net::DBus::Binding::Message::Error->new( replyto => $method_call, name => $name, description => $description);
	   Creates a new message, representing an error which occurred during the handling of the method call object passed in as the "replyto"
	   parameter. The "name" parameter is the formal name of the error condition, while the "description" is a short piece of text giving more
	   specific information on the error.

       my $name = $error->get_error_name
	   Returns the formal name of the error, as previously passed in via the "name" parameter in the constructor.

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::Error(3pm)

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)