Net::DBus::RemoteObject man page on Mageia

Man page or keyword search:  
man Server   17783 pages
apropos Keyword Search (all sections)
Output format
Mageia logo
[printable version]

Net::DBus::RemoteObjecUser Contributed Perl DocumentNet::DBus::RemoteObject(3)

NAME
       Net::DBus::RemoteObject - Access objects provided on the bus

SYNOPSIS
	 my $service = $bus->get_service("org.freedesktop.DBus");
	 my $object = $service->get_object("/org/freedesktop/DBus");

	 print "Names on the bus {\n";
	 foreach my $name (sort @{$object->ListNames}) {
	     print "  ", $name, "\n";
	 }
	 print "}\n";

DESCRIPTION
       This module provides the API for accessing remote objects available on
       the bus. It uses the autoloader to fake the presence of methods based
       on the API of the remote object. There is also support for setting
       callbacks against signals, and accessing properties of the object.

METHODS
       my $object = Net::DBus::RemoteObject->new($service, $object_path[,
       $interface]);
	   Creates a new handle to a remote object. The $service parameter is
	   an instance of the Net::DBus::RemoteService method, and
	   $object_path is the identifier of an object exported by this
	   service, for example "/org/freedesktop/DBus". For remote objects
	   which implement more than one interface it is possible to specify
	   an optional name of an interface as the third parameter. This is
	   only really required, however, if two interfaces in the object
	   provide methods with the same name, since introspection data can be
	   used to automatically resolve the correct interface to call cases
	   where method names are unique. Rather than using this constructor
	   directly, it is preferrable to use the "get_object" method on
	   Net::DBus::RemoteService, since this caches handles to remote
	   objects, eliminating unneccessary introspection data lookups.

       my $object = $object->as_interface($interface);
	   Casts the object to a specific interface, returning a new instance
	   of the Net::DBus::RemoteObject specialized to the desired
	   interface. It is only neccessary to cast objects to a specific
	   interface, if two interfaces export methods or signals with the
	   same name, or the remote object does not support introspection.

       my $service = $object->get_service
	   Retrieves a handle for the remote service on which this object is
	   attached. The returned object is an instance of
	   Net::DBus::RemoteService

       my $path = $object->get_object_path
	   Retrieves the unique path identifier for this object within the
	   service.

       my $object = $object->get_child_object($subpath, [$interface])
	   Retrieves a handle to a child of this object, identified by the
	   relative path $subpath. The returned object is an instance of
	   "Net::DBus::RemoteObject". The optional $interface parameter can be
	   used to immediately cast the object to a specific type.

       my $sigid = $object->connect_to_signal($name, $coderef);
	   Connects a callback to a signal emitted by the object. The $name
	   parameter is the name of the signal within the object, and $coderef
	   is a reference to an anonymous subroutine. When the signal $name is
	   emitted by the remote object, the subroutine $coderef will be
	   invoked, and passed the parameters from the signal. A unique $sigid
	   will be returned, which can be later passed to
	   "disconnect_from_signal" to remove the handler

       $object->disconnect_from_signal($name, $sigid);
	   Disconnects from a signal emitted by the object. The $name
	   parameter is the name of the signal within the object. The $sigid
	   must be the unique signal handler ID returned by a previous
	   "connect_to_signal" method call.

AUTHOR
       Daniel Berrange <dan@berrange.com>

COPYRIGHT
       Copright (C) 2004-2011, Daniel Berrange.

SEE ALSO
       Net::DBus::RemoteService, Net::DBus::Object

perl v5.18.1			  2011-06-30	    Net::DBus::RemoteObject(3)
[top]

List of man pages available for Mageia

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net