]> www.pilppa.org Git - linux-2.6-omap-h63xx.git/blob - Documentation/filesystems/ocfs2.txt
ocfs2: update docs for new features
[linux-2.6-omap-h63xx.git] / Documentation / filesystems / ocfs2.txt
1 OCFS2 filesystem
2 ==================
3 OCFS2 is a general purpose extent based shared disk cluster file
4 system with many similarities to ext3. It supports 64 bit inode
5 numbers, and has automatically extending metadata groups which may
6 also make it attractive for non-clustered use.
7
8 You'll want to install the ocfs2-tools package in order to at least
9 get "mount.ocfs2" and "ocfs2_hb_ctl".
10
11 Project web page:    http://oss.oracle.com/projects/ocfs2
12 Tools web page:      http://oss.oracle.com/projects/ocfs2-tools
13 OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/
14
15 All code copyright 2005 Oracle except when otherwise noted.
16
17 CREDITS:
18 Lots of code taken from ext3 and other projects.
19
20 Authors in alphabetical order:
21 Joel Becker   <joel.becker@oracle.com>
22 Zach Brown    <zach.brown@oracle.com>
23 Mark Fasheh   <mark.fasheh@oracle.com>
24 Kurt Hackel   <kurt.hackel@oracle.com>
25 Sunil Mushran <sunil.mushran@oracle.com>
26 Manish Singh  <manish.singh@oracle.com>
27
28 Caveats
29 =======
30 Features which OCFS2 does not support yet:
31         - extended attributes
32         - quotas
33         - cluster aware flock
34         - cluster aware lockf
35         - Directory change notification (F_NOTIFY)
36         - Distributed Caching (F_SETLEASE/F_GETLEASE/break_lease)
37         - POSIX ACLs
38         - readpages / writepages (not user visible)
39
40 Mount options
41 =============
42
43 OCFS2 supports the following mount options:
44 (*) == default
45
46 barrier=1               This enables/disables barriers. barrier=0 disables it,
47                         barrier=1 enables it.
48 errors=remount-ro(*)    Remount the filesystem read-only on an error.
49 errors=panic            Panic and halt the machine if an error occurs.
50 intr            (*)     Allow signals to interrupt cluster operations.
51 nointr                  Do not allow signals to interrupt cluster
52                         operations.
53 atime_quantum=60(*)     OCFS2 will not update atime unless this number
54                         of seconds has passed since the last update.
55                         Set to zero to always update atime.
56 data=ordered    (*)     All data are forced directly out to the main file
57                         system prior to its metadata being committed to the
58                         journal.
59 data=writeback          Data ordering is not preserved, data may be written
60                         into the main file system after its metadata has been
61                         committed to the journal.
62 preferred_slot=0(*)     During mount, try to use this filesystem slot first. If
63                         it is in use by another node, the first empty one found
64                         will be chosen. Invalid values will be ignored.