nbdkit-full-plugin(1)

Usage

nbdkit full [size=] SIZE

Overview

"nbdkit-full-plugin" is a plugin for nbdkit(1). Reads from this virtual disk return zeroes. All writes and similar operations like zero and trim fail with "ENOSPC" (No space left on device) error.

In other words this behaves like a sparse (thin-provisioned) virtual disk which has run out of space on the host.

Equivalent filters

Although this is a standalone plugin, it is equivalent to using either nbdkit-readonly-filter(1):

 nbdkit --filter=readonly null SIZE

or nbdkit-error-filter(1):

 nbdkit --filter=error null SIZE \
                       error-pwrite=ENOSPC error-pwrite-rate=100% \
                       error-trim=ENOSPC error-trim-rate=100% \
                       error-zero=ENOSPC error-zero-rate=100%

Those filters may be more flexible because you can place them on top of other plugins and you can control when to inject errors.

Parameters

[size=]SIZE

Specify the virtual size of the disk image.

This parameter is required.

"size=" prefix may be omitted in most cases. See "Magic parameters" in nbdkit(1).

Files

$plugindir/nbdkit-full-plugin.so

The plugin.

Use "nbdkit --dump-config" to find the location of $plugindir.

Version

"nbdkit-full-plugin" first appeared in nbdkit 1.10.

Releases

4 releases since Debian 10 (Buster); the text changed 3 times.

10
11
12
13

nbdkit(1) toolkit for creating Network Block Device (NBD) servers nbdkit-plugin(3) how to write nbdkit plugins nbdkit-error-filter(1) inject errors for testing clients nbdkit-null-plugin(1) nbdkit bitbucket plugin nbdkit-ones-plugin(1) nbdkit plugin filled with repeated 0xff or other bytes nbdkit-pattern-plugin(1) plugin to serve a fixed pattern of data for testing nbdkit-random-plugin(1) plugin to serve random data nbdkit-readonly-filter(1) switch a plugin between read-only and writable nbdkit-sparse-random-plugin(1) make sparse random disks nbdkit-zero-plugin(1) nbdkit zero length plugin

Referred to by

nbdkit(1) toolkit for creating Network Block Device (NBD) servers nbdkit-null-plugin(1) nbdkit bitbucket plugin nbdkit-ones-plugin(1) nbdkit plugin filled with repeated 0xff or other bytes nbdkit-zero-plugin(1) nbdkit zero length plugin nbdkit-error-filter(1) inject errors for testing clients nbdkit-random-plugin(1) plugin to serve random data nbdkit-pattern-plugin(1) plugin to serve a fixed pattern of data for testing nbdkit-readonly-filter(1) switch a plugin between read-only and writable nbdkit-release-notes-1.10(1) release notes for nbdkit 1.10 nbdkit-release-notes-1.14(1) release notes for nbdkit 1.14 nbdkit-sparse-random-plugin(1) make sparse random disks nbdkit-plugin(3) how to write nbdkit plugins