Caching paragraph removed (doesn't apply anymore)
authorlu_zero <lu_zero@xiph.org>
Tue, 18 Oct 2005 23:15:34 +0000 (23:15 +0000)
committerlu_zero <lu_zero@xiph.org>
Tue, 18 Oct 2005 23:15:34 +0000 (23:15 +0000)
Minor retouches

svn path=/trunk/vorbis/; revision=10193

doc/draft-ietf-avt-vorbis-rtp-01.txt
doc/draft-ietf-avt-vorbis-rtp-01.xml

index 122b405..54f19a6 100644 (file)
@@ -1,6 +1,7 @@
 
 
 
+
 AVT Working Group                                             L. Barbato
 Internet-Draft                                                  Xiph.Org
 Expires: April 18, 2006                                 October 15, 2005
@@ -79,11 +80,10 @@ Table of Contents
        3.1.1.  Packed Configuration . . . . . . . . . . . . . . . . .  9
      3.2.  Packed Headers Delivery  . . . . . . . . . . . . . . . . . 10
        3.2.1.  Packed Headers IANA Considerations . . . . . . . . . . 11
-     3.3.  Configuration Caching  . . . . . . . . . . . . . . . . . . 12
-     3.4.  Loss of Configuration Headers  . . . . . . . . . . . . . . 12
+     3.3.  Loss of Configuration Headers  . . . . . . . . . . . . . . 12
    4.  Comment Headers  . . . . . . . . . . . . . . . . . . . . . . . 12
    5.  Frame Packetizing  . . . . . . . . . . . . . . . . . . . . . . 13
-     5.1.  Example Fragmented Vorbis Packet . . . . . . . . . . . . . 14
+     5.1.  Example Fragmented Vorbis Packet . . . . . . . . . . . . . 13
      5.2.  Packet Loss  . . . . . . . . . . . . . . . . . . . . . . . 16
    6.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 17
      6.1.  Mapping MIME Parameters into SDP . . . . . . . . . . . . . 18
@@ -108,6 +108,7 @@ Table of Contents
 
 
 
+
 Barbato                  Expires April 18, 2006                 [Page 2]
 \f
 Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
@@ -619,15 +620,7 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
 
    Change controller: IETF AVT Working Group
 
-3.3.  Configuration Caching
-
-   Configuration caching allows clients that have previously connected
-   to a stream to re-use the associated configuration data.  When a
-   client receives a Packed Configuration packet it may store it locally
-   and can compare the Ident key with that of the new stream and begin
-   decoding before it has received any of the headers.
-
-3.4.  Loss of Configuration Headers
+3.3.  Loss of Configuration Headers
 
    Unlike the loss of raw Vorbis payload data, loss of a configuration
    header can lead to a situation where it will not be possible to
@@ -644,34 +637,8 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
    contain the comment metadata, such as artist name, track title and so
    on.  These metadata messages are not intended to be fully descriptive
    but to offer basic track/song information.  This packet SHOULD NOT be
-   sent and clients MAY ignore it completely.  During a session the
-   Details on the format of the comments can be found in the Vorbis
-   documentation [12].
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Barbato                  Expires April 18, 2006                [Page 12]
-\f
-Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
-
+   sent and clients MAY ignore it completely.  The details on the format
+   of the comments can be found in the Vorbis documentation [12].
 
        0                   1                   2                   3
        0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
@@ -701,6 +668,12 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
    fragmented.
 
 
+
+Barbato                  Expires April 18, 2006                [Page 12]
+\f
+Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
+
+
 5.  Frame Packetizing
 
    Each RTP packet contains either one Vorbis packet fragment, or an
@@ -711,16 +684,44 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
    in the RTP packet with as many Vorbis packets as will fit, up to a
    maximum of 15.  Path MTU is detailed in [6] and [7].
 
-   If a Vorbis packet is larger than 65535 octets it MUST be fragmented.
-   A fragmented packet has a zero in the last four bits of the payload
-   header.  The first fragment will set the Fragment type to 1.  Each
-   fragment after the first will set the Fragment type to 2 in the
-   payload header.  The RTP packet containing the last fragment of the
-   Vorbis packet will have the Fragment type set to 3.  To maintain the
-   correct sequence for fragmented packet reception the timestamp field
-   of fragmented packets MUST be the same as the first packet sent, with
-   the sequence number incremented as normal for the subsequent RTP
-   packets.
+   If a Vorbis packet, not only data but also Configuration and Comment,
+   is larger than 65535 octets it MUST be fragmented.  A fragmented
+   packet has a zero in the last four bits of the payload header.  The
+   first fragment will set the Fragment type to 1.  Each fragment after
+   the first will set the Fragment type to 2 in the payload header.  The
+   RTP packet containing the last fragment of the Vorbis packet will
+   have the Fragment type set to 3.  To maintain the correct sequence
+   for fragmented packet reception the timestamp field of fragmented
+   packets MUST be the same as the first packet sent, with the sequence
+   number incremented as normal for the subsequent RTP packets.
+
+5.1.  Example Fragmented Vorbis Packet
+
+   Here is an example fragmented Vorbis packet split over three RTP
+   packets.  Each packet contains the standard RTP headers as well as
+   the 4 octet Vorbis headers.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 
 
@@ -729,12 +730,6 @@ Barbato                  Expires April 18, 2006                [Page 13]
 Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
 
 
-5.1.  Example Fragmented Vorbis Packet
-
-   Here is an example fragmented Vorbis packet split over three RTP
-   packets.  Each packet contains the standard RTP headers as well as
-   the 4 octet Vorbis headers.
-
       Packet 1:
 
        0                   1                   2                   3
@@ -750,7 +745,7 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
       |                              ...                              |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
-      |                      Ident                    | 1 | 0 |      0|
+      |                       Ident                   | 1 | 0 |      0|
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       |             length            |            vorbis data       ..
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -780,6 +775,12 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
 
 
 
+
+
+
+
+
+
 Barbato                  Expires April 18, 2006                [Page 14]
 \f
 Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
@@ -917,8 +918,9 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
    Optional Parameters:
 
    configuration-uri: the URI of the configuration headers in case of
-   out of band transmission.  In the form of
-   proto://path/to/resource/Ident
+   out of band transmission.  In the form of proto://path/to/resource/
+   Depending on the specific method the single ident packet could be
+   retrived by their number, or aggregated in a single stream.
 
    Encoding considerations:
 
@@ -947,7 +949,6 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
 
 
 
-
 Barbato                  Expires April 18, 2006                [Page 17]
 \f
 Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
@@ -1012,14 +1013,14 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
       a=delivery:out_band/http
       a=fmtp:98 delivery-method:inline,out_band/http;
       configuration=base16string1;
-      configuration-uri=http://path/to/the/resource/159
+      configuration-uri=http://path/to/the/resource
 
    Note that the payload format (encoding) names are commonly shown in
    upper case.  MIME subtypes are commonly shown in lower case.  These
    names are case-insensitive in both places.  Similarly, parameter
    names are case-insensitive both in MIME types and in the default
    mapping to the SDP a=fmtp attribute.  The exception regarding case
-   sensitivity is the configuration header URL which MUST be regarded as
+   sensitivity is the configuration-uri URI which MUST be regarded as
    being case sensitive.
 
    The answer to any offer, [8], MUST NOT change the URI specified in
@@ -1070,9 +1071,9 @@ Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
    Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro,
    Jack Moffitt, Christopher Montgomery, Colin Perkins, Barry Short,
    Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David
-   Barrett, Politecnico di Torino (LS)^3/IMG Group in particular
-   Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De
-   Martin.
+   Barrett, Silvia Pfeiffer, Politecnico di Torino (LS)^3/IMG Group in
+   particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini,
+   Juan Carlos De Martin.
 
 
 10.  References
@@ -1286,3 +1287,4 @@ Acknowledgment
 
 Barbato                  Expires April 18, 2006                [Page 23]
 \f
+
index 07e8a66..ee781d7 100644 (file)
@@ -242,8 +242,7 @@ Raw Vorbis packets are unbounded in length currently, although at some future po
 </figure>
 
 <t>
-Each Vorbis payload packet starts with a two octet length header, which is used to represent the size of the following 
-data payload, followed by the raw Vorbis data.
+Each Vorbis payload packet starts with a two octet length header, which is used to represent the size of the following data payload, followed by the raw Vorbis data.
 </t>
 
 <t>
@@ -508,13 +507,6 @@ Intended usage: COMMON
 </section>
 </section>
 
-<section anchor="Configuration Caching" title="Configuration Caching"> 
-
-<t>
-Configuration caching allows clients that have previously connected to a stream to re-use the associated configuration data. When a client receives a Packed Configuration packet it may store it locally and can compare the Ident key with that of the new stream and begin decoding before it has received any of the headers.
-</t>
-
-</section>
 
 <section anchor="Loss of Configuration Headers" title="Loss of Configuration Headers"> 
 
@@ -542,7 +534,7 @@ The mapping between the stream and the the configuration is explicit.
 <section anchor="Comment Headers" title="Comment Headers">
 
 <t>
-With the payload type flag set to 2, this indicates that the packet contain the comment metadata, such as artist name, track title and so on. These metadata messages are not intended to be fully descriptive but to offer basic track/song information. This packet SHOULD NOT be sent and clients MAY ignore it completely. During a session the Details on the format of the comments can be found in the <xref target="vorbis-spec-ref">Vorbis documentation</xref>.
+With the payload type flag set to 2, this indicates that the packet contain the comment metadata, such as artist name, track title and so on. These metadata messages are not intended to be fully descriptive but to offer basic track/song information. This packet SHOULD NOT be sent and clients MAY ignore it completely. The details on the format of the comments can be found in the <xref target="vorbis-spec-ref">Vorbis documentation</xref>.
 </t>
 <figure anchor="Comment Packet Figure" title="Comment Packet">
 <artwork><![CDATA[
@@ -584,14 +576,13 @@ Any Vorbis data packet that is less than path MTU SHOULD be bundled in the RTP p
 </t>
 
 <t>
-If a Vorbis packet is larger than 65535 octets it MUST be fragmented.  A fragmented packet has a zero in the last four bits of the payload header. The first fragment will set the Fragment type to 1. Each fragment after the first will set the Fragment type to 2 in the payload header.  The RTP packet containing the last fragment of the Vorbis packet will have the Fragment type set to 3.  To maintain the correct sequence for fragmented packet reception the timestamp field of fragmented packets MUST be the same as the first packet sent, with the sequence number incremented as normal for the subsequent RTP packets.
+If a Vorbis packet, not only data but also Configuration and Comment, is larger than 65535 octets it MUST be fragmented. A fragmented packet has a zero in the last four bits of the payload header. The first fragment will set the Fragment type to 1. Each fragment after the first will set the Fragment type to 2 in the payload header.  The RTP packet containing the last fragment of the Vorbis packet will have the Fragment type set to 3.  To maintain the correct sequence for fragmented packet reception the timestamp field of fragmented packets MUST be the same as the first packet sent, with the sequence number incremented as normal for the subsequent RTP packets.
 </t>
 
 <section anchor="Example Fragmented Vorbis Packet" title="Example Fragmented Vorbis Packet">
 
 <t>
-Here is an example fragmented Vorbis packet split over three RTP packets.  Each packet contains the standard RTP headers as 
-well as the 4 octet Vorbis headers.
+Here is an example fragmented Vorbis packet split over three RTP packets.  Each packet contains the standard RTP headers as well as the 4 octet Vorbis headers.
 </t>
 
 <figure anchor="Example Fragmented Packet (Packet 1)" title="Example Fragmented Packet (Packet 1)">
@@ -611,7 +602,7 @@ well as the 4 octet Vorbis headers.
    |                              ...                              |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
-   |                      Ident                    | 1 | 0 |      0|
+   |                       Ident                   | 1 | 0 |      0|
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |             length            |            vorbis data       ..
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -722,7 +713,7 @@ configuration: the <xref target="rfc3548">base16</xref> (hexadecimal) representa
 
 <t>
 Optional Parameters: </t><t>
-configuration-uri: the URI of the configuration headers in case of out of band transmission. In the form of proto://path/to/resource/Ident
+configuration-uri: the URI of the configuration headers in case of out of band transmission. In the form of proto://path/to/resource/ Depending on the specific method the single ident packet could be retrived by their number, or aggregated in a single stream.
 </t>
 
 <t>
@@ -812,14 +803,11 @@ The port value is specified by the server application bound to the address speci
 <t>m=audio  RTP/AVP 98</t>
 <t>a=rtpmap:98 VORBIS/44100/2</t>
 <t>a=delivery:out_band/http</t>
-<t>a=fmtp:98 delivery-method:inline,out_band/http; configuration=base16string1; configuration-uri=http://path/to/the/resource/159</t>
+<t>a=fmtp:98 delivery-method:inline,out_band/http; configuration=base16string1; configuration-uri=http://path/to/the/resource</t>
 </list>
 
 <t>
-Note that the payload format (encoding) names are commonly shown in upper case.  MIME subtypes are commonly shown in lower 
-case.  These names are case-insensitive in both places.  Similarly, parameter names are case-insensitive both in MIME types and 
-in the default mapping to the SDP a=fmtp attribute.  The exception regarding case sensitivity is the configuration header URL 
-which MUST be regarded as being case sensitive.
+Note that the payload format (encoding) names are commonly shown in upper case.  MIME subtypes are commonly shown in lower case. These names are case-insensitive in both places.  Similarly, parameter names are case-insensitive both in MIME types and in the default mapping to the SDP a=fmtp attribute.  The exception regarding case sensitivity is the configuration-uri URI which MUST be regarded as being case sensitive.
 </t>
 
 <t>
@@ -862,7 +850,7 @@ This document is a continuation of draft-moffitt-vorbis-rtp-00.txt and draft-ker
 </t>
 
 <t>
-Thanks to the AVT, Ogg Vorbis Communities / Xiph.org including Steve Casner, Aaron Colwell, Ross Finlayson, Fluendo, Ramon Garcia, Pascal Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro, Jack Moffitt, Christopher Montgomery,  Colin Perkins, Barry Short, Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David Barrett, Politecnico di Torino (LS)³/IMG Group in particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De Martin.
+Thanks to the AVT, Ogg Vorbis Communities / Xiph.org including Steve Casner, Aaron Colwell, Ross Finlayson, Fluendo, Ramon Garcia, Pascal Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro, Jack Moffitt, Christopher Montgomery,  Colin Perkins, Barry Short, Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David Barrett, Silvia Pfeiffer, Politecnico di Torino (LS)³/IMG Group in particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De Martin.
 </t>
 
 </section>