mdns2

multicast DNS service discovery

  • mdns2

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
mdns2
861402.1.410 years ago11 years agoMinified + gzip package size for mdns2 in KB

Readme

h1. mdns -- node.js Service Discovery
THIS IS A FORK OF "agnat/nodemdns":https://github.com/agnat/nodemdns WITH ADDITIONAL PATCHES. THE MOMENT agnat/nodemdns BECOMES ACTIVE AGAIN, WE WILL SYNC UP AND REMOVE THIS REPOSITORY.
THE NAME OF THIS FORK ON NPM IS @mdns2@
|
. Package: | mdns | |. Description: | multicast DNS service discovery | |. Version: | 2.1.0 | |. Installation: | @npm install mdns2@ (see below) | |. Documentation: | "mdns user guide":http://agnat.github.com/nodemdns/userguide.html | |. License: | "MIT":http://github.com/agnat/nodemdns/blob/master/LICENSE | |. Donations: | !http://api.flattr.com/button/flattr-badge-large.png(Flattr this git repository)!:https://flattr.com/submit/auto?userid=agnat&url=https://github.com/agnat/nodemdns&title=nodemdns&tags=github&category=software |
mdns adds multicast DNS service discovery, also known as zeroconf or bonjour to "node.js":/joyent/node. It provides an object based interface to announce and browse services on the local network.
h2. Synopsis
bc.. // import the module var mdns = require('mdns');
// advertise a http server on port 4321 var ad = mdns.createAdvertisement(mdns.tcp('http'), 4321); ad.start();
// watch all http servers var browser = mdns.createBrowser(mdns.tcp('http')); browser.on('serviceUp', function(service) { console.log("service up: ", service); }); browser.on('serviceDown', function(service) { console.log("service down: ", service); }); browser.start();
// discover all available service types var allthetypes = mdns.browseThemAll(); // allthetypes is just another browser...
h2. Installation
On Linux and other systems using the avahi daemon the avahi dnssd compat library and its header files are required. On debianesque systems the package name is @libavahi-compat-libdnssd-dev@. On other platforms Apples "mDNSResponder":http://opensource.apple.com/tarballs/mDNSResponder/ is recommended. Care should be taken not to install more than one mDNS stack on a system.
On Windows you are going to need Apples "Bonjour SDK for Windows". You can download it either from Apple (registration required) or various unofficial sources. Take your pick. After installing the SDK restart your shell or command prompt and make sure the @BONJOUR
SDKHOME@ environment variable is set. You'll also need a compiler. Microsoft Visual Studio Express will do. On Windows node >=0.7.9 is required.
mdns is available as a npm package:
bc. npm install mdns2
If you want to play with the latest source code, here is a more manual approach:
bc. git clone http://github.com/Wizcorp/node
mdns cd nodemdns npm link && npm test
In case you want to run or even publish your package using the development version of mdns you may set the version field to a tarball URL:
bc. { "name": "discomvobulator" , "version": "0.0.1" , "description": "covers all your discomvobulation needs" , "dependencies": { "mdns": "https://github.com/Wizcorp/node
mdns/tarball/master" } }
h2. Documentation
See the "user guide":http://agnat.github.com/nodemdns/userguide.html.
h2. Contributors
... in random order:
  • Orlando Vazquez ("@orlandov":http://github.com/orlandov)
  • Ryan Dahl ("@ry":http://github.com/ry)
  • Dominic Tarr ("@dominictarr":http://github.com/dominictarr)
  • Emil Stenqvist ("@emilisto":http://github.com/emilisto)
  • Toby Ealden ("@TobyEalden":http://github.com/TobyEalden)

Your name is missing on the list? Shame on me. Please open an issue.
h2. Bugs and Contributions
If you find a bug, please report it using the "issue tracker":http://github.com/Wizcorp/nodemdns/issues.