diff options
| author | Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> | 2018-01-19 16:57:16 +0300 |
|---|---|---|
| committer | Eric Blake <eblake@redhat.com> | 2018-01-26 09:37:20 -0600 |
| commit | a3b0dc75829d910073e841539cb5ae4e6f75c09b (patch) | |
| tree | d2554b82e6bfe8ab281d255916019b688708d162 /qapi/block.json | |
| parent | dba49323ea83c8e661a279e8b69737fd18783a19 (diff) | |
qapi: add nbd-server-remove
Add command for removing an export. It is needed for cases when we
don't want to keep the export after the operation on it was completed.
The other example is a temporary node, created with blockdev-add.
If we want to delete it we should firstly remove any corresponding
NBD export.
Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
Message-Id: <20180119135719.24745-3-vsementsov@virtuozzo.com>
[eblake: drop dead nb_clients code]
Signed-off-by: Eric Blake <eblake@redhat.com>
Diffstat (limited to 'qapi/block.json')
| -rw-r--r-- | qapi/block.json | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/qapi/block.json b/qapi/block.json index 353e3a45bd..c694524002 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -228,6 +228,47 @@ 'data': {'device': 'str', '*name': 'str', '*writable': 'bool'} } ## +# @NbdServerRemoveMode: +# +# Mode for removing an NBD export. +# +# @safe: Remove export if there are no existing connections, fail otherwise. +# +# @hard: Drop all connections immediately and remove export. +# +# Potential additional modes to be added in the future: +# +# hide: Just hide export from new clients, leave existing connections as is. +# Remove export after all clients are disconnected. +# +# soft: Hide export from new clients, answer with ESHUTDOWN for all further +# requests from existing clients. +# +# Since: 2.12 +## +{'enum': 'NbdServerRemoveMode', 'data': ['safe', 'hard']} + +## +# @nbd-server-remove: +# +# Remove NBD export by name. +# +# @name: Export name. +# +# @mode: Mode of command operation. See @NbdServerRemoveMode description. +# Default is 'safe'. +# +# Returns: error if +# - the server is not running +# - export is not found +# - mode is 'safe' and there are existing connections +# +# Since: 2.12 +## +{ 'command': 'nbd-server-remove', + 'data': {'name': 'str', '*mode': 'NbdServerRemoveMode'} } + +## # @nbd-server-stop: # # Stop QEMU's embedded NBD server, and unregister all devices previously |