From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pj1-f42.google.com (mail-pj1-f42.google.com [209.85.216.42]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 41FF93093C3 for ; Wed, 4 Mar 2026 15:05:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.42 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772636705; cv=none; b=Y/IBOF+a0AYA/Y8Z5j9fA1lrfE35OCf3g+VvB5euuSMCTb2l6lC40ckJU2zekjW9nXYBBJGRc13z6MPQMv5NNH9DyhOOamj9a7IE9JdyCDb7yHGJQq+8Aak33ACsCXEd1k+xKnuLMvXPOIYyRRCVCvHDx2pkmM10368yiX9XbC0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772636705; c=relaxed/simple; bh=jHAcgKXcKNebtrlpWLGfC+a4usAjvIac1SzYg4lDCRw=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=XRyI5DwQ2I0Vz/wwPo2Yns/ii+t8QRc1PFQkB/RS+nwzWBsnyuF4SYSYDLsae0I3E7MmHgSmnkqEh3H8z1v+AmCXsQ5ewmYb7J5sOEcMDSAzej3fjstOPg8j5JTu4n8XaCpnTyOTLfcaRGasqMzG1uD0BxF2rw1k8Uhmby9zs1c= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=kQTw27Ii; arc=none smtp.client-ip=209.85.216.42 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="kQTw27Ii" Received: by mail-pj1-f42.google.com with SMTP id 98e67ed59e1d1-3598b2318c2so2047701a91.3 for ; Wed, 04 Mar 2026 07:05:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1772636701; x=1773241501; darn=vger.kernel.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=kQTw27IiEZ4ibhEU5iS8az0NOijK4o9pwKVvcNC+g7wmpWsb/QBjXjyhkyiOf8qC4G Qt4CW7yUDVAxiKVemZpR5POxtbHpU6enzu69gRBrf1fN0965ZGdjSAjzYNHyGU9Vv9CQ zu5r9eks7mSikUoFWdmRGvqPlKSNzVX/EP4ldpMbvQibN37UESLfgExF1+gU5Dn9OFr6 Sl0O7n7lXj52jCpGbTwg2PcVkpwl6mYyGwBOlhoIgG75cKXHkRWQmW1R8h4VXHNALbvt 93zXMkyGwGS1Z7nga21z8uK/gVGtmkhBoZEFj9n3UFb8Q76ZkLVdaujwAJboJK/IOkQ4 OV1g== 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=LZGIZ380lBLwQVs3gUm5SkaM+oeyE2FFjy4MVMXdJnPrQbilP/xvLL/RpWSeXNr7ld 5qG/DC72dQ6LiCiLsrc7gZHtsRjaEP2KuOQ9PW4qP6FZBKoHFd2LX87rkfhU/2dYbqIn 0BY5adBJUAeUDj4jkSctnBIyX6/SwAVELcF16ADqtpJ5Uo41PBZk2jRslIilHOVwTYbP FJZbUrh30a6UwcgZY7hFhfolps9+6vBMhL/Nlf+Gp+G86LLYTsFCqZZ3BcfCbqzj2WXz Cmu7RAKsMUxNjdp3Ux6CsR64/Kn2ml+V2T4RXphxq7OYQ9bYZVpehQodwqlmsF8xNiDj cyrw== X-Forwarded-Encrypted: i=1; AJvYcCXwBHNyh/hxm7402wolsicq31nbBJu8e9f7Wt4WW6JtvDrvtLcllDV2JjIeaN4w7HQyMcBkoVd/DUo4hTI=@vger.kernel.org X-Gm-Message-State: AOJu0Ywi0lumONooPLoNWbtwJheBi+yAgsqvN+Hcv6jpkSkvU4kViFiE LY5QfOgPQcJLO0lCTk5E2hMUroJfG19yjrVRfSvuo9XwV645xTVHobW5 X-Gm-Gg: ATEYQzwrYmOZjwIOCrQCW/NwqaPmLUMKOLgAS22T/Irm6R6WRp+ujW5IeMfxmshrM2a ylakmvXMPFqk5xCaY6IV8fW2U6RDDasJQMVpASqSRvvuRbCH60uiRarh6o35DDq/CwwTAvcAYaT j4ywAsBlMmRyZIL2duofUS6izhQxQ8Ps1FLiKptZSdjn7Galzhgs5ea1TGXOX7O/rdB9DEM4CVA a4cXdC8ih22z8V5MskMPEt1JZeOgbz1g48UNzrdgjuaybLDgbc6ASmc/wzotjaxN9PXD3AQ0kXi qJHdIlDb34xQRXsymjNJDeBjNAbE1j5L0GkLejJw6QLaBFi274wZsSk+evN8TiRratm/YNQFHxv H2xe7EAWmbknL/nTJyLq7/szFgcxW2iESXpP2mQFZpVqBF+GKiyf+1VBOvrvy6VQ32U2sZh0ILL Eb3Ut3Yq0s3u17Sz5suRxLyXXu0Les7xFqsl9OPJ2NdrZ4X2pDqJk2Xf8TnJuZFw== 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) 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) 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 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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/admin-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 =============== =============================================================== 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 @@ +=============== +/proc/sys/xen/ +=============== + +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 +=========================== + +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. -- 2.39.5