* PATCH 1/1] nilfs-utils: add omitted comments for structures in nilfs2_fs.h
@ 2012-07-19 10:17 Vyacheslav Dubeyko
2012-07-19 12:03 ` Ryusuke Konishi
0 siblings, 1 reply; 2+ messages in thread
From: Vyacheslav Dubeyko @ 2012-07-19 10:17 UTC (permalink / raw)
To: linux-nilfs-u79uwXL29TY76Z2rM5mHXA
Hi,
This patch adds omitted comments for structures in nilfs2_fs.h for the
NILFS utilities case. I think that these corrections also important.
With the best regards,
Vyacheslav Dubeyko.
--
From: Vyacheslav Dubeyko <slava-yeENwD64cLxBDgjK7y7TUQ@public.gmane.org>
Subject: [PATCH 1/1] nilfs-utils: add omitted comments for structures in
nilfs2_fs.h
This patch adds omitted comments for structures in nilfs2_fs.h.
Signed-off-by: Vyacheslav Dubeyko <slava-yeENwD64cLxBDgjK7y7TUQ@public.gmane.org>
---
include/nilfs2_fs.h | 63
+++++++++++++++++++++++++++++++-------------------
1 files changed, 39 insertions(+), 24 deletions(-)
diff --git a/include/nilfs2_fs.h b/include/nilfs2_fs.h
index a722268..20b1ab9 100644
--- a/include/nilfs2_fs.h
+++ b/include/nilfs2_fs.h
@@ -297,7 +297,7 @@ struct nilfs_dir_entry {
__le64 inode; /* Inode number */
__le16 rec_len; /* Directory entry length */
__u8 name_len; /* Name length */
- __u8 file_type;
+ __u8 file_type; /* Dir entry type (file, dir, special) */
char name[NILFS_NAME_LEN]; /* File name */
char pad;
};
@@ -399,7 +399,7 @@ union nilfs_binfo {
};
/**
- * struct nilfs_segment_summary - segment summary
+ * struct nilfs_segment_summary - segment summary header
* @ss_datasum: checksum of data
* @ss_sumsum: checksum of segment summary
* @ss_magic: magic number
@@ -687,9 +687,9 @@ struct nilfs_sufile_header {
/**
* nilfs_suinfo - segment usage information
- * @sui_lastmod:
- * @sui_nblocks:
- * @sui_flags:
+ * @sui_lastmod: timestamp of last modification
+ * @sui_nblocks: number of written blocks in segment
+ * @sui_flags: segment usage flags
*/
struct nilfs_suinfo {
__u64 sui_lastmod;
@@ -720,9 +720,10 @@ enum {
};
/**
- * struct nilfs_cpmode -
- * @cc_cno:
- * @cc_mode:
+ * struct nilfs_cpmode - change checkpoint mode structure
+ * @cm_cno: checkpoint number
+ * @cm_mode: mode of checkpoint
+ * @cm_pad: padding
*/
struct nilfs_cpmode {
__u64 cm_cno;
@@ -732,11 +733,11 @@ struct nilfs_cpmode {
/**
* struct nilfs_argv - argument vector
- * @v_base:
- * @v_nmembs:
- * @v_size:
- * @v_flags:
- * @v_index:
+ * @v_base: pointer on data array from userspace
+ * @v_nmembs: number of members in data array
+ * @v_size: size of data array in bytes
+ * @v_flags: flags
+ * @v_index: start number of target data items
*/
struct nilfs_argv {
__u64 v_base;
@@ -747,9 +748,9 @@ struct nilfs_argv {
};
/**
- * struct nilfs_period -
- * @p_start:
- * @p_end:
+ * struct nilfs_period - period of checkpoint numbers
+ * @p_start: start checkpoint number (inclusive)
+ * @p_end: end checkpoint number (exclusive)
*/
struct nilfs_period {
__u64 p_start;
@@ -757,7 +758,7 @@ struct nilfs_period {
};
/**
- * struct nilfs_cpstat -
+ * struct nilfs_cpstat - checkpoint statistics
* @cs_cno: checkpoint number
* @cs_ncps: number of checkpoints
* @cs_nsss: number of snapshots
@@ -769,7 +770,7 @@ struct nilfs_cpstat {
};
/**
- * struct nilfs_sustat -
+ * struct nilfs_sustat - segment usage statistics
* @ss_nsegs: number of segments
* @ss_ncleansegs: number of clean segments
* @ss_ndirtysegs: number of dirty segments
@@ -788,10 +789,10 @@ struct nilfs_sustat {
/**
* struct nilfs_vinfo - virtual block number information
- * @vi_vblocknr:
- * @vi_start:
- * @vi_end:
- * @vi_blocknr:
+ * @vi_vblocknr: virtual block number
+ * @vi_start: start checkpoint number (inclusive)
+ * @vi_end: end checkpoint number (exclusive)
+ * @vi_blocknr: disk block number
*/
struct nilfs_vinfo {
__u64 vi_vblocknr;
@@ -801,7 +802,15 @@ struct nilfs_vinfo {
};
/**
- * struct nilfs_vdesc -
+ * struct nilfs_vdesc - descriptor of virtual block number
+ * @vd_ino: inode number
+ * @vd_cno: checkpoint number
+ * @vd_vblocknr: virtual block number
+ * @vd_period: period of checkpoint numbers
+ * @vd_blocknr: disk block number
+ * @vd_offset: logical block offset inside a file
+ * @vd_flags: flags (data or node block)
+ * @vd_pad: padding
*/
struct nilfs_vdesc {
__u64 vd_ino;
@@ -815,7 +824,13 @@ struct nilfs_vdesc {
};
/**
- * struct nilfs_bdesc -
+ * struct nilfs_bdesc - descriptor of disk block number
+ * @bd_ino: inode number
+ * @bd_oblocknr: disk block address (for skipping dead blocks)
+ * @bd_blocknr: disk block address
+ * @bd_offset: logical block offset inside a file
+ * @bd_level: level in the b-tree organization
+ * @bd_pad: padding
*/
struct nilfs_bdesc {
__u64 bd_ino;
--
--
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
^ permalink raw reply related [flat|nested] 2+ messages in thread
* Re: PATCH 1/1] nilfs-utils: add omitted comments for structures in nilfs2_fs.h
2012-07-19 10:17 PATCH 1/1] nilfs-utils: add omitted comments for structures in nilfs2_fs.h Vyacheslav Dubeyko
@ 2012-07-19 12:03 ` Ryusuke Konishi
0 siblings, 0 replies; 2+ messages in thread
From: Ryusuke Konishi @ 2012-07-19 12:03 UTC (permalink / raw)
To: Vyacheslav Dubeyko; +Cc: linux-nilfs-u79uwXL29TY76Z2rM5mHXA
On Thu, 19 Jul 2012 14:17:17 +0400, Vyacheslav Dubeyko wrote:
> Hi,
>
> This patch adds omitted comments for structures in nilfs2_fs.h for the
> NILFS utilities case. I think that these corrections also important.
Sure.
As for nilfs2_fs.h, I will apply the same change of yours also to
nilfs-utils later on.
Thanks,
Ryusuke Konishi
> With the best regards,
> Vyacheslav Dubeyko.
> --
> From: Vyacheslav Dubeyko <slava-yeENwD64cLxBDgjK7y7TUQ@public.gmane.org>
> Subject: [PATCH 1/1] nilfs-utils: add omitted comments for structures in
> nilfs2_fs.h
>
> This patch adds omitted comments for structures in nilfs2_fs.h.
>
> Signed-off-by: Vyacheslav Dubeyko <slava-yeENwD64cLxBDgjK7y7TUQ@public.gmane.org>
> ---
> include/nilfs2_fs.h | 63
> +++++++++++++++++++++++++++++++-------------------
> 1 files changed, 39 insertions(+), 24 deletions(-)
>
> diff --git a/include/nilfs2_fs.h b/include/nilfs2_fs.h
> index a722268..20b1ab9 100644
> --- a/include/nilfs2_fs.h
> +++ b/include/nilfs2_fs.h
> @@ -297,7 +297,7 @@ struct nilfs_dir_entry {
> __le64 inode; /* Inode number */
> __le16 rec_len; /* Directory entry length */
> __u8 name_len; /* Name length */
> - __u8 file_type;
> + __u8 file_type; /* Dir entry type (file, dir, special) */
> char name[NILFS_NAME_LEN]; /* File name */
> char pad;
> };
> @@ -399,7 +399,7 @@ union nilfs_binfo {
> };
>
> /**
> - * struct nilfs_segment_summary - segment summary
> + * struct nilfs_segment_summary - segment summary header
> * @ss_datasum: checksum of data
> * @ss_sumsum: checksum of segment summary
> * @ss_magic: magic number
> @@ -687,9 +687,9 @@ struct nilfs_sufile_header {
>
> /**
> * nilfs_suinfo - segment usage information
> - * @sui_lastmod:
> - * @sui_nblocks:
> - * @sui_flags:
> + * @sui_lastmod: timestamp of last modification
> + * @sui_nblocks: number of written blocks in segment
> + * @sui_flags: segment usage flags
> */
> struct nilfs_suinfo {
> __u64 sui_lastmod;
> @@ -720,9 +720,10 @@ enum {
> };
>
> /**
> - * struct nilfs_cpmode -
> - * @cc_cno:
> - * @cc_mode:
> + * struct nilfs_cpmode - change checkpoint mode structure
> + * @cm_cno: checkpoint number
> + * @cm_mode: mode of checkpoint
> + * @cm_pad: padding
> */
> struct nilfs_cpmode {
> __u64 cm_cno;
> @@ -732,11 +733,11 @@ struct nilfs_cpmode {
>
> /**
> * struct nilfs_argv - argument vector
> - * @v_base:
> - * @v_nmembs:
> - * @v_size:
> - * @v_flags:
> - * @v_index:
> + * @v_base: pointer on data array from userspace
> + * @v_nmembs: number of members in data array
> + * @v_size: size of data array in bytes
> + * @v_flags: flags
> + * @v_index: start number of target data items
> */
> struct nilfs_argv {
> __u64 v_base;
> @@ -747,9 +748,9 @@ struct nilfs_argv {
> };
>
> /**
> - * struct nilfs_period -
> - * @p_start:
> - * @p_end:
> + * struct nilfs_period - period of checkpoint numbers
> + * @p_start: start checkpoint number (inclusive)
> + * @p_end: end checkpoint number (exclusive)
> */
> struct nilfs_period {
> __u64 p_start;
> @@ -757,7 +758,7 @@ struct nilfs_period {
> };
>
> /**
> - * struct nilfs_cpstat -
> + * struct nilfs_cpstat - checkpoint statistics
> * @cs_cno: checkpoint number
> * @cs_ncps: number of checkpoints
> * @cs_nsss: number of snapshots
> @@ -769,7 +770,7 @@ struct nilfs_cpstat {
> };
>
> /**
> - * struct nilfs_sustat -
> + * struct nilfs_sustat - segment usage statistics
> * @ss_nsegs: number of segments
> * @ss_ncleansegs: number of clean segments
> * @ss_ndirtysegs: number of dirty segments
> @@ -788,10 +789,10 @@ struct nilfs_sustat {
>
> /**
> * struct nilfs_vinfo - virtual block number information
> - * @vi_vblocknr:
> - * @vi_start:
> - * @vi_end:
> - * @vi_blocknr:
> + * @vi_vblocknr: virtual block number
> + * @vi_start: start checkpoint number (inclusive)
> + * @vi_end: end checkpoint number (exclusive)
> + * @vi_blocknr: disk block number
> */
> struct nilfs_vinfo {
> __u64 vi_vblocknr;
> @@ -801,7 +802,15 @@ struct nilfs_vinfo {
> };
>
> /**
> - * struct nilfs_vdesc -
> + * struct nilfs_vdesc - descriptor of virtual block number
> + * @vd_ino: inode number
> + * @vd_cno: checkpoint number
> + * @vd_vblocknr: virtual block number
> + * @vd_period: period of checkpoint numbers
> + * @vd_blocknr: disk block number
> + * @vd_offset: logical block offset inside a file
> + * @vd_flags: flags (data or node block)
> + * @vd_pad: padding
> */
> struct nilfs_vdesc {
> __u64 vd_ino;
> @@ -815,7 +824,13 @@ struct nilfs_vdesc {
> };
>
> /**
> - * struct nilfs_bdesc -
> + * struct nilfs_bdesc - descriptor of disk block number
> + * @bd_ino: inode number
> + * @bd_oblocknr: disk block address (for skipping dead blocks)
> + * @bd_blocknr: disk block address
> + * @bd_offset: logical block offset inside a file
> + * @bd_level: level in the b-tree organization
> + * @bd_pad: padding
> */
> struct nilfs_bdesc {
> __u64 bd_ino;
> --
>
>
> --
> 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
--
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
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2012-07-19 12:03 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-07-19 10:17 PATCH 1/1] nilfs-utils: add omitted comments for structures in nilfs2_fs.h Vyacheslav Dubeyko
2012-07-19 12:03 ` Ryusuke Konishi
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.