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

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

NAME

       Net::Rendezvous::Publish - publish Rendezvous services

SYNOPSIS

	use Net::Rendezvous::Publish;
	my $publisher = Net::Rendezvous::Publish->new
	  or die "couldn't make a Responder object";
	my $service = $publisher->publish(
	    name => "My HTTP Server",
	    type => '_http._tcp',
	    port => 12345,
	);
	while(1) { $publisher->step( 0.01 ) }

DESCRIPTION

METHODS

   new
       Creates a new publisher handle

   publish( %definition )
       Returns a Net::Rendezvous::Publish::Service object.  The following keys are meaningful in the service definition hash.

       name
	   A descriptive name for the service.

       type
	   The type of service.  This is string of the form _service._protocol.

       port
	   The port on which you're advertising the service.  If you're not using a port (and instead just using mDNS as a way of propogating
	   other service information) it's common practice to use 9 (the discard service)

       domain
	   The domain in which to advertise a service.	Defaults to "local."

   step( $seconds )
       Spend at most $seconds seconds handling network events and updating internal state.

TODO

       At some point I may learn enough of the mDNS protocol to write a pure-perl responder.  That'll be nifty.

AUTHOR

       Richard Clamp <richardc@unixbeard.net>

COPYRIGHT

       Copyright 2004, 2005, 2006, 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::Rendezous - for service browsing.

       Net::Rendezvous::Publish::Backend::* - you'll need one of these to talk to your local mDNS responder.

perl v5.10.1							    2010-06-07					     Net::Rendezvous::Publish(3pm)

avahi-publish-service(1)				      General Commands Manual					  avahi-publish-service(1)

NAME

       avahi-publish-service - Register an mDNS/DNS-SD service or host name or address mapping using the Avahi daemon

SYNOPSIS

       avahi-publish -s [options] name service-type port [TXT data ...]

       avahi-publish-service [options] name service-type port [TXT data ...]

       avahi-publish -a [options] host name address

       avahi-publish-address [options] host name address

DESCRIPTION

       Register an mDNS/DNS-SD service or host name/address mapping using the Avahi daemon.

OPTIONS

       When  calling in service registration mode, specify a DNS-SD service name (e.g. "Lennart's Files"), a service type (e.g. _http._tcp) and an
       IP port number for the service, optionally followed by any number of TXT record strings on the command line. When calling  in  address/host
       name registration mode specify a fully qualified host name and an address (IPv4 or IPv6).

       -s | --service
	      Register a service. avahi-publish-service is equivalent to avahi-publish -s.

       -a | --address
	      Register an address/host name mapping. avahi-publish-address is equivalent to avahi-publish -a.

       -v | --verbose
	      Enable verbose mode.

       -H | --host= HOSTNAME
	      Specify  a  host	name for this service, in case it doesn't reside on the local host. This host name needs to be fully qualified and
	      resolvable using mDNS or unicast DNS.

       -d | --domain= DOMAIN
	      Publish the service in the specified domain. If omitted the Avahi daemon will publish it in its default domain (usually .local).

       --subtype= SUBTYPE
	      Register the service with an additional subtype in addition to the main type. DNS-SD subtypes have  the  form  _anon._sub._ftp._tcp,
	      where _anon is the identifier of the subtype and _ftp._tcp is the main type. You may pass this option multiple times to register the
	      service with multiple subtypes.

       -f | --no-fail
	      Don't fail if the daemon is not found running. Instead, wait until it appears. If it disconnects, try to reconnect.

       -h | --help
	      Show help

       -V | --version
	      Show version information.

AUTHORS

       The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from http://avahi.org/

SEE ALSO

       avahi-resolve(1), avahi-browse(1), avahi-daemon(8)

COMMENTS

       This man page was written using xml2man(1) by Oliver Kurth.

Manuals 							       User						  avahi-publish-service(1)