3 nbdkit-full-plugin - nbdkit plugin which is always full
7 nbdkit full [size=]SIZE
11 C<nbdkit-full-plugin> is a plugin for L<nbdkit(1)>. Reads from this
12 virtual disk return zeroes. All writes and similar operations like
13 zero and trim fail with C<ENOSPC> S<(No space left on device)> error.
15 In other words this behaves like a sparse (thin-provisioned) virtual
16 disk which has run out of space on the host.
18 =head2 Equivalent nbdkit-error-filter command
20 Although this is a standalone plugin, it is equivalent to using
21 L<nbdkit-error-filter(1)>:
23 nbdkit --filter=error null SIZE \
24 error-pwrite=ENOSPC error-pwrite-rate=100% \
25 error-trim=ENOSPC error-trim-rate=100% \
26 error-zero=ENOSPC error-zero-rate=100%
28 nbdkit-error-filter can be more flexible because you can place it on
29 top of other plugins and you can control when to inject errors.
37 Specify the virtual size of the disk image.
39 This parameter is required.
41 C<size=> is a magic config key and may be omitted in most cases.
42 See L<nbdkit(1)/Magic parameters>.
50 =item F<$plugindir/nbdkit-full-plugin.so>
54 Use C<nbdkit --dump-config> to find the location of C<$plugindir>.
60 C<nbdkit-full-plugin> first appeared in nbdkit 1.10.
66 L<nbdkit-error-filter(1)>,
67 L<nbdkit-null-plugin(1)>,
68 L<nbdkit-pattern-plugin(1)>,
69 L<nbdkit-random-plugin(1)>.
70 L<nbdkit-sparse-random-plugin(1)>,
71 L<nbdkit-zero-plugin(1)>.