Dave Rolsky > Apache-Quota-0.04 > Apache::Quota

Download:
Apache-Quota-0.04.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.04   Source  

NAME ^

Apache::Quota - Flexible transfer limiting/throttling under mod_perl

SYNOPSIS ^

  PerlSetVar  QuotaFile  /tmp/Apache-Quota.db
  PerlSetVar  QuotaLocker       BerkeleyDB

  <Location /foo>
    PerlSetVar  QuotaLocationKey  foo
    PerlSetVar  QuotaType         client-ip
    PerlSetVar  QuotaPeriod       1d
    PerlSetVar  QuotaLimit        3M
    PerlSetVar  QuotaOnExceed     notes

    PerlFixupHandler  Apache::Quota
  </Location>

  <Location /bar>
    PerlSetVar  QuotaLocationKey  bar
    PerlSetVar  QuotaType         sub
    PerlSetVar  QuotaSub          "MyApp::get_user_id"
    PerlSetVar  QuotaPeriod       60s
    PerlSetVar  QuotaLimit        500k
    PerlSetVar  QuotaOnExceed     deny

    PerlFixupHandler  Apache::Quota
  </Location>

DESCRIPTION ^

This module provides flexible transfer quotas for all or part of a site. Additionally, quotas may be enforced for the site as a whole, on a per-client IP basis, or based on some other criterion you define.

USAGE ^

Most of this module's functionality is used by setting variables via the mod_perl PerlSetVar directive. The module should be installed as a PerlFixupHandler in a Location or similar Apache configuration block.

PerlSetVar Parameters

The following directives are available:

Functions for External Use

This module also offers some functions for directly looking at and manipulating quotas. None of these functions are exportable.

Common Parameters

All of these functions accept the following parameters:

Functions

SUPPORT ^

Please submit bugs to the CPAN RT system at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Apache%3A%3AQuota or via email at bug-apache-quota@rt.cpan.org.

AUTHOR ^

Dave Rolsky <autarch@urth.org>

COPYRIGHT ^

Copyright (c) 2003 David Rolsky. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.

SEE ALSO ^

The Apache modules mod_bandwidth and mod_throttle.

syntax highlighting: