RFA: Document conventions for terminating query/set packet names

Andrew Cagney cagney@redhat.com
Tue May 9 21:16:00 GMT 2006


Daniel Jacobowitz wrote:
> Otherwise, here's a proposed
> patch.  It recommends not starting new packets with qC, and clarifies
> that stubs should check for the end of a packet even for packets
> without a separator.

That was always the intent.  Your wording is much improved.
>  The name of a query or set packet should be separated from any
>  parameters by a @samp{:}; the parameters themselves should be
>  separated by @samp{,} or @samp{;}.  Stubs must be careful to match the
> +full packet name, and check for a separator or the end of the packet,
> +in case two packet names share a common prefix.  New packets should not begin
> +with @samp{qC}, @samp{qP}, or @samp{qL}@footnote{The @samp{qP} and @samp{qL}
> +packets predate these conventions, and have arguments without any terminator
> +for the packet name; we suspect they are in widespread use in places that
> +are difficult to upgrade.  The @samp{qC} packet has no arguments, but some
> +existing stubs (e.g.@: RedBoot) are known to not check for the end of the
> +packet.}.

The qC vs qCRC botch also pre-dates this convention; and was one of its 
motivators.




More information about the Gdb-patches mailing list