<pre>Network Working Group                                       J. Rosenberg
Request for Comments: 4575                                 Cisco Systems
Category: Standards Track                                 H. Schulzrinne
                                                     Columbia University
                                                           O. Levin, Ed.
                                                   Microsoft Corporation
                                                             August 2006


                  <span class="h1">A Session Initiation Protocol (SIP)</span>
                   <span class="h1">Event Package for Conference State</span>

Status of This Memo

   This document specifies an Internet standards track protocol for the
   Internet community, and requests discussion and suggestions for
   improvements.  Please refer to the current edition of the "Internet
   Official Protocol Standards" (STD 1) for the standardization state
   and status of this protocol.  Distribution of this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (2006).

Abstract

   This document defines a conference event package for tightly coupled
   conferences using the Session Initiation Protocol (SIP) events
   framework, along with a data format used in notifications for this
   package.  The conference package allows users to subscribe to a
   conference Uniform Resource Identifier (URI).  Notifications are sent
   about changes in the membership of this conference and optionally
   about changes in the state of additional conference components.


















<span class="grey">Rosenberg, et al.           Standards Track                     [Page 1]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-2" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


Table of Contents

   <a href="#section-1">1</a>. Introduction ....................................................<a href="#page-4">4</a>
   <a href="#section-2">2</a>. Terminology .....................................................<a href="#page-4">4</a>
   <a href="#section-3">3</a>. Conference Event Package ........................................<a href="#page-4">4</a>
      <a href="#section-3.1">3.1</a>. Event Package Name .........................................<a href="#page-5">5</a>
      <a href="#section-3.2">3.2</a>. Filtering ..................................................<a href="#page-5">5</a>
      <a href="#section-3.3">3.3</a>. Subscription Duration ......................................<a href="#page-5">5</a>
      <a href="#section-3.4">3.4</a>. NOTIFY Bodies ..............................................<a href="#page-5">5</a>
      <a href="#section-3.5">3.5</a>. Notifier Processing of SUBSCRIBE Requests ..................<a href="#page-6">6</a>
      <a href="#section-3.6">3.6</a>. Notifier Generation of NOTIFY Requests .....................<a href="#page-6">6</a>
      <a href="#section-3.7">3.7</a>. Subscriber Processing of NOTIFY Requests ...................<a href="#page-6">6</a>
      <a href="#section-3.8">3.8</a>. Handling of Forked Requests ................................<a href="#page-7">7</a>
      <a href="#section-3.9">3.9</a>. Rate of Notifications ......................................<a href="#page-7">7</a>
      <a href="#section-3.10">3.10</a>. State Agents ..............................................<a href="#page-7">7</a>
   <a href="#section-4">4</a>. Conference Document .............................................<a href="#page-7">7</a>
      <a href="#section-4.1">4.1</a>. Format .....................................................<a href="#page-7">7</a>
      <a href="#section-4.2">4.2</a>. Namespace ..................................................<a href="#page-7">7</a>
      <a href="#section-4.3">4.3</a>. Versioning .................................................<a href="#page-8">8</a>
      <a href="#section-4.4">4.4</a>. Partial Notifications Mechanism ............................<a href="#page-8">8</a>
      <a href="#section-4.5">4.5</a>. Element Keys ...............................................<a href="#page-9">9</a>
      <a href="#section-4.6">4.6</a>. Constructing Coherent State Procedure ......................<a href="#page-9">9</a>
   <a href="#section-5">5</a>. Conference Data ................................................<a href="#page-11">11</a>
      <a href="#section-5.1">5.1</a>. Overview ..................................................<a href="#page-11">11</a>
      <a href="#section-5.2">5.2</a>. &lt;conference-info&gt; .........................................<a href="#page-13">13</a>
      <a href="#section-5.3">5.3</a>. &lt;conference-description&gt; ..................................<a href="#page-14">14</a>
           <a href="#section-5.3.1">5.3.1</a>. &lt;conf-uris&gt; ........................................<a href="#page-14">14</a>
           <a href="#section-5.3.2">5.3.2</a>. &lt;service-uris&gt; .....................................<a href="#page-15">15</a>
           <a href="#section-5.3.3">5.3.3</a>. &lt;maximum-user-count&gt; ...............................<a href="#page-16">16</a>
           <a href="#section-5.3.4">5.3.4</a>. &lt;available-media&gt; ..................................<a href="#page-16">16</a>
      <a href="#section-5.4">5.4</a>. &lt;host-info&gt; ...............................................<a href="#page-17">17</a>
           <a href="#section-5.4.1">5.4.1</a>. &lt;display-text&gt; .....................................<a href="#page-17">17</a>
           <a href="#section-5.4.2">5.4.2</a>. &lt;web-page&gt; .........................................<a href="#page-17">17</a>
           <a href="#section-5.4.3">5.4.3</a>. &lt;uris&gt; .............................................<a href="#page-17">17</a>
      <a href="#section-5.5">5.5</a>. &lt;conference-state&gt; ........................................<a href="#page-17">17</a>
           <a href="#section-5.5.1">5.5.1</a>. &lt;user-count&gt; .......................................<a href="#page-17">17</a>
           <a href="#section-5.5.2">5.5.2</a>. &lt;active&gt; ...........................................<a href="#page-18">18</a>
           <a href="#section-5.5.3">5.5.3</a>. &lt;locked&gt; ...........................................<a href="#page-18">18</a>
      <a href="#section-5.6">5.6</a>. &lt;users&gt; and Its &lt;user&gt; Sub-elements .......................<a href="#page-18">18</a>
           <a href="#section-5.6.1">5.6.1</a>. &lt;display-text&gt; .....................................<a href="#page-19">19</a>
           <a href="#section-5.6.2">5.6.2</a>. &lt;associated-aors&gt; ..................................<a href="#page-19">19</a>
           <a href="#section-5.6.3">5.6.3</a>. &lt;roles&gt; ............................................<a href="#page-19">19</a>
           <a href="#section-5.6.4">5.6.4</a>. &lt;languages&gt; ........................................<a href="#page-19">19</a>
           <a href="#section-5.6.5">5.6.5</a>. &lt;cascaded-focus&gt; ...................................<a href="#page-19">19</a>
           <a href="#section-5.6.6">5.6.6</a>. &lt;endpoint&gt; .........................................<a href="#page-20">20</a>
      <a href="#section-5.7">5.7</a>. &lt;endpoint&gt; ................................................<a href="#page-20">20</a>
           <a href="#section-5.7.1">5.7.1</a>. &lt;display-text&gt; .....................................<a href="#page-20">20</a>
           <a href="#section-5.7.2">5.7.2</a>. &lt;referred&gt; .........................................<a href="#page-21">21</a>



<span class="grey">Rosenberg, et al.           Standards Track                     [Page 2]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-3" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


           <a href="#section-5.7.3">5.7.3</a>. &lt;status&gt; ...........................................<a href="#page-21">21</a>
           <a href="#section-5.7.4">5.7.4</a>. &lt;joining-method&gt; ...................................<a href="#page-22">22</a>
           <a href="#section-5.7.5">5.7.5</a>. &lt;joining-info&gt; .....................................<a href="#page-23">23</a>
           <a href="#section-5.7.6">5.7.6</a>. &lt;disconnection-method&gt; .............................<a href="#page-23">23</a>
           <a href="#section-5.7.7">5.7.7</a>. &lt;disconnection-info&gt; ...............................<a href="#page-23">23</a>
           <a href="#section-5.7.8">5.7.8</a>. &lt;media&gt; ............................................<a href="#page-24">24</a>
           <a href="#section-5.7.9">5.7.9</a>. &lt;call-info&gt; ........................................<a href="#page-24">24</a>
      <a href="#section-5.8">5.8</a>. &lt;media&gt; ...................................................<a href="#page-24">24</a>
           <a href="#section-5.8.1">5.8.1</a>. &lt;display-text&gt; .....................................<a href="#page-25">25</a>
           <a href="#section-5.8.2">5.8.2</a>. &lt;type&gt; .............................................<a href="#page-25">25</a>
           <a href="#section-5.8.3">5.8.3</a>. &lt;label&gt; ............................................<a href="#page-25">25</a>
           <a href="#section-5.8.4">5.8.4</a>. &lt;src-id&gt; ...........................................<a href="#page-25">25</a>
           <a href="#section-5.8.5">5.8.5</a>. &lt;status&gt; ...........................................<a href="#page-26">26</a>
      <a href="#section-5.9">5.9</a>. Sidebars ..................................................<a href="#page-26">26</a>
           <a href="#section-5.9.1">5.9.1</a>. &lt;sidebars-by-ref&gt; ..................................<a href="#page-26">26</a>
           <a href="#section-5.9.2">5.9.2</a>. &lt;sidebar-by-val&gt; ...................................<a href="#page-26">26</a>
   <a href="#section-6">6</a>. XML Schema .....................................................<a href="#page-26">26</a>
   <a href="#section-7">7</a>. Examples .......................................................<a href="#page-35">35</a>
      <a href="#section-7.1">7.1</a>. Basic Example .............................................<a href="#page-35">35</a>
      <a href="#section-7.2">7.2</a>. Rich Example ..............................................<a href="#page-36">36</a>
   <a href="#section-8">8</a>. Security Considerations ........................................<a href="#page-40">40</a>
      <a href="#section-8.1">8.1</a>. Connection Security .......................................<a href="#page-40">40</a>
      <a href="#section-8.2">8.2</a>. Authorization Considerations ..............................<a href="#page-41">41</a>
   <a href="#section-9">9</a>. IANA Considerations ............................................<a href="#page-41">41</a>
      <a href="#section-9.1">9.1</a>. conference Event Package Registration .....................<a href="#page-41">41</a>
      <a href="#section-9.2">9.2</a>. application/conference-info+xml MIME Registration .........<a href="#page-42">42</a>
      <a href="#section-9.3">9.3</a>. URN Sub-Namespace Registration for ........................<a href="#page-43">43</a>
      <a href="#section-9.4">9.4</a>. XML Schema Registration ...................................<a href="#page-43">43</a>
      <a href="#section-9.5">9.5</a>. URI Purposes Sub-registry Establishment ...................<a href="#page-44">44</a>
   <a href="#section-10">10</a>. Acknowledgements ..............................................<a href="#page-45">45</a>
   <a href="#section-11">11</a>. References ....................................................<a href="#page-45">45</a>
      <a href="#section-11.1">11.1</a>. Normative References .....................................<a href="#page-45">45</a>
      <a href="#section-11.2">11.2</a>. Informative References ...................................<a href="#page-46">46</a>


















<span class="grey">Rosenberg, et al.           Standards Track                     [Page 3]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-4" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


<span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>.  Introduction</span>

   The Session Initiation Protocol (SIP) events framework [<a href="#ref-10" title="&quot;Session Initiation Protocol (SIP)-Specific Event Notification&quot;">10</a>] defines
   general mechanisms for subscribing to, and receiving notifications
   of, events within SIP networks.  It introduces the notion of a
   package, which is a specific "instantiation" of the events framework
   for a well-defined set of events.  Here, we define a SIP event
   package for tightly coupled conferences.  This package can be used by
   the conference notification service as outlined in the SIP
   conferencing framework [<a href="#ref-16" title="&quot;A Framework for Conferencing with the Session Initiation Protocol (SIP)&quot;">16</a>].  As described there, subscriptions to a
   conference URI are routed to the focus that is handling the
   conference.  It acts as the notifier and provides clients with
   updates on conference state.

   The information provided by this package is comprised of conference
   identifier(s), conference participants (optionally with their
   statuses and media description), conference sidebars, conference
   service URIs, etc.

<span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>.  Terminology</span>

   In this document, the key words "MUST", "MUST NOT", "REQUIRED",
   "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",
   and "OPTIONAL" are to be interpreted as described in <a href="./rfc2119">RFC 2119</a> [<a href="#ref-1" title="&quot;Key words for use in RFCs to Indicate Requirement Levels&quot;">1</a>] and
   indicate requirement levels for compliant implementations.

   This document uses the conferencing terminology defined in
   Conferencing Framework [<a href="#ref-16" title="&quot;A Framework for Conferencing with the Session Initiation Protocol (SIP)&quot;">16</a>].  In addition, the "roster" term is used
   to collectively refer to participants in a conference or a sub-
   conference.

<span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>.  Conference Event Package</span>

   The conference event package allows a user to subscribe to the
   information relating to a conference.  In SIP, conferences are
   represented by URIs.  These URIs identify a SIP user agent (UA),
   called a focus, that is responsible for ensuring that all users in
   the conference can communicate with each other, as described in
   Conferencing Framework [<a href="#ref-16" title="&quot;A Framework for Conferencing with the Session Initiation Protocol (SIP)&quot;">16</a>].  The focus has sufficient information
   about the state of the conference to inform subscribers about it.

   It is possible that a participant in the conference may in fact be
   another focus.  In order to provide a more complete participant list,
   the focus MAY subscribe to the conference package of the other focus
   to discover the participant list in the cascaded conference.  This
   information can then be included in notifications by use of the
   &lt;cascaded-focus&gt; element as specified by this package.




<span class="grey">Rosenberg, et al.           Standards Track                     [Page 4]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-5" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   This section provides the details for defining a SIP-specific event
   notification package, as specified by <a href="./rfc3265">RFC 3265</a> [<a href="#ref-10" title="&quot;Session Initiation Protocol (SIP)-Specific Event Notification&quot;">10</a>].

