[xiph-commits] r14176 - trunk/vorbis/doc

lu_zero at svn.xiph.org lu_zero at svn.xiph.org
Sat Nov 17 10:42:30 PST 2007


Author: lu_zero
Date: 2007-11-17 10:42:30 -0800 (Sat, 17 Nov 2007)
New Revision: 14176

Modified:
   trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-08.txt
Log:
Update text version

Modified: trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-08.txt
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-08.txt	2007-11-17 18:11:23 UTC (rev 14175)
+++ trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-08.txt	2007-11-17 18:42:30 UTC (rev 14176)
@@ -88,14 +88,13 @@
      7.1.  Mapping Media Type Parameters into SDP . . . . . . . . . . 20
        7.1.1.  SDP Example  . . . . . . . . . . . . . . . . . . . . . 21
      7.2.  Usage with the SDP Offer/Answer Model  . . . . . . . . . . 21
-   8.  Congestion Control . . . . . . . . . . . . . . . . . . . . . . 21
-   9.  Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
-     9.1.  Stream Radio . . . . . . . . . . . . . . . . . . . . . . . 22
-   10. Security Considerations  . . . . . . . . . . . . . . . . . . . 22
-   11. Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . 23
-   12. References . . . . . . . . . . . . . . . . . . . . . . . . . . 23
-     12.1. Normative References . . . . . . . . . . . . . . . . . . . 23
-     12.2. Informative References . . . . . . . . . . . . . . . . . . 24
+   8.  Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
+     8.1.  Stream Radio . . . . . . . . . . . . . . . . . . . . . . . 22
+   9.  Security Considerations  . . . . . . . . . . . . . . . . . . . 22
+   10. Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . 23
+   11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 23
+     11.1. Normative References . . . . . . . . . . . . . . . . . . . 23
+     11.2. Informative References . . . . . . . . . . . . . . . . . . 24
    Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 24
    Intellectual Property and Copyright Statements . . . . . . . . . . 25
 
@@ -108,6 +107,7 @@
 
 
 
+
 Barbato                  Expires April 30, 2008                 [Page 2]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
@@ -454,7 +454,8 @@
    The Packed Configuration (Section 3.1.1) Payload is sent in-band with
    the packet type bits set to match the Vorbis Data Type.  Clients MUST
    be capable of dealing with fragmentation and periodic re-transmission
-   of [14] the configuration headers.
+   of [14] the configuration headers.  The RTP timestamp value MUST
+   reflect the transmission time of the next data packet.
 
 3.1.1.  Packed Configuration
 
@@ -499,7 +500,6 @@
 
 
 
-
 Barbato                  Expires April 30, 2008                 [Page 9]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
@@ -650,13 +650,12 @@
 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
-   successfully decode the stream.
+   header lead to a situation where it will not be possible to
+   successfully decode the stream.  Implementations MAY try to recover
+   from error requesting again the missing Configuration, the baseline
+   reaction SHOULD be either reset or end the connection.
 
-   Loss of Configuration Packets results in the halting of stream
-   decoding.
 
-
 4.  Comment Headers
 
    With the Vorbis Data Type flag set to 2, this indicates that the
@@ -668,6 +667,7 @@
 
 
 
+
 Barbato                  Expires April 30, 2008                [Page 12]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
@@ -716,11 +716,11 @@
    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 payload 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
+   payload header.  The consecutive fragments MUST be sent without any
+   other payloads being sent between the first and the last fragment.
+   The RTP payload 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
 
 
 
@@ -729,7 +729,10 @@
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
 
 
-   payloads.  The length field shows the fragment length.
+   fragmented packets MUST be the same as the first packet sent, with
+   the sequence number incremented as normal for the subsequent RTP
+   payloads, this will affect the RTCP jitter measurement.  The length
+   field shows the fragment length.
 
 5.1.  Example Fragmented Vorbis Packet
 
@@ -777,9 +780,6 @@
 
 
 
-
-
-
 Barbato                  Expires April 30, 2008                [Page 14]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
@@ -914,8 +914,9 @@
          Control. [3]
 
       delivery-method:  indicates the delivery methods in use, the
-         possible values are: inline, in_band, out_band, MAY be included
-         multiple times
+         possible values are: inline, in_band, out_band.  The parameter
+         MAY be included multiple time, followed by the configuration or
+         configuration-uri parameter associated.
 
       configuration:  the base64 [9] representation of the Packed
          Headers (Section 3.2.1).  It MUST follow the associated
@@ -947,7 +948,6 @@
 
 
 
-
 Barbato                  Expires April 30, 2008                [Page 17]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
@@ -994,8 +994,8 @@
 
 6.1.  Packed Headers IANA Considerations
 
