File: nbdkit-example2-plugin.pod

package info (click to toggle)
nbdkit 1.42.9-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 14,696 kB
  • sloc: ansic: 59,224; sh: 16,793; makefile: 6,463; python: 1,837; cpp: 1,116; ml: 504; perl: 502; tcl: 62
file content (57 lines) | stat: -rw-r--r-- 1,222 bytes parent folder | download | duplicates (2)
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
=head1 NAME

nbdkit-example2-plugin - example nbdkit plugin

=head1 SYNOPSIS

 nbdkit example2 file=FILENAME

=head1 DESCRIPTION

C<nbdkit-example2-plugin> is an example L<nbdkit(1)> plugin.

It serves the named C<FILENAME> over NBD, readonly.

Mainly this is useful for testing nbdkit and as an example for writing
nbdkit plugins (L<nbdkit-plugin(3)>).

There are two variations of this plugin which can be found in the
source directory.  F<example2.c> is the regular plugin for Linux and
other Unix-like systems.  F<winexample2.c> is the same plugin written
for Windows using Win32 APIs to access the file.

=head1 DEBUG FLAGS

For extra debugging (only useful for developers) use
S<I<-D example2.extra=1>>

=head1 FILES

=over 4

=item F<$plugindir/nbdkit-example2-plugin.so>

The plugin.

Use C<nbdkit --dump-config> to find the location of C<$plugindir>.

=back

=head1 VERSION

C<nbdkit-example2-plugin> first appeared in nbdkit 1.0.

=head1 SEE ALSO

L<https://gitlab.com/nbdkit/nbdkit/blob/master/plugins/example2/example2.c>,
L<https://gitlab.com/nbdkit/nbdkit/blob/master/plugins/example2/winexample2.c>,
L<nbdkit(1)>,
L<nbdkit-plugin(3)>

=head1 AUTHORS

Richard W.M. Jones

=head1 COPYRIGHT

Copyright Red Hat