Net::DBus::RemoteServiUserpContributed Perl DocumNet::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 "$_\n";
}
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]); =item my
$object = $service->get_object($object_path, \%params);
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 necessary 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.
An alternate form of the method is available, passing a hash
reference of extra parameters. Valid keys in the hash are
"interface" specifying the interface name to cast to, and "timeout"
specifying a timeout in milliseconds
my $timeout = $service->timeout(60 * 1000);
Sets or retrieves the timeout value which will be used for DBus
requests belongs to this service. The value is in milliseconds. If
the timeout for a service is undefined, then the default timeout
from the bus will apply.
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.36.0 2022-12-06 Net::DBus::RemoteService(3pm)
Generated by dwww version 1.15 on Thu Jun 20 14:18:51 CEST 2024.