debian net::bonjour::entry man page on unix.com

Net::Bonjour::Entry(3pm)				User Contributed Perl Documentation				  Net::Bonjour::Entry(3pm)

NAME
       Net::Bonjour::Entry - Support module for mDNS service discovery (Apple's Bonjour)

SYNOPSIS
       use Net::Bonjour;

       my $res = Net::Bonjour->new(<service>[, <protocol>]); $res->discover;

       foreach my $entry ( $res->entries ) {	  print $entry->name, "
"; }

DESCRIPTION
       Net::Bonjour::Entry is a module used to manage entries returned by a mDNS service discovery (Apple's Bonjour).  See Net::Bonjour for more
       information.

METHODS
   new([<fqdn>])
       Creates a new Net::Bonjour::Entry object. The optional argument defines the fully qualifed domain name (FQDN) of the entry.  Normal usage
       of the Net::Bonjour module will not require the construction of Net::Bonjour::Entry objects, as they are automatically created during the
       discovery process.

   address
       Returns the IP address of the entry.

   all_attrs
       Returns all the current attributes in the form of hashed array.

   attribute(<attribute>)
       Returns the specified attribute from the TXT record of the entry.  TXT records are used to specify additional information, e.g. path for
       http.

   dnsrr([<record type>])
       Returns an DNS answer packet of the entry.  The output will be in the format of a Net::DNS::Packet object.  The record type designates the
       resource record to answer with, i.e. PTR, SRV, or TXT.  The default is PTR.

   fetch
       Reloads the information for the entry via mDNS.

   fqdn
       Returns the fully qualifed domain name (FQDN) of entry.	An example FQDN is server._afpovertcp._tcp.local

   hostname
       Returns the hostname of the server, e.g. 'server.local'.

   name
       Returns the name of the entry.  In the case of the fqdn example, the name would be 'server'.  This name may not be the hostname of the
       server.	For example, names for presence/tcp will be the name of the user and http/tcp will be title of the web resource.

   port
       Returns the TCP or UDP port of the entry.

   sockaddr
       Returns the binary socket address for the resource and can be used directly to bind() sockets.

EXAMPLES
   Print out a list of local websites
	       print "<HTML><TITLE>Local Websites</TITLE>";

	       use Net::Bonjour;

	       my $res = Net::Bonjour->new('http');
	       $res->discover;

	       foreach my $entry ( $res->entries) {
		       printf "<A HREF='http://%s%s'>%s</A><BR>",
			       $entry->address, $entry->attribute('path'),
			       $entry->name;
	       }

	       print "</HTML>";

   Find a service and connect to it
	       use Net::Bonjour;

	       my $res = Net::Bonjour->new('custom');
	       $res->discover;

	       my $entry = $res->shift_entry;

	       socket SOCK, PF_INET, SOCK_STREAM, scalar(getprotobyname('tcp'));

	       connect SOCK, $entry->sockaddr;

	       print SOCK "Send a message to the service";

	       while ($line = <SOCK>) { print $line; }

	       close SOCK;

SEE ALSO
       Net::Bonjour

COPYRIGHT
       This library is free software and can be distributed or modified under the same terms as Perl itself.

       Bonjour (in this context) is a trademark of Apple Computer, Inc.

AUTHORS
       The Net::Bonjour::Entry module was created by George Chlipala <george@walnutcs.com>

perl v5.10.0							    2007-03-18						  Net::Bonjour::Entry(3pm)
debian man page for net::bonjour::entry
