tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

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: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: linux-fsdevel@vger.kernel.org
Reviewed-by: Christian Brauner <brauner@kernel.org>
Link: https://lore.kernel.org/r/20230314060347.605-1-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Randy Dunlap and committed by
Jonathan Corbet d2ea66a6 d7ba3657

+23 -21
+23 -21
Documentation/filesystems/proc.rst
··· 85 85 document. 86 86 87 87 The latest version of this document is available online at 88 - http://tldp.org/LDP/Linux-Filesystem-Hierarchy/html/proc.html 88 + https://www.kernel.org/doc/html/latest/filesystems/proc.html 89 89 90 90 If the above direction does not works for you, you could try the kernel 91 91 mailing list at linux-kernel@vger.kernel.org and/or try to reach me at ··· 232 232 snapshot of a moment, you can see /proc/<pid>/smaps file and scan page table. 233 233 It's slow but very precise. 234 234 235 - .. table:: Table 1-2: Contents of the status files (as of 4.19) 235 + .. table:: Table 1-2: Contents of the status fields (as of 4.19) 236 236 237 237 ========================== =================================================== 238 238 Field Content ··· 305 305 ========================== =================================================== 306 306 307 307 308 - .. table:: Table 1-3: Contents of the statm files (as of 2.6.8-rc3) 308 + .. table:: Table 1-3: Contents of the statm fields (as of 2.6.8-rc3) 309 309 310 310 ======== =============================== ============================== 311 311 Field Content ··· 323 323 ======== =============================== ============================== 324 324 325 325 326 - .. table:: Table 1-4: Contents of the stat files (as of 2.6.30-rc7) 326 + .. table:: Table 1-4: Contents of the stat fields (as of 2.6.30-rc7) 327 327 328 328 ============= =============================================================== 329 329 Field Content ··· 1321 1321 1.4 SCSI info 1322 1322 ------------- 1323 1323 1324 - If you have a SCSI host adapter in your system, you'll find a subdirectory 1325 - named after the driver for this adapter in /proc/scsi. You'll also see a list 1326 - of all recognized SCSI devices in /proc/scsi:: 1324 + If you have a SCSI or ATA host adapter in your system, you'll find a 1325 + subdirectory named after the driver for this adapter in /proc/scsi. 1326 + You'll also see a list of all recognized SCSI devices in /proc/scsi:: 1327 1327 1328 1328 >cat /proc/scsi/scsi 1329 1329 Attached devices: ··· 1449 1449 since the system first booted. For a quick look, simply cat the file:: 1450 1450 1451 1451 > cat /proc/stat 1452 - cpu 2255 34 2290 22625563 6290 127 456 0 0 0 1453 - cpu0 1132 34 1441 11311718 3675 127 438 0 0 0 1454 - cpu1 1123 0 849 11313845 2614 0 18 0 0 0 1455 - intr 114930548 113199788 3 0 5 263 0 4 [... lots more numbers ...] 1456 - ctxt 1990473 1457 - btime 1062191376 1458 - processes 2915 1459 - procs_running 1 1452 + cpu 237902850 368826709 106375398 1873517540 1135548 0 14507935 0 0 0 1453 + cpu0 60045249 91891769 26331539 468411416 495718 0 5739640 0 0 0 1454 + cpu1 59746288 91759249 26609887 468860630 312281 0 4384817 0 0 0 1455 + cpu2 59489247 92985423 26904446 467808813 171668 0 2268998 0 0 0 1456 + cpu3 58622065 92190267 26529524 468436680 155879 0 2114478 0 0 0 1457 + 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> 1458 + ctxt 22848221062 1459 + btime 1605316999 1460 + processes 746787147 1461 + procs_running 2 1460 1462 procs_blocked 0 1461 - softirq 183433 0 21755 12 39 1137 231 21459 2263 1463 + softirq 12121874454 100099120 3938138295 127375644 2795979 187870761 0 173808342 3072582055 52608 224184354 1462 1464 1463 1465 The very first "cpu" line aggregates the numbers in all of the other "cpuN" 1464 1466 lines. These numbers identify the amount of time the CPU has spent performing ··· 1522 1520 Information about mounted ext4 file systems can be found in 1523 1521 /proc/fs/ext4. Each mounted filesystem will have a directory in 1524 1522 /proc/fs/ext4 based on its device name (i.e., /proc/fs/ext4/hdc or 1525 - /proc/fs/ext4/dm-0). The files in each per-device directory are shown 1526 - in Table 1-12, below. 1523 + /proc/fs/ext4/sda9 or /proc/fs/ext4/dm-0). The files in each per-device 1524 + directory are shown in Table 1-12, below. 1527 1525 1528 1526 .. table:: Table 1-12: Files in /proc/fs/ext4/<devname> 1529 1527 ··· 1603 1601 documentation and source before actually making adjustments. In any case, be 1604 1602 very careful when writing to any of these files. The entries in /proc may 1605 1603 change slightly between the 2.1.* and the 2.2 kernel, so if there is any doubt 1606 - review the kernel documentation in the directory /usr/src/linux/Documentation. 1604 + review the kernel documentation in the directory linux/Documentation. 1607 1605 This chapter is heavily based on the documentation included in the pre 2.2 1608 1606 kernels, and became part of it in version 2.2.1 of the Linux kernel. 1609 1607 1610 - Please see: Documentation/admin-guide/sysctl/ directory for descriptions of these 1611 - entries. 1608 + Please see: Documentation/admin-guide/sysctl/ directory for descriptions of 1609 + these entries. 1612 1610 1613 1611 Summary 1614 1612 -------