<span class="h3"><a class="selflink" id="section-3.1" href="#section-3.1">3.1</a>.  Event Package Name</span>

   The name of this event package is "conference".  This package name is
   carried in the Event and Allow-Events header, as defined in <a href="./rfc3265">RFC 3265</a>
   [<a href="#ref-10" title="&quot;Session Initiation Protocol (SIP)-Specific Event Notification&quot;">10</a>].

<span class="h3"><a class="selflink" id="section-3.2" href="#section-3.2">3.2</a>.  Filtering</span>

   Filters, which can be applied to conference subscriptions, are a
   desirable feature and can be considered as a subject of future
   standardization activities.  This document does not define the
   filters for the conference package to be included in the SUBSCRIBE
   body.

   A SUBSCRIBE for a conference package, being sent without a body,
   implies the default subscription filtering policy.  The default
   policy is as follows:

   o  Notifications are generated every time there is any change in the
      state of the conference.

   o  Notifications do not normally contain full state; rather, they
      only indicate the state that has changed.  The exception is a
      NOTIFY sent in response to a SUBSCRIBE.  These NOTIFYs contain the
      full state of the information requested by the subscriber.

<span class="h3"><a class="selflink" id="section-3.3" href="#section-3.3">3.3</a>.  Subscription Duration</span>

   The default expiration time for a subscription to a conference is one
   hour.  Once the conference ends, all subscriptions to that particular
   conference are terminated, with a reason of "noresource" as defined
   in <a href="./rfc3265">RFC 3265</a> [<a href="#ref-10" title="&quot;Session Initiation Protocol (SIP)-Specific Event Notification&quot;">10</a>].

<span class="h3"><a class="selflink" id="section-3.4" href="#section-3.4">3.4</a>.  NOTIFY Bodies</span>

   According to <a href="./rfc3265">RFC 3265</a> [<a href="#ref-10" title="&quot;Session Initiation Protocol (SIP)-Specific Event Notification&quot;">10</a>], the NOTIFY message will contain bodies
   that describe the state of the subscribed resource.  This body is in
   a format listed in the Accept header field of the SUBSCRIBE, or a
   package-specific default if the Accept header field was omitted from
   the SUBSCRIBE.

   In this event package, the body of the notification contains a
   conference information document that describes the state of a
   conference.  All subscribers and notifiers MUST support the
   "application/conference-info+xml" data format described in Sections <a href="#section-9">9</a>



<span class="grey">Rosenberg, et al.           Standards Track                     [Page 5]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-6" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   and 5.  By default, i.e., if no Accept header is specified to a
   SUBSCRIBE request, the NOTIFY will contain a body in the
   "application/conference-info+xml" data format.  If the Accept header
   field is present, it MUST include "application/conference-info+xml"
   and MAY include any other types.

<span class="h3"><a class="selflink" id="section-3.5" href="#section-3.5">3.5</a>.  Notifier Processing of SUBSCRIBE Requests</span>

   The conference information contains very sensitive information.
   Therefore, all subscriptions SHOULD be authenticated and then
   authorized before approval.  Authorization policy is at the
   discretion of the administrator, as always.

   However, it is RECOMMENDED that all users in the conference be
   allowed to subscribe to the conference event package.

<span class="h3"><a class="selflink" id="section-3.6" href="#section-3.6">3.6</a>.  Notifier Generation of NOTIFY Requests</span>

   Notifications SHOULD be generated for the conference state when a new
   participant joins (i.e., gets "connected" to) or a participant leaves
   (i.e., gets "disconnected" from) the conference.

   Subject to a local focus policy, additional changes in participants'
   status, changes in their media types, and other optional information
   MAY be reported by the focus.

   Changes in sidebar rosters SHOULD be reported by the focus to their
   participants and MAY be reported to others, subject to local policy.

   Changes in conference identifiers and service URIs SHOULD be reported
   by the focus to the conference package subscribers.

   Changes in other conference state information MAY be reported by the
   focus to the conference package subscribers.

<span class="h3"><a class="selflink" id="section-3.7" href="#section-3.7">3.7</a>.  Subscriber Processing of NOTIFY Requests</span>

   The SIP events framework expects packages to specify how a subscriber
   processes NOTIFY requests in any package-specific ways, and in
   particular, how it uses the NOTIFY requests to construct a coherent
   view of the state of the subscribed resource.

   Typically, the NOTIFY for the conference package will only contain
   information about those users whose state in the conference has
   changed.  To construct a coherent view of the total state of all
   users, a subscriber to the conference package will need to combine
   NOTIFYs received over time.




<span class="grey">Rosenberg, et al.           Standards Track                     [Page 6]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-7" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   Notifications within this package can convey partial information;
   that is, they can indicate information about a subset of the state
   associated with the subscription.  This means that an explicit
   algorithm needs to be defined in order to construct coherent and
   consistent state.  The details of this mechanism are specific to the
   particular document type.  See <a href="#section-4.6">Section 4.6</a> for information on
   constructing coherent information from an application/
   conference-info+xml document.

<span class="h3"><a class="selflink" id="section-3.8" href="#section-3.8">3.8</a>.  Handling of Forked Requests</span>

   By their nature, the conferences supported by this package are
   centralized.  Therefore, SUBSCRIBE requests for a conference should
   not generally fork.  If forking happens in the network, subscribers
   to this package MUST NOT establish more than a single SIP dialog as a
   result of a single SUBSCRIBE request.  In the foci cascading case,
   detailed conference information can be retrieved by establishing an
   individual SUBSCRIBE dialog with each participating focus.

<span class="h3"><a class="selflink" id="section-3.9" href="#section-3.9">3.9</a>.  Rate of Notifications</span>

   For reasons of congestion control, it is important that the rate of
   notifications not become excessive.  As a result, it is RECOMMENDED
   that the server does not generate notifications for a single
   subscriber at a rate faster than once every 5 seconds.

<span class="h3"><a class="selflink" id="section-3.10" href="#section-3.10">3.10</a>.  State Agents</span>

   Conference state is ideally maintained in the element in which the
   conference resides.  Therefore, a conference focus is the best-suited
   element to handle subscriptions to it.  Cascaded foci MAY implement
   state agents (as defined in <a href="./rfc3265">RFC 3265</a> [<a href="#ref-10" title="&quot;Session Initiation Protocol (SIP)-Specific Event Notification&quot;">10</a>]) for this package.

<span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>.  Conference Document</span>

<span class="h3"><a class="selflink" id="section-4.1" href="#section-4.1">4.1</a>.  Format</span>

   Conference information is an XML document that MUST be well-formed
   and valid.  It MUST be based on Extensible Markup Language (XML) 1.0
   and MUST be encoded using UTF-8 [<a href="#ref-14" title="&quot;UTF-8, a transformation format of ISO 10646&quot;">14</a>].

<span class="h3"><a class="selflink" id="section-4.2" href="#section-4.2">4.2</a>.  Namespace</span>

   This specification makes use of XML namespaces for identifying
   conference information documents and document fragments.  The
   namespace URI for elements defined by this specification is a Uniform
   Resource Namespace (URN) [<a href="#ref-2" title="&quot;URN Syntax&quot;">2</a>], using the namespace identifier 'ietf'




<span class="grey">Rosenberg, et al.           Standards Track                     [Page 7]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-8" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   defined by [<a href="#ref-6" title="&quot;A URN Namespace for IETF Documents&quot;">6</a>] and extended by <a href="./rfc3688">RFC 3688</a> [<a href="#ref-21" title="&quot;The IETF XML Registry&quot;">21</a>].  This URN is as
   follows:

   urn:ietf:params:xml:ns:conference-info

<span class="h3"><a class="selflink" id="section-4.3" href="#section-4.3">4.3</a>.  Versioning</span>

   The conference information is described by a hierarchical XML
   structure with the root element &lt;conference-info&gt;.  The root element
   is the only element in the schema that carries a meaningful version
   number for all the elements in the document.  The whole conference
   information is associated with this version number.

   The 'version' attribute MUST be included in the root
   &lt;conference-info&gt; element.

<span class="h3"><a class="selflink" id="section-4.4" href="#section-4.4">4.4</a>.  Partial Notifications Mechanism</span>

   This specification defines a basic partial notifications mechanism by
   using a 'state' attribute as described below.  This mechanism MUST be
   supported by all subscribing clients.  Additional general partial
   notifications mechanisms can be defined and applied to this package
   in the future.

   All sub-elements in the &lt;conference-info&gt; hierarchical XML structure
   can be classified in two groups: permissible for partial
   notifications or not.  Elements that carry a substantial amount of
   data that is subject to frequent changes are permissible for partial
   notifications and have a 'state' attribute attached to them.  All
   future extensions to this schema MUST define which extension elements
   can also use this mechanism.  All other elements can be updated as
   atomic pieces of data only.

   Below is the complete list of elements permissible to use the partial
   notifications mechanism defined in this specification.  (Note that
   future partial notifications mechanisms can potentially be applicable
   to additional elements.)

   o  Element &lt;conference-info&gt;
   o  Element &lt;users&gt;
   o  Element &lt;user&gt;
   o  Element &lt;endpoint&gt;
   o  Element &lt;sidebars-by-val&gt;
   o  Element &lt;sidebars-by-ref&gt;







<span class="grey">Rosenberg, et al.           Standards Track                     [Page 8]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-9" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   The 'state' attribute value indicates whether the reported
   information about the element is "full" or "partial", or whether the
   element has been "deleted" from the conference state document.  The
   default value of any 'state' attribute is "full".

   A 'state' attribute of a child element in the document MUST be
   consistent with its parent 'state'.  This means that if the parent's
   'state' is "full", the state of its children MUST be "full".  If the
   parent's 'state' is "partial", the state of its children MAY be
   either "partial", "full", or "deleted".  A parent element with
   "deleted" 'state' SHOULD NOT contain child elements.  Any information
   provided for child elements of a "deleted" parent MUST be ignored by
   the package subscriber.

<span class="h3"><a class="selflink" id="section-4.5" href="#section-4.5">4.5</a>.  Element Keys</span>

   The defined XML schema has a property of unique identification among
   sub-elements of a common parent, which makes it possible to use the
   partial notifications mechanism defined in this document.  This
   property is achieved by defining a key to each sub-element that can
   appear multiple times under the common parent.

   In the context of this specification, the element key is the set of
   mandatory attributes or sub-elements of an element.  The key value
   MUST be unique for the element among its siblings of the same type.

   In the context of this specification, two keys of type xs:anyURI are
   considered to be equal if the UTF-8 representations of the keys
   (including all URI parameters that can be included with the URI) are
   identical.  Consequently, using relative URIs and lexical white space
   in these keys is NOT RECOMMENDED.

   Below is the list of elements (subject to partial notifications of
   their parent elements) with their keys as defined by this
   specification:

   o  Element &lt;user&gt; uses as the key 'entity'
   o  Element &lt;endpoint&gt; uses as the key 'entity'
   o  Element &lt;media&gt; uses as the key 'id'
   o  Element &lt;entry&gt; (child to &lt;sidebars-by-val&gt;) uses as the key
      'entity'
   o  Element &lt;sidebars-by-ref&gt; uses as the key &lt;uri&gt;

<span class="h3"><a class="selflink" id="section-4.6" href="#section-4.6">4.6</a>.  Constructing Coherent State Procedure</span>

   This section describes the algorithm for constructing a coherent
   conference state by a subscriber to the conference package.  Using
   software programming abstraction, the subscriber maintains a single



<span class="grey">Rosenberg, et al.           Standards Track                     [Page 9]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-10" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   local version number for the whole conference document and a local
   element instance for each element in the schema.  Also, for each
   element with keys (as defined above), the subscriber maintains a
   virtual table with a row for each existing key value.

   The first time a NOTIFY with a "full" document is received (as
   indicated by the value of the 'state' attribute in the
   &lt;conference-info&gt; element), the conference package subscriber MUST
   set the local 'version' number to the value of the 'version'
   attribute from the received &lt;conference-info&gt; and populate local data
   with the received information.

   Each time a new NOTIFY is received, the value of the local version
   number and the value of the 'version' attribute in the new received
   document are compared.  If the value in the document is equal to or
   less than the local version, the document is discarded without
   processing.

   Otherwise, if the received NOTIFY contains a "full" or "deleted"
   state, the conference package subscriber MUST set the local 'version'
   number to the value of the 'version' attribute from the received
   &lt;conference-info&gt; and replace the local information with the received
   document.  Receiving "deleted" state for the &lt;conference-info&gt;
   element means that the conference has ceased to exist and the
   subscriber SHOULD terminate the subscription by sending the SUBSCRIBE
   with Expires = 0.

   Otherwise (i.e., if the received NOTIFY contains "partial" state), if
   the 'version' number in the received document is more than one number
   higher than the previous local version number, the subscriber MUST
   generate a subscription refresh request to trigger a full state
   notification.  If the 'version' number in the document is one higher
   than the local version number, the local version number is updated
   accordingly and the document is used to update the local content as
   described below.

   For each sub-element of the &lt;conference-info&gt; element in the received
   document,

   1. If the element contains "full" state, the whole local element
      content is flushed and repopulated from the document.

   2. Otherwise, if the element contains "deleted" state, the whole
      element MUST be removed from the local content.

   3. Otherwise, if the element contains "partial" state:





