Update Red Hat Copyright Notices
[nbdkit.git] / filters / limit / nbdkit-limit-filter.pod
blob41f3acfb6b4d52dca13c277f8705a3a24cf6a268
1 =head1 NAME
3 nbdkit-limit-filter - limit number of clients that can connect concurrently
5 =head1 SYNOPSIS
7  nbdkit --filter=limit PLUGIN [limit=N]
9 =head1 DESCRIPTION
11 C<nbdkit-limit-filter> is an nbdkit filter that limits the number of
12 clients which can connect concurrently.  If more than C<limit=N>
13 (default: 1) clients try to connect at the same time then later
14 clients are rejected.
16 =head1 PARAMETERS
18 =over 4
20 =item B<limit=>N
22 Limit the number of concurrent clients to C<N>.  This parameter is
23 optional.  If not specified then the limit defaults to 1.  You can
24 also set this to 0 to make the number of clients unlimited (ie.
25 disable the filter).
27 =back
29 =head1 FILES
31 =over 4
33 =item F<$filterdir/nbdkit-limit-filter.so>
35 The filter.
37 Use C<nbdkit --dump-config> to find the location of C<$filterdir>.
39 =back
41 =head1 VERSION
43 C<nbdkit-limit-filter> first appeared in nbdkit 1.20.
45 =head1 SEE ALSO
47 L<nbdkit(1)>,
48 L<nbdkit-exitlast-filter(1)>,
49 L<nbdkit-exitwhen-filter(1)>,
50 L<nbdkit-ip-filter(1)>,
51 L<nbdkit-noparallel-filter(1)>,
52 L<nbdkit-rate-filter(1)>,
53 L<nbdkit-filter(3)>,
54 L<nbdkit-plugin(3)>.
56 =head1 AUTHORS
58 Richard W.M. Jones
60 =head1 COPYRIGHT
62 Copyright Red Hat