diff --git a/xep-0176.xml b/xep-0176.xml index a2769cad..e25bcd4b 100644 --- a/xep-0176.xml +++ b/xep-0176.xml @@ -27,6 +27,12 @@ &stpeter; &hildjj; &seanegan; + + 0.17 + 2008-03-20 + psa +

Moved pwd and ufrag attributes from candidate element to transport element since they describe session-level or media-level information.

+
0.16 2008-02-29 @@ -203,7 +209,7 @@ INITIATOR RESPONDER ]]> -

In order for the initiator in a Jingle exchange to start the negotiation, it MUST send a Jingle "session-initiate" stanza as described in XEP-0166. A content type MUST include one transport method. If the initiator wishes to negotiate the ice-udp transport method for an application format, it MUST include an empty &TRANSPORT; child element qualified by the 'urn:xmpp:tmp:jingle:transports:ice-tcp' namespace &NSNOTE;.

+

In order for the initiator in a Jingle exchange to start the negotiation, it MUST send a Jingle "session-initiate" stanza as described in XEP-0166. A content type MUST include one transport method. If the initiator wishes to negotiate the ice-udp transport method for an application format, it MUST include an empty &TRANSPORT; child element qualified by the 'urn:xmpp:tmp:jingle:transports:ice-udp' namespace &NSNOTE;.

[ ... ] - + ]]> +

The 'pwd' and 'ufrag' attributes MUST be included in the session-initate request, in subsequent content-add and content-replace actions, and when offering candidates via the transport-info action. The attributes SHOULD NOT be included in a session-accept action. The values are separately generated for both the initiator and the receiver, in accordance with &icecore; and as shown in the examples. The attributes are defined as follows.

+ + + + + + + + + + + + + + + + + + + +
NameDescriptionSDP SyntaxExample
pwdA Password as defined in &icecore;.a=ice-pwd lineasd88fgpdd777uzjYhagZg
ufragA User Fragment as defined in &icecore;.a=ice-ufrag line8hhy

As described in XEP-0166, to acknowledge receipt of the session initiation request, the responder returns an IQ-result:

@@ -247,9 +276,7 @@ INITIATOR RESPONDER port='8998' priority='2130706431' protocol='udp' - pwd='asd88fgpdd777uzjYhagZg' - type='host' - ufrag='8hhy'/> + type='host'/> ]]>

The attributes of the <candidate/> element are described in the following table:

@@ -309,12 +336,6 @@ INITIATOR RESPONDER - - - - - - @@ -345,12 +366,6 @@ INITIATOR RESPONDER - - - - - -
Transport protocol field in a=candidate line udp
pwdA Password as defined in &icecore;.a=ice-pwd lineasd88fgpdd777uzjYhagZg
rel-addr A related address as defined in &icecore;.Typ field in a=candidate line srflx
ufragA User Fragment as defined in &icecore;.a=ice-ufrag line8hhy
@@ -368,7 +383,9 @@ INITIATOR RESPONDER initiator='romeo@montague.net/orchard' sid='a73sjjvkla37jfea'> - + + type='host'/> @@ -394,7 +409,9 @@ INITIATOR RESPONDER initiator='romeo@montague.net/orchard' sid='a73sjjvkla37jfea'> - + + type='srflx'/> @@ -436,7 +451,9 @@ INITIATOR RESPONDER initiator='romeo@montague.lit/orchard' sid='a73sjjvkla37jfea'> - + + type='host'/> @@ -548,7 +563,9 @@ INITIATOR NAT RESPONDER [ ... ] - + + type='srflx'/> @@ -591,7 +606,7 @@ INITIATOR NAT RESPONDER [ ... ] - + + type='srflx'/> @@ -647,7 +660,9 @@ INITIATOR NAT RESPONDER initiator='romeo@montague.net/orchard' sid='a73sjjvkla37jfea'> - + + type='srflx'/> @@ -686,7 +699,9 @@ INITIATOR NAT RESPONDER [ ... ] - + + type='srflx'/> @@ -724,7 +737,9 @@ INITIATOR NAT RESPONDER initiator='romeo@montague.net/orchard' sid='a73sjjvkla37jfea'> - + + type='host'/< @@ -763,7 +776,9 @@ INITIATOR NAT RESPONDER [ ... ] - + + type='host'/> @@ -802,7 +815,9 @@ INITIATOR NAT RESPONDER [ ... ] - + + type='host'/> @@ -831,7 +844,7 @@ INITIATOR NAT RESPONDER -

If an entity supports the Jingle ice-udp transport, it MUST return a feature of "urn:xmpp:tmp:jingle:transports:ice-tcp" &NSNOTE; in response to &xep0030; information requests.

+

If an entity supports the Jingle ice-udp transport, it MUST return a feature of "urn:xmpp:tmp:jingle:transports:ice-udp" &NSNOTE; in response to &xep0030; information requests.

... - + ... @@ -875,7 +888,7 @@ INITIATOR NAT RESPONDER

Until this specification advances to a status of Draft, its associated namespaces shall be:

    -
  • urn:xmpp:tmp:jingle:transports:ice-tcp
  • +
  • urn:xmpp:tmp:jingle:transports:ice-udp

Upon advancement of this specification, the ®ISTRAR; shall issue permanent namespaces in accordance with the process defined in Section 4 of &xep0053;.

The following namespaces are requested, and are thought to be unique per the XMPP Registrar's requirements:

@@ -907,17 +920,17 @@ INITIATOR NAT RESPONDER - - - - - + + + + + @@ -933,7 +946,6 @@ INITIATOR NAT RESPONDER - @@ -948,7 +960,6 @@ INITIATOR NAT RESPONDER - @@ -964,6 +975,6 @@ INITIATOR NAT RESPONDER ]]>
-

Thanks to Steffen Larsen for his helpful feedback.

+

Thanks to Steffen Larsen and Paul Witty for their comments.