Merge branch 'linus' into perf/core
[sfrench/cifs-2.6.git] / Documentation / filesystems / jfs.txt
1 IBM's Journaled File System (JFS) for Linux
2
3 JFS Homepage:  http://jfs.sourceforge.net/
4
5 The following mount options are supported:
6 (*) == default
7
8 iocharset=name  Character set to use for converting from Unicode to
9                 ASCII.  The default is to do no conversion.  Use
10                 iocharset=utf8 for UTF-8 translations.  This requires
11                 CONFIG_NLS_UTF8 to be set in the kernel .config file.
12                 iocharset=none specifies the default behavior explicitly.
13
14 resize=value    Resize the volume to <value> blocks.  JFS only supports
15                 growing a volume, not shrinking it.  This option is only
16                 valid during a remount, when the volume is mounted
17                 read-write.  The resize keyword with no value will grow
18                 the volume to the full size of the partition.
19
20 nointegrity     Do not write to the journal.  The primary use of this option
21                 is to allow for higher performance when restoring a volume
22                 from backup media.  The integrity of the volume is not
23                 guaranteed if the system abnormally abends.
24
25 integrity(*)    Commit metadata changes to the journal.  Use this option to
26                 remount a volume where the nointegrity option was
27                 previously specified in order to restore normal behavior.
28
29 errors=continue         Keep going on a filesystem error.
30 errors=remount-ro(*)    Remount the filesystem read-only on an error.
31 errors=panic            Panic and halt the machine if an error occurs.
32
33 uid=value       Override on-disk uid with specified value
34 gid=value       Override on-disk gid with specified value
35 umask=value     Override on-disk umask with specified octal value.  For
36                 directories, the execute bit will be set if the corresponding
37                 read bit is set.
38
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 useful.
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().
50
51 The JFS mailing list can be subscribed to by using the link labeled
52 "Mail list Subscribe" at our web page http://jfs.sourceforge.net/