public inbox for pve-devel@lists.proxmox.com
 help / color / mirror / Atom feed
* [PATCH docs 0/6] container documentation updates
@ 2026-11-08 21:35 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces 666Goofy666
                   ` (5 more replies)
  0 siblings, 6 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
  To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666

From: 666Goofy666 <666goofy666@proton.me>

hi,
here some commits to update the container doc page.
the main one is the fix for network interfaces.
others are separate changes that I found while reviewing
the documentation, so you can cherry-pick them individually.

- network interfaces: info in the ticket #7852
- snapshots: just fixing a typo in the example
- cgroups and systemd: the code use 232, probably beceause
 systemd start implement in v230 and finish in 232
- configuration keys for LXC: settings have changed in LXC 2.1
 the change in code to depreceated is made in
 pve-container: `108c6cab98b091f82b725c98f198bada9752ccdc`
- cgroups memory: PVE 9 uses cgroups v2 so the settings changes
 v1 `memory.memsw.limit_in_bytes` represent memory + swap.
 v2 `memory.swap.max` represent only the swap,
 pve-container: `722a07704836d61a131af8b982d208ccfe6ce336`
- mount points just typo

best regards,

666Goofy666 (6):
  fix #7852: pct: network: fix max number interfaces
  pct: snapshots: fix example variable
  pct: cgroups: fix systemd supported version
  pct: configuration: update configuration keys
  pct: memory: change to cgroup v2
  pct: mountpoints: fix mount point typo

 pct.adoc | 30 ++++++++++++++----------------
 1 file changed, 14 insertions(+), 16 deletions(-)

-- 
2.56.0





^ permalink raw reply	[flat|nested] 7+ messages in thread

* [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces
  2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 2/6] pct: snapshots: fix example variable 666Goofy666
                   ` (4 subsequent siblings)
  5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
  To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666

From: 666Goofy666 <666goofy666@proton.me>

Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
 pct.adoc | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pct.adoc b/pct.adoc
index cd3130f..25dc1fe 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -593,9 +593,9 @@ Network
 
 [thumbnail="screenshot/gui-create-ct-network.png"]
 
-You can configure up to 10 network interfaces for a single container.
-The corresponding options are called `net0` to `net9`, and they can contain the
-following setting:
+You can configure up to 32 network interfaces for a single container.
+The corresponding options are called `net0` to `net31`, and they can contain the
+following settings:
 
 include::generated/pct-network-opts.adoc[]
 
-- 
2.56.0





^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH docs 2/6] pct: snapshots: fix example variable
  2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 3/6] pct: cgroups: fix systemd supported version 666Goofy666
                   ` (3 subsequent siblings)
  5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
  To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666

From: 666Goofy666 <666goofy666@proton.me>

Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
 pct.adoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pct.adoc b/pct.adoc
index 25dc1fe..ed99e8b 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -1234,10 +1234,10 @@ file will look like this:
 ----
 memory: 512
 swap: 512
-parent: testsnaphot
+parent: testsnapshot
 ...
 
-[testsnaphot]
+[testsnapshot]
 memory: 512
 swap: 512
 snaptime: 1457170803
-- 
2.56.0





^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH docs 3/6] pct: cgroups: fix systemd supported version
  2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 2/6] pct: snapshots: fix example variable 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 4/6] pct: configuration: update configuration keys 666Goofy666
                   ` (2 subsequent siblings)
  5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
  To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666

From: 666Goofy666 <666goofy666@proton.me>

Although systemd introduced cgroup v2 support in version 230, code
(unified_cgroupv2_support) requires 232 or newer to ensure broader
controller support.

Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
 pct.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pct.adoc b/pct.adoc
index ed99e8b..48cf56e 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -725,7 +725,7 @@ completely different way. Because of this, file system quotas are currently not
 supported in a pure 'cgroupv2' environment.
 
 'cgroupv2' support by the container's OS is needed to run in a pure 'cgroupv2'
-environment. Containers running 'systemd' version 231 or newer support
+environment. Containers running 'systemd' version 232 or newer support
 'cgroupv2' footnote:[this includes all newest major versions of container
 templates shipped by {pve}], as do containers not using 'systemd' as init
 system footnote:[for example Alpine Linux].
