<br>This is a near accurate description but there are 2 things i noticed:<br><br><br>1) the reply is allowed to contain any headers not just the ones listed, the unicast command for instance has Socket-Mode and Control headers in addition to the Content-Type: command/reply.&nbsp; The change was just for the sake of the guy who wanted to see the job uuid as a header and it should not violate that rule.<br>
<br>2) There cannot actually be more than one Content-Length, what you are actually seeing is an event inside the packet that in turn has it&#39;s own payload.<br><br><br>What I do when I make a parser for the protocol is read 1 packet by reading all the headers until i see 2 CR then i make a hash out of all of the headers and see if any of them was &quot;Content-Type&quot;.&nbsp; If so I read that many bytes of body being sure to do careful code to actually make sure I read the whole body.&nbsp; So if I was told the content-length was 356 bytes and my read of 356 only yielded 300 bytes i would continue to try to read 56 bytes untill I had accumulated exactly 356.&nbsp; <br>
<br>This should be the only main rule about the protocol, what you describe about the possible replies is all accurate but it should not be considered in the parsing of the packet apart from Content-Length.<br><br>In the case of an event, then the payload will be an entire serialized event, xml or plain text depending on preference.<br>
<br>Thanks for putting this together it&#39;s looking good.<br><br><br><br><div class="gmail_quote">On Fri, Jun 6, 2008 at 1:55 PM, UV &lt;<a href="mailto:uv@talknet.com.au">uv@talknet.com.au</a>&gt; wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">










<div link="blue" vlink="blue" lang="EN-US">

<div>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Before this last change, the event_socket
responses were structured in a manner that could have been generalized as
follows:</span></font></p>

<p style="margin-left: 18pt; text-indent: -18pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span>1.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">Command responses will
always have the following structure:</span></font></span></p>

<p style="margin-left: 18pt;"><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Type: &lt;auth/request
| command/reply | api/response | text/event-xml | log/data&gt;&lt;LF&gt;</span></font></p>

<p style="margin-left: 18pt;"><font face="Courier New" size="1"><span style="font-size: 6pt;">[Reply-Text: &lt;+OK | -ERR&gt;
&lt;info payload&gt;&lt;LF&gt;]</span></font></p>

<p style="margin-left: 18pt;"><font face="Courier New" size="1"><span style="font-size: 6pt;">[Content-Length: &lt;info payload
length&gt;&lt;LF&gt;]</span></font></p>

<p style="margin-left: 18pt;"><font face="Courier New" size="1"><span style="font-size: 6pt;">&lt;LF&gt;</span></font></p>

<p style="margin-left: 18pt;"><font face="Courier New" size="1"><span style="font-size: 6pt;">[&lt;info payload&gt;&lt;LF&gt;]</span></font></p>

<p style="margin-left: 18pt; text-indent: -18pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span>2.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">If </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Length</span></font><font size="2"><span style="font-size: 10pt;"> is defined, then there's an
additional info payload after the terminating &lt;LF&gt; at the byte length of
&lt;info payload length&gt;. There can be more than one </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Length</span></font><font size="2"><span style="font-size: 10pt;"> in a single event meaning there's
additional payload for this event.</span></font></p>

<p style="margin-left: 18pt; text-indent: -18pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span>3.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">Command response structure
will be determined by the Content-Type:</span></font></span></p>

<ol style="margin-top: 0cm;" start="3" type="1">
 <ol style="margin-top: 0cm;" start="1" type="a">
  <li><font face="Courier New" size="2"><span style="font-size: 10pt;">auth/request</span></font></li>
 </ol>
</ol>

<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>i.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">This response is self initiated upon creation of an
event_socket connection and will expect only an </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">auth</span></font><font size="2"><span style="font-size: 10pt;"> command to follow.</span></font></p>


<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>ii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">Will only have </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Type</span></font><font size="2"><span style="font-size: 10pt;"> field and will be waiting for
authentication for 1 (?) minute</span></font></p>

<ol style="margin-top: 0cm;" start="3" type="1">
 <ol style="margin-top: 0cm;" start="2" type="a">
  <li><font face="Courier New" size="2"><span style="font-size: 10pt;">command/reply</span></font></li>
 </ol>
</ol>

<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>i.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">This response will follow the </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">bgapi</span></font><font size="2"><span style="font-size: 10pt;"> command.</span></font></p>


