Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
PerlSections	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
Access.pm	14.75 KB	-rw-r--r--	2022-10-20 09:29
Build.pm	61.42 KB	-rw-r--r--	2022-10-20 09:29
BuildConfig.pm	6.81 KB	-rw-r--r--	2022-10-20 09:29
CmdParms.pm	9.93 KB	-rw-r--r--	2022-10-20 09:29
Command.pm	3.41 KB	-rw-r--r--	2022-10-20 09:29
Connection.pm	15.61 KB	-rw-r--r--	2022-10-20 09:29
ConnectionUtil.pm	2.81 KB	-rw-r--r--	2022-10-20 09:29
Const.pm	25.46 KB	-rw-r--r--	2022-10-20 09:29
Directive.pm	7.65 KB	-rw-r--r--	2022-10-20 09:29
Filter.pm	26.79 KB	-rw-r--r--	2022-10-20 09:29
FilterRec.pm	2.17 KB	-rw-r--r--	2022-10-20 09:29
HookRun.pm	13.14 KB	-rw-r--r--	2022-10-20 09:29
Log.pm	18.44 KB	-rw-r--r--	2022-10-20 09:29
MPM.pm	2.75 KB	-rw-r--r--	2022-10-20 09:29
Module.pm	8.13 KB	-rw-r--r--	2022-10-20 09:29
ParseSource.pm	16.72 KB	-rw-r--r--	2022-01-30 13:02
PerlSections.pm	16.89 KB	-rw-r--r--	2022-10-20 09:29
Process.pm	2.46 KB	-rw-r--r--	2022-10-20 09:29
Provider.pm	543 B	-rw-r--r--	2022-10-20 09:29
RequestIO.pm	10.02 KB	-rw-r--r--	2022-10-20 09:29
RequestRec.pm	41.51 KB	-rw-r--r--	2022-10-20 09:29
RequestUtil.pm	27.83 KB	-rw-r--r--	2022-10-20 09:29
Resource.pm	5.72 KB	-rw-r--r--	2022-10-20 09:29
Response.pm	9.85 KB	-rw-r--r--	2022-10-20 09:29
ServerRec.pm	16.63 KB	-rw-r--r--	2022-10-20 09:29
ServerUtil.pm	21.82 KB	-rw-r--r--	2022-10-20 09:29
SizeLimit.pm	16.44 KB	-rw-r--r--	2022-01-30 13:02
SourceTables.pm	1.29 KB	-rw-r--r--	2022-01-30 13:02
Status.pm	29.93 KB	-rw-r--r--	2022-10-20 09:29
SubProcess.pm	6.72 KB	-rw-r--r--	2022-10-20 09:29
SubRequest.pm	10.13 KB	-rw-r--r--	2022-10-20 09:29
URI.pm	6.55 KB	-rw-r--r--	2022-10-20 09:29
Util.pm	3.53 KB	-rw-r--r--	2022-10-20 09:29
XSLoader.pm	1.27 KB	-rw-r--r--	2022-01-30 13:02
compat.pm	26.32 KB	-rw-r--r--	2022-10-20 09:29
porting.pm	6.09 KB	-rw-r--r--	2022-10-20 09:29

Rename

# please insert nothing before this line: -*- mode: cperl; cperl-indent-level: 4; cperl-continued-statement-offset: 4; indent-tabs-mode: nil -*-
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License.  You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

package Apache2::Resource;

use strict;
use warnings FATAL => 'all';

use mod_perl2;

use Apache2::Module ();

use BSD::Resource qw(setrlimit getrlimit get_rlimits);

use Apache2::Const -compile => qw(OK);

$Apache2::Resource::VERSION = '1.72';

our $Debug;

$Debug ||= 0;

sub MB ($) {
    my $num = shift;
    return ($num < (1024 * 1024)) ?  $num*1024*1024 : $num;
}

sub BM ($) {
    my $num = shift;
    return ($num > (1024 * 1024)) ?  '(' . ($num>>20) . 'Mb)' : '';
}

sub DEFAULT_RLIMIT_DATA  () { 64   } # data (memory) size in MB
sub DEFAULT_RLIMIT_AS    () { 64   } # address space (memory) size in MB
sub DEFAULT_RLIMIT_CPU   () { 60*6 } # cpu time in seconds
sub DEFAULT_RLIMIT_CORE  () { 0    } # core file size (MB)
sub DEFAULT_RLIMIT_RSS   () { 16   } # resident set size (MB)
sub DEFAULT_RLIMIT_FSIZE () { 10   } # file size  (MB)
sub DEFAULT_RLIMIT_STACK () { 20   } # stack size (MB)

