----- Original Message ----- > From: "Kevin Wolf" <kw...@redhat.com> > To: qemu-bl...@nongnu.org > Cc: kw...@redhat.com, c...@redhat.com, qemu-devel@nongnu.org > Sent: Monday, August 6, 2018 8:37:28 PM > Subject: [PATCH] qapi/block: Document restrictions for node names > > blockdev-add fails if an invalid node name is given, so we should > document what a valid node name even is. > > Reported-by: Cong Li <c...@redhat.com> > Signed-off-by: Kevin Wolf <kw...@redhat.com>
Reviewed-by: Cong Li <c...@redhat.com> > --- > qapi/block-core.json | 3 +++ > 1 file changed, 3 insertions(+) > > diff --git a/qapi/block-core.json b/qapi/block-core.json > index 62a92fa4f4..fe565ebfaf 100644 > --- a/qapi/block-core.json > +++ b/qapi/block-core.json > @@ -3563,6 +3563,9 @@ > # @driver: block driver name > # @node-name: the node name of the new node (Since 2.0). > # This option is required on the top level of blockdev-add. > +# Valid node names start with an alphabetic character and > may > +# contain only alphanumeric characters, '-', '.' and '_'. > Their > +# maximum length is 31 characters. > # @discard: discard-related options (default: ignore) > # @cache: cache-related options > # @read-only: whether the block device should be read-only (default: > false). > -- > 2.13.6 > >