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