<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>ii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">The </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Type</span></font><font size="2"><span style="font-size: 10pt;"> field will be before a </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">Reply-Text</span></font><font size="2"><span style="font-size: 10pt;"> field that will appear with </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">+OK</span></font><font size="2"><span style="font-size: 10pt;"> or </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">–ERR</span></font><font size="2"><span style="font-size: 10pt;"> response</span></font></p>


<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>iii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">When that job ended (in a request), a "</span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">Job-UUID:</span></font><font size="2"><span style="font-size: 10pt;">" label will appear in the </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">BACKGROUND_JOB</span></font><font size="2"><span style="font-size: 10pt;"> event. That event's </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">+OK
&lt;uuid&gt;</span></font><font size="2"><span style="font-size: 10pt;"> will
correspond with all session's events </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">Unique-ID:
&lt;uuid&gt;</span></font><font size="2"><span style="font-size: 10pt;">.</span></font></p>

<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>iv.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">All following events concerning this session will have
that same </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">Unique-ID</span></font><font size="2"><span style="font-size: 10pt;"></span></font></p>

<ol style="margin-top: 0cm;" start="3" type="1">
 <ol style="margin-top: 0cm;" start="3" type="a">
  <li><font face="Courier New" size="2"><span style="font-size: 10pt;">api/response</span></font></li>
 </ol>
</ol>

<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>i.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">All Event_socket commands (except </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">bgapi</span></font><font size="2"><span style="font-size: 10pt;">) will be immediately answered by this
response before any other response.</span></font></p>

<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>ii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">A </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Type</span></font><font size="2"><span style="font-size: 10pt;"> first</span></font></p>


<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>iii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Length</span></font></span><font size="2"><span style="font-size: 10pt;"> second</span></font></p>


<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>iv.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">The info-payload will include the information</span></font></span></p>

<ol style="margin-top: 0cm;" start="3" type="1">
 <ol style="margin-top: 0cm;" start="4" type="a">
  <li><font face="Courier New" size="2"><span style="font-size: 10pt;">text/event-xml</span></font></li>
 </ol>
</ol>

<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>i.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">This response is for system-initiated events.</span></font></span></p>

<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>ii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">The </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Length</span></font><font size="2"><span style="font-size: 10pt;"> field will appear first, then the </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Type</span></font><font size="2"><span style="font-size: 10pt;"> field.</span></font></p>


<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>iii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">The XML/Text will appear in the info-payload data.</span></font></span></p>

<ol style="margin-top: 0cm;" start="3" type="1">
 <ol style="margin-top: 0cm;" start="5" type="a">
  <li><font face="Courier New" size="2"><span style="font-size: 10pt;">log/data</span></font></li>
 </ol>
</ol>

<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>i.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">Once an Event_socket is subscribed for </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">log</span></font><font size="2"><span style="font-size: 10pt;"> information, this response will be it.</span></font></p>


<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>ii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">The </span></font></span><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Type</span></font><font size="2"><span style="font-size: 10pt;"> field will appear first, then the </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">Content-Length</span></font><font size="2"><span style="font-size: 10pt;"> field.</span></font></p>


<p style="margin-left: 108pt; text-indent: -108pt;"><font face="Times New Roman" size="2"><span style="font-size: 10pt;"><span><font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font>iii.<font face="Times New Roman" size="1"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></font></span></span></font><span dir="ltr"><font size="2"><span style="font-size: 10pt;">The log info will appear in the info-payload data as
plain text</span></font></span></p>

<p><font face="Times New Roman" size="2"><span style="font-size: 10pt;">&nbsp;</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">This last change invites an exception for
the </span></font><font face="Courier New" size="1"><span style="font-size: 6pt;">[Reply-Text: &lt;+OK | -ERR&gt; &lt;info payload&gt;&lt;LF&gt;]</span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"> policy in a way that requires more parsing rules.</span></font></p>


<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">To preserve consistency, I would recommend
these alternatives:</span></font></p>

