block: New BlockBackend
A block device consists of a frontend device model and a backend.
A block backend has a tree of block drivers doing the actual work.
The tree is managed by the block layer.
We currently use a single abstraction BlockDriverState both for tree
nodes and the backend as a whole. Drawbacks:
* Its API includes both stuff that makes sense only at the block
backend level (root of the tree) and stuff that's only for use
within the block layer. This makes the API bigger and more complex
than necessary. Moreover, it's not obvious which interfaces are
meant for device models, and which really aren't.
* Since device models keep a reference to their backend, the backend
object can't just be destroyed. But for media change, we need to
replace the tree. Our solution is to make the BlockDriverState
generic, with actual driver state in a separate object, pointed to
by member opaque. That lets us replace the tree by deinitializing
and reinitializing its root. This special need of the root makes
the data structure awkward everywhere in the tree.
The general plan is to separate the APIs into "block backend", for use
by device models, monitor and whatever other code dealing with block
backends, and "block driver", for use by the block layer and whatever
other code (if any) dealing with trees and tree nodes.
Code dealing with block backends, device models in particular, should
become completely oblivious of BlockDriverState. This should let us
clean up both APIs, and the tree data structures.
This commit is a first step. It creates a minimal "block backend"
API: type BlockBackend and functions to create, destroy and find them.
BlockBackend objects are created and destroyed exactly when root
BlockDriverState objects are created and destroyed. "Root" in the
sense of "in bdrv_states". They're not yet used for anything; that'll
come shortly.
A root BlockDriverState is created with bdrv_new_root(), so where to
create a BlockBackend is obvious. Where these roots get destroyed
isn't always as obvious.
It is obvious in qemu-img.c, qemu-io.c and qemu-nbd.c, and in error
paths of blockdev_init(), blk_connect(). That leaves destruction of
objects successfully created by blockdev_init() and blk_connect().
blockdev_init() is used only by drive_new() and qmp_blockdev_add().
Objects created by the latter are currently indestructible (see commit
48f364d "blockdev: Refuse to drive_del something added with
blockdev-add" and commit 2d246f0 "blockdev: Introduce
DriveInfo.enable_auto_del"). Objects created by the former get
destroyed by drive_del().
Objects created by blk_connect() get destroyed by blk_disconnect().
BlockBackend is reference-counted. Its reference count never exceeds
one so far, but that's going to change.
In drive_del(), the BB's reference count is surely one now. The BDS's
reference count is greater than one when something else is holding a
reference, such as a block job. In this case, the BB is destroyed
right away, but the BDS lives on until all extra references get
dropped.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Max Reitz <mreitz@redhat.com>
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
2014-10-07 15:59:04 +04:00
|
|
|
/*
|
|
|
|
* QEMU Block backends
|
|
|
|
*
|
2016-05-06 19:26:30 +03:00
|
|
|
* Copyright (C) 2014-2016 Red Hat, Inc.
|
block: New BlockBackend
A block device consists of a frontend device model and a backend.
A block backend has a tree of block drivers doing the actual work.
The tree is managed by the block layer.
We currently use a single abstraction BlockDriverState both for tree
nodes and the backend as a whole. Drawbacks:
* Its API includes both stuff that makes sense only at the block
backend level (root of the tree) and stuff that's only for use
within the block layer. This makes the API bigger and more complex
than necessary. Moreover, it's not obvious which interfaces are
meant for device models, and which really aren't.
* Since device models keep a reference to their backend, the backend
object can't just be destroyed. But for media change, we need to
replace the tree. Our solution is to make the BlockDriverState
generic, with actual driver state in a separate object, pointed to
by member opaque. That lets us replace the tree by deinitializing
and reinitializing its root. This special need of the root makes
the data structure awkward everywhere in the tree.
The general plan is to separate the APIs into "block backend", for use
by device models, monitor and whatever other code dealing with block
backends, and "block driver", for use by the block layer and whatever
other code (if any) dealing with trees and tree nodes.
Code dealing with block backends, device models in particular, should
become completely oblivious of BlockDriverState. This should let us
clean up both APIs, and the tree data structures.
This commit is a first step. It creates a minimal "block backend"
API: type BlockBackend and functions to create, destroy and find them.
BlockBackend objects are created and destroyed exactly when root
BlockDriverState objects are created and destroyed. "Root" in the
sense of "in bdrv_states". They're not yet used for anything; that'll
come shortly.
A root BlockDriverState is created with bdrv_new_root(), so where to
create a BlockBackend is obvious. Where these roots get destroyed
isn't always as obvious.
It is obvious in qemu-img.c, qemu-io.c and qemu-nbd.c, and in error
paths of blockdev_init(), blk_connect(). That leaves destruction of
objects successfully created by blockdev_init() and blk_connect().
blockdev_init() is used only by drive_new() and qmp_blockdev_add().
Objects created by the latter are currently indestructible (see commit
48f364d "blockdev: Refuse to drive_del something added with
blockdev-add" and commit 2d246f0 "blockdev: Introduce
DriveInfo.enable_auto_del"). Objects created by the former get
destroyed by drive_del().
Objects created by blk_connect() get destroyed by blk_disconnect().
BlockBackend is reference-counted. Its reference count never exceeds
one so far, but that's going to change.
In drive_del(), the BB's reference count is surely one now. The BDS's
reference count is greater than one when something else is holding a
reference, such as a block job. In this case, the BB is destroyed
right away, but the BDS lives on until all extra references get
dropped.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Max Reitz <mreitz@redhat.com>
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
2014-10-07 15:59:04 +04:00
|
|
|
*
|
|
|
|
* Authors:
|
|
|
|
* Markus Armbruster <armbru@redhat.com>,
|
|
|
|
*
|
|
|
|
* This work is licensed under the terms of the GNU LGPL, version 2.1
|
|
|
|
* or later. See the COPYING.LIB file in the top-level directory.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef BLOCK_BACKEND_H
|
|
|
|
#define BLOCK_BACKEND_H
|
|
|
|
|
2016-03-09 12:52:44 +03:00
|
|
|
#include "qemu/iov.h"
|
2016-03-21 14:56:44 +03:00
|
|
|
#include "block/throttle-groups.h"
|
2016-03-09 12:52:44 +03:00
|
|
|
|
2014-10-07 15:59:18 +04:00
|
|
|
/*
|
|
|
|
* TODO Have to include block/block.h for a bunch of block layer
|
|
|
|
* types. Unfortunately, this pulls in the whole BlockDriverState
|
|
|
|
* API, which we don't want used by many BlockBackend users. Some of
|
|
|
|
* the types belong here, and the rest should be split into a common
|
|
|
|
* header and one for the BlockDriverState API.
|
|
|
|
*/
|
|
|
|
#include "block/block.h"
|
|
|
|
|
2014-10-07 15:59:25 +04:00
|
|
|
/* Callbacks for block device models */
|
|
|
|
typedef struct BlockDevOps {
|
|
|
|
/*
|
|
|
|
* Runs when virtual media changed (monitor commands eject, change)
|
|
|
|
* Argument load is true on load and false on eject.
|
|
|
|
* Beware: doesn't run when a host device's physical media
|
|
|
|
* changes. Sure would be useful if it did.
|
|
|
|
* Device models with removable media must implement this callback.
|
|
|
|
*/
|
2017-01-24 16:21:41 +03:00
|
|
|
void (*change_media_cb)(void *opaque, bool load, Error **errp);
|
2014-10-07 15:59:25 +04:00
|
|
|
/*
|
|
|
|
* Runs when an eject request is issued from the monitor, the tray
|
|
|
|
* is closed, and the medium is locked.
|
|
|
|
* Device models that do not implement is_medium_locked will not need
|
|
|
|
* this callback. Device models that can lock the medium or tray might
|
|
|
|
* want to implement the callback and unlock the tray when "force" is
|
|
|
|
* true, even if they do not support eject requests.
|
|
|
|
*/
|
|
|
|
void (*eject_request_cb)(void *opaque, bool force);
|
|
|
|
/*
|
|
|
|
* Is the virtual tray open?
|
|
|
|
* Device models implement this only when the device has a tray.
|
|
|
|
*/
|
|
|
|
bool (*is_tray_open)(void *opaque);
|
|
|
|
/*
|
|
|
|
* Is the virtual medium locked into the device?
|
|
|
|
* Device models implement this only when device has such a lock.
|
|
|
|
*/
|
|
|
|
bool (*is_medium_locked)(void *opaque);
|
|
|
|
/*
|
|
|
|
* Runs when the size changed (e.g. monitor command block_resize)
|
|
|
|
*/
|
|
|
|
void (*resize_cb)(void *opaque);
|
2017-03-17 00:23:50 +03:00
|
|
|
/*
|
|
|
|
* Runs when the backend receives a drain request.
|
|
|
|
*/
|
|
|
|
void (*drained_begin)(void *opaque);
|
|
|
|
/*
|
|
|
|
* Runs when the backend's last drain request ends.
|
|
|
|
*/
|
|
|
|
void (*drained_end)(void *opaque);
|
2014-10-07 15:59:25 +04:00
|
|
|
} BlockDevOps;
|
|
|
|
|
2016-03-21 13:27:04 +03:00
|
|
|
/* This struct is embedded in (the private) BlockBackend struct and contains
|
|
|
|
* fields that must be public. This is in particular for QLIST_ENTRY() and
|
2017-08-25 16:20:23 +03:00
|
|
|
* friends so that BlockBackends can be kept in lists outside block-backend.c
|
|
|
|
* */
|
2016-03-21 13:27:04 +03:00
|
|
|
typedef struct BlockBackendPublic {
|
2017-08-25 16:20:23 +03:00
|
|
|
ThrottleGroupMember throttle_group_member;
|
2016-03-21 13:27:04 +03:00
|
|
|
} BlockBackendPublic;
|
|
|
|
|
2019-04-25 15:25:10 +03:00
|
|
|
BlockBackend *blk_new(AioContext *ctx, uint64_t perm, uint64_t shared_perm);
|
2020-04-28 22:26:46 +03:00
|
|
|
BlockBackend *blk_new_with_bs(BlockDriverState *bs, uint64_t perm,
|
|
|
|
uint64_t shared_perm, Error **errp);
|
2016-03-16 21:54:38 +03:00
|
|
|
BlockBackend *blk_new_open(const char *filename, const char *reference,
|
|
|
|
QDict *options, int flags, Error **errp);
|
2015-11-02 17:51:54 +03:00
|
|
|
int blk_get_refcnt(BlockBackend *blk);
|
block: New BlockBackend
A block device consists of a frontend device model and a backend.
A block backend has a tree of block drivers doing the actual work.
The tree is managed by the block layer.
We currently use a single abstraction BlockDriverState both for tree
nodes and the backend as a whole. Drawbacks:
* Its API includes both stuff that makes sense only at the block
backend level (root of the tree) and stuff that's only for use
within the block layer. This makes the API bigger and more complex
than necessary. Moreover, it's not obvious which interfaces are
meant for device models, and which really aren't.
* Since device models keep a reference to their backend, the backend
object can't just be destroyed. But for media change, we need to
replace the tree. Our solution is to make the BlockDriverState
generic, with actual driver state in a separate object, pointed to
by member opaque. That lets us replace the tree by deinitializing
and reinitializing its root. This special need of the root makes
the data structure awkward everywhere in the tree.
The general plan is to separate the APIs into "block backend", for use
by device models, monitor and whatever other code dealing with block
backends, and "block driver", for use by the block layer and whatever
other code (if any) dealing with trees and tree nodes.
Code dealing with block backends, device models in particular, should
become completely oblivious of BlockDriverState. This should let us
clean up both APIs, and the tree data structures.
This commit is a first step. It creates a minimal "block backend"
API: type BlockBackend and functions to create, destroy and find them.
BlockBackend objects are created and destroyed exactly when root
BlockDriverState objects are created and destroyed. "Root" in the
sense of "in bdrv_states". They're not yet used for anything; that'll
come shortly.
A root BlockDriverState is created with bdrv_new_root(), so where to
create a BlockBackend is obvious. Where these roots get destroyed
isn't always as obvious.
It is obvious in qemu-img.c, qemu-io.c and qemu-nbd.c, and in error
paths of blockdev_init(), blk_connect(). That leaves destruction of
objects successfully created by blockdev_init() and blk_connect().
blockdev_init() is used only by drive_new() and qmp_blockdev_add().
Objects created by the latter are currently indestructible (see commit
48f364d "blockdev: Refuse to drive_del something added with
blockdev-add" and commit 2d246f0 "blockdev: Introduce
DriveInfo.enable_auto_del"). Objects created by the former get
destroyed by drive_del().
Objects created by blk_connect() get destroyed by blk_disconnect().
BlockBackend is reference-counted. Its reference count never exceeds
one so far, but that's going to change.
In drive_del(), the BB's reference count is surely one now. The BDS's
reference count is greater than one when something else is holding a
reference, such as a block job. In this case, the BB is destroyed
right away, but the BDS lives on until all extra references get
dropped.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Max Reitz <mreitz@redhat.com>
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
2014-10-07 15:59:04 +04:00
|
|
|
void blk_ref(BlockBackend *blk);
|
|
|
|
void blk_unref(BlockBackend *blk);
|
2016-01-29 18:36:13 +03:00
|
|
|
void blk_remove_all_bs(void);
|
2017-03-06 00:44:35 +03:00
|
|
|
const char *blk_name(const BlockBackend *blk);
|
block: New BlockBackend
A block device consists of a frontend device model and a backend.
A block backend has a tree of block drivers doing the actual work.
The tree is managed by the block layer.
We currently use a single abstraction BlockDriverState both for tree
nodes and the backend as a whole. Drawbacks:
* Its API includes both stuff that makes sense only at the block
backend level (root of the tree) and stuff that's only for use
within the block layer. This makes the API bigger and more complex
than necessary. Moreover, it's not obvious which interfaces are
meant for device models, and which really aren't.
* Since device models keep a reference to their backend, the backend
object can't just be destroyed. But for media change, we need to
replace the tree. Our solution is to make the BlockDriverState
generic, with actual driver state in a separate object, pointed to
by member opaque. That lets us replace the tree by deinitializing
and reinitializing its root. This special need of the root makes
the data structure awkward everywhere in the tree.
The general plan is to separate the APIs into "block backend", for use
by device models, monitor and whatever other code dealing with block
backends, and "block driver", for use by the block layer and whatever
other code (if any) dealing with trees and tree nodes.
Code dealing with block backends, device models in particular, should
become completely oblivious of BlockDriverState. This should let us
clean up both APIs, and the tree data structures.
This commit is a first step. It creates a minimal "block backend"
API: type BlockBackend and functions to create, destroy and find them.
BlockBackend objects are created and destroyed exactly when root
BlockDriverState objects are created and destroyed. "Root" in the
sense of "in bdrv_states". They're not yet used for anything; that'll
come shortly.
A root BlockDriverState is created with bdrv_new_root(), so where to
create a BlockBackend is obvious. Where these roots get destroyed
isn't always as obvious.
It is obvious in qemu-img.c, qemu-io.c and qemu-nbd.c, and in error
paths of blockdev_init(), blk_connect(). That leaves destruction of
objects successfully created by blockdev_init() and blk_connect().
blockdev_init() is used only by drive_new() and qmp_blockdev_add().
Objects created by the latter are currently indestructible (see commit
48f364d "blockdev: Refuse to drive_del something added with
blockdev-add" and commit 2d246f0 "blockdev: Introduce
DriveInfo.enable_auto_del"). Objects created by the former get
destroyed by drive_del().
Objects created by blk_connect() get destroyed by blk_disconnect().
BlockBackend is reference-counted. Its reference count never exceeds
one so far, but that's going to change.
In drive_del(), the BB's reference count is surely one now. The BDS's
reference count is greater than one when something else is holding a
reference, such as a block job. In this case, the BB is destroyed
right away, but the BDS lives on until all extra references get
dropped.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Max Reitz <mreitz@redhat.com>
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
2014-10-07 15:59:04 +04:00
|
|
|
BlockBackend *blk_by_name(const char *name);
|
|
|
|
BlockBackend *blk_next(BlockBackend *blk);
|
2017-07-11 15:06:04 +03:00
|
|
|
BlockBackend *blk_all_next(BlockBackend *blk);
|
2016-03-16 21:54:37 +03:00
|
|
|
bool monitor_add_blk(BlockBackend *blk, const char *name, Error **errp);
|
|
|
|
void monitor_remove_blk(BlockBackend *blk);
|
block: New BlockBackend
A block device consists of a frontend device model and a backend.
A block backend has a tree of block drivers doing the actual work.
The tree is managed by the block layer.
We currently use a single abstraction BlockDriverState both for tree
nodes and the backend as a whole. Drawbacks:
* Its API includes both stuff that makes sense only at the block
backend level (root of the tree) and stuff that's only for use
within the block layer. This makes the API bigger and more complex
than necessary. Moreover, it's not obvious which interfaces are
meant for device models, and which really aren't.
* Since device models keep a reference to their backend, the backend
object can't just be destroyed. But for media change, we need to
replace the tree. Our solution is to make the BlockDriverState
generic, with actual driver state in a separate object, pointed to
by member opaque. That lets us replace the tree by deinitializing
and reinitializing its root. This special need of the root makes
the data structure awkward everywhere in the tree.
The general plan is to separate the APIs into "block backend", for use
by device models, monitor and whatever other code dealing with block
backends, and "block driver", for use by the block layer and whatever
other code (if any) dealing with trees and tree nodes.
Code dealing with block backends, device models in particular, should
become completely oblivious of BlockDriverState. This should let us
clean up both APIs, and the tree data structures.
This commit is a first step. It creates a minimal "block backend"
API: type BlockBackend and functions to create, destroy and find them.
BlockBackend objects are created and destroyed exactly when root
BlockDriverState objects are created and destroyed. "Root" in the
sense of "in bdrv_states". They're not yet used for anything; that'll
come shortly.
A root BlockDriverState is created with bdrv_new_root(), so where to
create a BlockBackend is obvious. Where these roots get destroyed
isn't always as obvious.
It is obvious in qemu-img.c, qemu-io.c and qemu-nbd.c, and in error
paths of blockdev_init(), blk_connect(). That leaves destruction of
objects successfully created by blockdev_init() and blk_connect().
blockdev_init() is used only by drive_new() and qmp_blockdev_add().
Objects created by the latter are currently indestructible (see commit
48f364d "blockdev: Refuse to drive_del something added with
blockdev-add" and commit 2d246f0 "blockdev: Introduce
DriveInfo.enable_auto_del"). Objects created by the former get
destroyed by drive_del().
Objects created by blk_connect() get destroyed by blk_disconnect().
BlockBackend is reference-counted. Its reference count never exceeds
one so far, but that's going to change.
In drive_del(), the BB's reference count is surely one now. The BDS's
reference count is greater than one when something else is holding a
reference, such as a block job. In this case, the BB is destroyed
right away, but the BDS lives on until all extra references get
dropped.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Max Reitz <mreitz@redhat.com>
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
2014-10-07 15:59:04 +04:00
|
|
|
|
2016-03-21 13:27:04 +03:00
|
|
|
BlockBackendPublic *blk_get_public(BlockBackend *blk);
|
|
|
|
BlockBackend *blk_by_public(BlockBackendPublic *public);
|
|
|
|
|
2014-10-07 15:59:05 +04:00
|
|
|
BlockDriverState *blk_bs(BlockBackend *blk);
|
2015-10-26 23:39:05 +03:00
|
|
|
void blk_remove_bs(BlockBackend *blk);
|
2017-01-13 21:02:32 +03:00
|
|
|
int blk_insert_bs(BlockBackend *blk, BlockDriverState *bs, Error **errp);
|
2016-02-29 12:50:38 +03:00
|
|
|
bool bdrv_has_blk(BlockDriverState *bs);
|
2016-06-23 15:20:24 +03:00
|
|
|
bool bdrv_is_root_node(BlockDriverState *bs);
|
2017-01-20 17:42:39 +03:00
|
|
|
int blk_set_perm(BlockBackend *blk, uint64_t perm, uint64_t shared_perm,
|
|
|
|
Error **errp);
|
2017-02-10 18:24:56 +03:00
|
|
|
void blk_get_perm(BlockBackend *blk, uint64_t *perm, uint64_t *shared_perm);
|
2014-10-07 15:59:05 +04:00
|
|
|
|
2016-03-08 18:39:49 +03:00
|
|
|
void blk_set_allow_write_beyond_eof(BlockBackend *blk, bool allow);
|
2019-05-06 20:18:02 +03:00
|
|
|
void blk_set_allow_aio_context_change(BlockBackend *blk, bool allow);
|
block-backend: Queue requests while drained
This fixes devices like IDE that can still start new requests from I/O
handlers in the CPU thread while the block backend is drained.
The basic assumption is that in a drain section, no new requests should
be allowed through a BlockBackend (blk_drained_begin/end don't exist,
we get drain sections only on the node level). However, there are two
special cases where requests should not be queued:
1. Block jobs: We already make sure that block jobs are paused in a
drain section, so they won't start new requests. However, if the
drain_begin is called on the job's BlockBackend first, it can happen
that we deadlock because the job stays busy until it reaches a pause
point - which it can't if its requests aren't processed any more.
The proper solution here would be to make all requests through the
job's filter node instead of using a BlockBackend. For now, just
disabling request queuing on the job BlockBackend is simpler.
2. In test cases where making requests through bdrv_* would be
cumbersome because we'd need a BdrvChild. As we already got the
functionality to disable request queuing from 1., use it in tests,
too, for convenience.
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Reviewed-by: Max Reitz <mreitz@redhat.com>
2019-07-22 18:46:23 +03:00
|
|
|
void blk_set_disable_request_queuing(BlockBackend *blk, bool disable);
|
2014-10-07 15:59:18 +04:00
|
|
|
void blk_iostatus_enable(BlockBackend *blk);
|
2015-10-19 18:53:22 +03:00
|
|
|
bool blk_iostatus_is_enabled(const BlockBackend *blk);
|
|
|
|
BlockDeviceIoStatus blk_iostatus(const BlockBackend *blk);
|
|
|
|
void blk_iostatus_disable(BlockBackend *blk);
|
|
|
|
void blk_iostatus_reset(BlockBackend *blk);
|
|
|
|
void blk_iostatus_set_err(BlockBackend *blk, int error);
|
2016-09-29 19:47:03 +03:00
|
|
|
int blk_attach_dev(BlockBackend *blk, DeviceState *dev);
|
2019-01-23 11:56:01 +03:00
|
|
|
void blk_detach_dev(BlockBackend *blk, DeviceState *dev);
|
|
|
|
DeviceState *blk_get_attached_dev(BlockBackend *blk);
|
2017-07-11 14:26:59 +03:00
|
|
|
char *blk_get_attached_dev_id(BlockBackend *blk);
|
2016-09-20 14:38:40 +03:00
|
|
|
BlockBackend *blk_by_dev(void *dev);
|
2016-09-20 14:38:42 +03:00
|
|
|
BlockBackend *blk_by_qdev_id(const char *id, Error **errp);
|
2014-10-07 15:59:18 +04:00
|
|
|
void blk_set_dev_ops(BlockBackend *blk, const BlockDevOps *ops, void *opaque);
|
2016-04-14 17:40:16 +03:00
|
|
|
int coroutine_fn blk_co_preadv(BlockBackend *blk, int64_t offset,
|
|
|
|
unsigned int bytes, QEMUIOVector *qiov,
|
|
|
|
BdrvRequestFlags flags);
|
2019-10-11 12:07:09 +03:00
|
|
|
int coroutine_fn blk_co_pwritev_part(BlockBackend *blk, int64_t offset,
|
|
|
|
unsigned int bytes,
|
|
|
|
QEMUIOVector *qiov, size_t qiov_offset,
|
|
|
|
BdrvRequestFlags flags);
|
2016-04-14 17:40:16 +03:00
|
|
|
int coroutine_fn blk_co_pwritev(BlockBackend *blk, int64_t offset,
|
|
|
|
unsigned int bytes, QEMUIOVector *qiov,
|
|
|
|
BdrvRequestFlags flags);
|
2019-04-22 17:58:30 +03:00
|
|
|
|
|
|
|
static inline int coroutine_fn blk_co_pread(BlockBackend *blk, int64_t offset,
|
|
|
|
unsigned int bytes, void *buf,
|
|
|
|
BdrvRequestFlags flags)
|
|
|
|
{
|
|
|
|
QEMUIOVector qiov = QEMU_IOVEC_INIT_BUF(qiov, buf, bytes);
|
|
|
|
|
|
|
|
return blk_co_preadv(blk, offset, bytes, &qiov, flags);
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline int coroutine_fn blk_co_pwrite(BlockBackend *blk, int64_t offset,
|
|
|
|
unsigned int bytes, void *buf,
|
|
|
|
BdrvRequestFlags flags)
|
|
|
|
{
|
|
|
|
QEMUIOVector qiov = QEMU_IOVEC_INIT_BUF(qiov, buf, bytes);
|
|
|
|
|
|
|
|
return blk_co_pwritev(blk, offset, bytes, &qiov, flags);
|
|
|
|
}
|
|
|
|
|
2016-05-25 01:25:20 +03:00
|
|
|
int blk_pwrite_zeroes(BlockBackend *blk, int64_t offset,
|
2017-06-09 13:18:08 +03:00
|
|
|
int bytes, BdrvRequestFlags flags);
|
2016-05-25 01:25:20 +03:00
|
|
|
BlockAIOCB *blk_aio_pwrite_zeroes(BlockBackend *blk, int64_t offset,
|
2017-06-09 13:18:08 +03:00
|
|
|
int bytes, BdrvRequestFlags flags,
|
2016-05-25 01:25:20 +03:00
|
|
|
BlockCompletionFunc *cb, void *opaque);
|
2016-06-16 16:13:15 +03:00
|
|
|
int blk_make_zero(BlockBackend *blk, BdrvRequestFlags flags);
|
2017-06-09 13:18:08 +03:00
|
|
|
int blk_pread(BlockBackend *blk, int64_t offset, void *buf, int bytes);
|
|
|
|
int blk_pwrite(BlockBackend *blk, int64_t offset, const void *buf, int bytes,
|
2016-05-06 19:26:27 +03:00
|
|
|
BdrvRequestFlags flags);
|
2014-10-07 15:59:18 +04:00
|
|
|
int64_t blk_getlength(BlockBackend *blk);
|
|
|
|
void blk_get_geometry(BlockBackend *blk, uint64_t *nb_sectors_ptr);
|
2015-02-05 21:58:10 +03:00
|
|
|
int64_t blk_nb_sectors(BlockBackend *blk);
|
2016-05-06 19:26:30 +03:00
|
|
|
BlockAIOCB *blk_aio_preadv(BlockBackend *blk, int64_t offset,
|
|
|
|
QEMUIOVector *qiov, BdrvRequestFlags flags,
|
|
|
|
BlockCompletionFunc *cb, void *opaque);
|
|
|
|
BlockAIOCB *blk_aio_pwritev(BlockBackend *blk, int64_t offset,
|
|
|
|
QEMUIOVector *qiov, BdrvRequestFlags flags,
|
|
|
|
BlockCompletionFunc *cb, void *opaque);
|
2014-10-07 15:59:18 +04:00
|
|
|
BlockAIOCB *blk_aio_flush(BlockBackend *blk,
|
|
|
|
BlockCompletionFunc *cb, void *opaque);
|
2017-06-09 13:18:08 +03:00
|
|
|
BlockAIOCB *blk_aio_pdiscard(BlockBackend *blk, int64_t offset, int bytes,
|
2016-07-16 02:22:54 +03:00
|
|
|
BlockCompletionFunc *cb, void *opaque);
|
2014-10-07 15:59:18 +04:00
|
|
|
void blk_aio_cancel(BlockAIOCB *acb);
|
|
|
|
void blk_aio_cancel_async(BlockAIOCB *acb);
|
|
|
|
int blk_ioctl(BlockBackend *blk, unsigned long int req, void *buf);
|
|
|
|
BlockAIOCB *blk_aio_ioctl(BlockBackend *blk, unsigned long int req, void *buf,
|
|
|
|
BlockCompletionFunc *cb, void *opaque);
|
2017-06-09 13:18:08 +03:00
|
|
|
int blk_co_pdiscard(BlockBackend *blk, int64_t offset, int bytes);
|
2014-11-18 14:21:14 +03:00
|
|
|
int blk_co_flush(BlockBackend *blk);
|
2014-10-07 15:59:18 +04:00
|
|
|
int blk_flush(BlockBackend *blk);
|
2016-03-16 21:54:31 +03:00
|
|
|
int blk_commit_all(void);
|
2019-02-14 20:42:44 +03:00
|
|
|
void blk_inc_in_flight(BlockBackend *blk);
|
|
|
|
void blk_dec_in_flight(BlockBackend *blk);
|
2015-06-17 13:37:19 +03:00
|
|
|
void blk_drain(BlockBackend *blk);
|
2014-10-07 15:59:18 +04:00
|
|
|
void blk_drain_all(void);
|
2015-10-19 18:53:22 +03:00
|
|
|
void blk_set_on_error(BlockBackend *blk, BlockdevOnError on_read_error,
|
|
|
|
BlockdevOnError on_write_error);
|
2014-10-07 15:59:18 +04:00
|
|
|
BlockdevOnError blk_get_on_error(BlockBackend *blk, bool is_read);
|
|
|
|
BlockErrorAction blk_get_error_action(BlockBackend *blk, bool is_read,
|
|
|
|
int error);
|
|
|
|
void blk_error_action(BlockBackend *blk, BlockErrorAction action,
|
|
|
|
bool is_read, int error);
|
2021-01-18 15:34:47 +03:00
|
|
|
bool blk_supports_write_perm(BlockBackend *blk);
|
|
|
|
bool blk_is_writable(BlockBackend *blk);
|
2018-10-13 11:52:31 +03:00
|
|
|
bool blk_is_sg(BlockBackend *blk);
|
|
|
|
bool blk_enable_write_cache(BlockBackend *blk);
|
2014-10-07 15:59:18 +04:00
|
|
|
void blk_set_enable_write_cache(BlockBackend *blk, bool wce);
|
2014-11-18 14:21:14 +03:00
|
|
|
void blk_invalidate_cache(BlockBackend *blk, Error **errp);
|
2015-10-19 18:53:11 +03:00
|
|
|
bool blk_is_inserted(BlockBackend *blk);
|
2015-10-19 18:53:12 +03:00
|
|
|
bool blk_is_available(BlockBackend *blk);
|
2014-10-07 15:59:18 +04:00
|
|
|
void blk_lock_medium(BlockBackend *blk, bool locked);
|
|
|
|
void blk_eject(BlockBackend *blk, bool eject_flag);
|
|
|
|
int blk_get_flags(BlockBackend *blk);
|
2019-03-29 07:27:49 +03:00
|
|
|
uint32_t blk_get_request_alignment(BlockBackend *blk);
|
2016-06-24 01:37:19 +03:00
|
|
|
uint32_t blk_get_max_transfer(BlockBackend *blk);
|
2015-07-09 12:56:45 +03:00
|
|
|
int blk_get_max_iov(BlockBackend *blk);
|
2014-10-07 15:59:18 +04:00
|
|
|
void blk_set_guest_block_size(BlockBackend *blk, int align);
|
2016-01-07 16:34:13 +03:00
|
|
|
void *blk_try_blockalign(BlockBackend *blk, size_t size);
|
2014-10-07 15:59:18 +04:00
|
|
|
void *blk_blockalign(BlockBackend *blk, size_t size);
|
|
|
|
bool blk_op_is_blocked(BlockBackend *blk, BlockOpType op, Error **errp);
|
|
|
|
void blk_op_unblock(BlockBackend *blk, BlockOpType op, Error *reason);
|
|
|
|
void blk_op_block_all(BlockBackend *blk, Error *reason);
|
|
|
|
void blk_op_unblock_all(BlockBackend *blk, Error *reason);
|
|
|
|
AioContext *blk_get_aio_context(BlockBackend *blk);
|
2019-05-02 12:10:59 +03:00
|
|
|
int blk_set_aio_context(BlockBackend *blk, AioContext *new_context,
|
|
|
|
Error **errp);
|
2014-11-18 14:21:15 +03:00
|
|
|
void blk_add_aio_context_notifier(BlockBackend *blk,
|
|
|
|
void (*attached_aio_context)(AioContext *new_context, void *opaque),
|
|
|
|
void (*detach_aio_context)(void *opaque), void *opaque);
|
|
|
|
void blk_remove_aio_context_notifier(BlockBackend *blk,
|
|
|
|
void (*attached_aio_context)(AioContext *,
|
|
|
|
void *),
|
|
|
|
void (*detach_aio_context)(void *),
|
|
|
|
void *opaque);
|
2016-01-29 18:36:03 +03:00
|
|
|
void blk_add_remove_bs_notifier(BlockBackend *blk, Notifier *notify);
|
|
|
|
void blk_add_insert_bs_notifier(BlockBackend *blk, Notifier *notify);
|
2014-10-07 15:59:18 +04:00
|
|
|
void blk_io_plug(BlockBackend *blk);
|
|
|
|
void blk_io_unplug(BlockBackend *blk);
|
|
|
|
BlockAcctStats *blk_get_stats(BlockBackend *blk);
|
2015-10-19 18:53:24 +03:00
|
|
|
BlockBackendRootState *blk_get_root_state(BlockBackend *blk);
|
|
|
|
void blk_update_root_state(BlockBackend *blk);
|
2016-09-12 20:08:31 +03:00
|
|
|
bool blk_get_detect_zeroes_from_root_state(BlockBackend *blk);
|
2015-10-26 23:39:07 +03:00
|
|
|
int blk_get_open_flags_from_root_state(BlockBackend *blk);
|
2014-10-07 15:59:18 +04:00
|
|
|
|
|
|
|
void *blk_aio_get(const AIOCBInfo *aiocb_info, BlockBackend *blk,
|
|
|
|
BlockCompletionFunc *cb, void *opaque);
|
2016-05-25 01:25:20 +03:00
|
|
|
int coroutine_fn blk_co_pwrite_zeroes(BlockBackend *blk, int64_t offset,
|
2017-06-09 13:18:08 +03:00
|
|
|
int bytes, BdrvRequestFlags flags);
|
2016-07-22 11:17:40 +03:00
|
|
|
int blk_pwrite_compressed(BlockBackend *blk, int64_t offset, const void *buf,
|
2017-06-09 13:18:08 +03:00
|
|
|
int bytes);
|
2019-09-18 12:51:40 +03:00
|
|
|
int blk_truncate(BlockBackend *blk, int64_t offset, bool exact,
|
2020-04-24 15:54:41 +03:00
|
|
|
PreallocMode prealloc, BdrvRequestFlags flags, Error **errp);
|
2017-06-09 13:18:08 +03:00
|
|
|
int blk_pdiscard(BlockBackend *blk, int64_t offset, int bytes);
|
2015-02-05 21:58:10 +03:00
|
|
|
int blk_save_vmstate(BlockBackend *blk, const uint8_t *buf,
|
|
|
|
int64_t pos, int size);
|
|
|
|
int blk_load_vmstate(BlockBackend *blk, uint8_t *buf, int64_t pos, int size);
|
2015-02-16 14:47:57 +03:00
|
|
|
int blk_probe_blocksizes(BlockBackend *blk, BlockSizes *bsz);
|
|
|
|
int blk_probe_geometry(BlockBackend *blk, HDGeometry *geo);
|
2015-11-17 23:06:21 +03:00
|
|
|
BlockAIOCB *blk_abort_aio_request(BlockBackend *blk,
|
|
|
|
BlockCompletionFunc *cb,
|
|
|
|
void *opaque, int ret);
|
2014-10-07 15:59:18 +04:00
|
|
|
|
2016-03-21 15:53:52 +03:00
|
|
|
void blk_set_io_limits(BlockBackend *blk, ThrottleConfig *cfg);
|
|
|
|
void blk_io_limits_disable(BlockBackend *blk);
|
|
|
|
void blk_io_limits_enable(BlockBackend *blk, const char *group);
|
|
|
|
void blk_io_limits_update_group(BlockBackend *blk, const char *group);
|
2017-08-23 16:42:40 +03:00
|
|
|
void blk_set_force_allow_inactivate(BlockBackend *blk);
|
2016-03-21 15:53:52 +03:00
|
|
|
|
2018-01-16 09:08:56 +03:00
|
|
|
void blk_register_buf(BlockBackend *blk, void *host, size_t size);
|
|
|
|
void blk_unregister_buf(BlockBackend *blk, void *host);
|
|
|
|
|
2018-06-01 12:26:47 +03:00
|
|
|
int coroutine_fn blk_co_copy_range(BlockBackend *blk_in, int64_t off_in,
|
|
|
|
BlockBackend *blk_out, int64_t off_out,
|
2018-07-09 19:37:17 +03:00
|
|
|
int bytes, BdrvRequestFlags read_flags,
|
|
|
|
BdrvRequestFlags write_flags);
|
2018-06-01 12:26:47 +03:00
|
|
|
|
2018-12-21 20:09:07 +03:00
|
|
|
const BdrvChild *blk_root(BlockBackend *blk);
|
|
|
|
|
2020-04-29 17:11:25 +03:00
|
|
|
int blk_make_empty(BlockBackend *blk, Error **errp);
|
|
|
|
|
block: New BlockBackend
A block device consists of a frontend device model and a backend.
A block backend has a tree of block drivers doing the actual work.
The tree is managed by the block layer.
We currently use a single abstraction BlockDriverState both for tree
nodes and the backend as a whole. Drawbacks:
* Its API includes both stuff that makes sense only at the block
backend level (root of the tree) and stuff that's only for use
within the block layer. This makes the API bigger and more complex
than necessary. Moreover, it's not obvious which interfaces are
meant for device models, and which really aren't.
* Since device models keep a reference to their backend, the backend
object can't just be destroyed. But for media change, we need to
replace the tree. Our solution is to make the BlockDriverState
generic, with actual driver state in a separate object, pointed to
by member opaque. That lets us replace the tree by deinitializing
and reinitializing its root. This special need of the root makes
the data structure awkward everywhere in the tree.
The general plan is to separate the APIs into "block backend", for use
by device models, monitor and whatever other code dealing with block
backends, and "block driver", for use by the block layer and whatever
other code (if any) dealing with trees and tree nodes.
Code dealing with block backends, device models in particular, should
become completely oblivious of BlockDriverState. This should let us
clean up both APIs, and the tree data structures.
This commit is a first step. It creates a minimal "block backend"
API: type BlockBackend and functions to create, destroy and find them.
BlockBackend objects are created and destroyed exactly when root
BlockDriverState objects are created and destroyed. "Root" in the
sense of "in bdrv_states". They're not yet used for anything; that'll
come shortly.
A root BlockDriverState is created with bdrv_new_root(), so where to
create a BlockBackend is obvious. Where these roots get destroyed
isn't always as obvious.
It is obvious in qemu-img.c, qemu-io.c and qemu-nbd.c, and in error
paths of blockdev_init(), blk_connect(). That leaves destruction of
objects successfully created by blockdev_init() and blk_connect().
blockdev_init() is used only by drive_new() and qmp_blockdev_add().
Objects created by the latter are currently indestructible (see commit
48f364d "blockdev: Refuse to drive_del something added with
blockdev-add" and commit 2d246f0 "blockdev: Introduce
DriveInfo.enable_auto_del"). Objects created by the former get
destroyed by drive_del().
Objects created by blk_connect() get destroyed by blk_disconnect().
BlockBackend is reference-counted. Its reference count never exceeds
one so far, but that's going to change.
In drive_del(), the BB's reference count is surely one now. The BDS's
reference count is greater than one when something else is holding a
reference, such as a block job. In this case, the BB is destroyed
right away, but the BDS lives on until all extra references get
dropped.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Max Reitz <mreitz@redhat.com>
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
2014-10-07 15:59:04 +04:00
|
|
|
#endif
|