This commit is contained in:
Peter Saint-Andre 2013-02-20 17:31:15 -07:00
parent 8c2867bb6b
commit 59ca20b09f
2 changed files with 9 additions and 7 deletions

View File

@ -18,8 +18,8 @@
<spec>XMPP Core</spec>
<spec>XMPP IM</spec>
<spec>RFC 3927</spec>
<spec>draft-cheshire-dnsext-dns-sd</spec>
<spec>draft-cheshire-dnsext-multicastdns</spec>
<spec>RFC 6762</spec>
<spec>RFC 6763</spec>
</dependencies>
<supersedes/>
<supersededby/>
@ -163,7 +163,7 @@
</section2>
<section2 topic='How It Works' anchor='howitworks'>
<p>This section provides a friendly introduction to serverless messaging. The examples show usage on a local link using dynamically configured link-local addresses as described in &rfc3927; (see the <link url='#impl-wide'>Wide-Area Networks</link> section of this document regarding non-local usage).</p>
<p>Imagine that you are a Shakespearean character named Juliet. You are are using your laptop computer (a machine named "pronto") at a wifi hotspot in downtown Verona and you want to find other people to chat with on an ad-hoc basis (i.e., not people in your normal XMPP roster). Therefore your chat client advertises a serverless address of "juliet@pronto" so that other people can dynamically find you at the hotspot. Your client does this by invoking a daemon on your machine that supports DNS-based Service Discovery ("DNS-SD") as defined in &dnssd; and Multicast DNS ("mDNS") as defined in &mdns;. As a result, the daemon (1) publishes the following DNS records to the multicast DNS address 224.0.0.251 (or FF02::FB for IPv6) and (2) listens for multicast DNS queries requesting these records:</p>
<p>Imagine that you are a Shakespearean character named Juliet. You are are using your laptop computer (a machine named "pronto") at a wifi hotspot in downtown Verona and you want to find other people to chat with on an ad-hoc basis (i.e., not people in your normal XMPP roster). Therefore your chat client advertises a serverless address of "juliet@pronto" so that other people can dynamically find you at the hotspot. Your client does this by invoking a daemon on your machine that supports DNS-based Service Discovery ("DNS-SD") as defined in &rfc6763; and Multicast DNS ("mDNS") as defined in &rfc6762;. As a result, the daemon (1) publishes the following DNS records to the multicast DNS address 224.0.0.251 (or FF02::FB for IPv6) and (2) listens for multicast DNS queries requesting these records:</p>
<code><![CDATA[
pronto.local. A 10.2.1.187

10
xep.ent
View File

@ -622,7 +622,9 @@ THE SOFTWARE.
<!ENTITY rfc6455 "<span class='ref'><link url='http://tools.ietf.org/html/rfc6455'>RFC 6455</link></span> <note>RFC 6455: The WebSocket Protocol &lt;<link url='http://tools.ietf.org/html/rfc6455'>http://tools.ietf.org/html/rfc6455</link>&gt;.</note>" >
<!ENTITY rfc6473 "<span class='ref'><link url='http://tools.ietf.org/html/rfc6473'>RFC 6473</link></span> <note>RFC 6473: vCard KIND:application &lt;<link url='http://tools.ietf.org/html/rfc6473'>http://tools.ietf.org/html/rfc6351</link>&gt;.</note>" >
<!ENTITY rfc6648 "<span class='ref'><link url='http://tools.ietf.org/html/rfc6648'>RFC 6648</link></span> <note>RFC 6648: Deprecating the X- Prefix and Similar Constructs in Application Protocols &lt;<link url='http://tools.ietf.org/html/rfc6648'>http://tools.ietf.org/html/rfc6648</link>&gt;.</note>" >
<!ENTITY rfc6716 "<span class='ref'><link url='http://tools.ietf.org/html/rfc6716'>RFC 6716</link></span> <note>RFC 6716: Definition of the Opus Audio Codec &lt;<link url='http://tools.ietf.org/html/rfc6716'>http://tools.ietf.org/html/rfc716</link>&gt;.</note>" >
<!ENTITY rfc6716 "<span class='ref'><link url='http://tools.ietf.org/html/rfc6716'>RFC 6716</link></span> <note>RFC 6716: Definition of the Opus Audio Codec &lt;<link url='http://tools.ietf.org/html/rfc6716'>http://tools.ietf.org/html/rfc6716</link>&gt;.</note>" >
<!ENTITY rfc6762 "<span class='ref'><link url='http://tools.ietf.org/html/rfc6762'>RFC 6762</link></span> <note>RFC 6762: Multicast DNS &lt;<link url='http://tools.ietf.org/html/rfc6762'>http://tools.ietf.org/html/rfc6762</link>&gt;.</note>" >
<!ENTITY rfc6763 "<span class='ref'><link url='http://tools.ietf.org/html/rfc6763'>RFC 6763</link></span> <note>RFC 6763: DNS-Based Service Discovery &lt;<link url='http://tools.ietf.org/html/rfc6763'>http://tools.ietf.org/html/rfc6763</link>&gt;.</note>" >
<!-- Internet-Drafts -->
@ -630,13 +632,11 @@ THE SOFTWARE.
<!ENTITY atomsub "<span class='ref'><link url='http://xmpp.org/internet-drafts/draft-saintandre-atompub-notify-07.html'>AtomSub</link></span> <note>Atomsub: Transporting Atom Notifications over the Publish-Subscribe Extension to the Extensible Messaging and Presence Protocol (XMPP) &lt;<link url='http://xmpp.org/internet-drafts/draft-saintandre-atompub-notify-07.html'>http://xmpp.org/internet-drafts/draft-saintandre-atompub-notify-07.html</link>&gt;. Work in progress.</note>" >
<!ENTITY dna-dns "<span class='ref'><link url='http://datatracker.ietf.org/doc/draft-miller-xmpp-dnssec-prooftype/'>draft-miller-xmpp-dnssec-prooftype</link></span> <note>Using DNS Security Extensions (DNSSEC) and DNS-based Authentication of Named Entities (DANE) as a Prooftype for XMPP Domain Name Associations &lt;<link url='http://datatracker.ietf.org/doc/draft-miller-xmpp-dnssec-prooftype/'>http://datatracker.ietf.org/doc/draft-miller-xmpp-dnssec-prooftype/</link>&gt;. Work in progress.</note>" >
<!ENTITY dna-framework "<span class='ref'><link url='http://datatracker.ietf.org/doc/draft-saintandre-xmpp-dna/'>draft-saintandre-xmpp-dna</link></span> <note>Domain Name Associations (DNA) in the Extensible Messaging and Presence Protocol (XMPP) &lt;<link url='http://datatracker.ietf.org/doc/draft-saintandre-xmpp-dna/'>http://datatracker.ietf.org/doc/draft-saintandre-xmpp-dna/</link>&gt;. Work in progress.</note>" >
<!ENTITY dnssd "<span class='ref'><link url='http://tools.ietf.org/html/draft-cheshire-dnsext-dns-sd'>DNS-Based Service Discovery</link></span> <note>DNS-Based Service Discovery &lt;<link url='http://tools.ietf.org/html/draft-cheshire-dnsext-dns-sd'>http://tools.ietf.org/html/draft-cheshire-dnsext-dns-sd</link>&gt;. Work in progress.</note>" >
<!ENTITY dtlssrtp "<span class='ref'><link url='http://tools.ietf.org/html/draft-ietf-avt-dtls-srtp'>DTLS-SRTP</link></span> <note>Datagram Transport Layer Security (DTLS) Extension to Establish Keys for Secure Real-time Transport Protocol (SRTP) &lt;<link url='http://tools.ietf.org/html/draft-ietf-avt-dtls-srtp'>http://tools.ietf.org/html/draft-ietf-avt-dtls-srtp</link>&gt;. Work in progress.</note>" >
<!ENTITY geoprivpol "<span class='ref'><link url='http://tools.ietf.org/html/draft-ietf-geopriv-policy'>Geopriv Policy</link></span> <note>Geopriv Policy &lt;<link url='http://tools.ietf.org/html/draft-ietf-geopriv-policy'>http://tools.ietf.org/html/draft-ietf-geopriv-policy</link>&gt;. Work in progress.</note>" >
<!ENTITY iax "<span class='ref'><link url='http://tools.ietf.org/html/draft-guy-iax'>IAX</link></span> <note>IAX: Inter-Asterisk eXchange Version 2 &lt;<link url='http://tools.ietf.org/html/draft-guy-iax'>http://tools.ietf.org/html/draft-ietf-guy-iax</link>&gt;. Work in progress.</note>" >
<!ENTITY ice "<span class='ref'><link url='http://tools.ietf.org/html/rfc5245'>RFC 5245</link></span> <note>RFC 5245: Interactive Connectivity Establishment (ICE) &lt;<link url='http://tools.ietf.org/html/rfc5245'>http://tools.ietf.org/html/rfc5245</link>&gt;.</note>" >
<!ENTITY ice-tcp "<span class='ref'><link url='http://tools.ietf.org/html/draft-ietf-mmusic-ice-tcp'>TCP Candidates with Interactive Connectivity Establishment (ICE)</link></span> <note>TCP Candidates with Interactive Connectivity Establishment (ICE) &lt;<link url='http://tools.ietf.org/html/draft-ietf-mmusic-ice-tcp'>http://tools.ietf.org/html/draft-ietf-mmusic-ice-tcp</link>&gt;. Work in progress.</note>" >
<!ENTITY mdns "<span class='ref'><link url='http://tools.ietf.org/html/draft-cheshire-dnsext-multicastdns'>Multicast DNS</link></span> <note>Multicast DNS &lt;<link url='http://tools.ietf.org/html/draft-cheshire-dnsext-multicastdns'>http://tools.ietf.org/html/draft-cheshire-dnsext-multicastdns</link>&gt;. Work in progress.</note>" >
<!ENTITY miletemplate "<span class='ref'><link url='http://tools.ietf.org/html/draft-ietf-mile-template'>Guidelines for Defining Extensions to IODEF</link></span> <note>Guidelines for Defining Extensions to IODEF &lt;<link url='http://tools.ietf.org/html/draft-ietf-mile-template'>http://tools.ietf.org/html/draft-ietf-mile-template</link>&gt;. Work in progress.</note>" >
<!ENTITY opusrtp "<span class='ref'><link url='http://tools.ietf.org/html/draft-spittka-payload-rtp-opus'>RTP Payload Format and File Storage Format for Opus Speech and Audio Codec</link></span> <note>RTP Payload Format and File Storage Format for Opus Speech and Audio Codec &lt;<link url='http://tools.ietf.org/html/draft-spittka-payload-rtp-opus'>http://tools.ietf.org/html/draft-spittka-payload-rtp-opus</link>&gt;. Work in progress.</note>" >
<!ENTITY pidf "<span class='ref'><link url='http://tools.ietf.org/html/rfc3863'>Presence Information Data Format (PIDF) </link></span> <note>RFC 3863: Presence Information Data Format (PIDF) &lt;<link url='http://tools.ietf.org/html/rfc3863'>http://tools.ietf.org/html/rfc3863</link>&gt;.</note>" >
@ -1099,7 +1099,7 @@ IANA Service Location Protocol, Version 2 (SLPv2) Templates</link></span> <note>
<!ENTITY xep0158 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0158.html'>CAPTCHA Forms</link></span> <note>XEP-0158: CAPTCHA Forms &lt;<link url='http://xmpp.org/extensions/xep-0158.html'>http://xmpp.org/extensions/xep-0158.html</link>&gt;.</note>" >
<!ENTITY xep0159 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0159.html'>SPIM-Blocking Control</link></span> <note>XEP-0159: SPIM-Blocking Control &lt;<link url='http://xmpp.org/extensions/xep-0159.html'>http://xmpp.org/extensions/xep-0159.html</link>&gt;.</note>" >
<!ENTITY xep0160 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0160.html'>Best Practices for Handling Offline Messages</link></span> <note>XEP-0160: Best Practices for Handling Offline Messages &lt;<link url='http://xmpp.org/extensions/xep-0160.html'>http://xmpp.org/extensions/xep-0160.html</link>&gt;.</note>" >
<!ENTITY xep0161 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0161.html'>SPIM Reporting</link></span> <note>XEP-0161: SPIM Reporting &lt;<link url='http://xmpp.org/extensions/xep-0161.html'>http://xmpp.org/extensions/xep-0161.html</link>&gt;.</note>" >
<!ENTITY xep0161 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0161.html'>Abuse Reporting</link></span> <note>XEP-0161: Abuse Reporting &lt;<link url='http://xmpp.org/extensions/xep-0161.html'>http://xmpp.org/extensions/xep-0161.html</link>&gt;.</note>" >
<!ENTITY xep0162 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0162.html'>Best Practices for Roster and Subscription Management</link></span> <note>XEP-0162: Best Practices for Roster and Subscription Management &lt;<link url='http://xmpp.org/extensions/xep-0162.html'>http://xmpp.org/extensions/xep-0162.html</link>&gt;.</note>" >
<!ENTITY xep0163 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0163.html'>Personal Eventing Protocol</link></span> <note>XEP-0163: Personal Eventing Protocol &lt;<link url='http://xmpp.org/extensions/xep-0163.html'>http://xmpp.org/extensions/xep-0163.html</link>&gt;.</note>" >
<!ENTITY xep0164 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0164.html'>vCard Filtering</link></span> <note>XEP-0164: vCard Filtering &lt;<link url='http://xmpp.org/extensions/xep-0164.html'>http://xmpp.org/extensions/xep-0164.html</link>&gt;.</note>" >
@ -1254,3 +1254,5 @@ IANA Service Location Protocol, Version 2 (SLPv2) Templates</link></span> <note>
<!ENTITY xep0313 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0313.html'>Message Archive Management</link></span> <note>XEP-0313: Message Archive Management &lt;<link url='http://xmpp.org/extensions/xep-0313.html'>http://xmpp.org/extensions/xep-0313.html</link>&gt;.</note>" >
<!ENTITY xep0314 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0314.html'>Security Labels in PubSub</link></span> <note>XEP-0314: Security Labels in PubSub &lt;<link url='http://xmpp.org/extensions/xep-0314.html'>http://xmpp.org/extensions/xep-0314.html</link>&gt;.</note>" >
<!ENTITY xep0315 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0315.html'>Data Forms XML Media Element</link></span> <note>XEP-0315: Data Forms XML Media Element &lt;<link url='http://xmpp.org/extensions/xep-0315.html'>http://xmpp.org/extensions/xep-0315.html</link>&gt;.</note>" >
<!ENTITY xep0316 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0316.html'>MUC Eventing Protocol</link></span> <note>XEP-0316: MUC Eventing Protocol &lt;<link url='http://xmpp.org/extensions/xep-0316.html'>http://xmpp.org/extensions/xep-0316.html</link>&gt;.</note>" >
<!ENTITY xep0317 "<span class='ref'><link url='http://xmpp.org/extensions/xep-0317.html'>Hats</link></span> <note>XEP-0317: Hats &lt;<link url='http://xmpp.org/extensions/xep-0317.html'>http://xmpp.org/extensions/xep-0317.html</link>&gt;.</note>" >