From f5bf2be07bc67b554c52f50796266a1e380a8f61 Mon Sep 17 00:00:00 2001
From: Ilia Ross <ilia@ross.gdn>
Date: Sun, 21 Jun 2026 23:25:15 +0200
Subject: [PATCH] Add Apache process limit directive help

---
 apache/core.pl                         | 19 +++++++++++--------
 apache/help/AssignUserId.html          |  7 +++++++
 apache/help/ChildPerUserId.html        |  7 +++++++
 apache/help/LimitRequestBody.html      |  7 +++++++
 apache/help/LimitRequestFields.html    |  7 +++++++
 apache/help/LimitRequestFieldsize.html |  7 +++++++
 apache/help/LimitRequestLine.html      |  7 +++++++
 apache/help/LimitXMLRequestBody.html   |  6 ++++++
 apache/help/MaxThreadsPerChild.html    |  6 ++++++
 apache/help/NumServers.html            |  6 ++++++
 apache/help/RLimitCPU.html             |  8 ++++++++
 apache/help/RLimitMEM.html             |  8 ++++++++
 apache/help/RLimitNPROC.html           |  8 ++++++++
 apache/help/StartThreads.html          |  7 +++++++
 apache/mpm_netware.pl                  |  2 +-
 apache/perchild.pl                     | 10 +++++-----
 16 files changed, 108 insertions(+), 14 deletions(-)
 create mode 100644 apache/help/AssignUserId.html
 create mode 100644 apache/help/ChildPerUserId.html
 create mode 100644 apache/help/LimitRequestBody.html
 create mode 100644 apache/help/LimitRequestFields.html
 create mode 100644 apache/help/LimitRequestFieldsize.html
 create mode 100644 apache/help/LimitRequestLine.html
 create mode 100644 apache/help/LimitXMLRequestBody.html
 create mode 100644 apache/help/MaxThreadsPerChild.html
 create mode 100644 apache/help/NumServers.html
 create mode 100644 apache/help/RLimitCPU.html
 create mode 100644 apache/help/RLimitMEM.html
 create mode 100644 apache/help/RLimitNPROC.html
 create mode 100644 apache/help/StartThreads.html

