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]);
           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.

AUTHOR

       Daniel Berrange <dan@berrange.com>

COPYRIGHT

       Copright (C) 2004-2011, Daniel Berrange.

SEE ALSO

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