<ol style="margin-top: 0cm;" start="1" type="1">
 <li style="color: navy;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;">Not
     make that change (I think it's too late for that)</span></font></li>
 <li style="color: navy;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;">Make
     that change for all Reply-Text responses in a way that after the &lt;+OK |
     -ERR&gt; there's always a &lt;LF&gt;</span></font></li>
 <li style="color: navy;"><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial;">Keep
     it as an exception and live with it</span></font></li>
</ol>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Although this change breaks our
implementation, we'd be happy to change it once there's a decision
regardless of what it is.</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Disclaimer:</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">The info here is an extract from our _*INTERNAL*_DOCUMENTATION_
representing our limited knowledge, experience and understanding of the complex
FS internals. Once this documentation proves not to be a total BS and of some
true substance, it shall be wikified for the general good.</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">"If there are two ways to take
something I&#39;ve said and one of them hurts your feelings.....I meant the other
one." </span></font><font color="navy" face="Wingdings" size="2"><span style="font-size: 10pt; font-family: Wingdings; color: navy;">J</span></font><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;"></span></font></p>


<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<div>

<div style="text-align: center;" align="center"><font face="Times New Roman" size="3"><span style="font-size: 12pt;">

<hr align="center" size="2" width="100%">

</span></font></div>

<p><b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma; font-weight: bold;">From:</span></font></b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma;"> <a href="mailto:freeswitch-dev-bounces@lists.freeswitch.org" target="_blank">freeswitch-dev-bounces@lists.freeswitch.org</a>
[mailto:<a href="mailto:freeswitch-dev-bounces@lists.freeswitch.org" target="_blank">freeswitch-dev-bounces@lists.freeswitch.org</a>] <b><span style="font-weight: bold;">On Behalf Of </span></b>Anthony Minessale<br>
<b><span style="font-weight: bold;">Sent:</span></b> Saturday, June 07, 2008 2:58
AM<div><div></div><div class="Wj3C7c"><br>
<b><span style="font-weight: bold;">To:</span></b>
<a href="mailto:freeswitch-dev@lists.freeswitch.org" target="_blank">freeswitch-dev@lists.freeswitch.org</a><br>
<b><span style="font-weight: bold;">Subject:</span></b> Re: [Freeswitch-dev]
Could we have Job-UUID in a separate line?</div></div></span></font></p>

</div><div><div></div><div class="Wj3C7c">

<p><font face="Times New Roman" size="3"><span style="font-size: 12pt;">&nbsp;</span></font></p>

<p style="margin-bottom: 12pt;"><font face="Times New Roman" size="3"><span style="font-size: 12pt;">it&#39;s already done.</span></font></p>

<div>

<p><font face="Times New Roman" size="3"><span style="font-size: 12pt;">On Fri, Jun 6, 2008 at 11:22 AM, Michael Collins &lt;<a href="mailto:mcollins@fcnetwork.com" target="_blank">mcollins@fcnetwork.com</a>&gt; wrote:</span></font></p>


<div link="blue" vlink="blue">

<div>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Sounds reasonable to me.&nbsp; Also, since I don&#39;t hear
anyone yelling and screaming about how this change will break their software I
think you&#39;re safe to make the change w/o pissing off anyone.</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">-MC</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<div style="border-style: none none none solid; border-color: -moz-use-text-color -moz-use-text-color -moz-use-text-color blue; border-width: medium medium medium 1.5pt; padding: 0cm 0cm 0cm 4pt;">

<div>

<div style="text-align: center;" align="center"><font face="Times New Roman" size="3"><span style="font-size: 12pt;">

<hr align="center" size="2" width="100%">

</span></font></div>

<p><b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma; font-weight: bold;">From:</span></font></b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma;"> <a href="mailto:freeswitch-dev-bounces@lists.freeswitch.org" target="_blank">freeswitch-dev-bounces@lists.freeswitch.org</a>
[mailto:<a href="mailto:freeswitch-dev-bounces@lists.freeswitch.org" target="_blank">freeswitch-dev-bounces@lists.freeswitch.org</a>] <b><span style="font-weight: bold;">On Behalf Of </span></b>Anthony Minessale<br>
<b><span style="font-weight: bold;">Sent:</span></b> Friday, June 06, 2008 9:14
AM</span></font></p>

<div>

<p><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma;"><br>
<b><span style="font-weight: bold;">To:</span></b> <a href="mailto:freeswitch-dev@lists.freeswitch.org" target="_blank">freeswitch-dev@lists.freeswitch.org</a></span></font></p>

</div>

<p><b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma; font-weight: bold;">Subject:</span></font></b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma;"> Re:
[Freeswitch-dev] Could we have Job-UUID in a separate line?</span></font></p>

</div>

<div>

<div>

<p><font face="Times New Roman" size="3"><span style="font-size: 12pt;">&nbsp;</span></font></p>

<p style="margin-bottom: 12pt;"><font face="Times New Roman" size="3"><span style="font-size: 12pt;">i&#39;ll let both work<br>
it&#39;s own header and part of the text</span></font></p>

<div>

<p><font face="Times New Roman" size="3"><span style="font-size: 12pt;">On Thu,
Jun 5, 2008 at 4:46 PM, Michael Collins &lt;<a href="mailto:mcollins@fcnetwork.com" target="_blank">mcollins@fcnetwork.com</a>&gt;
wrote:</span></font></p>

<div link="blue" vlink="purple">

<div>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">This might qualify as an &quot;interface change&quot; so
before making the switch you should probably ask around and see if anyone has
software that would break if this change were implemented.</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">Johny: also, since it is open source you could always add the
&quot;\n&quot; yourself and recompile. &nbsp;If you haven&#39;t already tried that
you might want to take it for a test drive and see if it really does what you
want it to do.</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">-MC</span></font></p>

<p><font color="navy" face="Arial" size="2"><span style="font-size: 10pt; font-family: Arial; color: navy;">&nbsp;</span></font></p>

<div style="border-style: none none none solid; border-color: -moz-use-text-color -moz-use-text-color -moz-use-text-color blue; border-width: medium medium medium 1.5pt; padding: 0cm 0cm 0cm 4pt;">

<div>

<div style="text-align: center;" align="center"><font face="Times New Roman" size="3"><span style="font-size: 12pt;">

<hr align="center" size="2" width="100%">

</span></font></div>

<p><b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma; font-weight: bold;">From:</span></font></b><font face="Tahoma" size="2"><span style="font-size: 10pt; font-family: Tahoma;"> <a href="mailto:freeswitch-dev-bounces@lists.freeswitch.org" target="_blank">freeswitch-dev-bounces@lists.freeswitch.org</a>
[mailto:<a href="mailto:freeswitch-dev-bounces@lists.freeswitch.org" target="_blank">freeswitch-dev-bounces@lists.freeswitch.org</a>] <b><span style="font-weight: bold;">On Behalf Of </span></b>Johny Kadarisman<br>
<b><span style="font-weight: bold;">Sent:</span></b> Thursday, June 05, 2008 2:38
PM<br>
<b><span style="font-weight: bold;">To:</span></b> <a href="mailto:freeswitch-dev@lists.freeswitch.org" target="_blank">freeswitch-dev@lists.freeswitch.org</a><br>
<b><span style="font-weight: bold;">Subject:</span></b> [Freeswitch-dev] Could we
have Job-UUID in a separate line?</span></font></p>

</div>

<div>

<div>

<p><font face="Times New Roman" size="3"><span style="font-size: 12pt;">&nbsp;</span></font></p>

<p style="margin-bottom: 12pt;"><font face="Times New Roman" size="3"><span style="font-size: 12pt;">Could we have Job-UUID as a separate fields. It can be
parse easily, but its event easier to have it just like others response fields.<br>
<br>
so in bgapi reply, we will get:<br>
<br>
Content-Type: command/reply<br>
Reply-Text: +OK <br>
Job-UUID: e0d64b14-3327-11dd-96f6-6fa9e94f364f<br>
<br>
<br>
Johny K.</span></font></p>

</div>

</div>

</div>

</div>

</div>

<p style="margin-bottom: 12pt;"><font face="Times New Roman" size="3"><span style="font-size: 12pt;"><br>
_______________________________________________<br>
Freeswitch-dev mailing list<br>
<a href="mailto:Freeswitch-dev@lists.freeswitch.org" target="_blank">Freeswitch-dev@lists.freeswitch.org</a><br>
<a href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev</a><br>
UNSUBSCRIBE:<a href="http://lists.freeswitch.org/mailman/options/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/options/freeswitch-dev</a><br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a></span></font></p>

</div>

<p><font face="Times New Roman" size="3"><span style="font-size: 12pt;"><br>
<br clear="all">
<br>
-- <br>
Anthony Minessale II<br>
<br>
FreeSWITCH <a href="http://www.freeswitch.org/" target="_blank">http://www.freeswitch.org/</a><br>
ClueCon <a href="http://www.cluecon.com/" target="_blank">http://www.cluecon.com/</a><br>
<br>
AIM: anthm<br>
<a href="mailto:MSN%3Aanthony_minessale@hotmail.com" target="_blank">MSN:anthony_minessale@hotmail.com</a><br>
GTALK/JABBER/<a href="mailto:PAYPAL%3Aanthony.minessale@gmail.com" target="_blank">PAYPAL:anthony.minessale@gmail.com</a><br>
IRC: <a href="http://irc.freenode.net" target="_blank">irc.freenode.net</a>
#freeswitch<br>
<br>
FreeSWITCH Developer Conference<br>
<a href="mailto:sip%3A888@conference.freeswitch.org" target="_blank">sip:888@conference.freeswitch.org</a><br>
<a href="http://iax:guest@conference.freeswitch.org/888" target="_blank">iax:guest@conference.freeswitch.org/888</a><br>
<a href="mailto:googletalk%3Aconf%2B888@conference.freeswitch.org" target="_blank">googletalk:conf+888@conference.freeswitch.org</a><br>
pstn:213-799-1400 </span></font></p>

</div>

</div>

</div>

</div>

</div>

<p style="margin-bottom: 12pt;"><font face="Times New Roman" size="3"><span style="font-size: 12pt;"><br>
_______________________________________________<br>
Freeswitch-dev mailing list<br>
<a href="mailto:Freeswitch-dev@lists.freeswitch.org" target="_blank">Freeswitch-dev@lists.freeswitch.org</a><br>
<a href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev</a><br>
UNSUBSCRIBE:<a href="http://lists.freeswitch.org/mailman/options/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/options/freeswitch-dev</a><br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a></span></font></p>

</div>

<p><font face="Times New Roman" size="3"><span style="font-size: 12pt;"><br>
<br clear="all">
<br>
-- <br>
Anthony Minessale II<br>
<br>
FreeSWITCH <a href="http://www.freeswitch.org/" target="_blank">http://www.freeswitch.org/</a><br>
ClueCon <a href="http://www.cluecon.com/" target="_blank">http://www.cluecon.com/</a><br>
<br>
AIM: anthm<br>
<a href="mailto:MSN%3Aanthony_minessale@hotmail.com" target="_blank">MSN:anthony_minessale@hotmail.com</a><br>
GTALK/JABBER/<a href="mailto:PAYPAL%3Aanthony.minessale@gmail.com" target="_blank">PAYPAL:anthony.minessale@gmail.com</a><br>
IRC: <a href="http://irc.freenode.net" target="_blank">irc.freenode.net</a> #freeswitch<br>
<br>
FreeSWITCH Developer Conference<br>
<a href="mailto:sip%3A888@conference.freeswitch.org" target="_blank">sip:888@conference.freeswitch.org</a><br>
<a href="http://iax:guest@conference.freeswitch.org/888" target="_blank">iax:guest@conference.freeswitch.org/888</a><br>
<a href="mailto:googletalk%3Aconf%2B888@conference.freeswitch.org" target="_blank">googletalk:conf+888@conference.freeswitch.org</a><br>
pstn:213-799-1400 </span></font></p>

</div></div></div>

</div>


<br>_______________________________________________<br>
Freeswitch-dev mailing list<br>
<a href="mailto:Freeswitch-dev@lists.freeswitch.org">Freeswitch-dev@lists.freeswitch.org</a><br>
<a href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev</a><br>
UNSUBSCRIBE:<a href="http://lists.freeswitch.org/mailman/options/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/options/freeswitch-dev</a><br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
<br></blockquote></div><br><br clear="all"><br>-- <br>Anthony Minessale II<br><br>FreeSWITCH <a href="http://www.freeswitch.org/">http://www.freeswitch.org/</a><br>ClueCon <a href="http://www.cluecon.com/">http://www.cluecon.com/</a><br>
<br>AIM: anthm<br><a href="mailto:MSN%3Aanthony_minessale@hotmail.com">MSN:anthony_minessale@hotmail.com</a><br>GTALK/JABBER/<a href="mailto:PAYPAL%3Aanthony.minessale@gmail.com">PAYPAL:anthony.minessale@gmail.com</a><br>
IRC: <a href="http://irc.freenode.net">irc.freenode.net</a> #freeswitch<br><br>FreeSWITCH Developer Conference<br><a href="mailto:sip%3A888@conference.freeswitch.org">sip:888@conference.freeswitch.org</a><br><a href="http://iax:guest@conference.freeswitch.org/888">iax:guest@conference.freeswitch.org/888</a><br>
<a href="mailto:googletalk%3Aconf%2B888@conference.freeswitch.org">googletalk:conf+888@conference.freeswitch.org</a><br>pstn:213-799-1400