From nobody Tue Apr 05 18:35:10 2022 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 200371A81A68; Tue, 5 Apr 2022 18:35:11 +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 4KXxCM0N3Pz3pFn; Tue, 5 Apr 2022 18:35:11 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649183711; 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=HwXotnIbHixXVU62DmB9Xcmy9fiu7bVsA3JSazPSj6U=; b=VWjVSiMMGU/6ozciliSqUp8OeNP9Xixr1NjwUhO40C1lzBgD68k4ENM1UGcSicueJY9hpD +1ydhEGRhgT4KzoJPD1oE2FXj9wp08EnFT68X4z0FoJ6qp4RSxboFVcjqFu3Dj0gdD33PM P4nXbnkosc492oakoTE0NsS2UjugW77sX0TfegsCuT971YN/G1Ot/eBsLVoVCbl5dmv6kh 74HArQkAROdsaqfJ65M/xB5U5SITxuOc+keExTK+5R3YN4BkoGk8v+DNBZyCcJv86x3qr4 rJYgcZgKrUmlAksKo9my+iuLjLWvifrdeVZfSP2D3GyGCyBCyBz1sarY4HW4gw== 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 DCFEC3947; Tue, 5 Apr 2022 18:35:10 +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 235IZApv044122; Tue, 5 Apr 2022 18:35:10 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 235IZAZg044121; Tue, 5 Apr 2022 18:35:10 GMT (envelope-from git) Date: Tue, 5 Apr 2022 18:35:10 GMT Message-Id: <202204051835.235IZAZg044121@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mitchell Horne Subject: git: 071b78ce8fec - main - mem(4): Improve ioctl section formatting 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: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@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/main X-Git-Reftype: branch X-Git-Commit: 071b78ce8fecd874c9aaa329467399c7b500c2e8 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649183711; 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=HwXotnIbHixXVU62DmB9Xcmy9fiu7bVsA3JSazPSj6U=; b=Ergrk1EzpkRe3aCl82Fi1VLPR+viKVK8jQdhBwoQDUtwTJeZmeDSFGj1ag4nsaO6a7GDUw TMRMANwEUUpmktjY0F89f6ceDODpcAiW97y/G4gBzaCr18duXc6fU0slTkpbwU3ziMx6LO sghmwG/gyqhgumcd6PqtPPus/lVMvLJEnOkhGV80mQY5bKoYFjEmQ/HDbR4jKb2ZIh7h3W Rr+hIX1Z7QIvDKgct68nybzpjvxZc7arQIDexkoZYwW41tI2tQEM7D7Vf8IV1exm/IZmhs m3HAr+K92xtl/PQLhBoVs0tQJ34ag+lg94RsZH8C66pSt0A9KrlvATKP39OWhg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649183711; a=rsa-sha256; cv=none; b=CQT2ShMh9sMyaPsuNQ4QSeoPXGC5lsHrDj1hnDKbXW+IO7KpY3gmysJ3bCkTjQ6vO5JWHn VE3dO7ysaSXi9tEucWuRdjYQF0yaanxxrQf7odSrqRm0JXYtQtlLv51rE/zHzWm4VnUh71 nyr7OpjDE47fNcuCCfJv3vizn/g6OumN/nSP9kiZpbNJMYMbSGuZ23ogMDHBoSGwUcgrU3 AZguqK4Yl9fBGnOzymTwroUWMxAvmC1PNl872VDeCGBO7IEVg0ECXmmqAaGOuAZEi/XMo9 Cm6LKujYRua+niTw6fLsLsQ1Yla7Uwe66pxufTeuOs5d4GK0hUeEA9FLT0XNwQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=071b78ce8fecd874c9aaa329467399c7b500c2e8 commit 071b78ce8fecd874c9aaa329467399c7b500c2e8 Author: Mitchell Horne AuthorDate: 2022-02-24 16:15:17 +0000 Commit: Mitchell Horne CommitDate: 2022-04-05 18:35:05 +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 --- 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.