diff options
Diffstat (limited to 'Documentation/filesystems')
| -rw-r--r-- | Documentation/filesystems/00-INDEX | 2 | ||||
| -rw-r--r-- | Documentation/filesystems/efivarfs.txt | 16 | ||||
| -rw-r--r-- | Documentation/filesystems/ext4.txt | 9 | ||||
| -rw-r--r-- | Documentation/filesystems/proc.txt | 146 | ||||
| -rw-r--r-- | Documentation/filesystems/vfat.txt | 9 | ||||
| -rw-r--r-- | Documentation/filesystems/xfs.txt | 13 |
6 files changed, 180 insertions, 15 deletions
diff --git a/Documentation/filesystems/00-INDEX b/Documentation/filesystems/00-INDEX index 8c624a18f67d..7b52ba7bf32a 100644 --- a/Documentation/filesystems/00-INDEX +++ b/Documentation/filesystems/00-INDEX | |||
| @@ -38,6 +38,8 @@ dnotify_test.c | |||
| 38 | - example program for dnotify | 38 | - example program for dnotify |
| 39 | ecryptfs.txt | 39 | ecryptfs.txt |
| 40 | - docs on eCryptfs: stacked cryptographic filesystem for Linux. | 40 | - docs on eCryptfs: stacked cryptographic filesystem for Linux. |
| 41 | efivarfs.txt | ||
| 42 | - info for the efivarfs filesystem. | ||
| 41 | exofs.txt | 43 | exofs.txt |
| 42 | - info, usage, mount options, design about EXOFS. | 44 | - info, usage, mount options, design about EXOFS. |
| 43 | ext2.txt | 45 | ext2.txt |
diff --git a/Documentation/filesystems/efivarfs.txt b/Documentation/filesystems/efivarfs.txt new file mode 100644 index 000000000000..c477af086e65 --- /dev/null +++ b/Documentation/filesystems/efivarfs.txt | |||
| @@ -0,0 +1,16 @@ | |||
| 1 | |||
| 2 | efivarfs - a (U)EFI variable filesystem | ||
| 3 | |||
| 4 | The efivarfs filesystem was created to address the shortcomings of | ||
| 5 | using entries in sysfs to maintain EFI variables. The old sysfs EFI | ||
| 6 | variables code only supported variables of up to 1024 bytes. This | ||
| 7 | limitation existed in version 0.99 of the EFI specification, but was | ||
| 8 | removed before any full releases. Since variables can now be larger | ||
| 9 | than a single page, sysfs isn't the best interface for this. | ||
| 10 | |||
| 11 | Variables can be created, deleted and modified with the efivarfs | ||
| 12 | filesystem. | ||
| 13 | |||
| 14 | efivarfs is typically mounted like this, | ||
| 15 | |||
| 16 | mount -t efivarfs none /sys/firmware/efi/efivars | ||
diff --git a/Documentation/filesystems/ext4.txt b/Documentation/filesystems/ext4.txt index 104322bf378c..34ea4f1fa6ea 100644 --- a/Documentation/filesystems/ext4.txt +++ b/Documentation/filesystems/ext4.txt | |||
| @@ -200,12 +200,9 @@ inode_readahead_blks=n This tuning parameter controls the maximum | |||
| 200 | table readahead algorithm will pre-read into | 200 | table readahead algorithm will pre-read into |
| 201 | the buffer cache. The default value is 32 blocks. | 201 | the buffer cache. The default value is 32 blocks. |
| 202 | 202 | ||
| 203 | nouser_xattr Disables Extended User Attributes. If you have extended | 203 | nouser_xattr Disables Extended User Attributes. See the |
| 204 | attribute support enabled in the kernel configuration | 204 | attr(5) manual page and http://acl.bestbits.at/ |
| 205 | (CONFIG_EXT4_FS_XATTR), extended attribute support | 205 | for more information about extended attributes. |
| 206 | is enabled by default on mount. See the attr(5) manual | ||
| 207 | page and http://acl.bestbits.at/ for more information | ||
| 208 | about extended attributes. | ||
| 209 | 206 | ||
| 210 | noacl This option disables POSIX Access Control List | 207 | noacl This option disables POSIX Access Control List |
| 211 | support. If ACL support is enabled in the kernel | 208 | support. If ACL support is enabled in the kernel |
diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt index a1793d670cd0..fd8d0d594fc7 100644 --- a/Documentation/filesystems/proc.txt +++ b/Documentation/filesystems/proc.txt | |||
| @@ -33,7 +33,7 @@ Table of Contents | |||
| 33 | 2 Modifying System Parameters | 33 | 2 Modifying System Parameters |
| 34 | 34 | ||
| 35 | 3 Per-Process Parameters | 35 | 3 Per-Process Parameters |
| 36 | 3.1 /proc/<pid>/oom_score_adj - Adjust the oom-killer | 36 | 3.1 /proc/<pid>/oom_adj & /proc/<pid>/oom_score_adj - Adjust the oom-killer |
| 37 | score | 37 | score |
| 38 | 3.2 /proc/<pid>/oom_score - Display current oom-killer score | 38 | 3.2 /proc/<pid>/oom_score - Display current oom-killer score |
| 39 | 3.3 /proc/<pid>/io - Display the IO accounting fields | 39 | 3.3 /proc/<pid>/io - Display the IO accounting fields |
| @@ -41,6 +41,7 @@ Table of Contents | |||
| 41 | 3.5 /proc/<pid>/mountinfo - Information about mounts | 41 | 3.5 /proc/<pid>/mountinfo - Information about mounts |
| 42 | 3.6 /proc/<pid>/comm & /proc/<pid>/task/<tid>/comm | 42 | 3.6 /proc/<pid>/comm & /proc/<pid>/task/<tid>/comm |
| 43 | 3.7 /proc/<pid>/task/<tid>/children - Information about task children | 43 | 3.7 /proc/<pid>/task/<tid>/children - Information about task children |
| 44 | 3.8 /proc/<pid>/fdinfo/<fd> - Information about opened file | ||
| 44 | 45 | ||
| 45 | 4 Configuring procfs | 46 | 4 Configuring procfs |
| 46 | 4.1 Mount options | 47 | 4.1 Mount options |
| @@ -142,7 +143,7 @@ Table 1-1: Process specific entries in /proc | |||
| 142 | pagemap Page table | 143 | pagemap Page table |
| 143 | stack Report full stack trace, enable via CONFIG_STACKTRACE | 144 | stack Report full stack trace, enable via CONFIG_STACKTRACE |
| 144 | smaps a extension based on maps, showing the memory consumption of | 145 | smaps a extension based on maps, showing the memory consumption of |
| 145 | each mapping | 146 | each mapping and flags associated with it |
| 146 | .............................................................................. | 147 | .............................................................................. |
| 147 | 148 | ||
| 148 | For example, to get the status information of a process, all you have to do is | 149 | For example, to get the status information of a process, all you have to do is |
| @@ -181,6 +182,7 @@ read the file /proc/PID/status: | |||
| 181 | CapPrm: 0000000000000000 | 182 | CapPrm: 0000000000000000 |
| 182 | CapEff: 0000000000000000 | 183 | CapEff: 0000000000000000 |
| 183 | CapBnd: ffffffffffffffff | 184 | CapBnd: ffffffffffffffff |
| 185 | Seccomp: 0 | ||
| 184 | voluntary_ctxt_switches: 0 | 186 | voluntary_ctxt_switches: 0 |
| 185 | nonvoluntary_ctxt_switches: 1 | 187 | nonvoluntary_ctxt_switches: 1 |
| 186 | 188 | ||
| @@ -237,6 +239,7 @@ Table 1-2: Contents of the status files (as of 2.6.30-rc7) | |||
| 237 | CapPrm bitmap of permitted capabilities | 239 | CapPrm bitmap of permitted capabilities |
| 238 | CapEff bitmap of effective capabilities | 240 | CapEff bitmap of effective capabilities |
| 239 | CapBnd bitmap of capabilities bounding set | 241 | CapBnd bitmap of capabilities bounding set |
| 242 | Seccomp seccomp mode, like prctl(PR_GET_SECCOMP, ...) | ||
| 240 | Cpus_allowed mask of CPUs on which this process may run | 243 | Cpus_allowed mask of CPUs on which this process may run |
| 241 | Cpus_allowed_list Same as previous, but in "list format" | 244 | Cpus_allowed_list Same as previous, but in "list format" |
| 242 | Mems_allowed mask of memory nodes allowed to this process | 245 | Mems_allowed mask of memory nodes allowed to this process |
| @@ -415,8 +418,9 @@ Swap: 0 kB | |||
| 415 | KernelPageSize: 4 kB | 418 | KernelPageSize: 4 kB |
| 416 | MMUPageSize: 4 kB | 419 | MMUPageSize: 4 kB |
| 417 | Locked: 374 kB | 420 | Locked: 374 kB |
| 421 | VmFlags: rd ex mr mw me de | ||
| 418 | 422 | ||
| 419 | The first of these lines shows the same information as is displayed for the | 423 | the first of these lines shows the same information as is displayed for the |
| 420 | mapping in /proc/PID/maps. The remaining lines show the size of the mapping | 424 | mapping in /proc/PID/maps. The remaining lines show the size of the mapping |
| 421 | (size), the amount of the mapping that is currently resident in RAM (RSS), the | 425 | (size), the amount of the mapping that is currently resident in RAM (RSS), the |
| 422 | process' proportional share of this mapping (PSS), the number of clean and | 426 | process' proportional share of this mapping (PSS), the number of clean and |
| @@ -430,6 +434,41 @@ and a page is modified, the file page is replaced by a private anonymous copy. | |||
| 430 | "Swap" shows how much would-be-anonymous memory is also used, but out on | 434 | "Swap" shows how much would-be-anonymous memory is also used, but out on |
| 431 | swap. | 435 | swap. |
| 432 | 436 | ||
| 437 | "VmFlags" field deserves a separate description. This member represents the kernel | ||
| 438 | flags associated with the particular virtual memory area in two letter encoded | ||
| 439 | manner. The codes are the following: | ||
| 440 | rd - readable | ||
| 441 | wr - writeable | ||
| 442 | ex - executable | ||
| 443 | sh - shared | ||
| 444 | mr - may read | ||
| 445 | mw - may write | ||
| 446 | me - may execute | ||
| 447 | ms - may share | ||
| 448 | gd - stack segment growns down | ||
| 449 | pf - pure PFN range | ||
| 450 | dw - disabled write to the mapped file | ||
| 451 | lo - pages are locked in memory | ||
| 452 | io - memory mapped I/O area | ||
| 453 | sr - sequential read advise provided | ||
| 454 | rr - random read advise provided | ||
| 455 | dc - do not copy area on fork | ||
| 456 | de - do not expand area on remapping | ||
| 457 | ac - area is accountable | ||
| 458 | nr - swap space is not reserved for the area | ||
| 459 | ht - area uses huge tlb pages | ||
| 460 | nl - non-linear mapping | ||
| 461 | ar - architecture specific flag | ||
| 462 | dd - do not include area into core dump | ||
| 463 | mm - mixed map area | ||
| 464 | hg - huge page advise flag | ||
| 465 | nh - no-huge page advise flag | ||
| 466 | mg - mergable advise flag | ||
| 467 | |||
| 468 | Note that there is no guarantee that every flag and associated mnemonic will | ||
| 469 | be present in all further kernel releases. Things get changed, the flags may | ||
| 470 | be vanished or the reverse -- new added. | ||
| 471 | |||
| 433 | This file is only present if the CONFIG_MMU kernel configuration option is | 472 | This file is only present if the CONFIG_MMU kernel configuration option is |
| 434 | enabled. | 473 | enabled. |
| 435 | 474 | ||
| @@ -1320,10 +1359,10 @@ of the kernel. | |||
| 1320 | CHAPTER 3: PER-PROCESS PARAMETERS | 1359 | CHAPTER 3: PER-PROCESS PARAMETERS |
| 1321 | ------------------------------------------------------------------------------ | 1360 | ------------------------------------------------------------------------------ |
| 1322 | 1361 | ||
| 1323 | 3.1 /proc/<pid>/oom_score_adj- Adjust the oom-killer score | 1362 | 3.1 /proc/<pid>/oom_adj & /proc/<pid>/oom_score_adj- Adjust the oom-killer score |
| 1324 | -------------------------------------------------------------------------------- | 1363 | -------------------------------------------------------------------------------- |
| 1325 | 1364 | ||
| 1326 | This file can be used to adjust the badness heuristic used to select which | 1365 | These file can be used to adjust the badness heuristic used to select which |
| 1327 | process gets killed in out of memory conditions. | 1366 | process gets killed in out of memory conditions. |
| 1328 | 1367 | ||
| 1329 | The badness heuristic assigns a value to each candidate task ranging from 0 | 1368 | The badness heuristic assigns a value to each candidate task ranging from 0 |
| @@ -1361,6 +1400,12 @@ same system, cpuset, mempolicy, or memory controller resources to use at least | |||
| 1361 | equivalent to discounting 50% of the task's allowed memory from being considered | 1400 | equivalent to discounting 50% of the task's allowed memory from being considered |
| 1362 | as scoring against the task. | 1401 | as scoring against the task. |
| 1363 | 1402 | ||
| 1403 | For backwards compatibility with previous kernels, /proc/<pid>/oom_adj may also | ||
| 1404 | be used to tune the badness score. Its acceptable values range from -16 | ||
| 1405 | (OOM_ADJUST_MIN) to +15 (OOM_ADJUST_MAX) and a special value of -17 | ||
| 1406 | (OOM_DISABLE) to disable oom killing entirely for that task. Its value is | ||
| 1407 | scaled linearly with /proc/<pid>/oom_score_adj. | ||
| 1408 | |||
| 1364 | The value of /proc/<pid>/oom_score_adj may be reduced no lower than the last | 1409 | The value of /proc/<pid>/oom_score_adj may be reduced no lower than the last |
| 1365 | value set by a CAP_SYS_RESOURCE process. To reduce the value any lower | 1410 | value set by a CAP_SYS_RESOURCE process. To reduce the value any lower |
| 1366 | requires CAP_SYS_RESOURCE. | 1411 | requires CAP_SYS_RESOURCE. |
| @@ -1375,7 +1420,9 @@ minimal amount of work. | |||
| 1375 | ------------------------------------------------------------- | 1420 | ------------------------------------------------------------- |
| 1376 | 1421 | ||
| 1377 | This file can be used to check the current score used by the oom-killer is for | 1422 | This file can be used to check the current score used by the oom-killer is for |
| 1378 | any given <pid>. | 1423 | any given <pid>. Use it together with /proc/<pid>/oom_score_adj to tune which |
| 1424 | process should be killed in an out-of-memory situation. | ||
| 1425 | |||
| 1379 | 1426 | ||
| 1380 | 3.3 /proc/<pid>/io - Display the IO accounting fields | 1427 | 3.3 /proc/<pid>/io - Display the IO accounting fields |
| 1381 | ------------------------------------------------------- | 1428 | ------------------------------------------------------- |
| @@ -1587,6 +1634,93 @@ pids, so one need to either stop or freeze processes being inspected | |||
| 1587 | if precise results are needed. | 1634 | if precise results are needed. |
| 1588 | 1635 | ||
| 1589 | 1636 | ||
| 1637 | 3.7 /proc/<pid>/fdinfo/<fd> - Information about opened file | ||
| 1638 | --------------------------------------------------------------- | ||
| 1639 | This file provides information associated with an opened file. The regular | ||
| 1640 | files have at least two fields -- 'pos' and 'flags'. The 'pos' represents | ||
| 1641 | the current offset of the opened file in decimal form [see lseek(2) for | ||
| 1642 | details] and 'flags' denotes the octal O_xxx mask the file has been | ||
| 1643 | created with [see open(2) for details]. | ||
| 1644 | |||
| 1645 | A typical output is | ||
| 1646 | |||
| 1647 | pos: 0 | ||
| 1648 | flags: 0100002 | ||
| 1649 | |||
| 1650 | The files such as eventfd, fsnotify, signalfd, epoll among the regular pos/flags | ||
| 1651 | pair provide additional information particular to the objects they represent. | ||
| 1652 | |||
| 1653 | Eventfd files | ||
| 1654 | ~~~~~~~~~~~~~ | ||
| 1655 | pos: 0 | ||
| 1656 | flags: 04002 | ||
| 1657 | eventfd-count: 5a | ||
| 1658 | |||
| 1659 | where 'eventfd-count' is hex value of a counter. | ||
| 1660 | |||
| 1661 | Signalfd files | ||
| 1662 | ~~~~~~~~~~~~~~ | ||
| 1663 | pos: 0 | ||
| 1664 | flags: 04002 | ||
| 1665 | sigmask: 0000000000000200 | ||
| 1666 | |||
| 1667 | where 'sigmask' is hex value of the signal mask associated | ||
| 1668 | with a file. | ||
| 1669 | |||
| 1670 | Epoll files | ||
| 1671 | ~~~~~~~~~~~ | ||
| 1672 | pos: 0 | ||
| 1673 | flags: 02 | ||
| 1674 | tfd: 5 events: 1d data: ffffffffffffffff | ||
| 1675 | |||
| 1676 | where 'tfd' is a target file descriptor number in decimal form, | ||
| 1677 | 'events' is events mask being watched and the 'data' is data | ||
| 1678 | associated with a target [see epoll(7) for more details]. | ||
| 1679 | |||
| 1680 | Fsnotify files | ||
| 1681 | ~~~~~~~~~~~~~~ | ||
| 1682 | For inotify files the format is the following | ||
| 1683 | |||
| 1684 | pos: 0 | ||
| 1685 | flags: 02000000 | ||
| 1686 | inotify wd:3 ino:9e7e sdev:800013 mask:800afce ignored_mask:0 fhandle-bytes:8 fhandle-type:1 f_handle:7e9e0000640d1b6d | ||
| 1687 | |||
| 1688 | where 'wd' is a watch descriptor in decimal form, ie a target file | ||
| 1689 | descriptor number, 'ino' and 'sdev' are inode and device where the | ||
| 1690 | target file resides and the 'mask' is the mask of events, all in hex | ||
| 1691 | form [see inotify(7) for more details]. | ||
| 1692 | |||
| 1693 | If the kernel was built with exportfs support, the path to the target | ||
| 1694 | file is encoded as a file handle. The file handle is provided by three | ||
| 1695 | fields 'fhandle-bytes', 'fhandle-type' and 'f_handle', all in hex | ||
| 1696 | format. | ||
| 1697 | |||
| 1698 | If the kernel is built without exportfs support the file handle won't be | ||
| 1699 | printed out. | ||
| 1700 | |||
| 1701 | If there is no inotify mark attached yet the 'inotify' line will be omitted. | ||
| 1702 | |||
| 1703 | For fanotify files the format is | ||
| 1704 | |||
| 1705 | pos: 0 | ||
| 1706 | flags: 02 | ||
| 1707 | fanotify flags:10 event-flags:0 | ||
| 1708 | fanotify mnt_id:12 mflags:40 mask:38 ignored_mask:40000003 | ||
| 1709 | fanotify ino:4f969 sdev:800013 mflags:0 mask:3b ignored_mask:40000000 fhandle-bytes:8 fhandle-type:1 f_handle:69f90400c275b5b4 | ||
| 1710 | |||
| 1711 | where fanotify 'flags' and 'event-flags' are values used in fanotify_init | ||
| 1712 | call, 'mnt_id' is the mount point identifier, 'mflags' is the value of | ||
| 1713 | flags associated with mark which are tracked separately from events | ||
| 1714 | mask. 'ino', 'sdev' are target inode and device, 'mask' is the events | ||
| 1715 | mask and 'ignored_mask' is the mask of events which are to be ignored. | ||
| 1716 | All in hex format. Incorporation of 'mflags', 'mask' and 'ignored_mask' | ||
| 1717 | does provide information about flags and mask used in fanotify_mark | ||
| 1718 | call [see fsnotify manpage for details]. | ||
| 1719 | |||
| 1720 | While the first three lines are mandatory and always printed, the rest is | ||
| 1721 | optional and may be omitted if no marks created yet. | ||
| 1722 | |||
| 1723 | |||
| 1590 | ------------------------------------------------------------------------------ | 1724 | ------------------------------------------------------------------------------ |
| 1591 | Configuring procfs | 1725 | Configuring procfs |
| 1592 | ------------------------------------------------------------------------------ | 1726 | ------------------------------------------------------------------------------ |
diff --git a/Documentation/filesystems/vfat.txt b/Documentation/filesystems/vfat.txt index de1e6c4dccff..d230dd9c99b0 100644 --- a/Documentation/filesystems/vfat.txt +++ b/Documentation/filesystems/vfat.txt | |||
| @@ -111,6 +111,15 @@ tz=UTC -- Interpret timestamps as UTC rather than local time. | |||
| 111 | useful when mounting devices (like digital cameras) | 111 | useful when mounting devices (like digital cameras) |
| 112 | that are set to UTC in order to avoid the pitfalls of | 112 | that are set to UTC in order to avoid the pitfalls of |
| 113 | local time. | 113 | local time. |
| 114 | time_offset=minutes | ||
| 115 | -- Set offset for conversion of timestamps from local time | ||
| 116 | used by FAT to UTC. I.e. <minutes> minutes will be subtracted | ||
| 117 | from each timestamp to convert it to UTC used internally by | ||
| 118 | Linux. This is useful when time zone set in sys_tz is | ||
| 119 | not the time zone used by the filesystem. Note that this | ||
| 120 | option still does not provide correct time stamps in all | ||
| 121 | cases in presence of DST - time stamps in a different DST | ||
| 122 | setting will be off by one hour. | ||
| 114 | 123 | ||
| 115 | showexec -- If set, the execute permission bits of the file will be | 124 | showexec -- If set, the execute permission bits of the file will be |
| 116 | allowed only if the extension part of the name is .EXE, | 125 | allowed only if the extension part of the name is .EXE, |
diff --git a/Documentation/filesystems/xfs.txt b/Documentation/filesystems/xfs.txt index 3fc0c31a6f5d..3e4b3dd1e046 100644 --- a/Documentation/filesystems/xfs.txt +++ b/Documentation/filesystems/xfs.txt | |||
| @@ -43,7 +43,7 @@ When mounting an XFS filesystem, the following options are accepted. | |||
| 43 | Issue command to let the block device reclaim space freed by the | 43 | Issue command to let the block device reclaim space freed by the |
| 44 | filesystem. This is useful for SSD devices, thinly provisioned | 44 | filesystem. This is useful for SSD devices, thinly provisioned |
| 45 | LUNs and virtual machine images, but may have a performance | 45 | LUNs and virtual machine images, but may have a performance |
| 46 | impact. This option is incompatible with the nodelaylog option. | 46 | impact. |
| 47 | 47 | ||
| 48 | dmapi | 48 | dmapi |
| 49 | Enable the DMAPI (Data Management API) event callouts. | 49 | Enable the DMAPI (Data Management API) event callouts. |
| @@ -72,8 +72,15 @@ When mounting an XFS filesystem, the following options are accepted. | |||
| 72 | Indicates that XFS is allowed to create inodes at any location | 72 | Indicates that XFS is allowed to create inodes at any location |
| 73 | in the filesystem, including those which will result in inode | 73 | in the filesystem, including those which will result in inode |
| 74 | numbers occupying more than 32 bits of significance. This is | 74 | numbers occupying more than 32 bits of significance. This is |
| 75 | provided for backwards compatibility, but causes problems for | 75 | the default allocation option. Applications which do not handle |
| 76 | backup applications that cannot handle large inode numbers. | 76 | inode numbers bigger than 32 bits, should use inode32 option. |
| 77 | |||
| 78 | inode32 | ||
| 79 | Indicates that XFS is limited to create inodes at locations which | ||
| 80 | will not result in inode numbers with more than 32 bits of | ||
| 81 | significance. This is provided for backwards compatibility, since | ||
| 82 | 64 bits inode numbers might cause problems for some applications | ||
| 83 | that cannot handle large inode numbers. | ||
| 77 | 84 | ||
| 78 | largeio/nolargeio | 85 | largeio/nolargeio |
| 79 | If "nolargeio" is specified, the optimal I/O reported in | 86 | If "nolargeio" is specified, the optimal I/O reported in |
