[Gnash-commit] gnash/doc/C Makefile.am appendix.xml gnash.xml ...

[Rob Savoye]

CVSROOT:        /sources/gnash
Module name:    gnash
Changes by:     Rob Savoye <rsavoye>    06/08/14 23:44:07

Modified files:
        doc/C          : Makefile.am appendix.xml gnash.xml sources.xml 
Added files:
        doc/C          : rtmp.xml 
        doc/C/images   : rtmp.dia rtmp.png 

Log message:
        Add RTMP chapter with graphic.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/Makefile.am?cvsroot=gnash&r1=1.27&r2=1.28
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/appendix.xml?cvsroot=gnash&r1=1.6&r2=1.7
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/gnash.xml?cvsroot=gnash&r1=1.22&r2=1.23
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/sources.xml?cvsroot=gnash&r1=1.11&r2=1.12
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/rtmp.xml?cvsroot=gnash&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/images/rtmp.dia?cvsroot=gnash&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/images/rtmp.png?cvsroot=gnash&rev=1.1

Patches:
Index: Makefile.am
===================================================================
RCS file: /sources/gnash/gnash/doc/C/Makefile.am,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
--- Makefile.am 18 May 2006 07:40:21 -0000      1.27
+++ Makefile.am 14 Aug 2006 23:44:06 -0000      1.28
@@ -79,6 +79,7 @@
        object.xml              \
        opcodes.xml             \
        plugin.xml              \
+       rtmp.xml \
        selection.xml           \
        sharedobject.xml        \
        sound.xml               \

Index: appendix.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/appendix.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- appendix.xml        22 Apr 2006 03:12:08 -0000      1.6
+++ appendix.xml        14 Aug 2006 23:44:06 -0000      1.7
@@ -121,6 +121,7 @@
     </para>
   </sect2>
 
+  &rtmp;
   &amf;
 
 <!--

Index: gnash.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/gnash.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -b -r1.22 -r1.23
--- gnash.xml   27 Jul 2006 12:19:34 -0000      1.22
+++ gnash.xml   14 Aug 2006 23:44:07 -0000      1.23
@@ -52,6 +52,7 @@
   <!ENTITY plugin SYSTEM "plugin.xml">
   <!ENTITY logging SYSTEM "logging.xml">
   <!ENTITY opcodes SYSTEM "opcodes.xml">
+  <!ENTITY rtmp SYSTEM "rtmp.xml">
  ]
 >
 

Index: sources.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/sources.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -b -r1.11 -r1.12
--- sources.xml 11 May 2006 16:56:45 -0000      1.11
+++ sources.xml 14 Aug 2006 23:44:07 -0000      1.12
@@ -98,7 +98,7 @@
       </para>
     </sect3>
 
-    <sect3 id="gstreamer">
+    <sect3 id="gstreamer-dep">
       <title>Gstreamer</title>
       <para>
        Gstreamer will be used for sound and video support in the near

Index: rtmp.xml
===================================================================
RCS file: rtmp.xml
diff -N rtmp.xml
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ rtmp.xml    14 Aug 2006 23:44:07 -0000      1.1
@@ -0,0 +1,57 @@
+<sect2 id="rtmp">
+  <title>RTMP Protocol</title>
+  
+  <para>
+    The Real Time Messaging Protocol was created by MacroMedia (now
+    Adobe) for delivering Flash objects and video over a network
+    connection. Currently the only servers that support this format
+    are the MacroMedia Media sever, and the Open Source Red5 project.
+  </para>
+
+  <para>
+    This is a simple protocol, optimized for poor bandwidth
+    connections. It can support up to 64 concurrent streams over the
+    same network connection. Part of each AMF packet header contains
+    the index number of the stream.
+  </para>
+
+  <para>
+    An RTMP connection uses Tcp/ip port 1935. It is also possible to
+    tunnel RTMP over an HTTP connection using port 80.
+  </para>
+
+  <para>
+    The basics of the RTMP protocol are as follows. All communications
+    are initiated by the client.
+  </para>
+  <mediaobject>
+    <imageobject>
+      <imagedata align="center" fileref="images/rtmp.png"/>
+    </imageobject>
+  </mediaobject>
+
+  <para>
+    The client starts the RTMP connection by sending a single byte
+    with a value of 0x3. This byte is followed by a data block of 1536
+    bytes. The format if this data block is unknown, but it appears to
+    not be actually used by the protocol except as a handshake.
+  </para>
+
+  <para>
+    The server receives this packet, stores the 1536 byte data block,
+    and then send a single byte with the value of 0x3, followed by two
+    1536 data blocks. The second data block is the full contents of
+    the original data block as sent by the client.
+  </para>
+
+  <para>
+    The client receives the 1536 byte data block, and if they match,
+    the connection is established.
+  </para>
+
+  <para>
+    The first AMF packet sent to the server contains the connect 
+  </para>
+
+</sect2>
+  

Index: images/rtmp.dia
===================================================================
RCS file: images/rtmp.dia
diff -N images/rtmp.dia
Binary files /dev/null and /tmp/cvs1iX2in differ

Index: images/rtmp.png
===================================================================
RCS file: images/rtmp.png
diff -N images/rtmp.png
Binary files /dev/null and /tmp/cvs41gW2n differ