*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.
+
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"'
____
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.
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.
== 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.
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*.
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::
| 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.
projects / thirdparty / util-linux.git / commitdiff
