Allow multiple codecs to be printed in debug (bug #989)

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@3011 65c4cc65-6c06-0410-ace0-fbb531ad65f3

1 files changed, 14 insertions, 4 deletions

diff --git a/include/asterisk/frame.h b/include/asterisk/frame.h
index 0bec024bb..3f9964621 100755
--- a/include/asterisk/frame.h
+++ b/include/asterisk/frame.h
@@ -319,15 +319,25 @@ int ast_fr_fdwrite(int fd, struct ast_frame *frame);
  */
 int ast_fr_fdhangup(int fd);
 
-//! Get a format from a name
+//! Get the name of a format
 /*!
  * \param format id of format
- * Gets the name of a format.
- * This returns the name of the format in a sttring or UNKN if unknown.
+ * \return A static string containing the name of the format or "UNKN" if unknown.
  */
-//! Get the name of a format
 extern char* ast_getformatname(int format);
 
+//! Get the names of a set of formats
+/*!
+ * \param buf a buffer for the output string
+ * \param n size of buf (bytes)
+ * \param format the format (combined IDs of codecs)
+ * Prints a list of readable codec names corresponding to "format".
+ * ex: for format=AST_FORMAT_GSM|AST_FORMAT_SPEEX|AST_FORMAT_ILBC it will return "0x602(GSM|SPEEX|ILBC)"
+ * \return The return value is buf.
+ */
+extern char* ast_getformatname_multiple(char *buf, unsigned n, int format);
+
+
 /*!
  * \param name string of format
  * Gets a format from a name.