my %is_mb = map {$_, 1} qw{DATA RSS STACK FSIZE CORE MEMLOCK AS};

sub debug { print STDERR @_ if $Debug }

sub install_rlimit ($$$) {
    my ($res, $soft, $hard) = @_;

my $name = $res;

my $cv = \&{"BSD::Resource::RLIMIT_${res}"};
    eval { $res = $cv->() };
    return if $@;

unless ($soft) {
        my $defval = \&{"DEFAULT_RLIMIT_${name}"};
        if (defined &$defval) {
            $soft = $defval->();
        } else {
            warn "can't find default for `$defval'\n";
        }
    }

$hard ||= $soft;

debug "Apache2::Resource: PID $$ attempting to set `$name'=$soft:$hard ...";

($soft, $hard) = (MB $soft, MB $hard) if $is_mb{$name};

return setrlimit $res, $soft, $hard;
}

sub handler {
    while (my ($k, $v) = each %ENV) {
        next unless $k =~ /^PERL_RLIMIT_(\w+)$/;
        $k = $1;
        next if $k eq "DEFAULTS";
        my ($soft, $hard) = split ":", $v, 2;
        $hard ||= $soft;

my $set = install_rlimit $k, $soft, $hard;
        debug "not " unless $set;
        debug "ok\n";
        debug $@ if $@;
    }

Apache2::Const::OK;
}

sub default_handler {
    while (my ($k, $v) = each %Apache2::Resource::) {
        next unless $k =~ s/^DEFAULT_/PERL_/;
        $ENV{$k} = "";
    }
    handler();
}

sub status_rlimit {
    my $lim = get_rlimits();
    my @retval = ("<table border=1><tr>",
                  (map "<th>$_</th>", qw(Resource Soft Hard)),
                  "</tr>");

for my $res (keys %$lim) {
        my ($soft, $hard) = getrlimit($lim->{$res});
        (my $limit = $res) =~ s/^RLIMIT_//;
        ($soft, $hard) = ("$soft " . BM($soft), "$hard ". BM($hard))
            if $is_mb{$limit};
        push @retval,
            "<tr>", (map { "<td>$_</td>" } $res, $soft, $hard), "</tr>\n";
    }

push @retval, "</table><P>";
    push @retval, "<small>Apache2::Resource $Apache2::Resource::VERSION</small>";

return \@retval;
}

if ($ENV{MOD_PERL}) {
    if ($ENV{PERL_RLIMIT_DEFAULTS}) {
        require Apache2::ServerUtil;
        Apache2::ServerUtil->server->push_handlers(
            PerlChildInitHandler => \&default_handler);
    }

Apache2::Status->menu_item(rlimit => "Resource Limits",
            \&status_rlimit)
          if Apache2::Module::loaded("Apache2::Status");
}

# perl Apache2/Resource.pm
++$Debug, default_handler unless caller();

__END__

=head1 NAME

Apache2::Resource - Limit resources used by httpd children

=head1 Synopsis

PerlModule Apache2::Resource
  # set child memory limit in megabytes
  # default is 64 Meg
  PerlSetEnv PERL_RLIMIT_DATA 32:48
  
  # linux does not honor RLIMIT_DATA
  # RLIMIT_AS (address space) will work to limit the size of a process
  PerlSetEnv PERL_RLIMIT_AS 32:48
  
  # set child cpu limit in seconds
  # default is 360 seconds
  PerlSetEnv PERL_RLIMIT_CPU 120
  
  PerlChildInitHandler Apache2::Resource

=head1 Description

C<Apache2::Resource> uses the C<BSD::Resource> module, which uses the C
function C<setrlimit> to set limits on system resources such as memory
and cpu usage.

Any C<RLIMIT> operation available to limit on your system can be set
by defining that operation as an environment variable with a C<PERL_>
prefix.  See your system C<setrlimit> manpage for available resources
which can be limited.

The following limit values are in megabytes: C<DATA>, C<RSS>,
C<STACK>, C<FSIZE>, C<CORE>, C<MEMLOCK>; all others are treated as
their natural unit.

If the value of the variable is of the form C<S:H>, C<S> is treated as
the soft limit, and C<H> is the hard limit.  If it is just a single
number, it is used for both soft and hard limits.

=head1 Defaults

To set reasonable defaults for all RLIMITs, add this to your httpd.conf:

PerlSetEnv PERL_RLIMIT_DEFAULTS On
  PerlModule Apache2::Resource

=head1 See Also

BSD::Resource(3), setrlimit(2)

=head1 Copyright

mod_perl 2.0 and its core modules are copyrighted under
The Apache Software License, Version 2.0.

=head1 Author

Doug MacEachern

=cut