[PATCH 1/1] nilfs2: add detailed comment about description of DAT meta-data file's blocks in on-disk segment summary

[PATCH 1/1] nilfs2: add detailed comment about description of DAT meta-data file's blocks in on-disk segment summary

[Vyacheslav Dubeyko]

Hi,

I suggest to add comment with more details about description of data and
b-tree intermediate blocks of the DAT meta-data file in on-disk segment
summary. I think that absence of such comment can lead to
misunderstanding of segment summary's on-disk layout.

With the best regards,
Vyacheslav Dubeyko.
--
From: Vyacheslav Dubeyko <slava-yeENwD64cLxBDgjK7y7TUQ@public.gmane.org>
Subject: [PATCH 1/1] nilfs2: add detailed comment about description of
DAT meta-data file's blocks in on-disk segment summary

This patch adds comment with more details about description of data and
b-tree intermediate blocks of the DAT meta-data file in on-disk segment
summary.

Signed-off-by: Vyacheslav Dubeyko <slava-yeENwD64cLxBDgjK7y7TUQ@public.gmane.org>
---
 include/linux/nilfs2_fs.h |   13 ++++++++++++-
 1 files changed, 12 insertions(+), 1 deletions(-)

diff --git a/include/linux/nilfs2_fs.h b/include/linux/nilfs2_fs.h
index 655213e..630f550 100644
--- a/include/linux/nilfs2_fs.h
+++ b/include/linux/nilfs2_fs.h
@@ -372,7 +372,18 @@ struct nilfs_binfo_v {
 };
 
 /**
- * struct nilfs_binfo_dat - information for the block which belongs to
the DAT file
+ * Description of DAT meta-data file's blocks is a special case of
segment summary.
+ * The description can contain as data blocks as b-tree intermediate
blocks.
+ * The whole number of blocks (including intermediate blocks) is
described
+ * by fi_nblocks field of nilfs_finfo structure. The fi_ndatablk field
keeps
+ * count of data blocks. Firstly, it is described data blocks by means
of
+ * 64-bit block offset number (__le64) which is allocated per block.
+ * Finally, b-tree intermediate blocks are described by nilfs_binfo_dat
+ * structure which is allocated per block.
+ */
+
+/**
+ * struct nilfs_binfo_dat - information for b-tree intermediate block
of the DAT meta-data file
  * @bi_blkoff: block offset
  * @bi_level: level
  * @bi_pad: padding
--


--
To unsubscribe from this list: send the line "unsubscribe linux-nilfs" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html