diff --git a/apache/core.pl b/apache/core.pl
index 42228bfe6..18714c294 100755
--- a/apache/core.pl
+++ b/apache/core.pl
@@ -253,7 +253,8 @@ return &parse_opt("ThreadsPerChild", '^\d+$',
 
 sub edit_RLimitCPU
 {
-return &rlimit_input("RLimitCPU", $text{'core_cpulimit'}, $_[0]);
+return &rlimit_input("RLimitCPU",
+		     &hlink($text{'core_cpulimit'}, "RLimitCPU"), $_[0]);
 }
 sub save_RLimitCPU
 {
@@ -262,7 +263,8 @@ return &parse_rlimit("RLimitCPU", $text{'core_cpulimit2'});
 
 sub edit_RLimitMEM
 {
-return &rlimit_input("RLimitMEM", $text{'core_memlimit'}, $_[0]);
+return &rlimit_input("RLimitMEM",
+		     &hlink($text{'core_memlimit'}, "RLimitMEM"), $_[0]);
 }
 sub save_RLimitMEM
 {
@@ -271,7 +273,8 @@ return &parse_rlimit("RLimitMEM", $text{'core_memlimit2'});
 
 sub edit_RLimitNPROC
 {
-return &rlimit_input("RLimitNPROC", $text{'core_proclimit'}, $_[0]);
+return &rlimit_input("RLimitNPROC",
+		     &hlink($text{'core_proclimit'}, "RLimitNPROC"), $_[0]);
 }
 sub save_RLimitNPROC
 {
@@ -1353,7 +1356,7 @@ return &parse_opt("LockFile", '^\S+', $text{'core_elock'});
 
 sub edit_LimitRequestBody
 {
-return (1, $text{'core_maxbody'},
+return (1, &hlink($text{'core_maxbody'}, "LimitRequestBody"),
 	&opt_input($_[0]->{'value'}, "LimitRequestBody", $text{'core_default'}, 8)
 		.&ui_space(2).$text{'bytes'});
 }
@@ -1364,7 +1367,7 @@ return &parse_opt("LimitRequestBody", '^\d+$', $text{'core_ebody'});
 
 sub edit_LimitXMLRequestBody
 {
-return (1, $text{'core_maxxml'},
+return (1, &hlink($text{'core_maxxml'}, "LimitXMLRequestBody"),
 	&opt_input($_[0]->{'value'}, "LimitXMLRequestBody",
 		   $text{'core_default'}, 8).&ui_space(2).$text{'bytes'});
 }
@@ -1377,7 +1380,7 @@ return &parse_opt("LimitXMLRequestBody", '^\d+$', $text{'core_exml'});
 
 sub edit_LimitRequestFields
 {
-return (1, $text{'core_maxhead'},
+return (1, &hlink($text{'core_maxhead'}, "LimitRequestFields"),
 	&opt_input($_[0]->{'value'}, "LimitRequestFields", $text{'core_default'}, 6));
 }
 sub save_LimitRequestFields
@@ -1387,7 +1390,7 @@ return &parse_opt("LimitRequestFields", '^\d+$', $text{'core_ehead'});
 
 sub edit_LimitRequestFieldsize
 {
-return (1, $text{'core_maxshead'},
+return (1, &hlink($text{'core_maxshead'}, "LimitRequestFieldsize"),
 	&opt_input($_[0]->{'value'}, "LimitRequestFieldsize", $text{'core_default'}, 6));
 }
 sub save_LimitRequestFieldsize
@@ -1397,7 +1400,7 @@ return &parse_opt("LimitRequestFieldsize", '^\d+$', $text{'core_eshead'});
 
 sub edit_LimitRequestLine
 {
-return (1, $text{'core_maxline'},
+return (1, &hlink($text{'core_maxline'}, "LimitRequestLine"),
 	&opt_input($_[0]->{'value'}, "LimitRequestLine", $text{'core_default'}, 6));
 }
 sub save_LimitRequestLine
diff --git a/apache/help/AssignUserId.html b/apache/help/AssignUserId.html
new file mode 100644
index 000000000..5e1859b15
--- /dev/null
+++ b/apache/help/AssignUserId.html
@@ -0,0 +1,7 @@
+<header>Tie virtual to child process</header>
+The <tt>AssignUserId</tt> directive assigns a virtual host to a child process
+running with the selected user ID and group ID for the legacy perchild MPM.
+<p>
+This directive is only available for Apache versions and MPMs that support
+perchild.
+<p><footer>
diff --git a/apache/help/ChildPerUserId.html b/apache/help/ChildPerUserId.html
new file mode 100644
index 000000000..ed7311817
--- /dev/null
+++ b/apache/help/ChildPerUserId.html
@@ -0,0 +1,7 @@
+<header>Child process UID assignments</header>
+The <tt>ChildPerUserId</tt> directive defines how many child processes should
+run for a selected user ID and group ID in the legacy perchild MPM.
+<p>
+This directive is only available for Apache versions and MPMs that support
+perchild.
+<p><footer>
diff --git a/apache/help/LimitRequestBody.html b/apache/help/LimitRequestBody.html
new file mode 100644
index 000000000..1f821b819
--- /dev/null
+++ b/apache/help/LimitRequestBody.html
@@ -0,0 +1,7 @@
+<header>Maximum request body size</header>
+The <tt>LimitRequestBody</tt> directive sets the maximum allowed size of an HTTP
+request body in bytes.
+<p>
+This can be used to limit upload or form submission size for the server,
+virtual host, directory, or location where the directive is applied.
+<p><footer>
diff --git a/apache/help/LimitRequestFields.html b/apache/help/LimitRequestFields.html
new file mode 100644
index 000000000..28ef23c85
--- /dev/null
+++ b/apache/help/LimitRequestFields.html
@@ -0,0 +1,7 @@
+<header>Maximum headers in request</header>
+The <tt>LimitRequestFields</tt> directive sets the maximum number of HTTP
+request header fields that Apache will accept.
+<p>
+Lowering this limit can reduce exposure to unusually large requests, but values
+that are too low can reject legitimate clients.
+<p><footer>
diff --git a/apache/help/LimitRequestFieldsize.html b/apache/help/LimitRequestFieldsize.html
new file mode 100644
index 000000000..70504405e
--- /dev/null
+++ b/apache/help/LimitRequestFieldsize.html
@@ -0,0 +1,7 @@
+<header>Maximum request header size</header>
+The <tt>LimitRequestFieldSize</tt> directive sets the maximum size of each HTTP
+request header field in bytes.
+<p>
+Lowering this limit can reject oversized request headers, but values that are
+too low can break clients that send larger cookies or authorization headers.
+<p><footer>
diff --git a/apache/help/LimitRequestLine.html b/apache/help/LimitRequestLine.html
new file mode 100644
index 000000000..0918a4e0b
--- /dev/null
+++ b/apache/help/LimitRequestLine.html
@@ -0,0 +1,7 @@
+<header>Maximum request line size</header>
+The <tt>LimitRequestLine</tt> directive sets the maximum size of the HTTP
+request line in bytes.
+<p>
+This line contains the method, requested URI, and HTTP protocol version. Values
+that are too low can reject legitimate long URLs.
+<p><footer>
diff --git a/apache/help/LimitXMLRequestBody.html b/apache/help/LimitXMLRequestBody.html
new file mode 100644
index 000000000..eb3a5ab7d
--- /dev/null
+++ b/apache/help/LimitXMLRequestBody.html
@@ -0,0 +1,6 @@
+<header>Maximum XML request body size</header>
+The <tt>LimitXMLRequestBody</tt> directive sets the maximum allowed size of an
+XML request body in bytes.
+<p>
+It is mainly used by modules that parse XML request bodies, such as WebDAV.
+<p><footer>
diff --git a/apache/help/MaxThreadsPerChild.html b/apache/help/MaxThreadsPerChild.html
new file mode 100644
index 000000000..0fd3678b0
--- /dev/null
+++ b/apache/help/MaxThreadsPerChild.html
@@ -0,0 +1,6 @@
+<header>Maximum threads per child process</header>
+The <tt>MaxThreadsPerChild</tt> directive sets the maximum number of worker
+threads allowed in each child process for the legacy perchild MPM.
+<p>
+This directive only appears for Apache versions and MPMs that support perchild.
+<p><footer>
diff --git a/apache/help/NumServers.html b/apache/help/NumServers.html
new file mode 100644
index 000000000..9824c7559
--- /dev/null
+++ b/apache/help/NumServers.html
@@ -0,0 +1,6 @@
+<header>Number of child processes</header>
+The <tt>NumServers</tt> directive sets the number of child server processes for
+the legacy perchild MPM.
+<p>
+This directive only appears for Apache versions and MPMs that support perchild.
+<p><footer>
diff --git a/apache/help/RLimitCPU.html b/apache/help/RLimitCPU.html
new file mode 100644
index 000000000..f122e60c7
--- /dev/null
+++ b/apache/help/RLimitCPU.html
@@ -0,0 +1,8 @@
+<header>CPU resource limit</header>
+The <tt>RLimitCPU</tt> directive sets a CPU time resource limit for processes
+started by Apache in this context, such as CGI programs where supported by the
+operating system.
+<p>
+The soft limit is applied first. If a hard limit is also set, it is the maximum
+value that the process can raise the soft limit to.
+<p><footer>
diff --git a/apache/help/RLimitMEM.html b/apache/help/RLimitMEM.html
new file mode 100644
index 000000000..2c5ebc272
--- /dev/null
+++ b/apache/help/RLimitMEM.html
@@ -0,0 +1,8 @@
+<header>Memory resource limit</header>
+The <tt>RLimitMEM</tt> directive sets a memory resource limit for processes
+started by Apache in this context, such as CGI programs where supported by the
+operating system.
+<p>
+The soft limit is applied first. If a hard limit is also set, it is the maximum
+value that the process can raise the soft limit to.
+<p><footer>
diff --git a/apache/help/RLimitNPROC.html b/apache/help/RLimitNPROC.html
new file mode 100644
index 000000000..83a563a88
--- /dev/null
+++ b/apache/help/RLimitNPROC.html
@@ -0,0 +1,8 @@
+<header>Process limit</header>
+The <tt>RLimitNPROC</tt> directive sets a process count resource limit for
+processes started by Apache in this context, such as CGI programs where
+supported by the operating system.
+<p>
+The soft limit is applied first. If a hard limit is also set, it is the maximum
+value that the process can raise the soft limit to.
+<p><footer>
diff --git a/apache/help/StartThreads.html b/apache/help/StartThreads.html
new file mode 100644
index 000000000..14c727b89
--- /dev/null
+++ b/apache/help/StartThreads.html
@@ -0,0 +1,7 @@
+<header>Initial threads per child process</header>
+The <tt>StartThreads</tt> directive sets how many worker threads are created at
+startup for legacy threaded MPMs that support this directive.
+<p>
+Apache may adjust the number of running workers after startup based on traffic
+and the configured spare thread limits.
+<p><footer>
diff --git a/apache/mpm_netware.pl b/apache/mpm_netware.pl
index 49578d93d..c34aa9863 100755
--- a/apache/mpm_netware.pl
+++ b/apache/mpm_netware.pl
@@ -42,7 +42,7 @@ return &parse_opt("MaxSpareThreads", '^\d+$',
 sub edit_StartThreads
 {
 return (1,
-	$text{'perchild_sthreads'},
+	&hlink($text{'perchild_sthreads'}, "StartThreads"),
 	&opt_input($_[0]->{'value'},"StartThreads",$text{'default'}, 4));
 }
 sub save_StartThreads
diff --git a/apache/perchild.pl b/apache/perchild.pl
index bfaf1c880..2ecf0974f 100755
--- a/apache/perchild.pl
+++ b/apache/perchild.pl
@@ -35,7 +35,7 @@ $rv .= sprintf "<input type=radio name=AssignUserId_def value=0 %s>\n",
 $rv .= &text('perchild_assignug',
 	"<input name=AssignUserId_uid size=8 value='$_[0]->{'words'}->[0]'>",
 	"<input name=AssignUserId_gid size=8 value='$_[0]->{'words'}->[1]'>");
-return (2, $text{'perchild_assign'}, $rv);
+return (2, &hlink($text{'perchild_assign'}, "AssignUserId"), $rv);
 }
 sub save_AssignUserId
 {
@@ -66,7 +66,7 @@ foreach $c (@{$_[0]}, undef) {
 	$i++;
 	}
 $rv .= "</table>\n";
-return (2, $text{'perchild_child'}, $rv);
+return (2, &hlink($text{'perchild_child'}, "ChildPerUserId"), $rv);
 }
 sub save_ChildPerUserId
 {
@@ -112,7 +112,7 @@ return &parse_opt("MaxSpareThreads", '^\d+$',
 sub edit_StartThreads
 {
 return (1,
-	$text{'perchild_sthreads'},
+	&hlink($text{'perchild_sthreads'}, "StartThreads"),
 	&opt_input($_[0]->{'value'},"StartThreads",$text{'default'}, 4));
 }
 sub save_StartThreads
@@ -124,7 +124,7 @@ return &parse_opt("StartThreads", '^\d+$',
 sub edit_NumServers
 {
 return (1,
-	$text{'perchild_numservers'},
+	&hlink($text{'perchild_numservers'}, "NumServers"),
 	&opt_input($_[0]->{'value'},"NumServers",$text{'default'}, 4));
 }
 sub save_NumServers
@@ -136,7 +136,7 @@ return &parse_opt("NumServers", '^\d+$',
 sub edit_MaxThreadsPerChild
 {
 return (1,
-	$text{'perchild_maxthreads'},
+	&hlink($text{'perchild_maxthreads'}, "MaxThreadsPerChild"),
 	&opt_input($_[0]->{'value'},"MaxThreadsPerChild",$text{'default'}, 4));
 }
 sub save_MaxThreadsPerChild