<span class="grey">Rosenberg, et al.           Standards Track                    [Page 10]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-11" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


      3.1. For elements with keys, the subscriber compares the keys
           received in the update with the keys in the local tables.

           3.1.1. If a key does not exist in the local table, a row is
                  added, and its content is set to the element
                  information from the update.

           3.1.2. Otherwise, if a key of the same value does exist, for
                  each sub-element in the row, the algorithm is applied
                  from step 3.2.

      3.2. For each atomic element received in the schema, the element
           is replaced with the new information as a whole.  For each
           non-atomic element received in the schema with either no
           'state' attribute included or the state attribute is set to
           "full", the element is replaced with the new information as a
           whole.  Also, for each element with the state attribute set
           to "deleted", the whole element is removed from the local
           content.

      3.3. For each non-atomic element with the state attribute set to
           "partial", the algorithm is applied recursively starting from
           step 3.1.

<span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>.  Conference Data</span>

<span class="h3"><a class="selflink" id="section-5.1" href="#section-5.1">5.1</a>.  Overview</span>

   The &lt;conference-info&gt; document format is designed to convey
   information about the conference and about participation in the
   conference.  The following non-normative diagram gives an example of
   the overall hierarchy used in this format.  Conferences contain users
   who can be represented by multiple endpoints, each of which can have
   multiple media streams.  Conferences can also include or reference
   "sidebar conferences".  When sidebar information is incorporated into
   a conference information document in a &lt;sidebars-by-val&gt; element,
   each &lt;entry&gt; element represents a sidebar and can include any
   sub-elements permitted in the &lt;conference-info&gt; top-level element.













<span class="grey">Rosenberg, et al.           Standards Track                    [Page 11]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-12" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   conference-info
     |
     |-- conference-description
     |
     |-- host-info
     |
     |-- conference-state
     |
     |-- users
     |    |-- user
     |    |    |-- endpoint
     |    |    |    |-- media
     |    |    |    |-- media
     |    |    |    |-- call-info
     |    |    |
     |    |    |-- endpoint
     |    |         |-- media
     |    |-- user
     |         |-- endpoint
     |              |-- media
     |

     |-- sidebars-by-ref
     |    |-- entry
     |    |-- entry
     |
     |-- sidebars-by-val
          |-- entry
          |    |-- users
          |         |-- user
          |         |-- user
          |-- entry
               |-- users
                    |-- user
                    |-- user
                    |-- user

   In most cases, this document does not mandate how the information,
   presented through the conference document to the subscribers, is
   obtained by the focus.  In many cases, the information can be
   dynamically learned from the call signaling and can also be manually
   populated by an administrator - all subject to local policies.  This
   document specifies what the XML elements mean in order to allow the
   subscribers to appropriately interpret it.  Some portions of the
   information are intended for processing by automata; others are for
   human consumption only.  For example, the &lt;display-text&gt; sub-elements
   of elements &lt;conf-uris&gt;, &lt;service-uris&gt;, &lt;available-media&gt;,




<span class="grey">Rosenberg, et al.           Standards Track                    [Page 12]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-13" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   &lt;host-info&gt;, &lt;endpoint&gt;, and &lt;media&gt; are intended for display to
   human subscribers only.

   Although in multiple places this document states that specific
   information "SHOULD" be communicated to the subscribers, note that
   particular conference package subscribers (e.g., representing a
   moderator, an administrator, or a cascaded focus) rely on accuracy of
   this information for their proper operation.  Therefore, a
   conferencing server MUST ensure that all critical changes (stated
   as "SHOULD") are communicated to these specific subscribers;
   otherwise, these changes MUST be communicated to all subscribers to
   the conference information.

   Following sections describe the XML schema in more detail.

<span class="h3"><a class="selflink" id="section-5.2" href="#section-5.2">5.2</a>.  &lt;conference-info&gt;</span>

   A conference information document begins with the root element tag
   &lt;conference-info&gt; of conference-type.

   The following attributes are defined for &lt;conference-info&gt;:

   entity:  This attribute contains the conference URI that identifies
      the conference being described in the document.  This is the SIP
      URI that an interested entity needs to SUBSCRIBE to in order to
      get the conference package information.  Note that this URI can be
      listed as one of the URIs to be used in order to access the
      conference by SIP means and in accordance with <a href="#section-5.3.1">Section 5.3.1</a>
      below.

   state:  This attribute indicates whether the document contains the
      whole conference information ("full") or only the information that
      has changed since the previous document ("partial"), or whether
      the conference ceased to exist ("deleted").  For more detail, see
      <a href="#section-4">Section 4</a>.

   version:  This attribute allows the recipient of conference
      information documents to properly order the received
      notifications, and it MUST be used with the root &lt;conference-info&gt;
      element.  Version number is a 32-bit monotonically increasing
      integer scoped within a subscription.  A server MUST increment the
      version number for each notification (full, partial, and deleted)
      being sent to a subscriber and reporting a change in the
      conference document state.  For each partial notification, the
      version number MUST be increased by one. Note that a partial
      notification and a subsequent full notification over the same
      dialog MAY contain the same version number if no change in the
      conference state occurred in between.



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 13]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-14" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   The &lt;conference-info&gt; element is comprised of &lt;conference-
   description&gt;, &lt;host-info&gt;, &lt;conference-state&gt;, &lt;users&gt;,
   &lt;sidebars-by-ref&gt; and &lt;sidebars-by-val&gt; child elements.  A "full"
   conference document MUST at least include the
   &lt;conference-description&gt; and &lt;users&gt; child elements.

   Following sections describe these elements in detail.  The full XML
   schema is provided in <a href="#section-6">Section 6</a>.

<span class="h3"><a class="selflink" id="section-5.3" href="#section-5.3">5.3</a>.  &lt;conference-description&gt;</span>

   The &lt;conference-description&gt; element describes the conference as a
   whole.

   The child elements &lt;display-text&gt;, &lt;subject&gt;, &lt;free-text&gt;, and
   &lt;keywords&gt; are used to describe the conference content:

   &lt;display-text&gt;:  Contains descriptive text suitable for human
      consumption, for example, listing in a directory

   &lt;subject&gt;:  Contains the subject of the conference

   &lt;free-text&gt;:  Contains an additional longer description of the
      conference

   &lt;keywords&gt;:  Contains a list of space-separated string tokens that
      can be used by search engines to better classify the conference

   Additional child elements &lt;conf-uris&gt; and &lt;service-uris&gt; are used to
   describe the conference-related URIs; &lt;maximum-user-count&gt; and
   &lt;available-media&gt; are used to describe the overall characteristics.

   This information is typically derived from the system conference
   policies, is set before the conference activation, and is rarely
   changed during the conference lifetime.

   The following sections describe the remaining elements in more
   detail.  Other sub-elements can extend &lt;conference-description&gt; in
   the future.

<span class="h4"><a class="selflink" id="section-5.3.1" href="#section-5.3.1">5.3.1</a>.  &lt;conf-uris&gt;</span>

   This element contains a sequence of &lt;entry&gt; child elements - each
   containing the URI to be used in order to access the conference by
   different signaling means.  The value of the URI MUST be unique in
   the conference context and is included in the &lt;uri&gt; sub-element.





<span class="grey">Rosenberg, et al.           Standards Track                    [Page 14]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-15" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   Each &lt;entry&gt; MAY contain additional information useful to the
   participant when accessing the conference.

   An &lt;entry&gt; element MAY contain the &lt;display-text&gt; sub-element that
   provides a textual description meant for human consumption.

   Each &lt;entry&gt; element SHOULD contain a &lt;purpose&gt; sub-element that
   describes what happens when accessing the URI.  The currently defined
   &lt;purpose&gt; values to be used with the &lt;conf-uris&gt; are the following:

   participation:  Accessing a URI with this &lt;purpose&gt; will bring the
      party into the conference.

   streaming:  Accessing a URI with this &lt;purpose&gt; will commence
      streaming the conference, but not allow active participation.

   Examples of suitable URI schemes include sip: and sips: [<a href="#ref-8" title="&quot;SIP: Session Initiation Protocol&quot;">8</a>], xmpp:
   [<a href="#ref-22" title="&quot;A Uniform Resource Identifier (URI) Scheme for the Extensible Messaging and Presence Protocol (XMPP)&quot;">22</a>], h323: [<a href="#ref-20" title="&quot;H.323 Uniform Resource Locator (URL) Scheme Registration&quot;">20</a>], and tel: [<a href="#ref-19" title="&quot;The tel URI for Telephone Numbers&quot;">19</a>] URIs.  The rtsp [<a href="#ref-18" title="&quot;Real Time Streaming Protocol (RTSP)&quot;">18</a>] URI is suitable
   for streaming.

   Future extensions to this schema may define new values and register
   them with IANA under the registry established by this specification.

<span class="h4"><a class="selflink" id="section-5.3.2" href="#section-5.3.2">5.3.2</a>.  &lt;service-uris&gt;</span>

   This element describes auxiliary services available for the
   conference.  Like &lt;conference-uris&gt;, this element contains a set of
   &lt;entry&gt; child elements - each containing the URI to be used in order
   to access different services available for the particular conference.
   The value of the URI MUST be unique in the conference context and is
   included in the &lt;uri&gt; sub-element.

   An &lt;entry&gt; element MAY contain the &lt;display-text&gt; sub-element that
   provides a textual description meant for user consumption.

   Each &lt;entry&gt; element SHOULD contain a &lt;purpose&gt; sub-element.  The
   currently defined &lt;purpose&gt; values to be used with the &lt;service-uris&gt;
   are the following:

   web-page:  Indicates the web page containing the additional
      information about the conference.

   recording:  Indicates the link at which the recorded conference
      context can be retrieved.

   event:  Indicates the URI at which a subscription to the conference
      event package may be requested.  This would typically be the
      conference URI of the main conference.



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 15]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-16" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   Future extensions to this schema may define new values and register
   them with IANA under the registry established by this specification.

<span class="h4"><a class="selflink" id="section-5.3.3" href="#section-5.3.3">5.3.3</a>.  &lt;maximum-user-count&gt;</span>

   The value of this element provides a hint to the recipient of the
   conference document about the number of users that can be invited to
   the conference.  Typically, this value represents the overall number
   of users allowed to join the conference by different means as
   published through the conference document in &lt;conf-uris&gt;.  Note that
   this value is set by an administrator and can reflect any local
   policies combination such as network consumption, CPU processing
   power, and licensing rules.

<span class="h4"><a class="selflink" id="section-5.3.4" href="#section-5.3.4">5.3.4</a>.  &lt;available-media&gt;</span>

   This element contains a sequence of &lt;entry&gt; child elements of
   conference-medium-type, each being indexed by the attribute 'label'.

   The 'label' attribute is the media stream identifier assigned by the
   conferencing server: its value will be unique in the
   &lt;conference-info&gt; context.  The value of this attribute will
   typically correspond to the Session Description Protocol (SDP)
   "label" media attribute defined in [<a href="#ref-17" title="&quot;The Session Description Protocol (SDP) Label Attribute&quot;">17</a>].

   Each &lt;entry&gt; describes a single media stream available to the
   participants in the conference and contains the following
   information:

   &lt;display-text&gt;:  This element contains the display text for the media
      stream.

   &lt;type&gt;:  This element contains the media type of the media stream.
      The value of this element MUST be one of the values registered for
      "media" of SDP [<a href="#ref-3" title="&quot;SDP: Session Description Protocol&quot;">3</a>] and its later revision(s), for example,
      "audio", "video", "text", and "message".

   &lt;status&gt;:  This element indicates the available status of the media
      stream available to the conference participants.  For example,
      this would be the status of the media stream, which would be
      offered by the focus, in a 'dial-out' scenario.  Using normal SIP
      offer/answer mechanisms (being defined in <a href="./rfc3264">RFC 3264</a> [<a href="#ref-9" title="&quot;An Offer/Answer Model with Session Description Protocol (SDP)&quot;">9</a>]) in both
      dial-in and dial-out scenarios, a participant can of course
      establish only a subset of the available stream (i.e., request or
      accept the stream in one direction only, if both directions are
      available).  The valid values are "sendrecv", "sendonly",
      "recvonly", or "inactive" as defined in SDP [<a href="#ref-3" title="&quot;SDP: Session Description Protocol&quot;">3</a>] and its later




