[asterisk-dev] Re: [asterisk-commits] rizzo: trunk r45551 - /trunk/main/manager.c

[Luigi Rizzo]

On Wed, Oct 18, 2006 at 11:16:09AM -0500, Kevin P. Fleming wrote:
> ----- asterisk-commits at lists.digium.com wrote:
> > I am not totally clear if there is a preferred position for
> > the ActionID: line in a message. Some instances put it at
> > the end, but one would argue that it is preferable to have
> > it at the beginning.
> 
> I would prefer to see it be the beginning of the response as well; once you have made this change, manager.txt can be updated to document it that way so that AMI programmers can rely on it being the first response line they will receive (if there is an ActionID, of course).

"rely" is probably a bit too much - especially considering that external
software may need to talk to different versions of asterisk...
so having the field at the beginning may make filtering more efficient,
but cannot be relied upon.

This said, manager.txt (don't know how outdated) currently says this:

The first tag MUST be one of the following:

    * Action: An action requested by the CLIENT to the Asterisk SERVER. Only one "Action" may be outstanding at any
 time.
    * Response: A response to an action from the Asterisk SERVER to the CLIENT.
    * Event: An event reported by the Asterisk SERVER to the CLIENT

and doesn't mention actionID at all! does it presence mean that
we can have multiple outstanding actions now ?

cheers
luigi