@@ -34,7 +34,8 @@ man1_MANS = \
daxctl-offline-memory.1 \
daxctl-disable-device.1 \
daxctl-enable-device.1 \
- daxctl-create-device.1
+ daxctl-create-device.1 \
+ daxctl-destroy-device.1
EXTRA_DIST = $(man1_MANS)
new file mode 100644
@@ -0,0 +1,63 @@
+// SPDX-License-Identifier: GPL-2.0
+
+daxctl-destroy-device(1)
+========================
+
+NAME
+----
+daxctl-destroy-device - Destroy a devdax device
+
+SYNOPSIS
+--------
+[verse]
+'daxctl destroy-device' <dax0.0> [<dax1.0>...<daxY.Z>] [<options>]
+
+EXAMPLES
+--------
+
+* Destroys dax0.1
+----
+# daxctl disable-device dax0.1
+disabled 1 device
+# daxctl destroy-device dax0.1
+destroyed 1 device
+----
+
+* Destroys all devices in region id 0
+----
+# daxctl disable-device -r 0 all
+disabled 3 devices
+# daxctl destroy-device -r 0 all
+destroyed 2 devices
+----
+
+DESCRIPTION
+-----------
+
+Destroys a dax device in 'devdax' mode.
+
+OPTIONS
+-------
+-r::
+--region=::
+ Restrict the operation to devices belonging to the specified region(s).
+ A device-dax region is a contiguous range of memory that hosts one or
+ more /dev/daxX.Y devices, where X is the region id and Y is the device
+ instance id.
+
+-u::
+--human::
+ By default the command will output machine-friendly raw-integer
+ data. Instead, with this flag, numbers representing storage size
+ will be formatted as human readable strings with units, other
+ fields are converted to hexadecimal strings.
+
+-v::
+--verbose::
+ Emit more debug messages
+
+include::../copyright.txt[]
+
+SEE ALSO
+--------
+linkdaxctl:daxctl-list[1],daxctl-reconfigure-device[1],daxctl-create-device[1]
@@ -7,6 +7,7 @@ struct daxctl_ctx;
int cmd_list(int argc, const char **argv, struct daxctl_ctx *ctx);
int cmd_migrate(int argc, const char **argv, struct daxctl_ctx *ctx);
int cmd_create_device(int argc, const char **argv, struct daxctl_ctx *ctx);
+int cmd_destroy_device(int argc, const char **argv, struct daxctl_ctx *ctx);
int cmd_reconfig_device(int argc, const char **argv, struct daxctl_ctx *ctx);
int cmd_disable_device(int argc, const char **argv, struct daxctl_ctx *ctx);
int cmd_enable_device(int argc, const char **argv, struct daxctl_ctx *ctx);
@@ -72,6 +72,7 @@ static struct cmd_struct commands[] = {
{ "help", .d_fn = cmd_help },
{ "migrate-device-model", .d_fn = cmd_migrate },
{ "create-device", .d_fn = cmd_create_device },
+ { "destroy-device", .d_fn = cmd_destroy_device },
{ "reconfigure-device", .d_fn = cmd_reconfig_device },
{ "online-memory", .d_fn = cmd_online_memory },
{ "offline-memory", .d_fn = cmd_offline_memory },
@@ -52,6 +52,7 @@ enum device_action {
ACTION_CREATE,
ACTION_DISABLE,
ACTION_ENABLE,
+ ACTION_DESTROY,
};
#define BASE_OPTIONS() \
@@ -69,6 +70,10 @@ OPT_BOOLEAN('f', "force", ¶m.force, \
#define CREATE_OPTIONS() \
OPT_STRING('s', "size", ¶m.size, "size", "size to switch the device to")
+#define DESTROY_OPTIONS() \
+OPT_BOOLEAN('f', "force", ¶m.force, \
+ "attempt to disable before destroying device")
+
#define ZONE_OPTIONS() \
OPT_BOOLEAN('\0', "no-movable", ¶m.no_movable, \
"online memory in ZONE_NORMAL")
@@ -110,6 +115,12 @@ static const struct option enable_options[] = {
OPT_END(),
};
+static const struct option destroy_options[] = {
+ BASE_OPTIONS(),
+ DESTROY_OPTIONS(),
+ OPT_END(),
+};
+
static const char *parse_device_options(int argc, const char **argv,
enum device_action action, const struct option *options,
const char *usage, struct daxctl_ctx *ctx)
@@ -144,6 +155,9 @@ static const char *parse_device_options(int argc, const char **argv,
case ACTION_ENABLE:
action_string = "enable";
break;
+ case ACTION_DESTROY:
+ action_string = "destroy";
+ break;
default:
action_string = "<>";
break;
@@ -199,6 +213,7 @@ static const char *parse_device_options(int argc, const char **argv,
if (param.no_movable)
mem_zone = MEM_ZONE_NORMAL;
/* fall through */
+ case ACTION_DESTROY:
case ACTION_OFFLINE:
case ACTION_DISABLE:
case ACTION_ENABLE:
@@ -364,6 +379,35 @@ static int dev_resize(struct daxctl_dev *dev, unsigned long long val)
return 0;
}
+static int dev_destroy(struct daxctl_dev *dev)
+{
+ const char *devname = daxctl_dev_get_devname(dev);
+ int rc;
+
+ if (daxctl_dev_is_enabled(dev) && !param.force) {
+ fprintf(stderr, "%s is active, specify --force for deletion\n",
+ devname);
+ return -ENXIO;
+ } else {
+ rc = daxctl_dev_disable(dev);
+ if (rc) {
+ fprintf(stderr, "%s: disable failed: %s\n",
+ daxctl_dev_get_devname(dev), strerror(-rc));
+ return rc;
+ }
+ }
+
+ rc = daxctl_dev_set_size(dev, 0);
+ if (rc < 0)
+ return rc;
+
+ rc = daxctl_region_destroy_dev(daxctl_dev_get_region(dev), dev);
+ if (rc < 0)
+ return rc;
+
+ return 0;
+}
+
static int disable_devdax_device(struct daxctl_dev *dev)
{
struct daxctl_memory *mem = daxctl_dev_get_memory(dev);
@@ -689,6 +733,11 @@ static int do_xaction_device(const char *device, enum device_action action,
if (rc == 0)
(*processed)++;
break;
+ case ACTION_DESTROY:
+ rc = dev_destroy(dev);
+ if (rc == 0)
+ (*processed)++;
+ break;
default:
rc = -EINVAL;
break;
@@ -725,6 +774,23 @@ int cmd_create_device(int argc, const char **argv, struct daxctl_ctx *ctx)
return rc;
}
+int cmd_destroy_device(int argc, const char **argv, struct daxctl_ctx *ctx)
+{
+ char *usage = "daxctl destroy-device <device> [<options>]";
+ const char *device = parse_device_options(argc, argv, ACTION_DESTROY,
+ destroy_options, usage, ctx);
+ int processed, rc;
+
+ rc = do_xaction_device(device, ACTION_DESTROY, ctx, &processed);
+ if (rc < 0)
+ fprintf(stderr, "error destroying devices: %s\n",
+ strerror(-rc));
+
+ fprintf(stderr, "destroyed %d device%s\n", processed,
+ processed == 1 ? "" : "s");
+ return rc;
+}
+
int cmd_reconfig_device(int argc, const char **argv, struct daxctl_ctx *ctx)
{
char *usage = "daxctl reconfigure-device <device> [<options>]";