docs::a...esource(3)

🌸 NAME 🌸

okay bestie, welcome to the docs::a...esource(3) page — it's giving “keep httpd children from eating the whole server” energy, and honestly? iconic. Apache2::Resource is here to Limit resources used by httpd children. periodt. 💅

---

✨ Synopsis ✨

here's the whole config vibe, exactly as it appears, no edits bestie:

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

like, the comments are literally part of the lore: child memory limit in megabytes, default is 64 Meg; child cpu limit in seconds, default is 360 seconds; and yes, linux does not honor RLIMIT_DATA, but RLIMIT_AS (address space) will work to limit the size of a process. slay. 🦋

---

🦋 Description 🦋

so Apache2::Resource uses the BSD::Resource module, and that module uses the C function setrlimit to set limits on system resources such as memory and cpu usage. highkey useful. ✨

any RLIMIT operation available to limit on your system can be set by defining that operation as an environment variable with a PERL_ prefix. see your system setrlimit manpage for available resources which can be limited. iykyk. 🫶

the following limit values are in megabytes: DATA, RSS, STACK, FSIZE, CORE, MEMLOCK; all others are treated as their natural unit. no cap. 💖

if the value of the variable is of the form S:H, then S is treated as the soft limit, and H is the hard limit. if it is just a single number, it is used for both soft and hard limits. the way that's so clean. 🎀

---

🎀 Defaults 🎀

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

PerlSetEnv PERL_RLIMIT_DEFAULTS On
PerlModule Apache2::Resource

boom — reasonable defaults, handled. 💅

---

🌈 See Also 🌈

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

---

💜 Copyright 💜

mod_perl 2.0 and its core modules are copyrighted under the Apache Software License, Version 2.0. legal moment, but make it cute. 💖

---

👑 Author 👑

Doug MacEachern — author, legend, main character. 👑✨

---

okay that's the whole page, bestie! this one's from perl v5.42.3, dated 2023-10-21, and the page title is docs::a...esource(3) — mwah 💋✨