From nobody Mon Aug 05 16:46:27 2024 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Wd2QC32SLz5SLCP; Mon, 05 Aug 2024 16:46:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Wd2QC2Ld8z4dVr; Mon, 5 Aug 2024 16:46:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1722876387; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=qrUmjnFPcmxcAdMDd4YJ5L14rtBlNiKgK85FmU2Yg/A=; b=j3vVYjOdzpCzwW3Aka8EX8WiIRCmofHQ2iltXaUvpJffidi6F9TC1wEi7tdXHC7Mn3ZAeG LHnnHW1T3Or4YnkRqSF00+t+I+sbdDEDYiposz9ASnvjN+SQXJzZEcKRSx+aP24Lt14URE h55nBsvhcdGpaF1OFy4QlHpHXdVnUx2o2D2imqkOpO8nSSe0ghqJk2yBD1hW6ZsfwNhuyj aaSRqir7k1uNhHkHyvG/oXPpBWkXFmF6NQPHW7Jxjg0etrYiVCkI7RZ4HvDi9M/qRuAd25 zb2knEO93Uhlt9DUY7/4NfsUKGUHL9zg+Gmtup0biCI2uJFSYiQZIq0FfyCkNg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1722876387; a=rsa-sha256; cv=none; b=WITa4RkuroGsBMmhFxc9NC9lA3Q1e6Qj26J8SXn/C2+lxeY6GK7Q4L3Ia1BC4ztOXIFt4s kKB+JpbOptLP65+LvYOYM4/9TYH8NfmCroQP25LidJPFenxR64G7TtvytedP16ZJBjEsb5 atM5LuJF7+cHcG+zvr2SFLIgTm1goX2akfBhpA7pOKUogtxnt0qQPq5CtYLrNf0l+1PjYy xMya8ARIayZfGd1mddDH1cdrXbtw08JBGZxA+HVGkB4WUznMySPx37BkHTd9L8OFjsOQBm 2KZVMb4Kbd5hI/iMSfcqL6OFm8HUHi7S20ZfQZbNZAnzni79Am/ikQioT98VPw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1722876387; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=qrUmjnFPcmxcAdMDd4YJ5L14rtBlNiKgK85FmU2Yg/A=; b=TugMbBFPZd7BC0nlamPIRsdHwF/Kb1zF5lAaDEwngcn/YLtsGx+aLHR8dUwQU3vH4t4CNb r+IpsnbM8N+HzxyZcYVNMyE9Zue8FDQgcv1iDzobdUqPSclEEFWszgU/RKbDM/8AUibsjd BDRz8rak4Wnpt/Md306krazrpOylGtyketSW3rJlMhJHXZ8re5pbyeCeX04o4UjEH3o6qn TEtF75xM88L4OdPnn0FVuW0oaSca7eUheHD512t1kncasTO09WUC76nyUdDcKf8YZYDph9 KtKtRVnqv/Gp6L2FHTD4ybNL1DddNOfd2dKLsV6SV7fkrIs0Gh6cJEdD0udMfg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Wd2QC1n7CzXHL; Mon, 5 Aug 2024 16:46:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 475GkRlE050419; Mon, 5 Aug 2024 16:46:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 475GkRU3050416; Mon, 5 Aug 2024 16:46:27 GMT (envelope-from git) Date: Mon, 5 Aug 2024 16:46:27 GMT Message-Id: <202408051646.475GkRU3050416@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Bojan =?utf-8?Q?Novkovi=C4=87?= Subject: git: 31cc65708c66 - main - man9: Document M_NEVERFREED and VM_ALLOC_NOFREE List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bnovkov X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 31cc65708c664c2a0257c26503d39ebc506f674e Auto-Submitted: auto-generated The branch main has been updated by bnovkov: URL: https://cgit.FreeBSD.org/src/commit/?id=31cc65708c664c2a0257c26503d39ebc506f674e commit 31cc65708c664c2a0257c26503d39ebc506f674e Author: Bojan Novković AuthorDate: 2024-07-31 17:36:55 +0000 Commit: Bojan Novković CommitDate: 2024-08-05 16:41:22 +0000 man9: Document M_NEVERFREED and VM_ALLOC_NOFREE Reviewed by: alc, kib, markj Differential Revision: https://reviews.freebsd.org/D46198 --- share/man/man9/malloc.9 | 11 ++++++++++- share/man/man9/vm_page_alloc.9 | 6 +++++- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/share/man/man9/malloc.9 b/share/man/man9/malloc.9 index 0ab5b2ed6e8d..d8759a255492 100644 --- a/share/man/man9/malloc.9 +++ b/share/man/man9/malloc.9 @@ -28,7 +28,7 @@ .\" .\" $NetBSD: malloc.9,v 1.3 1996/11/11 00:05:11 lukem Exp $ .\" -.Dd October 12, 2022 +.Dd August 4, 2024 .Dt MALLOC 9 .Os .Sh NAME @@ -269,6 +269,15 @@ This option should only be used in combination with .Dv M_NOWAIT when an allocation failure cannot be tolerated by the caller without catastrophic effects on the system. +.It Dv M_NEVERFREED +This is an internal flag used by the +.Xr UMA 9 +allocator and should not be used in regular +.Fn malloc +invocations. +See the description of VM_ALLOC_NOFREE in +.Xr vm_page_alloc 9 +for more details. .El .Pp Exactly one of either diff --git a/share/man/man9/vm_page_alloc.9 b/share/man/man9/vm_page_alloc.9 index 7d6cf1692bb1..4bf8db33a28d 100644 --- a/share/man/man9/vm_page_alloc.9 +++ b/share/man/man9/vm_page_alloc.9 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH .\" DAMAGE. .\" -.Dd July 21, 2024 +.Dd August 4, 2024 .Dt VM_PAGE_ALLOC 9 .Os .Sh NAME @@ -307,6 +307,10 @@ pages will be allocated by the caller in the near future. must be no larger than 65535. If the system is short of free pages, this hint may cause the kernel to reclaim memory more aggressively than it would otherwise. +.It Dv VM_ALLOC_NOFREE +The caller asserts that the returned page will never be released. +If this flag is specified, the allocator will try to fetch a page from a +special per-domain arena in order to curb long-term physical memory fragmentation. .El .Sh RETURN VALUES If the allocation was successful, a pointer to the