1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
|
=head1 NAME
nbdkit-null-plugin - nbdkit bitbucket plugin
=head1 SYNOPSIS
nbdkit null [[size=]SIZE]
=head1 DESCRIPTION
C<nbdkit-null-plugin> is a null plugin for L<nbdkit(1)>. Everything
written to the virtual device is discarded, and reads back as zeroes.
Most NBD consumers will be very confused by this device. Trying to
create filesystems etc on it will likely fail badly. If the client is
caching writes locally then you will get inconsistent read behaviour.
The null plugin is also used when probing for installed filters, see
L<nbdkit-probing(1)/Detect if a filter is installed>.
=head1 PARAMETERS
=over 4
=item [B<size=>]SIZE
Specify the virtual size of the disk image.
This parameter is optional. If omitted then a zero-sized device is
created.
C<size=> __IS_MAGIC__
=back
=head1 FILES
=over 4
=item F<$plugindir/nbdkit-null-plugin.so>
The plugin.
Use C<nbdkit --dump-config> to find the location of C<$plugindir>.
=back
=head1 VERSION
C<nbdkit-null-plugin> first appeared in nbdkit 1.2.
=head1 SEE ALSO
L<nbdkit(1)>,
L<nbdkit-plugin(3)>,
L<nbdkit-full-plugin(1)>,
L<nbdkit-ones-plugin(1)>,
L<nbdkit-pattern-plugin(1)>,
L<nbdkit-random-plugin(1)>.
L<nbdkit-sparse-random-plugin(1)>,
L<nbdkit-zero-plugin(1)>.
=head1 AUTHORS
Richard W.M. Jones
=head1 COPYRIGHT
Copyright Red Hat
|