Commit d2ea66a6 authored by Randy Dunlap's avatar Randy Dunlap Committed by Jonathan Corbet

Documentation: fs/proc: corrections and update

Update URL for the latest online version of this document.
Correct "files" to "fields" in a few places.
Update /proc/scsi, /proc/stat, and /proc/fs/ext4 information.
Drop /usr/src/ from the location of the kernel source tree.
Signed-off-by: default avatarRandy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: linux-fsdevel@vger.kernel.org
Reviewed-by: default avatarChristian Brauner <brauner@kernel.org>
Link: https://lore.kernel.org/r/20230314060347.605-1-rdunlap@infradead.orgSigned-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent d7ba3657
...@@ -85,7 +85,7 @@ contact Bodo Bauer at bb@ricochet.net. We'll be happy to add them to this ...@@ -85,7 +85,7 @@ contact Bodo Bauer at bb@ricochet.net. We'll be happy to add them to this
document. document.
The latest version of this document is available online at The latest version of this document is available online at
http://tldp.org/LDP/Linux-Filesystem-Hierarchy/html/proc.html https://www.kernel.org/doc/html/latest/filesystems/proc.html
If the above direction does not works for you, you could try the kernel If the above direction does not works for you, you could try the kernel
mailing list at linux-kernel@vger.kernel.org and/or try to reach me at mailing list at linux-kernel@vger.kernel.org and/or try to reach me at
...@@ -232,7 +232,7 @@ asynchronous manner and the value may not be very precise. To see a precise ...@@ -232,7 +232,7 @@ asynchronous manner and the value may not be very precise. To see a precise
snapshot of a moment, you can see /proc/<pid>/smaps file and scan page table. snapshot of a moment, you can see /proc/<pid>/smaps file and scan page table.
It's slow but very precise. It's slow but very precise.
.. table:: Table 1-2: Contents of the status files (as of 4.19) .. table:: Table 1-2: Contents of the status fields (as of 4.19)
========================== =================================================== ========================== ===================================================
Field Content Field Content
...@@ -305,7 +305,7 @@ It's slow but very precise. ...@@ -305,7 +305,7 @@ It's slow but very precise.
========================== =================================================== ========================== ===================================================
.. table:: Table 1-3: Contents of the statm files (as of 2.6.8-rc3) .. table:: Table 1-3: Contents of the statm fields (as of 2.6.8-rc3)
======== =============================== ============================== ======== =============================== ==============================
Field Content Field Content
...@@ -323,7 +323,7 @@ It's slow but very precise. ...@@ -323,7 +323,7 @@ It's slow but very precise.
======== =============================== ============================== ======== =============================== ==============================
.. table:: Table 1-4: Contents of the stat files (as of 2.6.30-rc7) .. table:: Table 1-4: Contents of the stat fields (as of 2.6.30-rc7)
============= =============================================================== ============= ===============================================================
Field Content Field Content
...@@ -1321,9 +1321,9 @@ many times the slaves link has failed. ...@@ -1321,9 +1321,9 @@ many times the slaves link has failed.
1.4 SCSI info 1.4 SCSI info
------------- -------------
If you have a SCSI host adapter in your system, you'll find a subdirectory If you have a SCSI or ATA host adapter in your system, you'll find a
named after the driver for this adapter in /proc/scsi. You'll also see a list subdirectory named after the driver for this adapter in /proc/scsi.
of all recognized SCSI devices in /proc/scsi:: You'll also see a list of all recognized SCSI devices in /proc/scsi::
>cat /proc/scsi/scsi >cat /proc/scsi/scsi
Attached devices: Attached devices:
...@@ -1449,16 +1449,18 @@ Various pieces of information about kernel activity are available in the ...@@ -1449,16 +1449,18 @@ Various pieces of information about kernel activity are available in the
since the system first booted. For a quick look, simply cat the file:: since the system first booted. For a quick look, simply cat the file::
> cat /proc/stat > cat /proc/stat
cpu 2255 34 2290 22625563 6290 127 456 0 0 0 cpu 237902850 368826709 106375398 1873517540 1135548 0 14507935 0 0 0
cpu0 1132 34 1441 11311718 3675 127 438 0 0 0 cpu0 60045249 91891769 26331539 468411416 495718 0 5739640 0 0 0
cpu1 1123 0 849 11313845 2614 0 18 0 0 0 cpu1 59746288 91759249 26609887 468860630 312281 0 4384817 0 0 0
intr 114930548 113199788 3 0 5 263 0 4 [... lots more numbers ...] cpu2 59489247 92985423 26904446 467808813 171668 0 2268998 0 0 0
ctxt 1990473 cpu3 58622065 92190267 26529524 468436680 155879 0 2114478 0 0 0
btime 1062191376 intr 8688370575 8 3373 0 0 0 0 0 0 1 40791 0 0 353317 0 0 0 0 224789828 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 190974333 41958554 123983334 43 0 224593 0 0 0 <more 0's deleted>
processes 2915 ctxt 22848221062
procs_running 1 btime 1605316999
processes 746787147
procs_running 2
procs_blocked 0 procs_blocked 0
softirq 183433 0 21755 12 39 1137 231 21459 2263 softirq 12121874454 100099120 3938138295 127375644 2795979 187870761 0 173808342 3072582055 52608 224184354
The very first "cpu" line aggregates the numbers in all of the other "cpuN" The very first "cpu" line aggregates the numbers in all of the other "cpuN"
lines. These numbers identify the amount of time the CPU has spent performing lines. These numbers identify the amount of time the CPU has spent performing
...@@ -1520,8 +1522,8 @@ softirq. ...@@ -1520,8 +1522,8 @@ softirq.
Information about mounted ext4 file systems can be found in Information about mounted ext4 file systems can be found in
/proc/fs/ext4. Each mounted filesystem will have a directory in /proc/fs/ext4. Each mounted filesystem will have a directory in
/proc/fs/ext4 based on its device name (i.e., /proc/fs/ext4/hdc or /proc/fs/ext4 based on its device name (i.e., /proc/fs/ext4/hdc or
/proc/fs/ext4/dm-0). The files in each per-device directory are shown /proc/fs/ext4/sda9 or /proc/fs/ext4/dm-0). The files in each per-device
in Table 1-12, below. directory are shown in Table 1-12, below.
.. table:: Table 1-12: Files in /proc/fs/ext4/<devname> .. table:: Table 1-12: Files in /proc/fs/ext4/<devname>
...@@ -1601,12 +1603,12 @@ can inadvertently disrupt your system, it is advisable to read both ...@@ -1601,12 +1603,12 @@ can inadvertently disrupt your system, it is advisable to read both
documentation and source before actually making adjustments. In any case, be documentation and source before actually making adjustments. In any case, be
very careful when writing to any of these files. The entries in /proc may very careful when writing to any of these files. The entries in /proc may
change slightly between the 2.1.* and the 2.2 kernel, so if there is any doubt change slightly between the 2.1.* and the 2.2 kernel, so if there is any doubt
review the kernel documentation in the directory /usr/src/linux/Documentation. review the kernel documentation in the directory linux/Documentation.
This chapter is heavily based on the documentation included in the pre 2.2 This chapter is heavily based on the documentation included in the pre 2.2
kernels, and became part of it in version 2.2.1 of the Linux kernel. kernels, and became part of it in version 2.2.1 of the Linux kernel.
Please see: Documentation/admin-guide/sysctl/ directory for descriptions of these Please see: Documentation/admin-guide/sysctl/ directory for descriptions of
entries. these entries.
Summary Summary
------- -------
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment