From nobody Mon Apr 13 02:09:56 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1772636722; cv=none; d=zohomail.com; s=zohoarc; b=WhSwIblA6Qb8gfnAujsmMZPtwFTJ1mXSh6JHZYVR5f6Bubxa+E26Ydy87cru8eP94bcbToBvFpBTxph/ttpZ6MihtjnplJX81gGwLxCsQwp5izEqKN3e+pXEPiHL9/3h5EuYMDxVRy2UmlnGJNN3DBi1+a6nFceki8GjC2bx4rQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1772636722; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=fqTYOMIsNClRzqswixiS8WEm00nS5ICygdS6xEi4uwI=; b=R3jRr7KKeX1xYFK5UrZKOmGfesxk4pBNzr+3h2qJoi09bMsWW/if72JFtmchSA0psO24vE5hN9mt42fwflryq/hEaT6HsOWMLSDeBS67lF6qbTL3gLOl5Zqp4cyh0ZXv7vteji62eHBsAs5QFPqi2GR97KgGGkGUAEdh+QMcG0A= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1772636722709962.7294837962444; Wed, 4 Mar 2026 07:05:22 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.1245560.1544914 (Exim 4.92) (envelope-from ) id 1vxnmb-0007IW-L4; Wed, 04 Mar 2026 15:05:05 +0000 Received: by outflank-mailman (output) from mailman id 1245560.1544914; Wed, 04 Mar 2026 15:05:05 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1vxnmb-0007IP-IT; Wed, 04 Mar 2026 15:05:05 +0000 Received: by outflank-mailman (input) for mailman id 1245560; Wed, 04 Mar 2026 15:05:04 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1vxnma-0007IH-F0 for xen-devel@lists.xenproject.org; Wed, 04 Mar 2026 15:05:04 +0000 Received: from mail-pj1-x1030.google.com (mail-pj1-x1030.google.com [2607:f8b0:4864:20::1030]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id 84f786a4-17db-11f1-b164-2bf370ae4941; Wed, 04 Mar 2026 16:05:03 +0100 (CET) Received: by mail-pj1-x1030.google.com with SMTP id 98e67ed59e1d1-358ed696623so2866382a91.0 for ; Wed, 04 Mar 2026 07:05:03 -0800 (PST) Received: from localhost.localdomain ([47.30.254.178]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-359aa3eb916sm516439a91.11.2026.03.04.07.04.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Mar 2026 07:05:00 -0800 (PST) X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" X-Inumbo-ID: 84f786a4-17db-11f1-b164-2bf370ae4941 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1772636701; x=1773241501; darn=lists.xenproject.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=fqTYOMIsNClRzqswixiS8WEm00nS5ICygdS6xEi4uwI=; b=VASiVr9TJfSCmlBbui+D2U8h3fGQRVLqUznS5XuKhKnVc7e1YCX149X15UkWBHz6DI L4sh5bQ0lMBiEQ5JLtXuTxGz/8fcvSdTmEdaoqs/215PGAlkUkdrZzyyHV1AHlX1U+/T n/VJX5qbrQm1y3NoXkO1DfFHrlqTYsbmkWQwdhOHMEP0VD726Bffj1e8IGVZSgMZ+8Rl StLS2+y8+cbJeZ/YoeJU2FM+59KQVMPrTtNTTT1nwbJJSbeRgwq3LyCylpQVsq415p1C ix2WAEikNCX6nHFj49+cIKYnYBFTMyFqa1JiP8M69sze7qI5Nm716UzEjIImtIdjHmrr SSkQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1772636701; x=1773241501; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=fqTYOMIsNClRzqswixiS8WEm00nS5ICygdS6xEi4uwI=; b=RnlhaKopr+ItG4uZAc+JogYxzaorAXaHwmsHb9VG1+851gebQQ4585pgB3ebfE8UnA FeaiyRyJE8rbgaIPBWwE6oPNrj6WHkVRinMVt3hpFHXDpD6XkiqmRpfE7j/fLR/4KL06 qDT17z87GW7yJJ9rEJVesiO6A1P7FnwI/NOcjejaRldDAqwLpcL5700rrI0UQLi/si5Y bqA/JCdXJkz/5mRRmwSVkNtQKrgoDe1aLdmZPy71GEmdIh3BrCJl7i5QV9cVfjKrU8iV wkLGSmprPFKac/Vmf8ZxP0MX7p2pYSj5z2pATbWGNBiOtsYyFV8JggoWSeLl/BDfvKEM AF4g== X-Forwarded-Encrypted: i=1; AJvYcCUvGnnzrt7xPsJdIsdDiISWKyiS45W0FjNALRQhtZ7rDPYzXi2nMlSEDnAJckAfZpTRa5t5tDiPTMA=@lists.xenproject.org X-Gm-Message-State: AOJu0YxYyvhvmhFbqoqpVM79XbqZGs2Wfo6ukEhwCPgNlCnXF98EsZIr ZxU3hWYT6Yk6WVjk03+qfh4zJORiURUoH6xy+l+2ok7N3sgXrwzLENFI X-Gm-Gg: ATEYQzzJLBiBYf6/qls/40d6Bpst28G8afoGIPXMdCwQK60I/LUjgg6XmMxLxGm8Kgu wqfONbSnvRHNBJn/DEJaJdydgV579LoP/fKa7z+fmN+eibjmeeL6YBoUaBNttFTFJ6GEV+24yaP bmw5qOkcY3lbedefe7ki0Xc+Tae6VpwTV1HTOT41jXvZ/llhYJkjYk9n4Ob6d95yWk40VWZQg1v hJ52C9G5P0PzTAoaVtSnf+l7AZQs2YQo7C1n97PGajd6jQ0Fm242WMzfVECoRV7nt/Pi2wiM/3G J1DjZMerZmp9r4V2LnW8bu1GEcIYUan8RsvO5k2/bR9azqSiUxX+xKQyU9P58U4JVafaJOvd5/L c3ocN8DQRGfeUuWf8ACH8KpGqRJPvCOYlpYq/i3J5PpY5d1Lye46dAjn+kD/ihFmLy/1ps7LwMD tGh9/Y9zj/b4IELsLR5clfeJTaH7Gj+GVrcXyPdCAKHrATx2KRl4819x7b5M1vtA== X-Received: by 2002:a17:90b:48cd:b0:34a:8c77:d37b with SMTP id 98e67ed59e1d1-359a6a21536mr2121281a91.16.1772636701366; Wed, 04 Mar 2026 07:05:01 -0800 (PST) From: Shubham Chakraborty To: corbet@lwn.net, jgross@suse.com Cc: sstabellini@kernel.org, boris.ostrovsky@oracle.com, linux-doc@vger.kernel.org, xen-devel@lists.xenproject.org, linux-kernel@vger.kernel.org, Shubham Chakraborty Subject: [PATCH v2] docs: sysctl: Add documentation for /proc/sys/xen/ Date: Wed, 4 Mar 2026 20:34:19 +0530 Message-Id: <20260304150419.16738-1-chakrabortyshubham66@gmail.com> X-Mailer: git-send-email 2.39.5 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @gmail.com) X-ZM-MESSAGEID: 1772636727648158500 Content-Type: text/plain; charset="utf-8" Add documentation for the Xen hypervisor sysctl controls in /proc/sys/xen/balloon/. Documents the hotplug_unpopulated tunable (available when CONFIG_XEN_BALLOON_MEMORY_HOTPLUG is enabled) which controls whether unpopulated memory regions are automatically hotplugged when the Xen balloon driver needs to reclaim memory. The documentation is based on source code analysis of drivers/xen/balloon.c. Signed-off-by: Shubham Chakraborty --- Documentation/admin-guide/sysctl/index.rst | 3 ++- Documentation/admin-guide/sysctl/xen.rst | 31 ++++++++++++++++++++++ 2 files changed, 33 insertions(+), 1 deletion(-) create mode 100644 Documentation/admin-guide/sysctl/xen.rst diff --git a/Documentation/admin-guide/sysctl/index.rst b/Documentation/adm= in-guide/sysctl/index.rst index 4dd2c9b5d752..aae68373902f 100644 --- a/Documentation/admin-guide/sysctl/index.rst +++ b/Documentation/admin-guide/sysctl/index.rst @@ -84,7 +84,7 @@ sunrpc/ SUN Remote Procedure Call (NFS) user/ Per user namespace limits vm/ memory management tuning buffer and cache management -xen/ +xen/ Xen hypervisor controls =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D =20 These are the subdirs I have on my system or have been discovered by @@ -102,3 +102,4 @@ it :-) sunrpc user vm + xen diff --git a/Documentation/admin-guide/sysctl/xen.rst b/Documentation/admin= -guide/sysctl/xen.rst new file mode 100644 index 000000000000..6c5edc3e5e4c --- /dev/null +++ b/Documentation/admin-guide/sysctl/xen.rst @@ -0,0 +1,31 @@ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +/proc/sys/xen/ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Copyright (c) 2026, Shubham Chakraborty + +For general info and legal blurb, please look in +Documentation/admin-guide/sysctl/index.rst. + +--------------------------------------------------------------------------= ---- + +These files show up in ``/proc/sys/xen/``, depending on the +kernel configuration: + +.. contents:: :local: + +balloon/hotplug_unpopulated +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D + +This flag controls whether unpopulated memory ranges are automatically +hotplugged as system RAM. + +- ``0``: Unpopulated ranges are not hotplugged (default). +- ``1``: Unpopulated ranges are automatically hotplugged. + +When enabled, the Xen balloon driver will add memory regions that are +marked as unpopulated in the Xen memory map to the system as usable RAM. +This allows for dynamic memory expansion in Xen guest domains. + +This option is only available when the kernel is built with +``CONFIG_XEN_BALLOON_MEMORY_HOTPLUG`` enabled. --=20 2.39.5