From b2fefa6243151bf04a373b61774349ea15c1c1e4 Mon Sep 17 00:00:00 2001 From: Peter Saint-Andre Date: Wed, 27 May 2009 16:52:54 +0000 Subject: [PATCH] 1.1rc1: added use case for initial presence git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@3171 4b5297f7-1745-476d-ba37-a9c6900126ab --- xep-0256.xml | 39 ++++++++++++++++++++++++++++++++------- 1 file changed, 32 insertions(+), 7 deletions(-) diff --git a/xep-0256.xml b/xep-0256.xml index 1a45537f..f7f75012 100644 --- a/xep-0256.xml +++ b/xep-0256.xml @@ -22,6 +22,12 @@ N/A &stpeter; + + 1.1rc1 + in progress, last updated 2009-05-27 + psa +

Added use case for initial presence.

 + 1.0 2009-05-06 @@ -41,16 +47,34 @@

Rough draft based on list discussion.

 - -

&xep0012; defines a method for determining the last time that an XMPP entity was active. This document specifies that an online client MAY include last activity information when sending presence updates. The prototypical use case is including the idle time when automatically setting the user's &SHOW; value to "away" or "xa" (extended away). For example, consider a user who has configured her client to automatically change her presence to "away" after 10 minutes of inactivity. The client could include an iq:last flag to specify how long the user has been idle.

- +

&xep0012; defines a method for determining the last time that an XMPP entity was active. This document specifies that an online client MAY include last activity information when sending a presence update. Including such information essentially means "when I sent this presence notification I had last been active at time T".

+

There are two primary use cases:

+
    +
  1. When a client sends initial presence to start a presence session, the last activity notation indicates when that client terminated its previous presence session.
    2. +
  2. When a client changes from available to "away" or "xa", the last activity notation indicates when that client was last active during the current presence session.
    3. +
+

The following sections show examples of each use case.

+ +

When a client begins a presence session, it can indicate when that particular client was last online. It does this by sending initial presence with a last activity notation.

+ + + + ]]> +

This can be read as "I'm now online and I was last online at this client 24 hours and 111 seconds ago".

+ + +

When a client automatically sets the user's &SHOW; value to "away" or "xa" (extended away), it can indicate when that particular was last active during the current presence session.

+ away - ]]> -

If one of the user's contacts receives that presence notification with delayed delivery (see &xep0203;) on login in response to a presence probe as described in &xmppim;, the contact will then know how long the user has been idle (i.e., the number of seconds since the delayed delivery timestamp, plus the iq:last seconds). Thus the contact does not need to send an iq:last query.

- +

This can be read as "I just went away and I was last active 10 minutes ago".

+

If one of the user's contacts receives that presence notification with delayed delivery (see &xep0203;) on login in response to a presence probe as described in &xmppim;, the contact will then know how long the user has been idle (i.e., the number of seconds since the delayed delivery timestamp, plus the iq:last seconds). Thus the contact does not need to send an iq:last query.

+ away @@ -58,7 +82,8 @@ from='capulet.com' stamp='2002-09-10T23:41:07Z'/> - ]]> + ]]> +

Including a last activity notation in presence notifications can enable those who receive such notifications to determine exactly when a user has stopped interacting with his or her XMPP client, but this information is in essence already available if the user publishes timely presence updates. Therefore, this specification introduces no new vulnerabilities.