<span class="grey">Rosenberg, et al.           Standards Track                    [Page 16]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-17" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


      revision(s).  (Note that the value specifies the direction from
      the participants' point of view.)

<span class="h3"><a class="selflink" id="section-5.4" href="#section-5.4">5.4</a>.  &lt;host-info&gt;</span>

   This element contains information about the entity hosting the
   conference.  This information is set before the conference
   activation, and it is rarely changed during the conference lifetime,
   unless the whole conference is moved to be hosted by another entity.
   The host information is comprised of the following elements:

<span class="h4"><a class="selflink" id="section-5.4.1" href="#section-5.4.1">5.4.1</a>.  &lt;display-text&gt;</span>

   This element contains display text describing the entity hosting the
   conference.

<span class="h4"><a class="selflink" id="section-5.4.2" href="#section-5.4.2">5.4.2</a>.  &lt;web-page&gt;</span>

   This element contains HTTP: or HTTPS: URI of a web page describing
   either the conference service or the user hosting the conference.

<span class="h4"><a class="selflink" id="section-5.4.3" href="#section-5.4.3">5.4.3</a>.  &lt;uris&gt;</span>

   This element contains a set of &lt;entry&gt; child elements, each
   containing the URI value and optionally its description.

<span class="h3"><a class="selflink" id="section-5.5" href="#section-5.5">5.5</a>.  &lt;conference-state&gt;</span>

   By including this element in the conference document, the server can
   inform the subscribers about the changes in the overall conference
   information.  The &lt;conference-state&gt; child elements are described
   below.

<span class="h4"><a class="selflink" id="section-5.5.1" href="#section-5.5.1">5.5.1</a>.  &lt;user-count&gt;</span>

   The value of this element tells the recipient of the conference
   document the overall number of users participating in the conference
   at a certain moment.  Typically, this value represents the overall
   number of users who joined the conference by different means as
   published through the conference document in &lt;conf-uris&gt;.  Note that
   this number does not necessarily need to match and MAY exceed the
   number of the entries in the &lt;users&gt; container.  For example, in a
   lecturing scenario, large conference notifications may not include
   every participant in the &lt;users&gt; element, but instead report only the
   panelists or the speakers.






<span class="grey">Rosenberg, et al.           Standards Track                    [Page 17]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-18" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


<span class="h4"><a class="selflink" id="section-5.5.2" href="#section-5.5.2">5.5.2</a>.  &lt;active&gt;</span>

   This Boolean element indicates whether the conference is currently
   active.  A conference is active if calling one of the &lt;conf-uris&gt; by
   an authorized client results in successful establishment of a
   signaling session between the client and the focus and a successful
   joining of the conference.

<span class="h4"><a class="selflink" id="section-5.5.3" href="#section-5.5.3">5.5.3</a>.  &lt;locked&gt;</span>

   This Boolean element says whether the conference is currently locked.
   In this context, "locked" means that the conference roster cannot be
   added to (although participants may leave or be removed from the
   conference).

<span class="h3"><a class="selflink" id="section-5.6" href="#section-5.6">5.6</a>.  &lt;users&gt; and Its &lt;user&gt; Sub-elements</span>

   The &lt;users&gt; element is a container of &lt;user&gt; child elements, each
   describing a single participant in the conference.

   The following attributes are defined for &lt;user&gt; element:

   entity:  This attribute contains the URI for the user in the
      conference.  This is a logical identifier, which corresponds to
      the call signaling authenticated identity of the participant.  The
      'entity' value MUST be unique among all participants in the
      conference.  If, for some participants, the focus decides not to
      reveal this information (e.g., due to local policies or security
      reasons), the host portion of the user URI MUST use the .invalid
      top level domain (TLD) according to definitions of <a href="./rfc2606">RFC 2606</a> [<a href="#ref-5" title="&quot;Reserved Top Level DNS Names&quot;">5</a>].
      The focus also MUST construct the user portion of the URI so that
      the URI is unique among all participants of the same domain.  For
      example, the convention

          "AnonymousX" &lt;sip:anonymousX@anonymous.invalid&gt;

   SHOULD be used for a participant requesting privacy in accordance
   with the guidelines for generating anonymous URIs of <a href="./rfc3323">RFC 3323</a> [<a href="#ref-11" title="&quot;A Privacy Mechanism for the Session Initiation Protocol (SIP)&quot;">11</a>].
   Note that in a different case, such as when used in conjunction with
   Enhancements for Authenticated Identity Management in SIP [<a href="#ref-25" title="&quot;Enhancements for Authenticated Identity Management in the Session Initiation Protocol (SIP)&quot;">25</a>], the
   following convention can be used:

          "AnonymousX" &lt;sip:anonymousX@example.com&gt;

   state:  This attribute indicates whether the document contains the
      whole user information ("full") or only the information that has
      changed since the previous document ("partial"), or whether the
      user was removed from the conference ("deleted").



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 18]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-19" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   The following child elements are defined for &lt;user&gt; element:

<span class="h4"><a class="selflink" id="section-5.6.1" href="#section-5.6.1">5.6.1</a>.  &lt;display-text&gt;</span>

   This element is used to display the user-friendly name in the
   conference.

<span class="h4"><a class="selflink" id="section-5.6.2" href="#section-5.6.2">5.6.2</a>.  &lt;associated-aors&gt;</span>

   This element contains additional (to the 'entity') URIs being
   associated with the &lt;user&gt;.  Typically, this information will be
   manually provided by an administrator showing the logical association
   between signaling entities otherwise independent.  For example, if
   the 'entity' of a &lt;user&gt; contains a Globally Routable User URI (GRUU)
   [<a href="#ref-24" title="&quot;Obtaining and Using Globally Routable User Agent (UA) URIs (GRUU) in the Session Initiation Protocol (SIP)&quot;">24</a>] or tel: URI <a href="./rfc3966">RFC 3966</a> [<a href="#ref-19" title="&quot;The tel URI for Telephone Numbers&quot;">19</a>], it would be useful to populate this
   field with the Address of Record (AOR) of the person who uses these
   devices, each represented as an independent &lt;user&gt;.

<span class="h4"><a class="selflink" id="section-5.6.3" href="#section-5.6.3">5.6.3</a>.  &lt;roles&gt;</span>

   This element MAY contain a set of human-readable strings describing
   the roles of the user in the conference.  Note that this information
   is applicable for human consumption only.  This specification does
   not define the set of possible conferencing roles or the semantics
   associated with each.  It is expected that future conferencing
   specifications will define these and the corresponding schema
   extensions, as appropriate.

<span class="h4"><a class="selflink" id="section-5.6.4" href="#section-5.6.4">5.6.4</a>.  &lt;languages&gt;</span>

   This element contains a list of tokens, separated by spaces, each
   containing a language understood by the user.  This information can
   be automatically learned via call signaling or be manually set per
   participant.

<span class="h4"><a class="selflink" id="section-5.6.5" href="#section-5.6.5">5.6.5</a>.  &lt;cascaded-focus&gt;</span>

   This element contains a conference URI (different from the main
   conference URI) for users that are connected to the main conference
   as a result of focus cascading.  In accordance with the SIP
   Conferencing Framework [<a href="#ref-16" title="&quot;A Framework for Conferencing with the Session Initiation Protocol (SIP)&quot;">16</a>], this package allows for representation
   of peer-to-peer (i.e., "flat") focus cascading only.  The actual
   cascading graph cannot be deduced from the information provided in
   the package alone.  Advanced applications can construct the graph by
   subscribing to both this package and the Dialog Package [<a href="#ref-23" title="&quot;An INVITE- Initiated Dialog Event Package for the Session Initiation Protocol (SIP)&quot;">23</a>] of each
   cascaded focus and correlating the relevant information.





<span class="grey">Rosenberg, et al.           Standards Track                    [Page 19]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-20" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


<span class="h4"><a class="selflink" id="section-5.6.6" href="#section-5.6.6">5.6.6</a>.  &lt;endpoint&gt;</span>

   By including one or more &lt;endpoint&gt; elements under a parent &lt;user&gt;
   element, the server can provide the desired level of detail
   (including the state, media streams, and access information) about
   the user's devices and signaling sessions taking part in the
   conference.

   In a conferencing system where authentication is performed per
   endpoint (rather than per user), the focus can be unaware of the
   logical association of multiple endpoints under a common user.  In
   this case, each endpoint will appear as a separate &lt;user&gt; with its
   own &lt;endpoint&gt; sub-element(s) in the conference document.

   In a different case, the focus may choose to shield the information
   about the participant's multiple endpoints and signaling sessions
   from other subscribers altogether (e.g., due to privacy policies).
   To do so, the focus MAY aggregate the multiple signaling sessions'
   information under a single &lt;endpoint&gt; element.  Note that in this
   case, the detailed call signaling information (represented by
   &lt;call-info&gt; sub-element) will not be included.

<span class="h3"><a class="selflink" id="section-5.7" href="#section-5.7">5.7</a>.  &lt;endpoint&gt;</span>

   This section describes the &lt;endpoint&gt; element in more detail.

   The following attributes are defined for the &lt;endpoint&gt; element:

   entity:  The server MUST generate the 'entity' key for each
      &lt;endpoint&gt; element included under the parent &lt;user&gt;, such that its
      value is unique in the user context.  In SIP terms, this can be
      the Contact URI, GRUU, etc.

   state:  This attribute indicates whether the element contains the
      whole endpoint information ("full") or only the information that
      has changed since the previous document ("partial"), or whether
      the endpoint has been removed from the conference ("deleted").

   The following child elements are defined for the &lt;endpoint&gt; element:

<span class="h4"><a class="selflink" id="section-5.7.1" href="#section-5.7.1">5.7.1</a>.  &lt;display-text&gt;</span>

   This element contains the display text for the endpoint.








<span class="grey">Rosenberg, et al.           Standards Track                    [Page 20]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-21" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


<span class="h4"><a class="selflink" id="section-5.7.2" href="#section-5.7.2">5.7.2</a>.  &lt;referred&gt;</span>

   This element contains information about the user whose action
   resulted in this endpoint being brought into the conference (e.g.,
   the SIP user identified by this URI sent a REFER to the focus).  It
   MAY contain the following sub-elements:

   when:  This element of the XML dateTime type contains the date and
      time that the endpoint was referred to the conference and SHOULD
      be expressed in Coordinated Universal Time (UTC) format.  For
      example,

        &lt;when&gt;2005-03-04T20:00:00Z&lt;/when&gt;

   reason:  This element contains the reason the endpoint was referred
      to the conference.  Including the information in the format
      defined by <a href="./rfc3326">RFC 3326</a> [<a href="#ref-12" title="&quot;The Reason Header Field for the Session Initiation Protocol (SIP)&quot;">12</a>] is RECOMMENDED.  For example,

   &lt;reason&gt;Reason: SIP;text="Ad-hoc Invitation"&lt;/reason&gt;

   by:  This element contains the URI of the entity that caused the
      endpoint to be referred to the conference.  In the case of SIP, it
      will be populated from the Referred-By header defined in <a href="./rfc3892">RFC 3892</a>
      [<a href="#ref-15" title="&quot;The Session Initiation Protocol (SIP) Referred-By Mechanism&quot;">15</a>].

<span class="h4"><a class="selflink" id="section-5.7.3" href="#section-5.7.3">5.7.3</a>.  &lt;status&gt;</span>

   This element contains the status of the endpoint and can assume the
   following values:

   connected:  The endpoint is a participant in the conference.
      Depending on the media policies, he/she can send and receive media
      to and from other participants.

   disconnected:  The endpoint is not a participant in the conference,
      and no active dialog exists between the endpoint and the focus.

   on-hold:  Active signaling dialog exists between an endpoint and a
      focus, but endpoint is "on-hold" for this conference, i.e., he/she
      is neither "hearing" the conference mix nor is his/her media being
      mixed in the conference.  As an example, the endpoint has asked to
      join the conference using SIP, but his/her participation is
      pending based on moderator approval.  In the meantime, he/she is
      hearing music-on-hold or some other kind of related content.

   muted-via-focus:  Active signaling dialog exists between an endpoint
      and a focus and the endpoint can "listen" to the conference, but
      the endpoint's media is not being mixed into the conference.  Note



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 21]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-22" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


      that sometimes a subset of endpoint media streams can be muted by
      focus (such as poor-quality video) while others (such as voice or
      IM) can still be active.  In this case, it is RECOMMENDED that the
      "aggregated" endpoint connectivity &lt;status&gt; reflects the status of
      the most active media.

   pending:  Endpoint is not yet in the session, but it is anticipated
      that he/she will join in the near future.

   alerting:  A Public Switched Telephone Network (PSTN) ALERTING or SIP
      180 Ringing was returned for the outbound call; endpoint is being
      alerted.

   dialing-in:  Endpoint is dialing into the conference, not yet in the
      roster (probably being authenticated).

   dialing-out:  Focus has dialed out to connect the endpoint to the
      conference, but the endpoint is not yet in the roster (probably
      being authenticated).

   disconnecting:  Focus is in the process of disconnecting the endpoint
      (e.g., in SIP a DISCONNECT or BYE was sent to the endpoint).

   Note that the defined transient statuses (e.g., disconnecting,
   alerting, etc.) could generate a lot of traffic.  Therefore,
   implementations MAY choose to generate notifications on these
   statuses to certain participants only or not generate them at all,
   subject to local policy.

<span class="h4"><a class="selflink" id="section-5.7.4" href="#section-5.7.4">5.7.4</a>.  &lt;joining-method&gt;</span>

   This element contains the method by which the endpoint joined the
   conference and can assume the following values:

   dialed-in:  The endpoint dialed into the conference (e.g., in a SIP
      sent INVITE to the focus), which resulted in successful dialog
      establishment.

   dialed-out:  The focus has brought the endpoint into the conference
      (e.g., in SIP, the focus sent a successful INVITE to the
      endpoint).

   focus-owner:  The endpoint is the focus for this conference.  This
      status is used only when a participant's UA acts as a conference
      focus.






<span class="grey">Rosenberg, et al.           Standards Track                    [Page 22]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-23" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


