From: Mario Blättermann Date: Tue, 10 Feb 2026 13:38:36 +0000 (+0100) Subject: Fix various typos and markup in man pages X-Git-Tag: v2.43-devel~85^2 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=1c44486e4cf7cf09f9ad8f0d08cb92ac48a51e0f;p=thirdparty%2Futil-linux.git Fix various typos and markup in man pages --- diff --git a/misc-utils/getino.1.adoc b/misc-utils/getino.1.adoc index af654f2ea..2e3a464f9 100644 --- a/misc-utils/getino.1.adoc +++ b/misc-utils/getino.1.adoc @@ -24,7 +24,7 @@ getino - print the unique inode number associated to a process file descriptor o *getino* is a simple command that prints the inode numbers associated with the process file descriptor (pidfd) or namespace for all PIDs passed to it as arguments. The kernel guarantees that the inode number associated with a process's file descriptor is exempt from reuse during the current boot cycle; therefore, a process can be uniquely identified by its PID and the inode number, conveniently so with the format '_PID:inode_'. -As an example, this enables race-free signalling of processes with *kill(1)*, which accepts the aforementioned _PID_ format. +As an example, this enables race-free signalling of processes with *kill*(1), which accepts the aforementioned _PID_ format. Inode numbers associated with a namespace for a given process are essentially namespace IDs, identical to the inode number reported by /proc/pid/ns/_nstype_, see *namespaces(7)* for more details. diff --git a/misc-utils/lslocks.8.adoc b/misc-utils/lslocks.8.adoc index 31829eb43..d2ec4d03c 100644 --- a/misc-utils/lslocks.8.adoc +++ b/misc-utils/lslocks.8.adoc @@ -66,7 +66,7 @@ Print only the locks that meet the conditions specified by the expr. + This feature is EXPERIMENTAL. See also *scols-filter*(5). For example exclude POSIX type locks, but print all READ mode ones locks on files -with .qcow2 as extension: +with _.qcow2_ as extension: ____ lslocks --filter 'TYPE != "POSIX" and MODE == "READ" and PATH =~ ".*\.qcow2"' ____ diff --git a/sys-utils/fallocate.1.adoc b/sys-utils/fallocate.1.adoc index c253fa79a..5fdb1a67b 100644 --- a/sys-utils/fallocate.1.adoc +++ b/sys-utils/fallocate.1.adoc @@ -55,9 +55,9 @@ data holes – ranges inside the file which are logically filled with zero bytes For each hole the offset, end and size in bytes are printed in verbose mode, followed by a summary that gives the total size and percentage of the file that each hole type represents by default. If no offset is specified with *--offset*, the whole file is scanned. + -This option is read-only and can be used on any file to estimate how much space could be reclaimed by --dig-holes. +This option is read-only and can be used on any file to estimate how much space could be reclaimed by *--dig-holes*. + -See --punch-hole for a list of supported filesystems. +See *--punch-hole* for a list of supported filesystems. *-i*, *--insert-range*:: Insert a hole of _length_ bytes from _offset_, shifting existing data. diff --git a/sys-utils/flock.1.adoc b/sys-utils/flock.1.adoc index e25bd67e1..e250059b4 100644 --- a/sys-utils/flock.1.adoc +++ b/sys-utils/flock.1.adoc @@ -91,7 +91,7 @@ This is only available on kernel versions >= 3.15. The starting offset for lock. This option implies *--fcntl*. *--length* _number_:: -The number of bytes to lock. Ths option implies *--fcntl*. +The number of bytes to lock. This option implies *--fcntl*. *--verbose*:: Report how long it took to acquire the lock, or why the lock could not be obtained. diff --git a/sys-utils/irqtop.1.adoc b/sys-utils/irqtop.1.adoc index 63675f076..7b4cfedef 100644 --- a/sys-utils/irqtop.1.adoc +++ b/sys-utils/irqtop.1.adoc @@ -23,7 +23,7 @@ The default output is subject to change. So whenever possible, you should avoid == OPTIONS *-o*, *--output* _list_:: -Specify which output columns to print. Use *--help* to get a list of all supported columns. The default list of columns may be extended if list is specified in the format _+list_. +Specify which output columns to print. Use *--help* to get a list of all supported columns. The default list of columns may be extended if _list_ is specified in the format _+list_. *-b*, *--batch*:: Send the produced tables to stdout instead of to a static screen. @@ -38,7 +38,7 @@ for the full list of CPUs. Specify cpus in list format to show. *-d*, *--delay* _seconds_:: -Update the tables every this number of seconds. +Update the tables every this number of _seconds_. *-J*, *--json*:: Use JSON output format. Implies *--batch*. diff --git a/sys-utils/lsmem.1.adoc b/sys-utils/lsmem.1.adoc index e7226725a..3fcdba625 100644 --- a/sys-utils/lsmem.1.adoc +++ b/sys-utils/lsmem.1.adoc @@ -28,25 +28,25 @@ The supported columns are RANGE, SIZE, STATE, REMOVABLE, BLOCK, NODE, ZONES, CON RANGE The start and end physical address of the memory range. -SIZE +_SIZE_:: The size of the memory range, representing the total amount of memory in that range. -STATE +_STATE_:: The current online status of the memory range. Common states include online, offline or transitional states. -BLOCK +_BLOCK_:: The specific memory block number. -NODE +_NODE_:: The NUMA (Non-Uniform Memory Access) node to which the memory block belongs. -ZONES +_ZONES_:: The memory zones to which the blocks belongs, such as DMA, Normal, Movable. -CONFIGURED +_CONFIGURED_:: The configuration state of a memory block. Refer to *chmem* for details on configuring or deconfiguring memory blocks. -MEMMAP-ON-MEMORY +_MEMMAP-ON-MEMORY_:: The memmap-on-memory state of the memory block at configuration time. This setting indicates where memory hotplug stores its internal metadata (the struct pages array or memmap). If MEMMAP-ON-MEMORY is set to 1, the metadata is allocated directly from the newly added hotplugged memory, enabling hot-add operations even when the system is under high memory pressure. If set to 0, the memmap metadata is allocated from existing system memory. Possible BLOCK, CONFIGURED, STATE, MEMMAP-ON-MEMORY states:: @@ -62,7 +62,7 @@ Possible BLOCK, CONFIGURED, STATE, MEMMAP-ON-MEMORY states:: | 2 | offline | no | yes/no | The memory is offline and deconfigured. |=== -Not all columns are supported on all systems. If an unsupported column is specified, *lsmem* prints the column but does not provide any data for it. Additionally, *lsmem* may skip columns like CONFIGURED or MEMMAP-ON-MEMORY if these states are not relevant to the system's architecture. +Not all columns are supported on all systems. If an unsupported column is specified, *lsmem* prints the column but does not provide any data for it. Additionally, *lsmem* may skip columns like _CONFIGURED_ or _MEMMAP-ON-MEMORY_ if these states are not relevant to the system's architecture. Use the *--help* option to see the columns description.