xref: /OK3568_Linux_fs/kernel/Documentation/ABI/testing/sysfs-ocfs2 (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunWhat:		/sys/fs/ocfs2/
2*4882a593SmuzhiyunDate:		April 2008
3*4882a593SmuzhiyunContact:	ocfs2-devel@oss.oracle.com
4*4882a593SmuzhiyunDescription:
5*4882a593Smuzhiyun		The /sys/fs/ocfs2 directory contains knobs used by the
6*4882a593Smuzhiyun		ocfs2-tools to interact with the filesystem.
7*4882a593Smuzhiyun
8*4882a593SmuzhiyunWhat:		/sys/fs/ocfs2/max_locking_protocol
9*4882a593SmuzhiyunDate:		April 2008
10*4882a593SmuzhiyunContact:	ocfs2-devel@oss.oracle.com
11*4882a593SmuzhiyunDescription:
12*4882a593Smuzhiyun		The /sys/fs/ocfs2/max_locking_protocol file displays version
13*4882a593Smuzhiyun		of ocfs2 locking supported by the filesystem.  This version
14*4882a593Smuzhiyun		covers how ocfs2 uses distributed locking between cluster
15*4882a593Smuzhiyun		nodes.
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun		The protocol version has a major and minor number.  Two
18*4882a593Smuzhiyun		cluster nodes can interoperate if they have an identical
19*4882a593Smuzhiyun		major number and an overlapping minor number - thus,
20*4882a593Smuzhiyun		a node with version 1.10 can interoperate with a node
21*4882a593Smuzhiyun		sporting version 1.8, as long as both use the 1.8 protocol.
22*4882a593Smuzhiyun
23*4882a593Smuzhiyun		Reading from this file returns a single line, the major
24*4882a593Smuzhiyun		number and minor number joined by a period, eg "1.10".
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun		This file is read-only.  The value is compiled into the
27*4882a593Smuzhiyun		driver.
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunWhat:		/sys/fs/ocfs2/loaded_cluster_plugins
30*4882a593SmuzhiyunDate:		April 2008
31*4882a593SmuzhiyunContact:	ocfs2-devel@oss.oracle.com
32*4882a593SmuzhiyunDescription:
33*4882a593Smuzhiyun		The /sys/fs/ocfs2/loaded_cluster_plugins file describes
34*4882a593Smuzhiyun		the available plugins to support ocfs2 cluster operation.
35*4882a593Smuzhiyun		A cluster plugin is required to use ocfs2 in a cluster.
36*4882a593Smuzhiyun		There are currently two available plugins:
37*4882a593Smuzhiyun
38*4882a593Smuzhiyun		* 'o2cb' - The classic o2cb cluster stack that ocfs2 has
39*4882a593Smuzhiyun			used since its inception.
40*4882a593Smuzhiyun		* 'user' - A plugin supporting userspace cluster software
41*4882a593Smuzhiyun			in conjunction with fs/dlm.
42*4882a593Smuzhiyun
43*4882a593Smuzhiyun		Reading from this file returns the names of all loaded
44*4882a593Smuzhiyun		plugins, one per line.
45*4882a593Smuzhiyun
46*4882a593Smuzhiyun		This file is read-only.  Its contents may change as
47*4882a593Smuzhiyun		plugins are loaded or removed.
48*4882a593Smuzhiyun
49*4882a593SmuzhiyunWhat:		/sys/fs/ocfs2/active_cluster_plugin
50*4882a593SmuzhiyunDate:		April 2008
51*4882a593SmuzhiyunContact:	ocfs2-devel@oss.oracle.com
52*4882a593SmuzhiyunDescription:
53*4882a593Smuzhiyun		The /sys/fs/ocfs2/active_cluster_plugin displays which
54*4882a593Smuzhiyun		cluster plugin is currently in use by the filesystem.
55*4882a593Smuzhiyun		The active plugin will appear in the loaded_cluster_plugins
56*4882a593Smuzhiyun		file as well.  Only one plugin can be used at a time.
57*4882a593Smuzhiyun
58*4882a593Smuzhiyun		Reading from this file returns the name of the active plugin
59*4882a593Smuzhiyun		on a single line.
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun		This file is read-only.  Which plugin is active depends on
62*4882a593Smuzhiyun		the cluster stack in use.  The contents may change
63*4882a593Smuzhiyun		when all filesystems are unmounted and the cluster stack
64*4882a593Smuzhiyun		is changed.
65*4882a593Smuzhiyun
66*4882a593SmuzhiyunWhat:		/sys/fs/ocfs2/cluster_stack
67*4882a593SmuzhiyunDate:		April 2008
68*4882a593SmuzhiyunContact:	ocfs2-devel@oss.oracle.com
69*4882a593SmuzhiyunDescription:
70*4882a593Smuzhiyun		The /sys/fs/ocfs2/cluster_stack file contains the name
71*4882a593Smuzhiyun		of current ocfs2 cluster stack.  This value is set by
72*4882a593Smuzhiyun		userspace tools when bringing the cluster stack online.
73*4882a593Smuzhiyun
74*4882a593Smuzhiyun		Cluster stack names are 4 characters in length.
75*4882a593Smuzhiyun
76*4882a593Smuzhiyun		When the 'o2cb' cluster stack is used, the 'o2cb' cluster
77*4882a593Smuzhiyun		plugin is active.  All other cluster stacks use the 'user'
78*4882a593Smuzhiyun		cluster plugin.
79*4882a593Smuzhiyun
80*4882a593Smuzhiyun		Reading from this file returns the name of the current
81*4882a593Smuzhiyun		cluster stack on a single line.
82*4882a593Smuzhiyun
83*4882a593Smuzhiyun		Writing a new stack name to this file changes the current
84*4882a593Smuzhiyun		cluster stack unless there are mounted ocfs2 filesystems.
85*4882a593Smuzhiyun		If there are mounted filesystems, attempts to change the
86*4882a593Smuzhiyun		stack return an error.
87*4882a593Smuzhiyun
88*4882a593SmuzhiyunUsers:
89*4882a593Smuzhiyun	ocfs2-tools <ocfs2-tools-devel@oss.oracle.com>
90