<span class="h4"><a class="selflink" id="section-5.7.5" href="#section-5.7.5">5.7.5</a>.  &lt;joining-info&gt;</span>

   This element contains information about how the endpoint joined and
   MAY contain the following sub-elements:

   when:  This element of the XML dateTime type contains the date and
      time that the endpoint joined the conference and SHOULD be
      expressed in Coordinated Universal Time (UTC).

   reason:  This element contains the reason the endpoint joined the
      conference.  Including the information in the format defined by
      <a href="./rfc3326">RFC 3326</a> [<a href="#ref-12" title="&quot;The Reason Header Field for the Session Initiation Protocol (SIP)&quot;">12</a>] is RECOMMENDED.  For example,

   &lt;reason&gt;Reason: SIP;text="Ad-hoc Invitation"&lt;/reason&gt;

   by:  This element contains the URI of the entity that caused the
      endpoint to join the conference.

<span class="h4"><a class="selflink" id="section-5.7.6" href="#section-5.7.6">5.7.6</a>.  &lt;disconnection-method&gt;</span>

   This element contains the method by which the endpoint departed the
   conference and can assume the following values:

   departed:  In SIP, the endpoint sent a BYE, thus leaving the
      conference.

   booted:  In SIP, the endpoint was sent a BYE by the focus, ejecting
      him/her out of the conference.  Alternatively, the endpoint tried
      to dial into the conference but was rejected by the focus due to
      local policy.

   failed:  In SIP, the server tried to bring the endpoint into the
      conference, but its attempt to contact the specific endpoint
      resulted in a non-200 class final response.  Alternatively, the
      endpoint tried to dial into the conference without success due to
      technical reasons.

   busy:  In SIP, the server tried to bring the endpoint into the
      conference, but its attempt to contact the specific endpoint
      resulted in a 486 "Busy Here" final response.  Alternatively, the
      endpoint tried to dial into the conference but the focus responded
      with 486 response.

<span class="h4"><a class="selflink" id="section-5.7.7" href="#section-5.7.7">5.7.7</a>.  &lt;disconnection-info&gt;</span>

   This element contains information about the endpoint's departure from
   the conference and MAY contain the following sub-elements:




<span class="grey">Rosenberg, et al.           Standards Track                    [Page 23]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-24" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   when:  This element of the XML dateTime type contains the date and
      time that the endpoint departed the conference and SHOULD be
      expressed in Coordinated Universal Time (UTC).

   reason:  This element contains the reason the endpoint departed the
      conference.  When known and meaningful, including the information
      as conveyed/reported by the call signaling in the format defined
      by <a href="./rfc3326">RFC 3326</a> [<a href="#ref-12" title="&quot;The Reason Header Field for the Session Initiation Protocol (SIP)&quot;">12</a>] is RECOMMENDED.  For example,


   &lt;reason&gt;Reason: SIP;cause=415;text="Unsupported Media Type"&lt;/reason&gt;

   by:  This element contains the URI of the entity that caused the
      endpoint to depart the conference.

<span class="h4"><a class="selflink" id="section-5.7.8" href="#section-5.7.8">5.7.8</a>.  &lt;media&gt;</span>

   This element contains information about a single media stream and is
   included for each media stream being established between the focus
   and the &lt;endpoint&gt;.  The media stream definition can be found in SDP
   [<a href="#ref-3" title="&quot;SDP: Session Description Protocol&quot;">3</a>].

   Note that if the &lt;call-info&gt; sub-element of the endpoint is not
   included in the document by the server, it is possible that the media
   streams listed under the common &lt;endpoint&gt; were established by
   separate signaling sessions.

<span class="h4"><a class="selflink" id="section-5.7.9" href="#section-5.7.9">5.7.9</a>.  &lt;call-info&gt;</span>

   The &lt;call-info&gt; element provides detailed call signaling information
   for a call being maintained between the participant and the focus.
   Privacy policies MUST be consulted before revealing this information
   to other participants.

   The &lt;sip&gt; sub-element contains the SIP dialog identifier of the
   endpoint's dialog with the focus.  The element includes sub-elements
   &lt;display-text&gt;, &lt;call-id&gt;, &lt;to-tag&gt;, &lt;from-tag&gt;.

   In future, the &lt;call-info&gt; element can be expanded to include call
   signaling protocol information for other protocols besides SIP.

<span class="h3"><a class="selflink" id="section-5.8" href="#section-5.8">5.8</a>.  &lt;media&gt;</span>

   This section describes the &lt;media&gt; element in more detail.

   A single 'id' attribute is defined for this element.  This is the
   media stream identifier being generated by the server such that its




<span class="grey">Rosenberg, et al.           Standards Track                    [Page 24]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-25" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   value is unique in the endpoint context.  This attribute is the key
   to refer to a particular media stream in the conference document.

   The following child elements are defined for &lt;media&gt;:

<span class="h4"><a class="selflink" id="section-5.8.1" href="#section-5.8.1">5.8.1</a>.  &lt;display-text&gt;</span>

   This element contains the display text for the media stream.  The
   value of this element corresponds to the SDP description media
   attribute ("i") defined in SDP [<a href="#ref-3" title="&quot;SDP: Session Description Protocol&quot;">3</a>].

<span class="h4"><a class="selflink" id="section-5.8.2" href="#section-5.8.2">5.8.2</a>.  &lt;type&gt;</span>

   This element contains the media type for the media stream.  The value
   of this element MUST be one of the values registered for "media" of
   SDP [<a href="#ref-3" title="&quot;SDP: Session Description Protocol&quot;">3</a>] and its later revision(s).

<span class="h4"><a class="selflink" id="section-5.8.3" href="#section-5.8.3">5.8.3</a>.  &lt;label&gt;</span>

   The &lt;label&gt; element carries a unique identifier for this stream among
   all streams in the conference and is assigned by the focus.  The
   value of this element will typically correspond to the SDP "label"
   media attribute defined in [<a href="#ref-17" title="&quot;The Session Description Protocol (SDP) Label Attribute&quot;">17</a>] and is exchanged between a
   participant and a focus over the signaling connection between them.

   If the &lt;available-media&gt; information (described in <a href="#section-5.3.4">Section 5.3.4</a>) is
   included in the conference document, the value of this element MUST
   be equal to the 'label' value of the corresponding media stream
   &lt;entry&gt; in the &lt;available-media&gt; container.

<span class="h4"><a class="selflink" id="section-5.8.4" href="#section-5.8.4">5.8.4</a>.  &lt;src-id&gt;</span>

   The &lt;src-id&gt; element, if applicable, carries the information about
   the actual source of the media.  For example, for Real-time Transport
   Protocol (RTP) / RTP Control Protocol (RTCP) [<a href="#ref-13" title="&quot;RTP: A Transport Protocol for Real-Time Applications&quot;">13</a>] media streams, the
   value MUST contain the synchronization source (SSRC) identifier value
   generated by the endpoint for the stream it sends.

   When an RTP mixer generates a contributing source (CSRC) identifiers'
   list according to RTP/RTCP [<a href="#ref-13" title="&quot;RTP: A Transport Protocol for Real-Time Applications&quot;">13</a>], it inserts a list of the SSRC
   identifiers of the sources that contributed to the generation of a
   particular packet into the RTP header of that packet.  A quote from
   <a href="./rfc3550">RFC 3550</a> [<a href="#ref-13" title="&quot;RTP: A Transport Protocol for Real-Time Applications&quot;">13</a>] explains as follows: "An example application is audio
   conferencing where a mixer indicates all the talkers whose speech was
   combined to produce the outgoing packet, allowing the receiver to
   indicate the current talker, even though all the audio packets
   contain the same SSRC identifier (that of the mixer)."




<span class="grey">Rosenberg, et al.           Standards Track                    [Page 25]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-26" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   If an RTP mixer compliant to the above is used, participants can
   perform an SSRC to user mapping and identify "a current speaker".

<span class="h4"><a class="selflink" id="section-5.8.5" href="#section-5.8.5">5.8.5</a>.  &lt;status&gt;</span>

   The element &lt;status&gt; indicates the status in both directions of the
   media stream and has the values "sendrecv", "sendonly", "recvonly",
   or "inactive" as defined in SDP [<a href="#ref-3" title="&quot;SDP: Session Description Protocol&quot;">3</a>] and its later revision(s).  Note
   that value specifies the direction from the participant's point of
   view.  For example, a muted participant's stream will have the value
   of "recvonly".

<span class="h3"><a class="selflink" id="section-5.9" href="#section-5.9">5.9</a>.  Sidebars</span>

   If a participant in the main conference joins a sidebar, a new &lt;user&gt;
   element representing the user is created either as a part of a
   separate sub-conference referenced from the &lt;sidebars-by-ref&gt; element
   or under one of the &lt;sidebars-by-val&gt; elements as described below.

   Note that the &lt;user&gt; in the main roster is not being deleted, but its
   media statuses can be updated to reflect the effect being caused by
   his/her participation in the sidebar.  The display of this
   information can vary among subscribers to the same conference
   information, subject to local policies and to the subscriber role
   both in the sidebar and in the main conference.

<span class="h4"><a class="selflink" id="section-5.9.1" href="#section-5.9.1">5.9.1</a>.  &lt;sidebars-by-ref&gt;</span>

   This element contains a set of &lt;entry&gt; child elements, each
   containing a sidebar conference URI.  The recipient of the
   information can then subscribe to sidebar information independently
   from the main conference package subscription.

<span class="h4"><a class="selflink" id="section-5.9.2" href="#section-5.9.2">5.9.2</a>.  &lt;sidebars-by-val&gt;</span>

   This element contains a set of &lt;entry&gt; child elements, each
   containing information about a single sidebar.  By using this element
   of conference-type, the server can include a full or partial
   description of each sidebar (as a sub-conference) in the body of the
   main conference document.

