Skip to content

Commit b89968f

Browse files
author
docs-bot
committed
docs: update from source@1339f38
1 parent f442b69 commit b89968f

3 files changed

Lines changed: 17 additions & 5 deletions

File tree

‎docs/kernel-configuration.html‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -443,17 +443,17 @@ <h3 id="3-what-to-do-if-something-is-missing">3. What to do if something is miss
443443
</tr>
444444
<tr>
445445
<td>Memory limit</td>
446-
<td><code>CONFIG_MEMCG=y</code></td>
446+
<td><code>CONFIG_MEMCG=y</code>, and no <code>cgroup_disable=memory</code> on the kernel command line</td>
447447
<td><code>--memory</code> is skipped.</td>
448448
</tr>
449449
<tr>
450450
<td>CPU limit</td>
451-
<td><code>CONFIG_CFS_BANDWIDTH=y</code></td>
451+
<td><code>CONFIG_CFS_BANDWIDTH=y</code>, and no <code>cgroup_disable=cpu</code> on the kernel command line</td>
452452
<td><code>--cpus</code> is skipped.</td>
453453
</tr>
454454
<tr>
455455
<td>Process limit</td>
456-
<td><code>CONFIG_CGROUP_PIDS=y</code></td>
456+
<td><code>CONFIG_CGROUP_PIDS=y</code>, and no <code>cgroup_disable=pids</code> on the kernel command line</td>
457457
<td><code>--pids-limit</code> is skipped.</td>
458458
</tr>
459459
<tr>

‎docs/search.json‎

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