-   The following IANA considerations MUST only be applied to the packed
-   headers.
+   The following IANA considerations MUST only be applied to the Packed
+   Headers (Section 3.2.1).
 
 
 
@@ -1163,32 +1163,22 @@
    parameters MUST not be altered on answer otherwise.
 
 
-8.  Congestion Control
+8.  Examples
 
-   Vorbis clients SHOULD send regular receiver reports detailing
-   congestion.  A mechanism for dynamically downgrading the stream,
-   known as bitrate peeling, will allow for a graceful backing off of
-   the stream bitrate.  This feature is not available at present so an
+   The following examples are common usage patterns that MAY be applied
+   in such situations, the main scope of this section is to explain
+   better usage of the transmission vectors.
 
 
 
+
 Barbato                  Expires April 30, 2008                [Page 21]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
 
 
-   alternative would be to redirect the client to a lower bitrate stream
-   if one is available.
+8.1.  Stream Radio
 
-
-9.  Examples
-
-   The following examples are common usage patterns that MAY be applied
-   in such situations, the main scope of this section is to explain
-   better usage of the transmission vectors.
-
-9.1.  Stream Radio
-
    This is one of the most common situation: one single server streaming
    content in multicast, the clients may start a session at random time.
    The content itself could be a mix of live stream, as the webjockey's
@@ -1221,29 +1211,30 @@
    already known.
 
 
-10.  Security Considerations
+9.  Security Considerations
 
    RTP packets using this payload format are subject to the security
-   considerations discussed in the RTP specification [2].  This implies
+   considerations discussed in the RTP specification [2], the base64
+   specification [9] and the URI Generic syntax specification [4].
+   Among other considerations, this implies that the confidentiality of
+   the media stream is archieved by using encryption.  Because the data
+   compression used with this payload format is applied end-to-end,
+   encryption may be performed on the compressed data.  Additional care
+   MAY be needed for delivery methods that point to external resources,
+   using secure protocols to fetch the configuration payloads.  Where
+   the size of a data block is set, care MUST be taken to prevent buffer
+   overflows in the client applications.
 
 
 
+
 Barbato                  Expires April 30, 2008                [Page 22]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
 
 
-   that the confidentiality of the media stream is archieved by using
-   encryption.  Because the data compression used with this payload
-   format is applied end-to-end, encryption may be performed on the
-   compressed data.  Additional care MAY be needed for delivery methods
-   that point to external resources, using secure protocols to fetch the
-   configuration payloads.  Where the size of a data block is set, care
-   MUST be taken to prevent buffer overflows in the client applications.
+10.  Acknowledgments
 
-
-11.  Acknowledgments
-
    This document is a continuation of draft-moffitt-vorbis-rtp-00.txt
    and draft-kerr-avt-vorbis-rtp-04.txt.  The Media Type declaration is
    a continuation of draft-short-avt-rtp-vorbis-mime-00.txt.
@@ -1259,9 +1250,9 @@
    Carlos De Martin.
 
 
-12.  References
+11.  References
 
-12.1.  Normative References
+11.1.  Normative References
 
    [1]   Bradner, S., "Key words for use in RFCs to Indicate Requirement
          Levels", RFC 2119.
@@ -1282,13 +1273,6 @@
    [6]   Mogul, J. and S. Deering, "Path MTU discovery", RFC 1191,
          November 1990.
 
-
-
-Barbato                  Expires April 30, 2008                [Page 23]
-
-Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
-
-
    [7]   McCann et al., J., "Path MTU Discovery for IP version 6",
          RFC 1981.
 
@@ -1298,16 +1282,24 @@
    [9]   Josefsson, S., "The Base16, Base32, and Base64 Data Encodings",
          RFC 3548.
 
+
+
+Barbato                  Expires April 30, 2008                [Page 23]
+
+Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007
+
+
    [10]  "Ogg Vorbis I specification:  Codec setup and packet decode.
-         Available from the Xiph website, http://www.xiph.org".
+         Available from the Xiph website,
+         http://xiph.org/vorbis/doc/Vorbis_I_spec.html".
 
-12.2.  Informative References
+11.2.  Informative References
 
    [11]  Pfeiffer, S., "The Ogg Encapsulation Format Version 0",
          RFC 3533.
 
-   [12]  "libvorbis: Available from the Xiph website,
-         http://www.xiph.org".
+   [12]  "libvorbis: Available from the dedicated website,
+         http://www.vorbis.com".
 
    [13]  Friedman, T., Caceres, R., and A. Clark, "RTP Control Protocol
          Extended Reports (RTCP XR)", RFC 3611, November 2003.
@@ -1340,6 +1332,14 @@
 
 
 
+
+
+
+
+
+
+
+
 Barbato                  Expires April 30, 2008                [Page 24]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-08              Oct 2007



More information about the commits mailing list