From nobody Thu Jan 1 10:41:58 2026 X-Original-To: dev-commits-src-all@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 4dhk0W30d7z6M0Lp for ; Thu, 01 Jan 2026 10:42:03 +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 "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dhk0Q29QKz3gBG for ; Thu, 01 Jan 2026 10:41:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1767264118; 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=NTODxNZYgZKvC8rVAprQ4S9kSuWcri3RvU5uKLKb2uQ=; b=i62Xxh6FaAI71WQpqTQHipzmZ5EN/tVFT3bI+JfyMd39sKkpr/6Avp252MZ+98/vVUE/JD tY2z58THZ7Bka3n7xkACgsfmabhSYF8alBgnETKSAMWE4I47qmuTEDD0bAxgOwq27If2CP 4/5s+oxusbrKTXm6k6aX1yrlNvRpmlzTyHtL7lUBxCcS2FHBYGdn4P+2ro653O3YZUEKyn o0T3/WnZNqXheVKZNibkwfG9OQY42wTeWGTH/ihP2srcIFqD7sJk1fRM/WYBPEPQy6ebRn Gz0owTdbEav1/XeY8pvocpnNbPrWz+Frbb94cdZbhcOZ5BzXILwhZOfQa5ZUVg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1767264118; 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=NTODxNZYgZKvC8rVAprQ4S9kSuWcri3RvU5uKLKb2uQ=; b=SHqgxswv8pHR1YZINp3XjGuG7xR9mk01FzmNystlT4H2On/BdEPE3F3LPQ3GTZRaQXR2VA PHMOfH8AhLbcIoNc4KdiLB6sleK0QOVn/WjC5X2ImQmAnFYCPX49bJRuC3cP9nts8WLlXh byfMiLUXhaa3kIjvS0CdSrC9DBfwmz8fti6cNbOFg2XjRVdszHTvpRwMy2iLFDctk/nQHz 4zvOL2R12QKPw7qVhQ1k0t92Jj+OEzSypJcoYvcXuq2JLlQGPnybvFT7XDxzQI5QhdqvtM h3ssZ/A9Qo8+eqYJv2QL3OYL5zQBdg/MnnWuR8xDPzXyolR/uycayFaeu4Nltg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1767264118; a=rsa-sha256; cv=none; b=i8mhogzmDBebFeaPMAk2ylWhzJghPKS+x8h7T3h7A3dtpOmG19O0SbGxITD2fg2pv+KvBY hn8vuLt0v2N1NOaqwbt0VaG9cYhkGt5MWzn19/ApuIAjmmP2pXHuGkQP37uJyBMlz6/wX7 Z45G6RRNz9AKDyEgXnOeePQB8SBg5AfUhD+BQ8VJvZUKf53a1ooD29mZH7FaeX1jFYh4m8 vcQabuvSQE/Zd5JC8uovARipgZkNwV/JLFjLQ/nv8JXnubg9JW+7kmLFWK1bOFf42f16sT UhgwQkCSsv4wwaJdUTm4RWjjPYi8k0+QJoRn6sjCYHSgYxxCMW82/m9GQodR0Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dhk0Q1hZpzD5p for ; Thu, 01 Jan 2026 10:41:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 20d69 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 01 Jan 2026 10:41:58 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Michael Osipov Subject: git: 1839dd31cab9 - stable/14 - linprocfs.5: Synchronize style and format with 15-STABLE List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: michaelo X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 1839dd31cab9a02acc2a1065bb0a63488a69ba0b Auto-Submitted: auto-generated Date: Thu, 01 Jan 2026 10:41:58 +0000 Message-Id: <69564f76.20d69.2df94dae@gitrepo.freebsd.org> The branch stable/14 has been updated by michaelo: URL: https://cgit.FreeBSD.org/src/commit/?id=1839dd31cab9a02acc2a1065bb0a63488a69ba0b commit 1839dd31cab9a02acc2a1065bb0a63488a69ba0b Author: Michael Osipov AuthorDate: 2025-12-29 20:49:49 +0000 Commit: Michael Osipov CommitDate: 2026-01-01 10:41:38 +0000 linprocfs.5: Synchronize style and format with 15-STABLE This is a logical backport of 1d193b1808098328d3ad16b436a329b258935e0c including the changes happended after that. Reviewed by: fernape Differential Revision: https://reviews.freebsd.org/D54408 --- share/man/man5/linprocfs.5 | 89 +++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 81 insertions(+), 8 deletions(-) diff --git a/share/man/man5/linprocfs.5 b/share/man/man5/linprocfs.5 index 568d4dcd9d14..bcd8587eb76c 100644 --- a/share/man/man5/linprocfs.5 +++ b/share/man/man5/linprocfs.5 @@ -1,7 +1,7 @@ .\" Written by Garrett Wollman .\" This file is in the public domain. .\" -.Dd November 13, 2019 +.Dd December 26, 2025 .Dt LINPROCFS 5 .Os .Sh NAME @@ -26,17 +26,53 @@ There is also a special node called .Pa self which always refers to the process making the lookup request. .Pp -Each node is a directory containing several files: -.Bl -tag -width status +Each process node is a directory containing several files: +.Bl -tag -width oom_score_adj +.It Pa auxv +The auxiliary vector passed to the program. +.It Pa cmdline +The command line used to execute the process. +.It Pa cwd +A symbolic link pointing to the current work directory of the process. +.It Pa environ +The list of environment variables and values of the process. +Every variable and pair value is separated from the next by a NULL byte. .It Pa exe A reference to the vnode from which the process text was read. This can be used to gain access to the process' symbol table, or to start another copy of the process. +.It Pa limits +The soft and hard limits for the process along with the units used. +.It Pa maps +Memory map of the process. .It Pa mem The complete virtual memory image of the process. Only those addresses which exist in the process can be accessed. Reads and writes to this file modify the process. Writes to the text segment remain private to the process. +.It Pa mountinfo +Information about mount points. +.It Pa mounts +Similar to the above. +.It Pa oom_score_adj +Score adjustment for the Out Of Memory killer. +.It Pa root +Symbolic link to the root directory for this process. +.It Pa stat +Process statistics. +It includes user, nice, system, idle, iowait, irq, softirq, +steal, guest and guest_nice. +.It Pa statm +Process size statistics. +It includes total program size, resident set size, number of resident shared +pages (unused), text size, library size (unused), data + stack and dirty pages +(unused). +.It Pa status +Process statistics in human readable form. +It includes process name, state, PID, +etc. +.It Pa task +Dummy directory to avoid problems in specific software such as Chromium. .El .Pp Each node is owned by the process's user, and belongs to that user's @@ -46,19 +82,55 @@ node, which belongs to the .Li kmem group. .Sh FILES -.Bl -tag -width /compat/linux/proc/self/XXXXXXX -compact +.Bl -tag -width /compat/linux/proc/filesystems -compact .It Pa /compat/linux/proc -The normal mount point for the +The normal mount point for .Nm . +.It Pa /compat/linux/proc/cmdline +Contains the path of the kernel image used to boot the system. .It Pa /compat/linux/proc/cpuinfo CPU vendor and model information in human-readable form. +.It Pa /compat/linux/proc/devices +List of character and block devices. +The latter is usually empty on +.Fx . +.It Pa /compat/linux/proc/filesystems +List of supported filesystems. +For pseudo filesystems, the first column contains +.Em nodev . .It Pa /compat/linux/proc/meminfo System memory information in human-readable form. -.It Pa /compat/linux/proc/pid +.It Pa /compat/linux/proc/modules +Loaded kernel modules. +Empty for now. +.It Pa /compat/linux/proc/mounts +Devices corresponding mount points. +.It Pa /compat/linux/proc/mtab +Same as above. +.It Pa /compat/linux/proc/partitions +Partition information including major and minor numbers, number of blocks and +name. +The rest of the fields are set to zero. +.It Pa /compat/linux/proc/stat +System statistics. +For each cpu it includes at most user time, nice time, system +time and idle time, iowait (time waiting for I/O to complete), times serving +irqs and softirq, steal, guest and guest_nice times that represent times spent +in different modes in a virtualized environment. +The last columns are set to zero. +This file also contains brief statistics for disks, context switches and +more. +.It Pa /compat/linux/proc/swap +Information about the swap device if any. +.It Pa /compat/linux/proc/uptime +Time since the last boot and time spent in idle state. +.It Pa /compat/linux/proc/version +Version of the emulated linux system. +.It Pa /compat/linux/proc/ Ns Ao Ar pid Ac A directory containing process information for process -.Pa pid . +.Ar pid . .It Pa /compat/linux/proc/self -A directory containing process information for the current process. +A symlink to a directory containing process information for the current process. .It Pa /compat/linux/proc/self/exe The executable image for the current process. .It Pa /compat/linux/proc/self/mem @@ -74,6 +146,7 @@ file system on .Sh SEE ALSO .Xr mount 2 , .Xr unmount 2 , +.Xr auxv 3 , .Xr linux 4 , .Xr procfs 5 , .Xr pseudofs 9