From: Travis Cross <tc@traviscross.com>
Date: Wed, 28 May 2014 17:03:46 +0000 (+0000)
Subject: Document the length limit of fifo_outbound_uuid
X-Git-Tag: v1.4.5~2^2~11
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a976badec7257a904bb77353af085cedc8c78fbe;p=thirdparty%2Ffreeswitch.git

Document the length limit of fifo_outbound_uuid

Ask me sometime how I was "reminded" of this.
---

diff --git a/src/mod/applications/mod_fifo/mod_fifo.c b/src/mod/applications/mod_fifo/mod_fifo.c
index 48b02422aa..b8ae5433cd 100644
--- a/src/mod/applications/mod_fifo/mod_fifo.c
+++ b/src/mod/applications/mod_fifo/mod_fifo.c
@@ -86,9 +86,12 @@ SWITCH_MODULE_DEFINITION(mod_fifo, mod_fifo_load, mod_fifo_shutdown, NULL);
  * from receiving a call from the fifo system.  We do this by tracking
  * non-fifo calls in a special fifo named `manual_calls`.  When
  * creating a channel for an agent we set the channel variable
- * `fifo_outbound_uuid` to an arbitrary unique value for that agent,
- * then call `fifo_track_call`.  For the corresponding member we must
- * also set `{fifo_outbound_uuid=}` to the same value.
+ * `fifo_outbound_uuid` to an arbitrary unique value <= 32 characters
+ * for that agent, then call `fifo_track_call`.  For the corresponding
+ * member we must also set `{fifo_outbound_uuid=}` to the same value.
+ * We expect the value of `fifo_outbound_uuid` to be the MD5 hash of
+ * the unique ID.  Values longer than 32 characters will cause the
+ * mechanism to fail to work as expected.
  *
  * ## Importance
  *