net::rendezvous::publish::service(3pm) [debian man page]

Net::Rendezvous::Publish::Service(3pm)			User Contributed Perl Documentation		    Net::Rendezvous::Publish::Service(3pm)

NAME

	 Net::Rendezvous::Publish::Service - a Rendezvous odvertised service

SYNOPSIS

	 use Net::Rendezvous::Publish;
	 my $z = Net::Rendezvous::Publish->new;
	 # publish a webserver on an odd port
	 my $service = $z->publish( name => "My Webserver",
				    type => "_http._tcp",
				    port => 8231 );
	 # handle callbacks for 10 seconds
	 for (1..100) { $z->step( 0.1 ) }

	 # stop publishing the service
	 $service->stop;

DESCRIPTION

       A Net::Rendezvous::Publish::Service represents a service you tried to publish.

       You never create one directly, and instead are handed one by the publish method.

METHODS

   stop
       Stop advertising the service.

AUTHOR

       Richard Clamp <richardc@unixbeard.net>

COPYRIGHT

       Copyright 2004, Richard Clamp.  All Rights Reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       Net::Rendezvous::Publish - the module this module supports

perl v5.10.1							    2010-06-07				    Net::Rendezvous::Publish::Service(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)