NAME
    Apache::LimitIPConn - Limit simultaneous connections by an IP address

SYNOPSIS
     <Location /somewhere>
     PerlAccessHandler Apache::LimitIPConn
     PerlSetVar MaxConnPerIP 3
     PerlSetVar NoIPLimit "image/png video"
     </Location>

     <Location /mp3>
     PerlAccessHandler Apache::LimitIPConn
     PerlSetVar MaxConnPerIP 1
     PerlSetVar OnlyIPLimit audio/mpeg
     </Location>

DESCRIPTION
    The Apache::LimitByIPConn module lets you enforce limits on the number
    of simultaneous downloads allowed from a single IP address. You can also
    control which MIME types are affected by the limits.

    The MaxConnPerIP variable dictates the maximum number of simultaneous
    connections that each IP address is allowed. Connections in excess of
    this limit will result in a 403 Forbidden response.

    The NoIPLimit variable specifies a list of MIME types for which limit
    checking is turned off. The OnlyIPLimit variable followed by a list of
    MIME types restricts limit checking only to the types specified under
    this variable. These MIME types match by prefix, so for example

        PerlSetVar NoIPLimit "image"

    turns off limit checking for all MIME types starting with "image",
    including "image/jpeg", "image/png", etc. Wildcard matching with ? and *
    is also supported.

    The job of crafting useful error messages for the client is left as an
    exercise for the reader.

NOTES
    The limits defined by Apache::LimitIPConn apply to all IP addresses
    connecting to your Apache server. Currently there is no way to set
    different limits for different IP addresses.

    Proxy clients are treated no differently from regular clients. Overly
    restrictive limits will adversely affect the accessibility of your site
    from large Internet Service Providers such as AOL that route millions of
    users through a small pool of proxy clients.

    This module requires Apache::Scoreboard and the configuration setting
    "ExtendedStatus On" in the httpd.conf configuration file.

SEE ALSO
    Apache::Scoreboard(3)

AUTHOR
    David Jao <djao@dominia.org>