From nobody Mon Apr 11 14:05:08 2022 X-Original-To: dev-commits-src-branches@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 28B8A1A962B5; Mon, 11 Apr 2022 14:05:09 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4KcVx05Fxpz3GVK; Mon, 11 Apr 2022 14:05:08 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649685908; 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=1IStOOCjaPPKO7lCuotMYaA2AfJLNYDFdGL1s9zvjwo=; b=lXqBFEABQJBN/zeKWLfVndtEfZTQXnh+OX/32BdTmrHiUirM4N59hLMT405pCWNZUjcgPe fWc8LwBEWJwGf3DQzymii4Xim8EirxlXWa9jqGwmdDufQ3HZwFHols3033XBh857SUAnQO BG8Zz1RYjD3jcALUGmsN4c3/YvG0X/3I/XzXXghhR1HHNNWwtMHn+4ZaFSCifzNGrrqMZV BgrDAMwM1aZt+uOPNKYm81rohIWg9z030M8EzfeXNiUaBkFhYxDosxV08Uti00nCUKaNH2 ipLABCQvRGTnOXZuQkCfu/hYpLHvLGsiwj5jwcHPx2b28D8IbnTMEU480Zzpog== 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 6B34C24528; Mon, 11 Apr 2022 14:05:08 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 23BE58F9056381; Mon, 11 Apr 2022 14:05:08 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 23BE58Jv056380; Mon, 11 Apr 2022 14:05:08 GMT (envelope-from git) Date: Mon, 11 Apr 2022 14:05:08 GMT Message-Id: <202204111405.23BE58Jv056380@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mitchell Horne Subject: git: 678b6696734e - stable/13 - mem(4): Improve ioctl section formatting List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-branches@freebsd.org X-BeenThere: dev-commits-src-branches@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: mhorne X-Git-Repository: src X-Git-Refname: refs/heads/stable/13 X-Git-Reftype: branch X-Git-Commit: 678b6696734e95514b27867bfaa3b45ee5b056f1 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649685908; 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=1IStOOCjaPPKO7lCuotMYaA2AfJLNYDFdGL1s9zvjwo=; b=xmknr0enno0BUykdpXzjzHcCo+1wo+hswvHuU1yLjUAWvIKpO1pI/lrHHJ3UVAiJ8ys8MX IZ74VQKq6sRGWnD8hKF2LKzGi8K6BMpDThxmi5z1kOwCZ1cyZ6/vTN4rXloUYLuZJMYNmd 1gJ0BQpb79Cn/dMjV3S4ETfVsUd6zlp2+88KI7P7wPU8j4tgEw5bfza+wq/hvko2ptqTL5 pNqGC/hj2aOalHoWAsOoFOEI21aPQqkEgUHk7yZ1BDTyhoxoqt2xsE64xiVirO/HCPgZsj 4nFZSNtKCTpXjRT1fBLCS1z40YBWki5WlmyNfWIIAoHOamaxCFZTuUiVbx1xkQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649685908; a=rsa-sha256; cv=none; b=FLdQVqE6G1BIPbjXEF8Pkp0P6+Gb/EK5HfQMyKmuj5X0z1KaW5UwAXntw7ISRniDNWi/Rg bMgZBQkq5tmp0ODZX/0BicOntwIHiP9XrF86UgrDKyyEfDaIkO8mcFYOHNHNyNb3W9eRCS IyWGUoc3lAUYia1dNMfB9pY586ZnCI11L1X0oggV2izlmo8SmrVtrncnfjmuEV4/lESHPz ws+OTprODQJuV8gLR7Qw76Udf0lZb4M/il0V67x8uZnggLUjE2fbATIJOcOOuc5iJN2Dcp GHCuDoRJNnipdHEI9EEgRSm50g9aDBFyTriGRJMiyPpUjVWyujB/RMRE8Z0CHg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=678b6696734e95514b27867bfaa3b45ee5b056f1 commit 678b6696734e95514b27867bfaa3b45ee5b056f1 Author: Mitchell Horne AuthorDate: 2022-02-24 16:15:17 +0000 Commit: Mitchell Horne CommitDate: 2022-04-11 14:04:08 +0000 mem(4): Improve ioctl section formatting Add the missing .El which fixes the indentation of the memory range definitions and operation. Add subsection headings to further clarify this section. Do the same for the RETURN VALUES section, and mention explicitly that MEM_EXTRACT_PADDR always returns zero. Reviewed by: markj, 0mp, Pau Amma Sponsored by: Juniper Networks, Inc. Sponsored by: Klara, Inc. MFC after: 3 days Differential Revision: https://reviews.freebsd.org/D34574 (cherry picked from commit 071b78ce8fecd874c9aaa329467399c7b500c2e8) --- share/man/man4/mem.4 | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/share/man/man4/mem.4 b/share/man/man4/mem.4 index ee348ed5f167..f860df036428 100644 --- a/share/man/man4/mem.4 +++ b/share/man/man4/mem.4 @@ -28,7 +28,7 @@ .\" @(#)mem.4 5.3 (Berkeley) 5/2/91 .\" $FreeBSD$ .\" -.Dd August 25, 2020 +.Dd March 11, 2022 .Dt MEM 4 .Os .Sh NAME @@ -65,6 +65,7 @@ is long, and ends at virtual address 0xf0000000. .Sh IOCTL INTERFACE +.Ss Address Properties The .Dv MEM_EXTRACT_PADDR ioctl can be used to look up the physical address and NUMA domain of a given @@ -104,6 +105,8 @@ The virtual address corresponds to a physical page mapping, and the and .Fa me_domain fields are valid. +.El +.Ss Memory Ranges .Pp Several architectures allow attributes to be associated with ranges of physical memory. @@ -200,6 +203,11 @@ to update an existing or establish a new range, or to to remove a range. .El .Sh RETURN VALUES +.Ss MEM_EXTRACT_PADDR +The +.Dv MEM_EXTRACT_PADDR +ioctl always returns a value of zero. +.Ss MEMRANGE_GET/MEMRANGE_SET .Bl -tag -width Er .It Bq Er EOPNOTSUPP Memory range operations are not supported on this architecture.