‎docs/troubleshooting.html‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,7 @@ <h3 id="quick-navigation">Quick navigation <a class="header-anchor" href="#quick
9494
<li><a href="#reclaim-storage">Reclaiming storage (sparse image)</a></li>
9595
<li><a href="#nuke-wifi-powersave">Wi-Fi <code>Power save: on</code> makes networking sluggish on Android</a></li>
9696
<li><a href="#sysinfo-host-values">LuCI, or another tool, shows the host's RAM and load despite a limit</a></li>
97+
<li><a href="#controller-disabled-at-boot">A resource limit is unavailable although its kernel option is enabled</a></li>
9798
<li><a href="#getting-help">Getting help</a></li>
9899
</ul>
99100
<hr />
@@ -350,6 +351,17 @@ <h2 id="luci-or-another-tool-shows-the-hosts-ram-and-load-despite-a-limit">LuCI,
350351
<p><strong>Checking a limit yourself:</strong> run <code>droidspaces -n &lt;name&gt; info</code> on the host, or <code>cat /proc/meminfo</code> inside the container.</p>
351352
<p>There is no fix for this at the moment. Intercepting <code>sysinfo()</code> needs seccomp user notifications, which only exist on kernel 5.0 and later.</p>
352353
<hr />
354+
<p><a id="controller-disabled-at-boot"></a></p>
355+
<h2 id="a-resource-limit-is-unavailable-although-its-kernel-option-is-enabled">A resource limit is unavailable although its kernel option is enabled <a class="header-anchor" href="#a-resource-limit-is-unavailable-although-its-kernel-option-is-enabled">#</a></h2>
356+
<p><strong>Symptom:</strong> <code>droidspaces check</code> marks &quot;Memory limit support&quot;, &quot;CPU limit support&quot; or &quot;Process limit support&quot; as missing, the app greys out the matching toggle, or a start prints for example <code>memory.max is not available on this kernel</code>, yet <code>/proc/config.gz</code> has the option (<code>CONFIG_MEMCG=y</code>, <code>CONFIG_CFS_BANDWIDTH=y</code>, <code>CONFIG_CGROUP_PIDS=y</code>).</p>
357+
<p><strong>Cause:</strong> the controller is built in but was switched off at boot. Look at the last column of <code>/proc/cgroups</code>:</p>
358+
<div class="code-block"><button class="icon-button copy-btn" onclick="copyCode(this)" aria-label="Copy"><span class="icon" aria-hidden="true">content_copy</span></button><pre><code>#subsys_name hierarchy num_cgroups enabled
359+
memory 0 255 0
360+
</code></pre></div>
361+
<p>A <code>0</code> there means the kernel was booted with <code>cgroup_disable=</code> for that controller: <code>cgroup_disable=memory</code>, <code>cgroup_disable=cpu</code> or <code>cgroup_disable=pids</code>. Confirm it with <code>cat /proc/cmdline</code>. <code>cgroup_disable=memory</code> is the common one, many vendor and custom Android kernels use it to save a little memory.</p>
362+
<p><strong>Fix:</strong> remove the argument from the kernel command line. It comes from <code>CONFIG_CMDLINE</code> in the kernel config, from the boot image header (<code>boot</code> or <code>vendor_boot</code>), or from the bootloader. If <code>zcat /proc/config.gz | grep CMDLINE</code> does not show it, it is one of the last two. Avoid <code>CONFIG_CMDLINE_FORCE</code> as a way out on Android: it drops every other argument the device passes at boot as well.</p>
363+
<p>The container still starts either way, only the limit is skipped.</p>
364+
<hr />
353365
<h2 id="getting-help">Getting help <a class="header-anchor" href="#getting-help">#</a></h2>
354366
<p>If your problem is not listed here:</p>
355367
<ol>
@@ -365,7 +377,7 @@ <h2 id="getting-help">Getting help <a class="header-anchor" href="#getting-help"
365377
<nav class="doc-nav" aria-label="Pages"><a href="cool-things-you-can-do.html" class="doc-nav-prev"><small>Previous</small>Cool things you can do</a><a href="community-supported-devices.html" class="doc-nav-next"><small>Next</small>Community-supported devices</a></nav>
366378
</main>
367379
<aside class="toc-column">
368-
<nav class="toc" aria-label="On this page"><p class="toc-title">On this page</p><ul><li class="toc-h3"><a href="#quick-navigation">Quick navigation</a></li><li class="toc-h2"><a href="#modern-distros-arch-fedora-etc-failure-on-legacy-kernels">Modern distros (Arch, Fedora, etc.) failure on legacy kernels</a></li><li class="toc-h2"><a href="#required-key-not-available">&quot;Required key not available&quot;</a></li><li class="toc-h2"><a href="#mount-errors-on-kernel-414">Mount errors on kernel 4.14</a></li><li class="toc-h2"><a href="#overlayfs-not-supported-f2fs">OverlayFS not supported (f2fs)</a></li><li class="toc-h2"><a href="#container-name-conflicts">Container name conflicts</a></li><li class="toc-h2"><a href="#systemd-hangs-on-older-kernels">systemd hangs on older kernels</a></li><li class="toc-h2"><a href="#container-wont-stop">Container won&#x27;t stop</a></li><li class="toc-h2"><a href="#rootfs-image-io-errors-on-android">Rootfs image I/O errors on Android</a></li><li class="toc-h2"><a href="#networking-is-completely-dead---ping-fails-with-socket-permission-denied">Networking is completely dead - ping fails with &quot;socket: permission denied&quot;</a></li><li class="toc-h2"><a href="#dns--name-resolution-issues">DNS / name resolution issues</a></li><li class="toc-h2"><a href="#wifimobile-data-disconnects">WiFi/mobile data disconnects</a></li><li class="toc-h2"><a href="#selinux-induced-rootfs-corruption-directory-mode">SELinux-induced rootfs corruption (directory mode)</a></li><li class="toc-h2"><a href="#reclaiming-storage-sparse-image">Reclaiming storage (sparse image)</a></li><li class="toc-h2"><a href="#wi-fi-power-save-on-causing-sluggish-networking-on-android">Wi-Fi Power save: on causing sluggish networking on Android</a></li><li class="toc-h3"><a href="#1-install-required-utilities">1. Install required utilities</a></li><li class="toc-h3"><a href="#2-create-the-watchdog-script">2. Create the watchdog script</a></li><li class="toc-h3"><a href="#3-wire-up-the-init-service">3. Wire up the init service</a></li><li class="toc-h2"><a href="#luci-or-another-tool-shows-the-hosts-ram-and-load-despite-a-limit">LuCI, or another tool, shows the host&#x27;s RAM and load despite a limit</a></li><li class="toc-h2"><a href="#getting-help">Getting help</a></li></ul></nav>
380+
<nav class="toc" aria-label="On this page"><p class="toc-title">On this page</p><ul><li class="toc-h3"><a href="#quick-navigation">Quick navigation</a></li><li class="toc-h2"><a href="#modern-distros-arch-fedora-etc-failure-on-legacy-kernels">Modern distros (Arch, Fedora, etc.) failure on legacy kernels</a></li><li class="toc-h2"><a href="#required-key-not-available">&quot;Required key not available&quot;</a></li><li class="toc-h2"><a href="#mount-errors-on-kernel-414">Mount errors on kernel 4.14</a></li><li class="toc-h2"><a href="#overlayfs-not-supported-f2fs">OverlayFS not supported (f2fs)</a></li><li class="toc-h2"><a href="#container-name-conflicts">Container name conflicts</a></li><li class="toc-h2"><a href="#systemd-hangs-on-older-kernels">systemd hangs on older kernels</a></li><li class="toc-h2"><a href="#container-wont-stop">Container won&#x27;t stop</a></li><li class="toc-h2"><a href="#rootfs-image-io-errors-on-android">Rootfs image I/O errors on Android</a></li><li class="toc-h2"><a href="#networking-is-completely-dead---ping-fails-with-socket-permission-denied">Networking is completely dead - ping fails with &quot;socket: permission denied&quot;</a></li><li class="toc-h2"><a href="#dns--name-resolution-issues">DNS / name resolution issues</a></li><li class="toc-h2"><a href="#wifimobile-data-disconnects">WiFi/mobile data disconnects</a></li><li class="toc-h2"><a href="#selinux-induced-rootfs-corruption-directory-mode">SELinux-induced rootfs corruption (directory mode)</a></li><li class="toc-h2"><a href="#reclaiming-storage-sparse-image">Reclaiming storage (sparse image)</a></li><li class="toc-h2"><a href="#wi-fi-power-save-on-causing-sluggish-networking-on-android">Wi-Fi Power save: on causing sluggish networking on Android</a></li><li class="toc-h3"><a href="#1-install-required-utilities">1. Install required utilities</a></li><li class="toc-h3"><a href="#2-create-the-watchdog-script">2. Create the watchdog script</a></li><li class="toc-h3"><a href="#3-wire-up-the-init-service">3. Wire up the init service</a></li><li class="toc-h2"><a href="#luci-or-another-tool-shows-the-hosts-ram-and-load-despite-a-limit">LuCI, or another tool, shows the host&#x27;s RAM and load despite a limit</a></li><li class="toc-h2"><a href="#a-resource-limit-is-unavailable-although-its-kernel-option-is-enabled">A resource limit is unavailable although its kernel option is enabled</a></li><li class="toc-h2"><a href="#getting-help">Getting help</a></li></ul></nav>
369381
</aside>
370382
<footer class="footer">
371383
<div class="footer-inner">

0 commit comments

Comments
 (0)