pvebcache(1)

NAME

pvebcache - PXVIRT bcache 管理工具

SYNOPSIS

pvebcache <COMMAND> [ARGS] [OPTIONS]

pvebcache create <device>

将指定磁盘设备转换为 bcache 后端设备。

<device>: <string>: 要转换为 bcache 后端设备的块设备，例如 /dev/sdb。

pvebcache list

列出当前 bcache 后端设备和缓存设备。

pvebcache stop <name>

停止指定 bcache 后端设备。

<name>: <string>: bcache 后端设备名称，例如 bcache0。

pvebcache register <device>

重新注册已经创建过的 bcache 后端设备。

<device>: <string>: 要重新注册的后端块设备，例如 /dev/sdb。

pvebcache cache create <device>

创建 bcache 缓存设备。

<device>: <string>: 要转换为缓存设备的块设备，例如 /dev/nvme0n1p1。

pvebcache cache stop <device>

停止指定缓存设备。如果缓存设备正在使用，则无法停止。

<device>: <string>: 要停止的缓存设备，例如 /dev/nvme0n1p1。

pvebcache cache attach <name> --cache <device>

将缓存设备绑定到 bcache 后端设备。

<name>: <string>: bcache 后端设备名称，例如 bcache0。
--cache <device>: 要绑定的缓存设备，例如 /dev/nvme0n1p1。

pvebcache cache detach <name>

将 bcache 后端设备与缓存设备分离。

<name>: <string>: bcache 后端设备名称，例如 bcache0。

pvebcache cache set <name> [OPTIONS]

设置 bcache 后端设备的缓存策略和相关参数。

<name>: <string>: bcache 后端设备名称，例如 bcache0。
--cachemode <none | writearound | writeback | writethrough>: 缓存模式。
--sequential <integer>: 顺序 IO 阈值，单位为 KiB。
--wb-percent <integer>: 回写缓存比例。
--clear-stats <boolean>: 清除统计数据。

常用命令示例

pvebcache list
pvebcache create /dev/sdb
pvebcache cache create /dev/nvme0n1p1
pvebcache cache attach bcache0 --cache /dev/nvme0n1p1
pvebcache cache set bcache0 --cachemode writeback --sequential 4096 --wb-percent 20

DESCRIPTION

pvebcache 是 PXVIRT 的 bcache 管理工具，用于创建、注册、停止 bcache 后端设备，以及创建、停止、绑定、分离和配置 bcache 缓存设备。

bcache 可以将高速块设备（例如 NVMe SSD）作为缓存设备，为较慢的后端块设备提供缓存能力。

创建 bcache 后端设备或缓存设备会修改目标块设备元数据。执行相关命令前，请确认设备上没有需要保留的数据，并确认设备没有被系统或虚拟机使用。

后端设备管理

创建后端设备

pvebcache create 用于将一个磁盘设备转换为 bcache 后端设备。

# pvebcache create /dev/sdb

以上命令会将 /dev/sdb 转换为 bcache 后端设备。

查看设备列表

pvebcache list 用于查看当前 bcache 后端设备和缓存设备。

# pvebcache list
name       type       backend-dev          cache-dev             state           size            cachemode
bcache0    backend    sdc                  unknown              Running         80GB            writeback
nvme0n1    cache      unknown              unknown              Running         32GB            unknown

停止后端设备

pvebcache stop 用于停止指定 bcache 后端设备。

# pvebcache stop bcache0

重新注册后端设备

pvebcache register 用于重新注册已经创建过的 bcache 后端设备。

# pvebcache register /dev/sdb

缓存设备管理

创建缓存设备

pvebcache cache create 用于将指定块设备创建为 bcache 缓存设备。

# pvebcache cache create /dev/nvme0n1p1

停止缓存设备

pvebcache cache stop 用于停止指定缓存设备。如果该缓存设备正在被后端设备使用，则无法停止。

# pvebcache cache stop /dev/nvme0n1p1

绑定缓存设备

pvebcache cache attach 用于将缓存设备绑定到 bcache 后端设备。

# pvebcache cache attach bcache0 --cache /dev/nvme0n1p1

分离缓存设备

pvebcache cache detach 用于将 bcache 后端设备与当前缓存设备分离。

# pvebcache cache detach bcache0

缓存策略

pvebcache cache set 用于设置 bcache 后端设备的缓存策略和相关参数。

cachemode

缓存模式。支持以下取值：

writethrough
writeback
writearound
none

sequential

顺序 IO 阈值，单位为 KiB。

wb-percent

回写缓存比例。

clear-stats

清除统计数据。

以下示例将 bcache0 的缓存模式设置为 writeback，顺序 IO 阈值设置为 4096 KiB，回写缓存比例设置为 20：

# pvebcache cache set bcache0 --cachemode writeback --sequential 4096 --wb-percent 20

常用命令示例

# pvebcache list
# pvebcache create /dev/sdb
# pvebcache cache create /dev/nvme0n1p1
# pvebcache cache attach bcache0 --cache /dev/nvme0n1p1
# pvebcache cache set bcache0 --cachemode writeback --sequential 4096 --wb-percent 20

版权和免责声明

本程序是自由软件：你可以依据自由软件基金会发布的 GNU Affero General Public License 条款重新分发和/或修改本程序；可使用该许可证第 3 版，或（由你选择）任何后续版本。

发布本程序是希望它能够有用，但不提供任何担保；甚至不包含对适销性或特定用途适用性的默示担保。更多详情请参见 GNU Affero General Public License。

你应当已经随本程序收到一份 GNU Affero General Public License 的副本。如果没有，请访问： https://www.gnu.org/licenses/

本程序是自由软件：你可以依据自由软件基金会发布的 GNU Affero General Public License 条款重新分发和/或修改本程序；可使用该许可证第 3 版，或（由你选择）任何后续版本。

发布本程序是希望它能够有用，但不提供任何担保；甚至不包含对适销性或特定用途适用性的默示担保。更多详情请参见 GNU Affero General Public License。

你应当已经随本程序收到一份 GNU Affero General Public License 的副本。如果没有，请访问： https://www.gnu.org/licenses/