[asterisk-commits] mmichelson: branch 1.6.0 r176698 - in /branches/1.6.0: ./ include/asterisk/

[SVN commits to the Asterisk project]

Author: mmichelson
Date: Tue Feb 17 15:40:40 2009
New Revision: 176698

URL: http://svn.digium.com/svn-view/asterisk?view=rev&rev=176698
Log:
Merged revisions 176697 via svnmerge from 
https://origsvn.digium.com/svn/asterisk/trunk

........
  r176697 | mmichelson | 2009-02-17 15:40:09 -0600 (Tue, 17 Feb 2009) | 3 lines
  
  Clear up documentation of AST_FRIENDLY_OFFSET in frame.h
........

Modified:
    branches/1.6.0/   (props changed)
    branches/1.6.0/include/asterisk/frame.h

Propchange: branches/1.6.0/
------------------------------------------------------------------------------
Binary property 'trunk-merged' - no diff available.

Modified: branches/1.6.0/include/asterisk/frame.h
URL: http://svn.digium.com/svn-view/asterisk/branches/1.6.0/include/asterisk/frame.h?view=diff&rev=176698&r1=176697&r2=176698
==============================================================================
--- branches/1.6.0/include/asterisk/frame.h (original)
+++ branches/1.6.0/include/asterisk/frame.h Tue Feb 17 15:40:40 2009
@@ -194,9 +194,17 @@
     for this purpose instead of having to declare one on the stack */
 extern struct ast_frame ast_null_frame;
 
-#define AST_FRIENDLY_OFFSET 	64	/*! It's polite for a a new frame to
-					  have this number of bytes for additional
-					  headers.  */
+/*! \brief Offset into a frame's data buffer.
+ *
+ * By providing some "empty" space prior to the actual data of an ast_frame,
+ * this gives any consumer of the frame ample space to prepend other necessary
+ * information without having to create a new buffer.
+ *
+ * As an example, RTP can use the data from an ast_frame and simply prepend the
+ * RTP header information into the space provided by AST_FRIENDLY_OFFSET instead
+ * of having to create a new buffer with the necessary space allocated.
+ */
+#define AST_FRIENDLY_OFFSET 	64	
 #define AST_MIN_OFFSET 		32	/*! Make sure we keep at least this much handy */
 
 /*! Need the header be free'd? */