Apache::GTopLimit 1.02

Apache::GTopLimit is a Perl module that will run on platforms supported by GTop.pm a Perl interface to libgtop (which in turn needs libgtop).<br /><br />This module was written in response to questions on the mod_perl mailing list on how to tell the httpd process to exit if:<br /><br />* its memory size goes beyond a specified limit<br />* its shared memory size goes below a specified limit<br />* its unshared memory size goes beyond a specified limit<br /><br />SYNOPSIS<br /><br />This module allows you to kill off Apache httpd processes if they grow too large or have too little of shared memory. You can choose to set up the process size limiter to check the process size on every request:<br /><br /> # in your startup.pl:<br /> # ___________________<br /><br /> use Apache::GTopLimit;<br /><br /> # Control the life based on memory size<br /> # in KB, so this is ~10MB<br /> $Apache::GTopLimit::MAX_PROCESS_SIZE = 10000;<br /><br /> # Control the life based on Shared memory size<br /> # in KB, so this is ~4MB<br /> $Apache::GTopLimit::MIN_PROCESS_SHARED_SIZE = 4000;<br /><br /> # Control the life based on UnShared memory size<br /> # in KB, so this is ~6MB<br /> $Apache::GTopLimit::MAX_PROCESS_UNSHARED_SIZE = 6000;<br /><br /> # in your httpd.conf:<br /> # ___________________<br /><br /> # debug mode must be set before the module is loaded<br /> PerlSetVar Apache::GTopLimit::DEBUG 1<br /><br /> # register handler<br /> PerlFixupHandler Apache::GTopLimit<br /> # you can set this up as any Perl*Handler that handles<br /> # part of the request, even the LogHandler will do.<br /><br />Or you can just check those requests that are likely to get big or unshared. This way of checking is also easier for those who are mostly just running Apache::Registry scripts:<br /><br /> # in your handler/CGI script<br /> use Apache::GTopLimit;<br /> # Max Process Size in KB<br /> Apache::GTopLimit->set_max_size(10000);<br /><br />and/or<br /><br /> use Apache::GTopLimit;<br /> # Min Shared process Size in KB<br /> Apache::GTopLimit->set_min_shared_size(4000);<br /><br />and/or<br /><br /> use Apache::GTopLimit;<br /> # Min UnShared process Size in KB<br /> Apache::GTopLimit->set_max_unshared_size(6000);<br /><br />Since accessing the process info might add a little overhead, you may want to only check the process size every N times. To do so, put this in your startup.pl or CGI:<br /><br /> $Apache::GTopLimit::CHECK_EVERY_N_REQUESTS = 2;<br /><br />This will only check the process size every other time the process size checker is called.<br /><br />Note: The MAX_PROCESS_SIZE, MIN_PROCESS_SHARED_SIZE and MAX_PROCESS_UNSHARED_SIZE are independent, and each will be checked if only set. So if you set the first two -- the process can be killed if it grows beyond the limit or its shared memory goes below the limit. It's better not to mix MAX_PROCESS_UNSHARED_SIZE with the first two.

Requirements:	No special requirements
Platforms:	*nix, Linux , Win All
Keyword:	Apachegtoplimit,  Apachegtoplimit 1 02,  Based,  Check,  Control,  Limit,  Max Process Unshared Size,  Memory,  Module,  Process,  Shared,  Unshared
Users rating:	0/10