Blame view

Documentation/filesystems/ocfs2.txt 4.3 KB
ccd979bdb   Mark Fasheh   [PATCH] OCFS2: Th...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
  OCFS2 filesystem
  ==================
  OCFS2 is a general purpose extent based shared disk cluster file
  system with many similarities to ext3. It supports 64 bit inode
  numbers, and has automatically extending metadata groups which may
  also make it attractive for non-clustered use.
  
  You'll want to install the ocfs2-tools package in order to at least
  get "mount.ocfs2" and "ocfs2_hb_ctl".
  
  Project web page:    http://oss.oracle.com/projects/ocfs2
  Tools web page:      http://oss.oracle.com/projects/ocfs2-tools
  OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/
  
  All code copyright 2005 Oracle except when otherwise noted.
  
  CREDITS:
  Lots of code taken from ext3 and other projects.
  
  Authors in alphabetical order:
  Joel Becker   <joel.becker@oracle.com>
  Zach Brown    <zach.brown@oracle.com>
7ab8f5244   Sunil Mushran   ocfs2: Refresh do...
23
  Mark Fasheh   <mfasheh@suse.com>
ccd979bdb   Mark Fasheh   [PATCH] OCFS2: Th...
24
  Kurt Hackel   <kurt.hackel@oracle.com>
7ab8f5244   Sunil Mushran   ocfs2: Refresh do...
25
  Tao Ma        <tao.ma@oracle.com>
ccd979bdb   Mark Fasheh   [PATCH] OCFS2: Th...
26
27
  Sunil Mushran <sunil.mushran@oracle.com>
  Manish Singh  <manish.singh@oracle.com>
7ab8f5244   Sunil Mushran   ocfs2: Refresh do...
28
  Tiger Yang    <tiger.yang@oracle.com>
ccd979bdb   Mark Fasheh   [PATCH] OCFS2: Th...
29
30
31
32
  
  Caveats
  =======
  Features which OCFS2 does not support yet:
ccd979bdb   Mark Fasheh   [PATCH] OCFS2: Th...
33
34
  	- Directory change notification (F_NOTIFY)
  	- Distributed Caching (F_SETLEASE/F_GETLEASE/break_lease)
ccd979bdb   Mark Fasheh   [PATCH] OCFS2: Th...
35
36
37
38
39
40
41
42
43
44
45
46
47
48
  
  Mount options
  =============
  
  OCFS2 supports the following mount options:
  (*) == default
  
  barrier=1		This enables/disables barriers. barrier=0 disables it,
  			barrier=1 enables it.
  errors=remount-ro(*)	Remount the filesystem read-only on an error.
  errors=panic		Panic and halt the machine if an error occurs.
  intr		(*)	Allow signals to interrupt cluster operations.
  nointr			Do not allow signals to interrupt cluster
  			operations.
e2b0c215c   Tiger Yang   ocfs2: clean up m...
49
50
51
52
53
  noatime			Do not update access time.
  relatime(*)		Update atime if the previous atime is older than
  			mtime or ctime
  strictatime		Always update atime, but the minimum update interval
  			is specified by atime_quantum.
bcd5625bf   Tiger Yang   ocfs2: update mou...
54
55
  atime_quantum=60(*)	OCFS2 will not update atime unless this number
  			of seconds has passed since the last update.
e2b0c215c   Tiger Yang   ocfs2: clean up m...
56
57
  			Set to zero to always update atime. This option need
  			work with strictatime.
10b0845be   Mark Fasheh   ocfs2: update doc...
58
59
60
61
62
63
64
65
66
  data=ordered	(*)	All data are forced directly out to the main file
  			system prior to its metadata being committed to the
  			journal.
  data=writeback		Data ordering is not preserved, data may be written
  			into the main file system after its metadata has been
  			committed to the journal.
  preferred_slot=0(*)	During mount, try to use this filesystem slot first. If
  			it is in use by another node, the first empty one found
  			will be chosen. Invalid values will be ignored.
d147b3d63   Mark Fasheh   ocfs2: Support co...
67
68
69
70
71
72
73
74
75
76
77
  commit=nrsec	(*)	Ocfs2 can be told to sync all its data and metadata
  			every 'nrsec' seconds. The default value is 5 seconds.
  			This means that if you lose your power, you will lose
  			as much as the latest 5 seconds of work (your
  			filesystem will not be damaged though, thanks to the
  			journaling).  This default value (or any low value)
  			will hurt performance, but it's good for data-safety.
  			Setting it to 0 will have the same effect as leaving
  			it at the default (5 seconds).
  			Setting it to very large values will improve
  			performance.
2fbe8d1eb   Sunil Mushran   ocfs2: Local allo...
78
79
  localalloc=8(*)		Allows custom localalloc size in MB. If the value is too
  			large, the fs will silently revert it to the default.
53fc622b9   Mark Fasheh   [PATCH 2/2] ocfs2...
80
  localflocks		This disables cluster aware flock.
12462f1d9   Joel Becker   ocfs2: Add the 'i...
81
82
83
84
  inode64			Indicates that Ocfs2 is allowed to create inodes at
  			any location in the filesystem, including those which
  			will result in inode numbers occupying more than 32
  			bits of significance.
696b55d76   Mark Fasheh   ocfs2: Documentat...
85
86
  user_xattr	(*)	Enables Extended User Attributes.
  nouser_xattr		Disables Extended User Attributes.
a68979b85   Tiger Yang   ocfs2: add mount ...
87
88
  acl			Enables POSIX Access Control Lists support.
  noacl		(*)	Disables POSIX Access Control Lists support.
25985edce   Lucas De Marchi   Fix common misspe...
89
  resv_level=2	(*)	Set how aggressive allocation reservations will be.
d02f00cc0   Mark Fasheh   ocfs2: allocation...
90
91
  			Valid values are between 0 (reservations off) to 8
  			(maximum space for reservations).
83f92318f   Mark Fasheh   ocfs2: Add dir_re...
92
93
94
95
  dir_resv_level=	(*)	By default, directory reservations will scale with file
  			reservations - users should rarely need to change this
  			value. If allocation reservations are turned off, this
  			option will have no effect.
7bdb0d18b   Tristan Ye   ocfs2: Add a moun...
96
97
98
99
100
101
102
  coherency=full  (*)	Disallow concurrent O_DIRECT writes, cluster inode
  			lock will be taken to force other nodes drop cache,
  			therefore full cluster coherency is guaranteed even
  			for O_DIRECT writes.
  coherency=buffered	Allow concurrent O_DIRECT writes without EX lock among
  			nodes, which gains high performance at risk of getting
  			stale data on other nodes.