GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Net::Bonjour::Entry(3) User Contributed Perl Documentation Net::Bonjour::Entry(3)

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

use Net::Bonjour;

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

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

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.

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.

Returns the IP address of the entry.

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

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

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.

Reloads the information for the entry via mDNS.

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

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

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.

Returns the TCP or UDP port of the entry.

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

        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>";

        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;

Net::Bonjour

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.

The Net::Bonjour::Entry module was created by George Chlipala <george@walnutcs.com>
2007-03-18 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.