git: 678b6696734e - stable/13 - mem(4): Improve ioctl section formatting

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Mon, 11 Apr 2022 14:05:08 UTC
The branch stable/13 has been updated by mhorne:

URL: https://cgit.FreeBSD.org/src/commit/?id=678b6696734e95514b27867bfaa3b45ee5b056f1

commit 678b6696734e95514b27867bfaa3b45ee5b056f1
Author:     Mitchell Horne <mhorne@FreeBSD.org>
AuthorDate: 2022-02-24 16:15:17 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
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 <pauamma@gundo.com>
    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.