diff options
author | Mauro Carvalho Chehab <mchehab@redhat.com> | 2012-10-17 08:32:49 -0400 |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab@redhat.com> | 2012-10-17 08:32:49 -0400 |
commit | 214e2ca2b82d335935a861c253fe94c61ad77aad (patch) | |
tree | eee42ff74d10470789d919b8499737ad0e919360 /Documentation/filesystems | |
parent | 1fdead8ad31d3aa833bc37739273fcde89ace93c (diff) | |
parent | ddffeb8c4d0331609ef2581d84de4d763607bd37 (diff) |
Merge tag 'v3.7-rc1' into staging/for_v3.8
Linux 3.7-rc1
* tag 'v3.7-rc1': (9579 commits)
Linux 3.7-rc1
x86, boot: Explicitly include autoconf.h for hostprogs
perf: Fix UAPI fallout
ARM: config: make sure that platforms are ordered by option string
ARM: config: sort select statements alphanumerically
UAPI: (Scripted) Disintegrate include/linux/byteorder
UAPI: (Scripted) Disintegrate include/linux
UAPI: Unexport linux/blk_types.h
UAPI: Unexport part of linux/ppp-comp.h
perf: Handle new rbtree implementation
procfs: don't need a PATH_MAX allocation to hold a string representation of an int
vfs: embed struct filename inside of names_cache allocation if possible
audit: make audit_inode take struct filename
vfs: make path_openat take a struct filename pointer
vfs: turn do_path_lookup into wrapper around struct filename variant
audit: allow audit code to satisfy getname requests from its names_list
vfs: define struct filename and have getname() return it
btrfs: Fix compilation with user namespace support enabled
userns: Fix posix_acl_file_xattr_userns gid conversion
userns: Properly print bluetooth socket uids
...
Diffstat (limited to 'Documentation/filesystems')
-rw-r--r-- | Documentation/filesystems/debugfs.txt | 4 | ||||
-rw-r--r-- | Documentation/filesystems/ext4.txt | 10 | ||||
-rw-r--r-- | Documentation/filesystems/jfs.txt | 19 | ||||
-rw-r--r-- | Documentation/filesystems/nfs/nfs.txt | 44 | ||||
-rw-r--r-- | Documentation/filesystems/nfs/nfsd-admin-interfaces.txt | 41 | ||||
-rw-r--r-- | Documentation/filesystems/nfs/nfsroot.txt | 10 | ||||
-rw-r--r-- | Documentation/filesystems/proc.txt | 22 |
7 files changed, 122 insertions, 28 deletions
diff --git a/Documentation/filesystems/debugfs.txt b/Documentation/filesystems/debugfs.txt index 7a34f827989c..3a863f692728 100644 --- a/Documentation/filesystems/debugfs.txt +++ b/Documentation/filesystems/debugfs.txt | |||
@@ -15,8 +15,8 @@ Debugfs is typically mounted with a command like: | |||
15 | mount -t debugfs none /sys/kernel/debug | 15 | mount -t debugfs none /sys/kernel/debug |
16 | 16 | ||
17 | (Or an equivalent /etc/fstab line). | 17 | (Or an equivalent /etc/fstab line). |
18 | The debugfs root directory is accessible by anyone by default. To | 18 | The debugfs root directory is accessible only to the root user by |
19 | restrict access to the tree the "uid", "gid" and "mode" mount | 19 | default. To change access to the tree the "uid", "gid" and "mode" mount |
20 | options can be used. | 20 | options can be used. |
21 | 21 | ||
22 | Note that the debugfs API is exported GPL-only to modules. | 22 | Note that the debugfs API is exported GPL-only to modules. |
diff --git a/Documentation/filesystems/ext4.txt b/Documentation/filesystems/ext4.txt index 1b7f9acbcbbe..104322bf378c 100644 --- a/Documentation/filesystems/ext4.txt +++ b/Documentation/filesystems/ext4.txt | |||
@@ -375,6 +375,16 @@ dioread_nolock locking. If the dioread_nolock option is specified | |||
375 | Because of the restrictions this options comprises | 375 | Because of the restrictions this options comprises |
376 | it is off by default (e.g. dioread_lock). | 376 | it is off by default (e.g. dioread_lock). |
377 | 377 | ||
378 | max_dir_size_kb=n This limits the size of directories so that any | ||
379 | attempt to expand them beyond the specified | ||
380 | limit in kilobytes will cause an ENOSPC error. | ||
381 | This is useful in memory constrained | ||
382 | environments, where a very large directory can | ||
383 | cause severe performance problems or even | ||
384 | provoke the Out Of Memory killer. (For example, | ||
385 | if there is only 512mb memory available, a 176mb | ||
386 | directory may seriously cramp the system's style.) | ||
387 | |||
378 | i_version Enable 64-bit inode version support. This option is | 388 | i_version Enable 64-bit inode version support. This option is |
379 | off by default. | 389 | off by default. |
380 | 390 | ||
diff --git a/Documentation/filesystems/jfs.txt b/Documentation/filesystems/jfs.txt index 26ebde77e821..f7433355394a 100644 --- a/Documentation/filesystems/jfs.txt +++ b/Documentation/filesystems/jfs.txt | |||
@@ -3,6 +3,7 @@ IBM's Journaled File System (JFS) for Linux | |||
3 | JFS Homepage: http://jfs.sourceforge.net/ | 3 | JFS Homepage: http://jfs.sourceforge.net/ |
4 | 4 | ||
5 | The following mount options are supported: | 5 | The following mount options are supported: |
6 | (*) == default | ||
6 | 7 | ||
7 | iocharset=name Character set to use for converting from Unicode to | 8 | iocharset=name Character set to use for converting from Unicode to |
8 | ASCII. The default is to do no conversion. Use | 9 | ASCII. The default is to do no conversion. Use |
@@ -21,12 +22,12 @@ nointegrity Do not write to the journal. The primary use of this option | |||
21 | from backup media. The integrity of the volume is not | 22 | from backup media. The integrity of the volume is not |
22 | guaranteed if the system abnormally abends. | 23 | guaranteed if the system abnormally abends. |
23 | 24 | ||
24 | integrity Default. Commit metadata changes to the journal. Use this | 25 | integrity(*) Commit metadata changes to the journal. Use this option to |
25 | option to remount a volume where the nointegrity option was | 26 | remount a volume where the nointegrity option was |
26 | previously specified in order to restore normal behavior. | 27 | previously specified in order to restore normal behavior. |
27 | 28 | ||
28 | errors=continue Keep going on a filesystem error. | 29 | errors=continue Keep going on a filesystem error. |
29 | errors=remount-ro Default. Remount the filesystem read-only on an error. | 30 | errors=remount-ro(*) Remount the filesystem read-only on an error. |
30 | errors=panic Panic and halt the machine if an error occurs. | 31 | errors=panic Panic and halt the machine if an error occurs. |
31 | 32 | ||
32 | uid=value Override on-disk uid with specified value | 33 | uid=value Override on-disk uid with specified value |
@@ -35,7 +36,17 @@ umask=value Override on-disk umask with specified octal value. For | |||
35 | directories, the execute bit will be set if the corresponding | 36 | directories, the execute bit will be set if the corresponding |
36 | read bit is set. | 37 | read bit is set. |
37 | 38 | ||
38 | Please send bugs, comments, cards and letters to shaggy@linux.vnet.ibm.com. | 39 | discard=minlen This enables/disables the use of discard/TRIM commands. |
40 | discard The discard/TRIM commands are sent to the underlying | ||
41 | nodiscard(*) block device when blocks are freed. This is useful for SSD | ||
42 | devices and sparse/thinly-provisioned LUNs. The FITRIM ioctl | ||
43 | command is also available together with the nodiscard option. | ||
44 | The value of minlen specifies the minimum blockcount, when | ||
45 | a TRIM command to the block device is considered usefull. | ||
46 | When no value is given to the discard option, it defaults to | ||
47 | 64 blocks, which means 256KiB in JFS. | ||
48 | The minlen value of discard overrides the minlen value given | ||
49 | on an FITRIM ioctl(). | ||
39 | 50 | ||
40 | The JFS mailing list can be subscribed to by using the link labeled | 51 | The JFS mailing list can be subscribed to by using the link labeled |
41 | "Mail list Subscribe" at our web page http://jfs.sourceforge.net/ | 52 | "Mail list Subscribe" at our web page http://jfs.sourceforge.net/ |
diff --git a/Documentation/filesystems/nfs/nfs.txt b/Documentation/filesystems/nfs/nfs.txt index f50f26ce6cd0..f2571c8bef74 100644 --- a/Documentation/filesystems/nfs/nfs.txt +++ b/Documentation/filesystems/nfs/nfs.txt | |||
@@ -12,9 +12,47 @@ and work is in progress on adding support for minor version 1 of the NFSv4 | |||
12 | protocol. | 12 | protocol. |
13 | 13 | ||
14 | The purpose of this document is to provide information on some of the | 14 | The purpose of this document is to provide information on some of the |
15 | upcall interfaces that are used in order to provide the NFS client with | 15 | special features of the NFS client that can be configured by system |
16 | some of the information that it requires in order to fully comply with | 16 | administrators. |
17 | the NFS spec. | 17 | |
18 | |||
19 | The nfs4_unique_id parameter | ||
20 | ============================ | ||
21 | |||
22 | NFSv4 requires clients to identify themselves to servers with a unique | ||
23 | string. File open and lock state shared between one client and one server | ||
24 | is associated with this identity. To support robust NFSv4 state recovery | ||
25 | and transparent state migration, this identity string must not change | ||
26 | across client reboots. | ||
27 | |||
28 | Without any other intervention, the Linux client uses a string that contains | ||
29 | the local system's node name. System administrators, however, often do not | ||
30 | take care to ensure that node names are fully qualified and do not change | ||
31 | over the lifetime of a client system. Node names can have other | ||
32 | administrative requirements that require particular behavior that does not | ||
33 | work well as part of an nfs_client_id4 string. | ||
34 | |||
35 | The nfs.nfs4_unique_id boot parameter specifies a unique string that can be | ||
36 | used instead of a system's node name when an NFS client identifies itself to | ||
37 | a server. Thus, if the system's node name is not unique, or it changes, its | ||
38 | nfs.nfs4_unique_id stays the same, preventing collision with other clients | ||
39 | or loss of state during NFS reboot recovery or transparent state migration. | ||
40 | |||
41 | The nfs.nfs4_unique_id string is typically a UUID, though it can contain | ||
42 | anything that is believed to be unique across all NFS clients. An | ||
43 | nfs4_unique_id string should be chosen when a client system is installed, | ||
44 | just as a system's root file system gets a fresh UUID in its label at | ||
45 | install time. | ||
46 | |||
47 | The string should remain fixed for the lifetime of the client. It can be | ||
48 | changed safely if care is taken that the client shuts down cleanly and all | ||
49 | outstanding NFSv4 state has expired, to prevent loss of NFSv4 state. | ||
50 | |||
51 | This string can be stored in an NFS client's grub.conf, or it can be provided | ||
52 | via a net boot facility such as PXE. It may also be specified as an nfs.ko | ||
53 | module parameter. Specifying a uniquifier string is not support for NFS | ||
54 | clients running in containers. | ||
55 | |||
18 | 56 | ||
19 | The DNS resolver | 57 | The DNS resolver |
20 | ================ | 58 | ================ |
diff --git a/Documentation/filesystems/nfs/nfsd-admin-interfaces.txt b/Documentation/filesystems/nfs/nfsd-admin-interfaces.txt new file mode 100644 index 000000000000..56a96fb08a73 --- /dev/null +++ b/Documentation/filesystems/nfs/nfsd-admin-interfaces.txt | |||
@@ -0,0 +1,41 @@ | |||
1 | Administrative interfaces for nfsd | ||
2 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
3 | |||
4 | Note that normally these interfaces are used only by the utilities in | ||
5 | nfs-utils. | ||
6 | |||
7 | nfsd is controlled mainly by pseudofiles under the "nfsd" filesystem, | ||
8 | which is normally mounted at /proc/fs/nfsd/. | ||
9 | |||
10 | The server is always started by the first write of a nonzero value to | ||
11 | nfsd/threads. | ||
12 | |||
13 | Before doing that, NFSD can be told which sockets to listen on by | ||
14 | writing to nfsd/portlist; that write may be: | ||
15 | |||
16 | - an ascii-encoded file descriptor, which should refer to a | ||
17 | bound (and listening, for tcp) socket, or | ||
18 | - "transportname port", where transportname is currently either | ||
19 | "udp", "tcp", or "rdma". | ||
20 | |||
21 | If nfsd is started without doing any of these, then it will create one | ||
22 | udp and one tcp listener at port 2049 (see nfsd_init_socks). | ||
23 | |||
24 | On startup, nfsd and lockd grace periods start. | ||
25 | |||
26 | nfsd is shut down by a write of 0 to nfsd/threads. All locks and state | ||
27 | are thrown away at that point. | ||
28 | |||
29 | Between startup and shutdown, the number of threads may be adjusted up | ||
30 | or down by additional writes to nfsd/threads or by writes to | ||
31 | nfsd/pool_threads. | ||
32 | |||
33 | For more detail about files under nfsd/ and what they control, see | ||
34 | fs/nfsd/nfsctl.c; most of them have detailed comments. | ||
35 | |||
36 | Implementation notes | ||
37 | ^^^^^^^^^^^^^^^^^^^^ | ||
38 | |||
39 | Note that the rpc server requires the caller to serialize addition and | ||
40 | removal of listening sockets, and startup and shutdown of the server. | ||
41 | For nfsd this is done using nfsd_mutex. | ||
diff --git a/Documentation/filesystems/nfs/nfsroot.txt b/Documentation/filesystems/nfs/nfsroot.txt index ffdd9d866ad7..2d66ed688125 100644 --- a/Documentation/filesystems/nfs/nfsroot.txt +++ b/Documentation/filesystems/nfs/nfsroot.txt | |||
@@ -78,7 +78,8 @@ nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>] | |||
78 | flags = hard, nointr, noposix, cto, ac | 78 | flags = hard, nointr, noposix, cto, ac |
79 | 79 | ||
80 | 80 | ||
81 | ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf> | 81 | ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf>: |
82 | <dns0-ip>:<dns1-ip> | ||
82 | 83 | ||
83 | This parameter tells the kernel how to configure IP addresses of devices | 84 | This parameter tells the kernel how to configure IP addresses of devices |
84 | and also how to set up the IP routing table. It was originally called | 85 | and also how to set up the IP routing table. It was originally called |
@@ -158,6 +159,13 @@ ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf> | |||
158 | 159 | ||
159 | Default: any | 160 | Default: any |
160 | 161 | ||
162 | <dns0-ip> IP address of first nameserver. | ||
163 | Value gets exported by /proc/net/pnp which is often linked | ||
164 | on embedded systems by /etc/resolv.conf. | ||
165 | |||
166 | <dns1-ip> IP address of secound nameserver. | ||
167 | Same as above. | ||
168 | |||
161 | 169 | ||
162 | nfsrootdebug | 170 | nfsrootdebug |
163 | 171 | ||
diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt index fb0a6aeb936c..a1793d670cd0 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_adj & /proc/<pid>/oom_score_adj - Adjust the oom-killer | 36 | 3.1 /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 |
@@ -1320,10 +1320,10 @@ of the kernel. | |||
1320 | CHAPTER 3: PER-PROCESS PARAMETERS | 1320 | CHAPTER 3: PER-PROCESS PARAMETERS |
1321 | ------------------------------------------------------------------------------ | 1321 | ------------------------------------------------------------------------------ |
1322 | 1322 | ||
1323 | 3.1 /proc/<pid>/oom_adj & /proc/<pid>/oom_score_adj- Adjust the oom-killer score | 1323 | 3.1 /proc/<pid>/oom_score_adj- Adjust the oom-killer score |
1324 | -------------------------------------------------------------------------------- | 1324 | -------------------------------------------------------------------------------- |
1325 | 1325 | ||
1326 | These file can be used to adjust the badness heuristic used to select which | 1326 | This file can be used to adjust the badness heuristic used to select which |
1327 | process gets killed in out of memory conditions. | 1327 | process gets killed in out of memory conditions. |
1328 | 1328 | ||
1329 | The badness heuristic assigns a value to each candidate task ranging from 0 | 1329 | The badness heuristic assigns a value to each candidate task ranging from 0 |
@@ -1361,22 +1361,10 @@ 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 | 1361 | equivalent to discounting 50% of the task's allowed memory from being considered |
1362 | as scoring against the task. | 1362 | as scoring against the task. |
1363 | 1363 | ||
1364 | For backwards compatibility with previous kernels, /proc/<pid>/oom_adj may also | ||
1365 | be used to tune the badness score. Its acceptable values range from -16 | ||
1366 | (OOM_ADJUST_MIN) to +15 (OOM_ADJUST_MAX) and a special value of -17 | ||
1367 | (OOM_DISABLE) to disable oom killing entirely for that task. Its value is | ||
1368 | scaled linearly with /proc/<pid>/oom_score_adj. | ||
1369 | |||
1370 | Writing to /proc/<pid>/oom_score_adj or /proc/<pid>/oom_adj will change the | ||
1371 | other with its scaled value. | ||
1372 | |||
1373 | The value of /proc/<pid>/oom_score_adj may be reduced no lower than the last | 1364 | The value of /proc/<pid>/oom_score_adj may be reduced no lower than the last |
1374 | value set by a CAP_SYS_RESOURCE process. To reduce the value any lower | 1365 | value set by a CAP_SYS_RESOURCE process. To reduce the value any lower |
1375 | requires CAP_SYS_RESOURCE. | 1366 | requires CAP_SYS_RESOURCE. |
1376 | 1367 | ||
1377 | NOTICE: /proc/<pid>/oom_adj is deprecated and will be removed, please see | ||
1378 | Documentation/feature-removal-schedule.txt. | ||
1379 | |||
1380 | Caveat: when a parent task is selected, the oom killer will sacrifice any first | 1368 | Caveat: when a parent task is selected, the oom killer will sacrifice any first |
1381 | generation children with separate address spaces instead, if possible. This | 1369 | generation children with separate address spaces instead, if possible. This |
1382 | avoids servers and important system daemons from being killed and loses the | 1370 | avoids servers and important system daemons from being killed and loses the |
@@ -1387,9 +1375,7 @@ minimal amount of work. | |||
1387 | ------------------------------------------------------------- | 1375 | ------------------------------------------------------------- |
1388 | 1376 | ||
1389 | This file can be used to check the current score used by the oom-killer is for | 1377 | This file can be used to check the current score used by the oom-killer is for |
1390 | any given <pid>. Use it together with /proc/<pid>/oom_adj to tune which | 1378 | any given <pid>. |
1391 | process should be killed in an out-of-memory situation. | ||
1392 | |||
1393 | 1379 | ||
1394 | 3.3 /proc/<pid>/io - Display the IO accounting fields | 1380 | 3.3 /proc/<pid>/io - Display the IO accounting fields |
1395 | ------------------------------------------------------- | 1381 | ------------------------------------------------------- |