<span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>.  XML Schema</span>

   &lt;?xml version="1.0" encoding="UTF-8" ?&gt;
   &lt;xs:schema
   targetNamespace="urn:ietf:params:xml:ns:conference-info"
   xmlns:tns="urn:ietf:params:xml:ns:conference-info"
   xmlns:xs="http://www.w3.org/2001/XMLSchema"



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 26]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-27" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   xmlns="urn:ietf:params:xml:ns:conference-info"
   elementFormDefault="qualified"
   attributeFormDefault="unqualified"&gt;
   &lt;!--
     This imports the xml:language definition
   --&gt;
      &lt;xs:import namespace="http://www.w3.org/XML/1998/namespace"
       schemaLocation="http://www.w3.org/2001/03/xml.xsd"/&gt;
   &lt;!--
     CONFERENCE ELEMENT
   --&gt;
      &lt;xs:element name="conference-info" type="conference-type"/&gt;
      &lt;!--
         CONFERENCE TYPE
      --&gt;
      &lt;xs:complexType name="conference-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="conference-description"
         type="conference-description-type" minOccurs="0"/&gt;
        &lt;xs:element name="host-info"
         type="host-type" minOccurs="0"/&gt;
        &lt;xs:element name="conference-state"
         type="conference-state-type" minOccurs="0"/&gt;
        &lt;xs:element name="users"
         type="users-type" minOccurs="0"/&gt;
        &lt;xs:element name="sidebars-by-ref"
         type="uris-type" minOccurs="0"/&gt;
        &lt;xs:element name="sidebars-by-val"
         type="sidebars-by-val-type" minOccurs="0"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:attribute name="entity"
        type="xs:anyURI" use="required"/&gt;
       &lt;xs:attribute name="state"
        type="state-type" use="optional" default="full"/&gt;
       &lt;xs:attribute name="version"
        type="xs:unsignedInt" use="optional"/&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         STATE TYPE
      --&gt;
      &lt;xs:simpleType name="state-type"&gt;
       &lt;xs:restriction base="xs:string"&gt;
        &lt;xs:enumeration value="full"/&gt;
        &lt;xs:enumeration value="partial"/&gt;
        &lt;xs:enumeration value="deleted"/&gt;



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 27]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-28" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


       &lt;/xs:restriction&gt;
      &lt;/xs:simpleType&gt;
      &lt;!--
         CONFERENCE DESCRIPTION TYPE
      --&gt;
      &lt;xs:complexType name="conference-description-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="display-text"
         type="xs:string" minOccurs="0"/&gt;
        &lt;xs:element name="subject"
         type="xs:string" minOccurs="0"/&gt;
        &lt;xs:element name="free-text"
         type="xs:string" minOccurs="0"/&gt;
        &lt;xs:element name="keywords"
         type="keywords-type" minOccurs="0"/&gt;
        &lt;xs:element name="conf-uris"
         type="uris-type" minOccurs="0"/&gt;
        &lt;xs:element name="service-uris"
         type="uris-type" minOccurs="0"/&gt;
        &lt;xs:element name="maximum-user-count"
         type="xs:unsignedInt" minOccurs="0"/&gt;
        &lt;xs:element name="available-media"
         type="conference-media-type" minOccurs="0"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         HOST TYPE
      --&gt;
      &lt;xs:complexType name="host-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="display-text" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="web-page" type="xs:anyURI"
         minOccurs="0"/&gt;
        &lt;xs:element name="uris" type="uris-type"
         minOccurs="0"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         CONFERENCE STATE TYPE
      --&gt;
      &lt;xs:complexType name="conference-state-type"&gt;



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 28]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-29" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


       &lt;xs:sequence&gt;
        &lt;xs:element name="user-count" type="xs:unsignedInt"
         minOccurs="0"/&gt;
        &lt;xs:element name="active" type="xs:boolean"
         minOccurs="0"/&gt;
        &lt;xs:element name="locked" type="xs:boolean"
         minOccurs="0"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         CONFERENCE MEDIA TYPE
      --&gt;
      &lt;xs:complexType name="conference-media-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="entry" type="conference-medium-type"
         maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         CONFERENCE MEDIUM TYPE
      --&gt;
      &lt;xs:complexType name="conference-medium-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="display-text" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="type" type="xs:string"/&gt;
        &lt;xs:element name="status" type="media-status-type"
         minOccurs="0"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:attribute name="label" type="xs:string"
        use="required"/&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         URIs TYPE
      --&gt;
      &lt;xs:complexType name="uris-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="entry" type="uri-type"
         maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:attribute name="state" type="state-type"



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 29]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-30" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


        use="optional" default="full"/&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         URI TYPE
      --&gt;
      &lt;xs:complexType name="uri-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="uri" type="xs:anyURI"/&gt;
        &lt;xs:element name="display-text" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="purpose" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="modified" type="execution-type"
         minOccurs="0"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         KEYWORDS TYPE
      --&gt;
      &lt;xs:simpleType name="keywords-type"&gt;
       &lt;xs:list itemType="xs:string"/&gt;
      &lt;/xs:simpleType&gt;
      &lt;!--
         USERS TYPE
      --&gt;
      &lt;xs:complexType name="users-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="user" type="user-type"
         minOccurs="0" maxOccurs="unbounded"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:attribute name="state" type="state-type"
        use="optional" default="full"/&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         USER TYPE
      --&gt;
      &lt;xs:complexType name="user-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="display-text" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="associated-aors" type="uris-type"



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 30]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-31" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


         minOccurs="0"/&gt;
        &lt;xs:element name="roles" type="user-roles-type"
         minOccurs="0"/&gt;
        &lt;xs:element name="languages" type="user-languages-type"
         minOccurs="0"/&gt;
        &lt;xs:element name="cascaded-focus" type="xs:anyURI"
         minOccurs="0"/&gt;
        &lt;xs:element name="endpoint" type="endpoint-type"
         minOccurs="0" maxOccurs="unbounded"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:attribute name="entity" type="xs:anyURI"/&gt;
       &lt;xs:attribute name="state" type="state-type"
        use="optional" default="full"/&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         USER ROLES TYPE
      --&gt;
      &lt;xs:complexType name="user-roles-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="entry" type="xs:string"
         maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         USER LANGUAGES TYPE
      --&gt;
      &lt;xs:simpleType name="user-languages-type"&gt;
       &lt;xs:list itemType="xs:language"/&gt;
      &lt;/xs:simpleType&gt;
      &lt;!--
         ENDPOINT TYPE
      --&gt;
      &lt;xs:complexType name="endpoint-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="display-text" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="referred" type="execution-type"
         minOccurs="0"/&gt;
        &lt;xs:element name="status" type="endpoint-status-type"
         minOccurs="0"/&gt;
        &lt;xs:element name="joining-method" type="joining-type"
         minOccurs="0"/&gt;
        &lt;xs:element name="joining-info"
         type="execution-type"



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 31]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-32" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


         minOccurs="0"/&gt;
        &lt;xs:element name="disconnection-method"
         type="disconnection-type"
         minOccurs="0"/&gt;
        &lt;xs:element name="disconnection-info"
         type="execution-type"
         minOccurs="0"/&gt;
        &lt;xs:element name="media" type="media-type"
         minOccurs="0" maxOccurs="unbounded"/&gt;
        &lt;xs:element name="call-info" type="call-type"
         minOccurs="0"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:attribute name="entity" type="xs:string"/&gt;
       &lt;xs:attribute name="state" type="state-type"
        use="optional" default="full"/&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         ENDPOINT STATUS TYPE
      --&gt;
      &lt;xs:simpleType name="endpoint-status-type"&gt;
       &lt;xs:restriction base="xs:string"&gt;
        &lt;xs:enumeration value="pending"/&gt;
        &lt;xs:enumeration value="dialing-out"/&gt;
        &lt;xs:enumeration value="dialing-in"/&gt;
        &lt;xs:enumeration value="alerting"/&gt;
        &lt;xs:enumeration value="on-hold"/&gt;
        &lt;xs:enumeration value="connected"/&gt;
        &lt;xs:enumeration value="muted-via-focus"/&gt;
        &lt;xs:enumeration value="disconnecting"/&gt;
        &lt;xs:enumeration value="disconnected"/&gt;
       &lt;/xs:restriction&gt;
      &lt;/xs:simpleType&gt;
      &lt;!--
         JOINING TYPE
      --&gt;
      &lt;xs:simpleType name="joining-type"&gt;
       &lt;xs:restriction base="xs:string"&gt;
        &lt;xs:enumeration value="dialed-in"/&gt;
        &lt;xs:enumeration value="dialed-out"/&gt;
        &lt;xs:enumeration value="focus-owner"/&gt;
       &lt;/xs:restriction&gt;
      &lt;/xs:simpleType&gt;
      &lt;!--
         DISCONNECTION TYPE
      --&gt;



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 32]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-33" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


      &lt;xs:simpleType name="disconnection-type"&gt;
       &lt;xs:restriction base="xs:string"&gt;
        &lt;xs:enumeration value="departed"/&gt;
        &lt;xs:enumeration value="booted"/&gt;
        &lt;xs:enumeration value="failed"/&gt;
        &lt;xs:enumeration value="busy"/&gt;
       &lt;/xs:restriction&gt;
      &lt;/xs:simpleType&gt;
      &lt;!--
         EXECUTION TYPE
      --&gt;
      &lt;xs:complexType name="execution-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="when" type="xs:dateTime"
         minOccurs="0"/&gt;
        &lt;xs:element name="reason" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="by" type="xs:anyURI"
         minOccurs="0"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
     &lt;!--
         CALL TYPE
      --&gt;
      &lt;xs:complexType name="call-type"&gt;
       &lt;xs:choice&gt;
        &lt;xs:element name="sip" type="sip-dialog-id-type"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:choice&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         SIP DIALOG ID TYPE
      --&gt;
      &lt;xs:complexType name="sip-dialog-id-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="display-text" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="call-id" type="xs:string"/&gt;
        &lt;xs:element name="from-tag" type="xs:string"/&gt;
        &lt;xs:element name="to-tag" type="xs:string"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 33]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-34" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


      &lt;!--
         MEDIA TYPE
      --&gt;
      &lt;xs:complexType name="media-type"&gt;
       &lt;xs:sequence&gt;
        &lt;xs:element name="display-text" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="type" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="label" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="src-id" type="xs:string"
         minOccurs="0"/&gt;
        &lt;xs:element name="status" type="media-status-type"
         minOccurs="0"/&gt;
        &lt;xs:any namespace="##other" processContents="lax"
         minOccurs="0" maxOccurs="unbounded"/&gt;
       &lt;/xs:sequence&gt;
       &lt;xs:attribute name="id" type="xs:string"
        use="required"/&gt;
       &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
      &lt;/xs:complexType&gt;
      &lt;!--
         MEDIA STATUS TYPE
      --&gt;
      &lt;xs:simpleType name="media-status-type"&gt;
       &lt;xs:restriction base="xs:string"&gt;
        &lt;xs:enumeration value="recvonly"/&gt;
        &lt;xs:enumeration value="sendonly"/&gt;
        &lt;xs:enumeration value="sendrecv"/&gt;
        &lt;xs:enumeration value="inactive"/&gt;
       &lt;/xs:restriction&gt;
      &lt;/xs:simpleType&gt;
       &lt;!--
         SIDEBARS BY VAL TYPE
       --&gt;
       &lt;xs:complexType name="sidebars-by-val-type"&gt;
        &lt;xs:sequence&gt;
         &lt;xs:element name="entry" type="conference-type"
          minOccurs="0" maxOccurs="unbounded"/&gt;
        &lt;/xs:sequence&gt;
        &lt;xs:attribute name="state" type="state-type"
         use="optional" default="full"/&gt;
        &lt;xs:anyAttribute namespace="##other" processContents="lax"/&gt;
       &lt;/xs:complexType&gt;
      &lt;/xs:schema&gt;





<span class="grey">Rosenberg, et al.           Standards Track                    [Page 34]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-35" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


<span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>.  Examples</span>

<span class="h3"><a class="selflink" id="section-7.1" href="#section-7.1">7.1</a>.  Basic Example</span>

   The following is an example of a full conference information
   document:

   &lt;?xml version="1.0" encoding="UTF-8"?&gt;
   &lt;conference-info
    xmlns="urn:ietf:params:xml:ns:conference-info"
    entity="sips:conf233@example.com"
    state="full" version="1"&gt;
   &lt;!--
     CONFERENCE INFO
   --&gt;
    &lt;conference-description&gt;
     &lt;subject&gt;Agenda: This month's goals&lt;/subject&gt;
      &lt;service-uris&gt;
       &lt;entry&gt;
        &lt;uri&gt;http://sharepoint/salesgroup/&lt;/uri&gt;
        &lt;purpose&gt;web-page&lt;/purpose&gt;
       &lt;/entry&gt;
      &lt;/service-uris&gt;
     &lt;/conference-description&gt;
   &lt;!--
      CONFERENCE STATE
   --&gt;
    &lt;conference-state&gt;
     &lt;user-count&gt;33&lt;/user-count&gt;
    &lt;/conference-state&gt;
   &lt;!--
     USERS
   --&gt;
    &lt;users&gt;
     &lt;user entity="sip:bob@example.com" state="full"&gt;
      &lt;display-text&gt;Bob Hoskins&lt;/display-text&gt;
   &lt;!--
     ENDPOINTS
   --&gt;
      &lt;endpoint entity="sip:bob@pc33.example.com"&gt;
       &lt;display-text&gt;Bob's Laptop&lt;/display-text&gt;
       &lt;status&gt;disconnected&lt;/status&gt;
       &lt;disconnection-method&gt;departed&lt;/disconnection-method&gt;
       &lt;disconnection-info&gt;
        &lt;when&gt;2005-03-04T20:00:00Z&lt;/when&gt;
        &lt;reason&gt;bad voice quality&lt;/reason&gt;
        &lt;by&gt;sip:mike@example.com&lt;/by&gt;
       &lt;/disconnection-info&gt;



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 35]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-36" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   &lt;!--
     MEDIA
   --&gt;
       &lt;media id="1"&gt;
        &lt;display-text&gt;main audio&lt;/display-text&gt;
        &lt;type&gt;audio&lt;/type&gt;
        &lt;label&gt;34567&lt;/label&gt;
        &lt;src-id&gt;432424&lt;/src-id&gt;
        &lt;status&gt;sendrecv&lt;/status&gt;
       &lt;/media&gt;
      &lt;/endpoint&gt;
     &lt;/user&gt;
   &lt;!--
     USER
   --&gt;
     &lt;user entity="sip:alice@example.com" state="full"&gt;
      &lt;display-text&gt;Alice&lt;/display-text&gt;
   &lt;!--
     ENDPOINTS
   --&gt;
      &lt;endpoint entity="sip:4kfk4j392jsu@example.com;grid=433kj4j3u"&gt;
       &lt;status&gt;connected&lt;/status&gt;
       &lt;joining-method&gt;dialed-out&lt;/joining-method&gt;
       &lt;joining-info&gt;
        &lt;when&gt;2005-03-04T20:00:00Z&lt;/when&gt;
        &lt;by&gt;sip:mike@example.com&lt;/by&gt;
       &lt;/joining-info&gt;
   &lt;!--
     MEDIA
   --&gt;
       &lt;media id="1"&gt;
        &lt;display-text&gt;main audio&lt;/display-text&gt;
        &lt;type&gt;audio&lt;/type&gt;
        &lt;label&gt;34567&lt;/label&gt;
        &lt;src-id&gt;534232&lt;/src-id&gt;
        &lt;status&gt;sendrecv&lt;/status&gt;
       &lt;/media&gt;
      &lt;/endpoint&gt;
     &lt;/user&gt;
    &lt;/users&gt;
   &lt;/conference-info&gt;

