summaryrefslogtreecommitdiffstats
path: root/qapi
diff options
context:
space:
mode:
authorKevin Wolf2018-08-06 14:35:10 +0200
committerKevin Wolf2018-08-15 12:50:39 +0200
commitdbfdf6cb3625c68d0ea84ace4a786406cf43d4f3 (patch)
tree38d59879714982057643f5785c72e401a2ebef39 /qapi
parentblock: Remove dead deprecation warning code (diff)
downloadqemu-dbfdf6cb3625c68d0ea84ace4a786406cf43d4f3.tar.gz
qemu-dbfdf6cb3625c68d0ea84ace4a786406cf43d4f3.tar.xz
qemu-dbfdf6cb3625c68d0ea84ace4a786406cf43d4f3.zip
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 <coli@redhat.com> Signed-off-by: Kevin Wolf <kwolf@redhat.com> Reviewed-by: Eric Blake <eblake@redhat.com> Reviewed-by: Cong Li <coli@redhat.com> Reviewed-by: Alberto Garcia <berto@igalia.com>
Diffstat (limited to 'qapi')
-rw-r--r--qapi/block-core.json3
1 files changed, 3 insertions, 0 deletions
diff --git a/qapi/block-core.json b/qapi/block-core.json
index 5b9084a394..f20efc97f7 100644
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -3572,6 +3572,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).