Skip to contentSkip to conversation

Add a comment about reading the super block [69/70]

GFS2 Steven Whitehouse 1 participant 1 message Nov 30, 2006 GFS2 file system

lore
Share & tools
lore
#0 lore raw

From aac1a3c77a46c2d06f297641760dd740ac2a84af Mon Sep 17 00:00:00 2001
From: Steven Whitehouse <[email protected]>
Date: Thu, 30 Nov 2006 10:02:19 -0500
Subject: [PATCH] [GFS2] Add a comment about reading the super block

The comment explains why we use the bio functions to read the super block.

Cc Andrew Morton <[email protected]>
Cc Srinivasa Ds <[email protected]>
---
 fs/gfs2/super.c |   18 ++++++++++++++++++
 1 files changed, 18 insertions(+), 0 deletions(-)
fs/gfs2/super.c +18 -0
index 3b22727..43a24f2 100644
@@ -180,6 +180,24 @@ static int end_bio_io_page(struct bio *b
 	return 0;
 }
 
+/**
+ * gfs2_read_super - Read the gfs2 super block from disk
+ * @sb: The VFS super block
+ * @sector: The location of the super block
+ *
+ * This uses the bio functions to read the super block from disk
+ * because we want to be 100% sure that we never read cached data.
+ * A super block is read twice only during each GFS2 mount and is
+ * never written to by the filesystem. The first time its read no
+ * locks are held, and the only details which are looked at are those
+ * relating to the locking protocol. Once locking is up and working,
+ * the sb is read again under the lock to establish the location of
+ * the master directory (contains pointers to journals etc) and the
+ * root directory.
+ *
+ * Returns: A page containing the sb or NULL
+ */
+
 struct page *gfs2_read_super(struct super_block *sb, sector_t sector)
 {
 	struct page *page;
Signature · 1 line
1.4.1