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

Net::DBus::Annotation(3pm)				User Contributed Perl Documentation				Net::DBus::Annotation(3pm)

NAME

       Net::DBus::Annotation - annotations for changing behaviour of APIs

SYNOPSIS

	 use Net::DBus::Annotation qw(:call);

	 my $object = $service->get_object("/org/example/systemMonitor");

	 # Block until processes are listed
	 my $processes = $object->list_processes("someuser");

	 # Just throw away list of processes, pretty pointless
	 # in this example, but useful if the method doesn't have
	 # a return value
	 $object->list_processes(dbus_call_noreply, "someuser");

	 # List processes & get on with other work until
	 # the list is returned.
	 my $asyncreply = $object->list_processes(dbus_call_async, "someuser");

	 ... some time later...
	 my $processes = $asyncreply->get_data;

DESCRIPTION

       This module provides a number of annotations which will be useful when dealing with the DBus APIs. There are annotations for switching
       remote calls between sync, async and no-reply mode. More annotations may be added over time.

METHODS

       dbus_call_sync
	   Requests that a method call be performed synchronously, waiting for the reply or error return to be received before continuing.

       dbus_call_async
	   Requests that a method call be performed a-synchronously, returning a pending call object, which will collect the reply when it
	   eventually arrives.

       dbus_call_noreply
	   Requests that a method call be performed a-synchronously, discarding any possible reply or error message.

AUTHOR

       Daniel Berrange <dan@berrange.com>

COPYRIGHT

       Copright (C) 2006-2011, Daniel Berrange.

SEE ALSO

       Net::DBus, Net::DBus::RemoteObject

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

Net::DBus::RemoteService(3pm)				User Contributed Perl Documentation			     Net::DBus::RemoteService(3pm)

NAME

       Net::DBus::RemoteService - Access services provided on the bus

SYNOPSIS

	 my $bus = Net::DBus->find;
	 my $service = $bus->get_service("org.freedesktop.DBus");

	 my $object = $service->get_object("/org/freedesktop/DBus");
	 foreach (@{$object->ListNames}) {
	   print "$_
";
	 }

DESCRIPTION

       This object provides a handle to a remote service on the bus. From this handle it is possible to access objects associated with the
       service. If a service is not running, an attempt will be made to activate it the first time a method is called against one of its objects.

METHODS

       my $service = Net::DBus::RemoteService->new($bus, $owner, $service_name);
	   Creates a new handle for a remote service. The $bus parameter is an instance of Net::DBus, $owner is the name of the client providing
	   the service, while $service_name is the well known name of the  service on the bus. Service names consist of two or more tokens,
	   separated by periods, while the tokens comprise the letters a-z, A-Z, 0-9 and _, for example "org.freedesktop.DBus". There is generally
	   no need to call this constructor, instead the "get_service" method on Net::DBus should be used. This caches handles to remote services,
	   eliminating repeated retrieval of introspection data.

       my $bus = $service->get_bus;
	   Retrieves a handle for the bus to which this service is attached.  The returned object will be an instance of Net::DBus.

       my $service_name = $service->get_service_name
	   Retrieves the name of the remote service as known to the bus.

       my $owner_name = $service->get_owner_name;
	   Retrieves the name of the client owning the service at the time it was connected to.

       my $object = $service->get_object($object_path[, $interface]);
	   Retrieves a handle to the remote object provided by the service  with the name of $object_path. If the optional $interface parameter is
	   provided, the object will immediately be cast to the designated interface. NB, it is only neccessary to cast an object to a specific
	   interface if there are multiple interfaces on the object providing methods with the same name, or the remote object does support
	   introspection. The returned object will be an instance of Net::DBus::RemoteObject.

AUTHOR

       Daniel Berrange <dan@berrange.com>

COPYRIGHT

       Copright (C) 2004-2011, Daniel Berrange.

SEE ALSO

       Net::DBus::RemoteObject, Net::DBus::Service, Net::DBus

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