<span class="h3"><a class="selflink" id="section-7.2" href="#section-7.2">7.2</a>.  Rich Example</span>

   The following is an example of a partial conference information
   document.  In this example, there are 32 participants in a voice
   conference.  The user Bob has been ejected from the conference by
   Mike due to bad voice quality.  Note that there are three sidebars in



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 36]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-37" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   the conference; two are referenced just by their sidebar URIs, and
   information about the third sidebar is included in this notification.
   Also note that while this conference offers both audio and video
   capabilities, only audio is currently in use.

   &lt;?xml version="1.0" encoding="UTF-8"?&gt;
   &lt;conference-info
    xmlns="urn:ietf:params:xml:ns:conference-info"
    entity="sips:conf233@example.com"
    state="partial" version="5"&gt;
   &lt;!--
     CONFERENCE INFO
   --&gt;
    &lt;conference-description&gt;
     &lt;display-text&gt;Weekly Sales Meeting&lt;/display-text&gt;
     &lt;subject&gt;Agenda: This month's goals&lt;/subject&gt;
     &lt;free-text&gt;We will start strict on time&lt;/free-text&gt;
     &lt;keywords&gt;sales meeting weekly&lt;/keywords&gt;
     &lt;conf-uris&gt;
      &lt;entry&gt;
       &lt;uri&gt;tel:+18005671234&lt;/uri&gt;
       &lt;display-text&gt;TTI Bridge&lt;/display-text&gt;
       &lt;purpose&gt;participation&lt;/purpose&gt;
      &lt;/entry&gt;
      &lt;entry&gt;
       &lt;uri&gt;h323:conf545@h323.example.com&lt;/uri&gt;
       &lt;purpose&gt;participation&lt;/purpose&gt;
      &lt;/entry&gt;
      &lt;entry&gt;
       &lt;uri&gt;http://real.streaming.com/54634/live.ram&lt;/uri&gt;
       &lt;purpose&gt;streaming&lt;/purpose&gt;
      &lt;/entry&gt;
     &lt;/conf-uris&gt;
     &lt;service-uris&gt;
      &lt;entry&gt;
       &lt;uri&gt;http://sharepoint/salesgroup/&lt;/uri&gt;
       &lt;purpose&gt;web-page&lt;/purpose&gt;
      &lt;/entry&gt;
      &lt;entry&gt;
       &lt;uri&gt;http://quicktime.com/54634/recording.mov&lt;/uri&gt;
       &lt;display-text&gt;Quicktime&lt;/display-text&gt;
       &lt;purpose&gt;recording&lt;/purpose&gt;
      &lt;/entry&gt;
     &lt;/service-uris&gt;
     &lt;maximum-user-count&gt;100&lt;/maximum-user-count&gt;
     &lt;available-media&gt;
      &lt;entry label="34567"&gt;
       &lt;display-text&gt;main audio&lt;/display-text&gt;



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 37]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-38" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


       &lt;type&gt;audio&lt;/type&gt;
       &lt;status&gt;sendrecv&lt;/status&gt;
      &lt;/entry&gt;
      &lt;entry label="34569"&gt;
       &lt;display-text&gt;main video&lt;/display-text&gt;
       &lt;type&gt;video&lt;/type&gt;
       &lt;status&gt;inactive&lt;/status&gt;
      &lt;/entry&gt;
     &lt;/available-media&gt;
    &lt;/conference-description&gt;
   &lt;!--
     HOST INFO
   --&gt;
    &lt;host-info&gt;
     &lt;display-text&gt;Sales Host&lt;/display-text&gt;
     &lt;web-page&gt;http://sharepoint/salesgroup/hosts/&lt;/web-page&gt;
     &lt;uris&gt;
      &lt;entry&gt;
       &lt;uri&gt;sip:sales@example.com&lt;/uri&gt;
      &lt;/entry&gt;
     &lt;/uris&gt;
    &lt;/host-info&gt;
   &lt;!--
     CONFERENCE STATE
   --&gt;
    &lt;conference-state&gt;
     &lt;user-count&gt;32&lt;/user-count&gt;
     &lt;active&gt;true&lt;/active&gt;
     &lt;locked&gt;false&lt;/locked&gt;
    &lt;/conference-state&gt;
   &lt;!--
     USERS
   --&gt;
    &lt;users&gt;
     &lt;user entity="sip:bob@example.com"&gt;
      &lt;display-text&gt;Bob Hoskins&lt;/display-text&gt;
      &lt;associated-aors&gt;
       &lt;entry&gt;
        &lt;uri&gt;mailto:bob@example.com&lt;/uri&gt;
        &lt;display-text&gt;email&lt;/display-text&gt;
       &lt;/entry&gt;
      &lt;/associated-aors&gt;
      &lt;roles&gt;
      &lt;entry&gt;participant&lt;/entry&gt;
      &lt;/roles&gt;
      &lt;languages&gt;en&lt;/languages&gt;
   &lt;!--
     ENDPOINTS



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 38]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-39" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   --&gt;
      &lt;endpoint entity="sip:bob@pc33.example.com"&gt;
       &lt;display-text&gt;Bob's Laptop&lt;/display-text&gt;
       &lt;referred&gt;
        &lt;when&gt;2005-03-04T20:00:00Z&lt;/when&gt;
        &lt;reason&gt;expert required&lt;/reason&gt;
        &lt;by&gt;sip:mike@example.com&lt;/by&gt;
       &lt;/referred&gt;
       &lt;status&gt;disconnecting&lt;/status&gt;
       &lt;joining-method&gt;dialed-out&lt;/joining-method&gt;
       &lt;joining-info&gt;
        &lt;when&gt;2005-03-04T20:00:00Z&lt;/when&gt;
        &lt;reason&gt;invitation&lt;/reason&gt;
        &lt;by&gt;sip:mike@example.com&lt;/by&gt;
       &lt;/joining-info&gt;
       &lt;disconnection-method&gt;booted&lt;/disconnection-method&gt;
       &lt;disconnection-info&gt;

        &lt;when&gt;2005-03-04T20:00:00Z&lt;/when&gt;
        &lt;reason&gt;bad voice quality&lt;/reason&gt;
        &lt;by&gt;sip:mike@example.com&lt;/by&gt;
       &lt;/disconnection-info&gt;
   &lt;!--
     MEDIA
   --&gt;
       &lt;media id="1"&gt;
        &lt;display-text&gt;main audio&lt;/display-text&gt;
        &lt;type&gt;audio&lt;/type&gt;
        &lt;label&gt;34567&lt;/label&gt;
        &lt;src-id&gt;432424&lt;/src-id&gt;
        &lt;status&gt;sendrecv&lt;/status&gt;
       &lt;/media&gt;
   &lt;!--
     CALL INFO
   --&gt;
       &lt;call-info&gt;
        &lt;sip&gt;
         &lt;display-text&gt;full info&lt;/display-text&gt;
           &lt;call-id&gt;hsjh8980vhsb78&lt;/call-id&gt;
           &lt;from-tag&gt;vav738dvbs&lt;/from-tag&gt;
           &lt;to-tag&gt;8954jgjg8432&lt;/to-tag&gt;
        &lt;/sip&gt;
       &lt;/call-info&gt;
      &lt;/endpoint&gt;
     &lt;/user&gt;
    &lt;/users&gt;
   &lt;!--
     SIDEBARS BY REFERENCE



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 39]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-40" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   --&gt;
    &lt;sidebars-by-ref state="partial"&gt;
     &lt;entry&gt;
      &lt;uri&gt;sips:conf233@example.com;grid=45&lt;/uri&gt;
      &lt;display-text&gt;sidebar with Carol&lt;/display-text&gt;
     &lt;/entry&gt;
     &lt;entry&gt;
      &lt;uri&gt;sips:conf233@example.com;grid=21&lt;/uri&gt;
      &lt;display-text&gt;private with Peter&lt;/display-text&gt;
     &lt;/entry&gt;
    &lt;/sidebars-by-ref&gt;
   &lt;!--
     SIDEBARS BY VALUE
   --&gt;
    &lt;sidebars-by-val state="partial"&gt;
     &lt;entry entity="sips:conf233@example.com;grid=77"

      state="partial"&gt;
      &lt;users&gt;
       &lt;user entity="sip:bob@example.com"/&gt;
       &lt;user entity="sip:mark@example.com"/&gt;
       &lt;user entity="sip:dan@example.com"/&gt;
      &lt;/users&gt;
     &lt;/entry&gt;
    &lt;/sidebars-by-val&gt;
   &lt;/conference-info&gt;

<span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>.  Security Considerations</span>

   Subscriptions to conference state information can reveal very
   sensitive information.  For this reason, it is RECOMMENDED that a
   focus use a strong means for authentication and conference
   information protection and that it apply comprehensive authorization
   rules when using the conference notification mechanism defined in
   this document.  The following sections will discuss each of these
   aspects in more detail.

<span class="h3"><a class="selflink" id="section-8.1" href="#section-8.1">8.1</a>.  Connection Security</span>

   It is RECOMMENDED that a focus authenticate a conference package
   subscriber using the normal SIP authentication mechanisms, such as
   Digest as defined in <a href="./rfc3261#section-22">Section&nbsp;22 of RFC 3261</a> [<a href="#ref-8" title="&quot;SIP: Session Initiation Protocol&quot;">8</a>].

   The mechanism used for conveying the conference information MUST
   ensure integrity and SHOULD ensure confidentially of the information.
   In order to achieve these, an end-to-end SIP encryption mechanism,





<span class="grey">Rosenberg, et al.           Standards Track                    [Page 40]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-41" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   such as S/MIME described in <a href="./rfc3261#section-26.2.4">Section&nbsp;26.2.4 of RFC 3261</a> [<a href="#ref-8" title="&quot;SIP: Session Initiation Protocol&quot;">8</a>], SHOULD be
   used.

   If a strong end-to-end security means (such as above) is not
   available, it is RECOMMENDED that a focus use mutual hop-by-hop
   Transport Layer Security (TLS) authentication and encryption
   mechanisms described in <a href="#section-26.2.2">Section 26.2.2</a> "SIPS URI Scheme" and <a href="#section-26.3.2.2">Section</a>
   <a href="#section-26.3.2.2">26.3.2.2</a> "Interdomain Requests" of <a href="./rfc3261">RFC 3261</a> [<a href="#ref-8" title="&quot;SIP: Session Initiation Protocol&quot;">8</a>].

<span class="h3"><a class="selflink" id="section-8.2" href="#section-8.2">8.2</a>.  Authorization Considerations</span>

   Generally speaking, conference applications are very concerned about
   authorization decisions.  Mechanisms for establishing and enforcing
   such authorization rules are a central concept throughout the SIP
   Conferencing Framework [<a href="#ref-16" title="&quot;A Framework for Conferencing with the Session Initiation Protocol (SIP)&quot;">16</a>].  Because most of the information about a
   conference can be presented using the conference package, many of the
   authorization rules directly apply to this specification.  As a
   result, a notification server MUST be capable of generating distinct
   conference information views to different subscribers, subject to a
   subscriber's role in a conference, personal access rights, etc. - all
   subject to local authorization policies and rules.

   Since a focus provides participant identity information using this
   event package, participant privacy needs to be taken into account.  A
   focus MUST support requests by participants for privacy.  Privacy can
   be indicated by the conference policy - for every participant or
   select participants.  It can also be indicated in the session
   signaling.  In SIP, this can be done using the Privacy header field
   described in <a href="./rfc3323">RFC 3323</a> [<a href="#ref-11" title="&quot;A Privacy Mechanism for the Session Initiation Protocol (SIP)&quot;">11</a>].  For a participant requesting privacy, no
   identity information SHOULD be revealed by the focus in any included
   URI (e.g., the Address of Record, Contact, or GRUU).  For these
   cases, the anonymous URI generation method outlined in <a href="#section-5.6">Section 5.6</a> of
   this document MUST be followed.

<span class="h2"><a class="selflink" id="section-9" href="#section-9">9</a>.  IANA Considerations</span>

   This document registers a SIP event package, a new MIME type,
   application/conference-info+xml, a new XML namespace, and a new XML
   schema, and creates a sub-registry "URI purposes" under the existing
   registry: <a href="http://www.iana.org/assignments/sip-parameters">http://www.iana.org/assignments/sip-parameters</a>.

<span class="h3"><a class="selflink" id="section-9.1" href="#section-9.1">9.1</a>.  conference Event Package Registration</span>

   This specification registers an event package, based on the
   registration procedures defined in <a href="./rfc3265">RFC 3265</a> [<a href="#ref-10" title="&quot;Session Initiation Protocol (SIP)-Specific Event Notification&quot;">10</a>].  The following is
   the information required for such a registration:





<span class="grey">Rosenberg, et al.           Standards Track                    [Page 41]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-42" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   Package Name:  conference

   Package or Template-Package:  This is a package.

   Published Document:  <a href="./rfc4575">RFC 4575</a>

   Person to Contact:  IETF SIPPING Working Group &lt;sipping@ietf.org&gt;, as
      designated by the IESG &lt;iesg@ietf.org&gt;

<span class="h3"><a class="selflink" id="section-9.2" href="#section-9.2">9.2</a>.  application/conference-info+xml MIME Registration</span>

   MIME media type name:  application

   MIME subtype name:  conference-info+xml

   Mandatory parameters:  none

   Optional parameters:  Same as charset parameter application/xml as
      specified in <a href="./rfc3023">RFC 3023</a> [<a href="#ref-7" title="&quot;XML Media Types&quot;">7</a>]

   Encoding considerations:  Same as encoding considerations of
      application/xml as specified in <a href="./rfc3023">RFC 3023</a> [<a href="#ref-7" title="&quot;XML Media Types&quot;">7</a>]

   Security considerations:  See <a href="./rfc3023#section-10">Section&nbsp;10 of RFC 3023</a> [<a href="#ref-7" title="&quot;XML Media Types&quot;">7</a>] and
      <a href="#section-8">Section 8</a> of this specification

   Interoperability considerations:  none

   Published specification:  This document

   Applications which use this media type:  This document type has been
      used to support SIP conferencing applications

   Additional Information:

      Magic Number:  None

      File Extension:  .xml

      Macintosh file type code:  "TEXT"

   Personal and email address for further information:  IETF SIPPING
      Working Group &lt;sipping@ietf.org&gt;, as designated by the IESG
      &lt;iesg@ietf.org&gt;

   Intended usage:  COMMON





<span class="grey">Rosenberg, et al.           Standards Track                    [Page 42]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-43" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   Author/Change controller:  IETF SIPPING Working Group
      &lt;sipping@ietf.org&gt;, as designated by the IESG &lt;iesg@ietf.org&gt;

