From a0d2f80891c98589b953b26345573fd59ef2c20b Mon Sep 17 00:00:00 2001 From: Peter Saint-Andre Date: Thu, 20 Dec 2007 18:06:41 +0000 Subject: [PATCH] 1.1pre2 git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@1487 4b5297f7-1745-476d-ba37-a9c6900126ab --- xep-0174.xml | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/xep-0174.xml b/xep-0174.xml index 42a9af29..c638ae68 100644 --- a/xep-0174.xml +++ b/xep-0174.xml @@ -27,10 +27,10 @@ &stpeter; - 1.1pre1 - in progress, last updated 2007-12-19 + 1.1pre2 + in progress, last updated 2007-12-20 psa -

Corrected several DNS errors in the text and examples; added friendly How It Works section; updated to reflect version 1.5 of XEP-0115.

 +

Corrected several DNS errors in the text and examples; added friendly How It Works section; updated to reflect version 1.5 of XEP-0115; added implementation note about port choice; updated registry.

 1.0 @@ -276,6 +276,7 @@ _presence._tcp SRV port-number machine-name.local. IN TXT "txtvers=1" IN TXT "1st=user-first-name" IN TXT "email=user-email-address" + IN TXT "hash=entity-capabilities-algorithm" IN TXT "jid=user-jabber-id" IN TXT "last=user-last-name" IN TXT "msg=freeform-availability-status" @@ -284,8 +285,9 @@ _presence._tcp SRV port-number machine-name.local. IN TXT "phsh=sha1-hash-of-avatar" IN TXT "port.p2pj=5562" IN TXT "status=avail-away-or-dnd" + IN TXT "v=entity-capabilities-version" IN TXT "vc=capabilities-string" - IN TXT "ver=application-version" + IN TXT "ver=entity-capabilities-identity" ]]>

Note: In accordance with Section 6.7 of draft-cheshire-dnsext-dns-sd, the "txtvers" record should be the first record specified.

@@ -320,7 +322,7 @@ juliet IN TXT "ver=66/0NaeaBKkwk85efJTGmU47vXI="

If the machine name asserted by a client is already taken by another machine on the network, the client MUST assert a different machine name, which SHOULD be formed by adding the character "-" and digit "1" to the end of the machine name string (e.g., "pronto-1"), adding the character "-" and digit "2" if the resulting machine name is already taken (e.g., "pronto-2"), and similarly incrementing the digit until a unique machine name is constructed.

If the username asserted by a client is already taken by another application on the machine, the client MUST assert a different username, which SHOULD be formed by adding the character "-" and digit "1" to the end of the username string (e.g., "juliet-1"), adding the character "-" and digit "2" if the resulting username is already taken (e.g., "juliet-2"), and similarly incrementing the digit until a unique username is constructed.

-

DNS-SD enables service definitions to include various TXT records that specify parameters to be used in the context of the relevant service type. The ®ISTRAR; shall maintain a registry of TXT records for use with the _presence._tcp service type, as specified in the XMPP Registrar Considerations section of this document.

+

DNS-SD enables service definitions to include various TXT records that specify parameters to be used in the context of the relevant service type. The ®ISTRAR; maintains a registry of TXT records for use with the _presence._tcp service type, as specified in the XMPP Registrar Considerations section of this document.

It is OPTIONAL to include any of these TXT records, and an implementation MUST NOT fail (i.e., MUST enable link-local messaging) even if none of the TXT records are provided by another local entity.

Most of the registered TXT records relate to human users, in which context certain records are of greater interest than others, e.g. "msg", "nick", and "status"; however, link-local messaging can be used by non-human entities (e.g., devices).

Note: See the Security Considerations section of this document regarding the inclusion of information that may have an impact on personal privacy (e.g., the "1st", "last", "nick", "email", and "jid" records).

@@ -407,6 +409,9 @@ _presence._tcp.local. IN NULL raw-binary-data-here

After retrieving the "phsh" value from a Buddy's TXT record, a client SHOULD search its local picture database to learn the last recorded picture hash value for an entity and then compare it to the "phsh" value in the TXT record. If the values are equal, the client SHOULD use the local copy of the icon. If the picture hash values are not equal, the client SHOULD issue a Multicast DNS NULL record query to retrieve the new icon. After retrieving the NULL record, the client SHOULD replace the old "phsh" value in the picture database with the new "phsh" value and save the icon to disk. If the client needs to send a Multicast DNS query in order to retrieve the icon, it MUST cancel the NULL record query immediately after receiving a response containing the new picture data.

If a user changes their picture, the user's client MUST update the NULL record with the contents of the new picture, calculate a new picture hash, and then update the "phsh" value in the TXT record with the new hash value. Since all users logged into local presence are monitoring for TXT record changes, they will see that the "phsh" value was changed; if they wish to view the new icon, their clients SHOULD issue a new Multicast DNS query to retrieve the updated picture.

 + +

The port used for link-local messaging MAY be any unassigned port number, as determined by the messaging application on the device. The chosen port MUST be specified in the SRV record and applications MUST use the port specified in the SRV record. However, the chosen port SHOULD also be specifed in the "port.p2pj" TXT record for backwards-compatibility with older implementations, and if included the port specified in the TXT record MUST be the same as the port specified in the SRV record.

+