-- 
2.56.0





^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH docs 4/6] pct: configuration: update configuration keys
  2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
                   ` (2 preceding siblings ...)
  2026-11-08 21:35 ` [PATCH docs 3/6] pct: cgroups: fix systemd supported version 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 5/6] pct: memory: change to cgroup v2 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 6/6] pct: mountpoints: fix mount point typo 666Goofy666
  5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
  To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666

From: 666Goofy666 <666goofy666@proton.me>

the format as change in LXC 2.1

Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
 pct.adoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pct.adoc b/pct.adoc
index 48cf56e..0d618ab 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -1209,13 +1209,13 @@ are treated as comments and are also ignored.
 It is possible to add low-level, LXC style configuration directly, for example:
 
 ----
-lxc.init_cmd: /sbin/my_own_init
+lxc.init.cmd: /sbin/my_own_init
 ----
 
 or
 
 ----
-lxc.init_cmd = /sbin/my_own_init
+lxc.init.cmd = /sbin/my_own_init
 ----
 
 The settings are passed directly to the LXC low-level tools.
-- 
2.56.0





^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH docs 5/6] pct: memory: change to cgroup v2
  2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
                   ` (3 preceding siblings ...)
  2026-11-08 21:35 ` [PATCH docs 4/6] pct: configuration: update configuration keys 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
  2026-11-08 21:35 ` [PATCH docs 6/6] pct: mountpoints: fix mount point typo 666Goofy666
  5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
  To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666

From: 666Goofy666 <666goofy666@proton.me>

PVE9 no longer uses cgroups v1, reflect cgroup v2 memory and swap
limits, where swap is defined independently from the memory limit.

Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
 pct.adoc | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/pct.adoc b/pct.adoc
index 0d618ab..6f8fab4 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -471,17 +471,15 @@ Memory
 
 [thumbnail="screenshot/gui-create-ct-memory.png"]
 
-Container memory is controlled using the cgroup memory controller.
+Container memory is controlled using the cgroup v2 memory controller.
 
 [horizontal]
 
-`memory`: :: Limit overall memory usage. This corresponds to the
-`memory.limit_in_bytes` cgroup setting.
-
-`swap`: :: Allows the container to use additional swap memory from the host
-swap space. This corresponds to the `memory.memsw.limit_in_bytes` cgroup
-setting, which is set to the sum of both value (`memory + swap`).
+`memory`: :: Limits the maximum memory usage of the container.
+This corresponds to the `memory.max` cgroup setting.
 
+`swap`: :: Limits the additional swap memory the container can use.
+This corresponds to the `memory.swap.max` cgroup setting.
 
 [[pct_mount_points]]
 Mount Points
-- 
2.56.0





^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH docs 6/6] pct: mountpoints: fix mount point typo
  2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
                   ` (4 preceding siblings ...)
  2026-11-08 21:35 ` [PATCH docs 5/6] pct: memory: change to cgroup v2 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
  5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
  To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666

From: 666Goofy666 <666goofy666@proton.me>

Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
 pct.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pct.adoc b/pct.adoc
index 6f8fab4..9333f0d 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -524,7 +524,7 @@ pct set 100 -mp0 thin1:10,mp=/path/in/container
 ----
 
 will allocate a 10GB volume on the storage `thin1` and replace the volume ID
-place holder `10` with the allocated volume ID, and setup the moutpoint in the
+place holder `10` with the allocated volume ID, and setup the mount point in the
 container at `/path/in/container`
 
 
-- 
2.56.0





^ permalink raw reply related	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2026-11-08 21:46 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
2026-11-08 21:35 ` [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces 666Goofy666
2026-11-08 21:35 ` [PATCH docs 2/6] pct: snapshots: fix example variable 666Goofy666
2026-11-08 21:35 ` [PATCH docs 3/6] pct: cgroups: fix systemd supported version 666Goofy666
2026-11-08 21:35 ` [PATCH docs 4/6] pct: configuration: update configuration keys 666Goofy666
2026-11-08 21:35 ` [PATCH docs 5/6] pct: memory: change to cgroup v2 666Goofy666
2026-11-08 21:35 ` [PATCH docs 6/6] pct: mountpoints: fix mount point typo 666Goofy666

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal