Permalink
Browse files

Update README to match reality.

  • Loading branch information...
1 parent 7570721 commit 0b879d71ec0ea6b03857042c13748df3a0a8d6e5 @nevali nevali committed Sep 1, 2010
Showing with 80 additions and 50 deletions.
  1. +80 −50 README
View
130 README
@@ -60,67 +60,97 @@ For example:
$ ./radiodns -app radiovis fm 9580 0xc586 0xce1
Instance (no name):
- 1 service records.
- IN SRV 0 100 61613 vis.musicradio.com.
+ 1 service record:
+ IN SRV 0 100 61613 vis.musicradio.com.
+ No parameters.
This does, of course, work on ordinary DNS domains which advertise SRV
records in the usual fashion. For example:
$ ./radiodns -app xmpp-server dns google.com
Instance (no name):
- 5 service records.
- IN SRV 20 0 5269 xmpp-server4.l.google.com.
- IN SRV 5 0 5269 xmpp-server.l.google.com.
- IN SRV 20 0 5269 xmpp-server1.l.google.com.
- IN SRV 20 0 5269 xmpp-server2.l.google.com.
- IN SRV 20 0 5269 xmpp-server3.l.google.com.
+ 5 service records:
+ IN SRV 20 0 5269 xmpp-server4.l.google.com.
+ IN SRV 5 0 5269 xmpp-server.l.google.com.
+ IN SRV 20 0 5269 xmpp-server1.l.google.com.
+ IN SRV 20 0 5269 xmpp-server2.l.google.com.
+ IN SRV 20 0 5269 xmpp-server3.l.google.com.
+ No parameters.
In a minor divergance from the RadioDNS specification, libradiodns supports
multiple service instances, using PTR records (as per DNS-SD):
-$ ./radiodns -app http dns-sd.org
+$ ./radiodns -app http dns dns-sd.org
Instance (no name):
- 1 service records.
- IN SRV 0 100 80 www.dns-sd.org.
-Instance \032*\032DNS\032Service\032Discovery:
- 1 service records.
- IN SRV 0 0 80 dns-sd.org.
-Instance Stuart\226\128\153s\032Printer:
- 1 service records.
- IN SRV 0 0 80 exampleprinter.dns-sd.org.
-Instance \032*\032CNN,\032World\032news:
- 1 service records.
- IN SRV 0 0 80 www.cnn.com.
-Instance \032*\032BBC,\032World\032news:
- 1 service records.
- IN SRV 0 0 80 news.bbc.co.uk.
-Instance \032*\032Multicast\032DNS:
- 1 service records.
- IN SRV 0 0 80 multicastdns.org.
-Instance \032*\032Zeroconf:
- 1 service records.
- IN SRV 0 0 80 zeroconf.org.
-Instance \032*\032Wired,\032Technology,\032Culture,\032Business,\032Politics:
- 1 service records.
- IN SRV 0 0 80 wired.com.
-Instance \032*\032SlashDot,\032News\032for\032Nerds,\032Stuff\032that\032Matters:
- 1 service records.
- IN SRV 0 0 80 slashdot.org.
-Instance \032*\032Yahoo,\032maps,\032weather,\032and\032stock\032quotes:
- 1 service records.
- IN SRV 0 0 80 www.yahoo.com.
-Instance \032*\032Amazon\:
- 1 service records.
- IN SRV 0 0 80 www.amazon.com.
-Instance \032*\032Google,\032searching\032the\032Web:
- 1 service records.
- IN SRV 0 0 80 www.google.com.
-Instance \032*\032Apple,\032makers\032of\032the\032iPod:
- 1 service records.
- IN SRV 0 0 80 www.apple.com.
-Instance \032*\032eBay,\032online\032auctions:
- 1 service records.
- IN SRV 0 0 80 www.ebay.com.
+ 1 service record:
+ IN SRV 0 100 80 www.dns-sd.org.
+ No parameters.
+Instance " * Zeroconf":
+ 1 service record:
+ IN SRV 0 0 80 zeroconf.org.
+ 1 parameter:
+ path = /
+Instance " * Wired, Technology, Culture, Business, Politics":
+ 1 service record:
+ IN SRV 0 0 80 wired.com.
+ 1 parameter:
+ path = /
+Instance " * SlashDot, News for Nerds, Stuff that Matters":
+ 1 service record:
+ IN SRV 0 0 80 slashdot.org.
+ 1 parameter:
+ path = /
+Instance " * Yahoo, maps, weather, and stock quotes":
+ 1 service record:
+ IN SRV 0 0 80 www.yahoo.com.
+ 1 parameter:
+ path = /
+Instance " * Amazon.com, on-line shopping":
+ 1 service record:
+ IN SRV 0 0 80 www.amazon.com.
+ 1 parameter:
+ path = /
+Instance " * Google, searching the Web":
+ 1 service record:
+ IN SRV 0 0 80 www.google.com.
+ 1 parameter:
+ path = /
+Instance " * Apple, makers of the iPod":
+ 1 service record:
+ IN SRV 0 0 80 www.apple.com.
+ 1 parameter:
+ path = /
+Instance " * eBay, online auctions":
+ 1 service record:
+ IN SRV 0 0 80 www.ebay.com.
+ 1 parameter:
+ path = /
+Instance " * DNS Service Discovery":
+ 1 service record:
+ IN SRV 0 0 80 dns-sd.org.
+ 1 parameter:
+ path = /
+Instance "Stuart's Printer":
+ 1 service record:
+ IN SRV 0 0 80 exampleprinter.dns-sd.org.
+ 1 parameter:
+ path = /
+Instance " * CNN, World news":
+ 1 service record:
+ IN SRV 0 0 80 www.cnn.com.
+ 1 parameter:
+ path = /
+Instance " * BBC, World news":
+ 1 service record:
+ IN SRV 0 0 80 news.bbc.co.uk.
+ 1 parameter:
+ path = /
+Instance " * Multicast DNS":
+ 1 service record:
+ IN SRV 0 0 80 multicastdns.org.
+ 1 parameter:
+ path = /
+
In this example, dns-sd.org has a SRV record on _http._tcp.dns-sd.org, but it
*also* has thirteen PTR records, consituting named service instances. In the

0 comments on commit 0b879d7

Please sign in to comment.