From nobody Thu May 29 15:57:49 2025 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 4b7WH24gwyz5x9ZR; Thu, 29 May 2025 15:57:50 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4b7WH16bnWz3bMZ; Thu, 29 May 2025 15:57:49 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1748534269; 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=ZdXEfz20tV2X5eaWvck543v8S+UPMIZfsy1DLCaL2Ms=; b=ViIg9DYU4Q3DGo/9Vy10AeDPDQ5WRrkmRIz6EtPLdmIXY3qqG1+kXH5DTJLpKp/JIcfiB7 XKfXKyCuVmOVWAHH9C3XZCLDqGDy7Ni28rUNpV3gGPLQETaswtRUgvyiBCwQUYtsztSQw9 MwRN9PDOrEzZH0ttGI2vBD1ZRYbzS9gpn9qMd9N8UL0+ZGWgcgkfEnDrr4ARedzcXNrds5 OspczEry29BpEUJicujL5oPfM6w2VGBbYqjf/YbTIzLhZVY8dFS583caPZrQoYzF2o8DgM p2jFzOGE6BSRMhb2c17O+FI9U5fJSaP9mJqp+RJHlqrwcFueNNauIL7ARsJkbw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1748534269; a=rsa-sha256; cv=none; b=tQx73M+6NGbosqXHJwriqnGKsG63ko75Pc9xwNWQ17gj80B45gT1tjJmxyR763TUUE4G85 XGzJx/BLQU0oYCTYNZjJAQZzU+03AtEweBUe1moxdOhJ0pp/aXKXFWI+TKTF6j/TyVFkHQ xUTm201xMaDRydLM7ntX8I33GCwL76QPIPnMCLZhWHrr7q9vLFWaBmPhQbBwXOimagLaEh gi8uq5K5NL7rwbu9Z7q+niVYAtfY2qgKP+LfW9u72MEidb/E8WQ3BBuGPwyDCmsnJZxRgp duHq7BlZEnqoRmsZuwLecXQ95BZoge8LuKSbuZqG8CXURsYHH2mpD+CG215Lmw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1748534269; 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=ZdXEfz20tV2X5eaWvck543v8S+UPMIZfsy1DLCaL2Ms=; b=xsKRmdhv/6sSxfvhGloodBir7aKo6MNtGRIbK23P8SMRuvCgsGUb924pOwKWSfu5QWhG+Z K9HiumSTx8LXwrXSuBZHrUiCud9qXocbX8OILM75RaGzCffmEBYKTsL/RKSF3m1EITvLGU WhUc2EneSWd9bd62iM22yt/Pr4b1oYuPcBOiDCNNJauCfZcaucGYkCGq9JYvR8jK4YRKaY EVJS1C+jJcD8STc1Oa2caGvwC3Ae3gOZRxm9M8eYTnqLcAZyepbwRBMfv6ELMnsiWTRzdz UANf9UwXKFsBf6ZUbxSPyZuNkxDINsDNISy4hdl024nRvnMVtkkLBI9tg9OgdQ== 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 4b7WH167Xtz1S5X; Thu, 29 May 2025 15:57:49 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 54TFvnWB080534; Thu, 29 May 2025 15:57:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 54TFvnvF080530; Thu, 29 May 2025 15:57:49 GMT (envelope-from git) Date: Thu, 29 May 2025 15:57:49 GMT Message-Id: <202505291557.54TFvnvF080530@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Fernando =?utf-8?Q?Apestegu=C3=ADa?= Subject: git: 1d193b180809 - main - Update linprocfs.4 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: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1d193b1808098328d3ad16b436a329b258935e0c Auto-Submitted: auto-generated The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/src/commit/?id=1d193b1808098328d3ad16b436a329b258935e0c commit 1d193b1808098328d3ad16b436a329b258935e0c Author: Fernando Apesteguía AuthorDate: 2025-04-04 18:02:59 +0000 Commit: Fernando Apesteguía CommitDate: 2025-05-29 15:57:18 +0000 Update linprocfs.4 Add documentation for missing files and directories. Also reorganize a bit. Approved by: gbe@, ziaee@ (manpages) Differential Revision: https://reviews.freebsd.org/D50408 --- share/man/man4/linprocfs.4 | 87 +++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 78 insertions(+), 9 deletions(-) diff --git a/share/man/man4/linprocfs.4 b/share/man/man4/linprocfs.4 index f5ab7d9a10ad..53940d7c02b0 100644 --- a/share/man/man4/linprocfs.4 +++ b/share/man/man4/linprocfs.4 @@ -1,7 +1,7 @@ .\" Written by Garrett Wollman .\" This file is in the public domain. .\" -.Dd November 13, 2019 +.Dd May 29, 2025 .Dt LINPROCFS 4 .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,23 +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 later 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/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/pid A directory containing process information for process .Pa pid . .It Pa /compat/linux/proc/self 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 -The complete virtual address space of the current process. .El .Sh EXAMPLES To mount a @@ -74,6 +142,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