Re: [Qemu-devel] [PATCH v2] Add chardev-send-break monitor command

["Dr. David Alan Gilbert" <dgilbert@redhat.com>]

* Eric Blake (eblake@redhat.com) wrote:
> On 06/11/2017 02:48 AM, Stefan Fritsch wrote:
> > Sending a break on a serial console can be useful for debugging the
> > guest. But not all chardev backends support sending breaks (only telnet
> > and mux do). The chardev-send-break command allows to send a break even
> > if using other backends.
> > 
> > Signed-off-by: Stefan Fritsch <sf@sfritsch.de>
> > Acked-by: Dr. David Alan Gilbert <dgilbert@redhat.com>
> > ---
> > v2: added tests and Acked-by line
> > 
> 
> > +++ b/hmp-commands.hx
> > @@ -1745,6 +1745,22 @@ Removes the chardev @var{id}.
> >  ETEXI
> >  
> >      {
> > +        .name       = "chardev-send-break",
> > +        .args_type  = "id:s",
> > +        .params     = "id",
> > +        .help       = "send break on chardev",
> 
> Compare this wording,...
> 
> > +STEXI
> > +@item chardev-send-break id
> > +@findex chardev-send-break
> > +Sends break on the chardev @var{id}.
> 
> repeated here,
> 
> > +++ b/qapi-schema.json
> > @@ -5114,6 +5114,26 @@
> >  { 'command': 'chardev-remove', 'data': {'id': 'str'} }
> >  
> >  ##
> > +# @chardev-send-break:
> > +#
> > +# Send a break to a character device
> 
> ...with this wording.  I like 'send a break' better than 'send break',
> but even better might be 'send a break sequence' or even 'emulate a
> break sequence' (by definition, a break is NOT a character, but on bare
> metal character devices it IS a defined electrical sequence distinct
> from characters to make the recipient aware that the sender is trying to
> get attention).
> 
> Otherwise, the patch looks fine to me.  If all that changes is some
> word-smithing (and the maintainer may be willing to do that), you can add:
> Reviewed-by: Eric Blake <eblake@redhat.com>

I'll go with the 'send a break' - the official terminology seems to
be a 'break condition', but I've never heard anyone say that,
it's always been 'send a break'.

diff --git a/hmp-commands.hx b/hmp-commands.hx
index fc8d54b52a..275ccdfbc7 100644
--- a/hmp-commands.hx
+++ b/hmp-commands.hx
@@ -1748,7 +1748,7 @@ ETEXI
         .name       = "chardev-send-break",
         .args_type  = "id:s",
         .params     = "id",
-        .help       = "send break on chardev",
+        .help       = "send a break on chardev",
         .cmd        = hmp_chardev_send_break,
         .command_completion = chardev_remove_completion,
     },
@@ -1756,7 +1756,7 @@ ETEXI
 STEXI
 @item chardev-send-break id
 @findex chardev-send-break
-Sends break on the chardev @var{id}.
+Send a break on the chardev @var{id}.

 ETEXI


Queued to HMP

Dave

> 
> -- 
> Eric Blake, Principal Software Engineer
> Red Hat, Inc.           +1-919-301-3266
> Virtualization:  qemu.org | libvirt.org
> 



--
Dr. David Alan Gilbert / dgilbert@redhat.com / Manchester, UK