<span class="h3"><a class="selflink" id="section-9.3" href="#section-9.3">9.3</a>.  URN Sub-Namespace Registration for</span>
<span class="h3">      urn:ietf:params:xml:ns:conference-info</span>

   This section registers a new XML namespace, as per the guidelines in
   <a href="./rfc3688">RFC 3688</a> [<a href="#ref-21" title="&quot;The IETF XML Registry&quot;">21</a>].

   URI:  The URI for this namespace is
      urn:ietf:params:xml:ns:conference-info

   Registrant Contact:  IETF SIPPING Working Group &lt;sipping@ietf.org&gt;,
      as designated by the IESG &lt;iesg@ietf.org&gt;

   XML:

   BEGIN
   &lt;?xml version="1.0"?&gt;
   &lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.0//EN"
             "<a href="http://www.w3.org/TR/xhtml-basic/xhtml-basic10.dtd">http://www.w3.org/TR/xhtml-basic/xhtml-basic10.dtd</a>"&gt;
   &lt;html xmlns="http://www.w3.org/1999/xhtml"&gt;
   &lt;head&gt;
     &lt;meta http-equiv="content-type"
        content="text/html;charset=iso-8859-1"/&gt;
     &lt;title&gt;Conference Information Namespace&lt;/title&gt;

   &lt;/head
   &lt;body&gt;
     &lt;h1&gt;Namespace for Conference Information&lt;/h1&gt;
     &lt;h2&gt;urn:ietf:params:xml:ns:conference-info&lt;/h2&gt;
     &lt;p&gt;See &lt;a href="http://www.rfc-editor.org/rfc/rfc4575.txt"&gt;
        <a href="./rfc4575">RFC4575</a>&lt;/a&gt;.&lt;/p&gt;
   &lt;/body&gt;
   &lt;/html&gt;
   END

<span class="h3"><a class="selflink" id="section-9.4" href="#section-9.4">9.4</a>.  XML Schema Registration</span>

   This specification registers a schema, as per the guidelines in <a href="./rfc3688">RFC</a>
   <a href="./rfc3688">3688</a> [<a href="#ref-21" title="&quot;The IETF XML Registry&quot;">21</a>].

      URI: please assign

      Registrant Contact: IETF SIPPING Working Group &lt;sipping@ietf.org&gt;,
      as designated by the IESG &lt;iesg@ietf.org&gt;

      XML: The XML can be found as the sole content of <a href="#section-6">Section 6</a>.



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 43]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-44" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


<span class="h3"><a class="selflink" id="section-9.5" href="#section-9.5">9.5</a>.  URI Purposes Sub-registry Establishment</span>

   The IANA has created a new sub-registry, "URI purposes", under the
   already existing registry:
   <a href="http://www.iana.org/assignments/sip-parameters">http://www.iana.org/assignments/sip-parameters</a>.

   The purpose of a URI is an XML element, encoded in the conference
   event package <a href="./rfc4575">RFC 4575</a>.  The value of the &lt;purpose&gt; element indicates
   the intended usage of the URI in the context of the conference event
   package and is defined in Sections <a href="#section-5.3.1">5.3.1</a> and <a href="#section-5.3.2">5.3.2</a> of this
   specification.

   This sub-registry is defined as a table that contains the following
   three columns:

   Value:  The token under registration

   Description:  A descriptive text defining the intended usage of the
      URI

   Document:  A reference to the document defining the registration

   The IANA has created the table with the initial content as defined
   below:

   Value         Description                         Document
   -------       ----------------------------------  ----------

   participation The URI can be used to join the     [<a href="./rfc4575">RFC 4575</a>]
                 conference

   streaming     The URI can be used to access the   [<a href="./rfc4575">RFC 4575</a>]
                 streamed conference data

   event         The URI can be used to subscribe    [<a href="./rfc4575">RFC 4575</a>]
                 to the conference event package

   recording     The URI can be used to access the   [<a href="./rfc4575">RFC 4575</a>]
                 recorded conference data

   web-page      The URI can be used to access a     [<a href="./rfc4575">RFC 4575</a>]
                 web page that contains additional
                 information of the conference

   New values of the "URI purposes" are registered by the IANA and are
   specification required according to the definition of <a href="./rfc2434">RFC 2434</a> [<a href="#ref-4" title="">4</a>].
   The IANA Considerations section of the specification MUST include the
   following information:



<span class="grey">Rosenberg, et al.           Standards Track                    [Page 44]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-45" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   Value:  The value of the &lt;purpose&gt; element to be registered

   Description:  A short description of the intended usage of the URI

<span class="h2"><a class="selflink" id="section-10" href="#section-10">10</a>.  Acknowledgements</span>

   The authors would like to thank Dan Petrie, Sean Olson, Alan
   Johnston, Rohan Mahy, Cullen Jennings, Brian Rosen, Roni Even, and
   Miguel Garcia for their comments and inputs.

<span class="h2"><a class="selflink" id="section-11" href="#section-11">11</a>.  References</span>

<span class="h3"><a class="selflink" id="section-11.1" href="#section-11.1">11.1</a>.  Normative References</span>

   [<a id="ref-1">1</a>]   Bradner, S., "Key words for use in RFCs to Indicate Requirement
         Levels", <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a>, March 1997.

   [<a id="ref-2">2</a>]   Moats, R., "URN Syntax", <a href="./rfc2141">RFC 2141</a>, May 1997.

   [<a id="ref-3">3</a>]   Handley, M., Jacobson, V. and C. Perkins, "SDP: Session
         Description Protocol", <a href="./rfc4566">RFC 4566</a>, July 2006.

   [<a id="ref-4">4</a>]   Narten, T. and H. Alvestrand, "Guidelines for Writing an IANA
         Considerations Section in RFCs", <a href="https://www.rfc-editor.org/bcp/bcp26">BCP 26</a>, <a href="./rfc2434">RFC 2434</a>, October
         1998.

   [<a id="ref-5">5</a>]   Eastlake 3rd, D. and A. Panitz, "Reserved Top Level DNS Names",
         <a href="https://www.rfc-editor.org/bcp/bcp32">BCP 32</a>, <a href="./rfc2606">RFC 2606</a>, June 1999.

   [<a id="ref-6">6</a>]   Moats, R., "A URN Namespace for IETF Documents", <a href="./rfc2648">RFC 2648</a>,
         August 1999.

   [<a id="ref-7">7</a>]   Murata, M., St. Laurent, S., and D. Kohn, "XML Media Types",
         <a href="./rfc3023">RFC 3023</a>, January 2001.

   [<a id="ref-8">8</a>]   Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A.,
         Peterson, J., Sparks, R., Handley, M., and E. Schooler, "SIP:
         Session Initiation Protocol", <a href="./rfc3261">RFC 3261</a>, June 2002.

   [<a id="ref-9">9</a>]   Rosenberg, J. and H. Schulzrinne, "An Offer/Answer Model with
         Session Description Protocol (SDP)", <a href="./rfc3264">RFC 3264</a>, June 2002.

   [<a id="ref-10">10</a>]  Roach, A.B., "Session Initiation Protocol (SIP)-Specific Event
         Notification", <a href="./rfc3265">RFC 3265</a>, June 2002.

   [<a id="ref-11">11</a>]  Peterson, J., "A Privacy Mechanism for the Session Initiation
         Protocol (SIP)", <a href="./rfc3323">RFC 3323</a>, November 2002.




<span class="grey">Rosenberg, et al.           Standards Track                    [Page 45]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-46" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   [<a id="ref-12">12</a>]  Schulzrinne, H., Oran, D., and G. Camarillo, "The Reason Header
         Field for the Session Initiation Protocol (SIP)", <a href="./rfc3326">RFC 3326</a>,
         December 2002.

   [<a id="ref-13">13</a>]  Schulzrinne, H., Casner, S., Frederick, R., and V. Jacobson,
         "RTP: A Transport Protocol for Real-Time Applications", STD 64,
         <a href="./rfc3550">RFC 3550</a>, July 2003.

   [<a id="ref-14">14</a>]  Yergeau, F., "UTF-8, a transformation format of ISO 10646", STD
         63, <a href="./rfc3629">RFC 3629</a>, November 2003.

   [<a id="ref-15">15</a>]  Sparks, R., "The Session Initiation Protocol (SIP) Referred-By
         Mechanism", <a href="./rfc3892">RFC 3892</a>, September 2004.

   [<a id="ref-16">16</a>]  Rosenberg, J., "A Framework for Conferencing with the Session
         Initiation Protocol (SIP)", <a href="./rfc4353">RFC 4353</a>, February 2006.

   [<a id="ref-17">17</a>]  Levin, O. and G. Camarillo, "The Session Description Protocol
         (SDP) Label Attribute", <a href="./rfc4574">RFC 4574</a>, August 2006.

<span class="h3"><a class="selflink" id="section-11.2" href="#section-11.2">11.2</a>.  Informative References</span>

   [<a id="ref-18">18</a>]  Schulzrinne, H., Rao, A., and R. Lanphier, "Real Time Streaming
         Protocol (RTSP)", <a href="./rfc2326">RFC 2326</a>, April 1998.

   [<a id="ref-19">19</a>]  Schulzrinne, H., "The tel URI for Telephone Numbers", <a href="./rfc3966">RFC 3966</a>,
         December 2004.

   [<a id="ref-20">20</a>]  Levin, O., "H.323 Uniform Resource Locator (URL) Scheme
         Registration", <a href="./rfc3508">RFC 3508</a>, April 2003.

   [<a id="ref-21">21</a>]  Mealling, M., "The IETF XML Registry", <a href="https://www.rfc-editor.org/bcp/bcp81">BCP 81</a>, <a href="./rfc3688">RFC 3688</a>,
         January 2004.

   [<a id="ref-22">22</a>]  Saint-Andre, P., "A Uniform Resource Identifier (URI) Scheme
         for the Extensible Messaging and Presence Protocol (XMPP)",
         Work in Progress, December 2004.

   [<a id="ref-23">23</a>]  Rosenberg, J., Schulzrinne, H., and R. Mahy, "An INVITE-
         Initiated Dialog Event Package for the Session Initiation
         Protocol (SIP)", <a href="./rfc4235">RFC 4235</a>, November 2005.

   [<a id="ref-24">24</a>]  Rosenberg, J., "Obtaining and Using Globally Routable User
         Agent (UA) URIs (GRUU) in the Session Initiation Protocol
         (SIP)", Work in Progress, May 2006.






<span class="grey">Rosenberg, et al.           Standards Track                    [Page 46]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-47" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


   [<a id="ref-25">25</a>]  Peterson, J. and C. Jennings, "Enhancements for Authenticated
         Identity Management in the Session Initiation Protocol (SIP)",
         <a href="./rfc4474">RFC 4474</a>, August 2006.

Authors' Addresses

   Jonathan Rosenberg
   Cisco Systems
   600 Lanidex Plaza
   Parsippany, NJ  07054
   US

   Phone: +1 973 952-5000
   EMail: jdrosen@cisco.com
   URI:   <a href="http://www.jdrosen.net">http://www.jdrosen.net</a>


   Henning Schulzrinne
   Columbia University
   M/S 0401
   1214 Amsterdam Ave.
   New York, NY  10027
   US

   EMail: schulzrinne@cs.columbia.edu
   URI:   <a href="http://www.cs.columbia.edu/~hgs">http://www.cs.columbia.edu/~hgs</a>


   Orit Levin (editor)
   Microsoft Corporation
   One Microsoft Way
   Redmond, WA  98052
   US

   EMail: oritl@microsoft.com
















<span class="grey">Rosenberg, et al.           Standards Track                    [Page 47]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-48" ></span>
<span class="grey"><a href="./rfc4575">RFC 4575</a>                   Conference Package                August 2006</span>


Full Copyright Statement

   Copyright (C) The Internet Society (2006).

   This document is subject to the rights, licenses and restrictions
   contained in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a>, and except as set forth therein, the authors
   retain all their rights.

   This document and the information contained herein are provided on an
   "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
   OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
   ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
   INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
   INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
   WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Intellectual Property

   The IETF takes no position regarding the validity or scope of any
   Intellectual Property Rights or other rights that might be claimed to
   pertain to the implementation or use of the technology described in
   this document or the extent to which any license under such rights
   might or might not be available; nor does it represent that it has
   made any independent effort to identify any such rights.  Information
   on the procedures with respect to rights in RFC documents can be
   found in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> and <a href="https://www.rfc-editor.org/bcp/bcp79">BCP 79</a>.

   Copies of IPR disclosures made to the IETF Secretariat and any
   assurances of licenses to be made available, or the result of an
   attempt made to obtain a general license or permission for the use of
   such proprietary rights by implementers or users of this
   specification can be obtained from the IETF on-line IPR repository at
   <a href="http://www.ietf.org/ipr">http://www.ietf.org/ipr</a>.

   The IETF invites any interested party to bring to its attention any
   copyrights, patents or patent applications, or other proprietary
   rights that may cover technology that may be required to implement
   this standard.  Please address the information to the IETF at
   ietf-ipr@ietf.org.

Acknowledgement

   Funding for the RFC Editor function is provided by the IETF
   Administrative Support Activity (IASA).







Rosenberg, et al.           Standards Track                    [Page 48]
</pre>