nilfs2: add omitted comments for structures in nilfs2_fs.h

Add omitted comments for structures in nilfs2_fs.h.

Signed-off-by: Vyacheslav Dubeyko <slava@dubeyko.com>
Signed-off-by: Ryusuke Konishi <konishi.ryusuke@lab.ntt.co.jp>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
This commit is contained in:
Vyacheslav Dubeyko 2012-07-30 14:42:09 -07:00 committed by Linus Torvalds
parent 572d8b3945
commit 8c74ac0557

View File

@ -293,7 +293,7 @@ struct nilfs_dir_entry {
__le64 inode; /* Inode number */ __le64 inode; /* Inode number */
__le16 rec_len; /* Directory entry length */ __le16 rec_len; /* Directory entry length */
__u8 name_len; /* Name length */ __u8 name_len; /* Name length */
__u8 file_type; __u8 file_type; /* Dir entry type (file, dir, etc) */
char name[NILFS_NAME_LEN]; /* File name */ char name[NILFS_NAME_LEN]; /* File name */
char pad; char pad;
}; };
@ -395,7 +395,7 @@ union nilfs_binfo {
}; };
/** /**
* struct nilfs_segment_summary - segment summary * struct nilfs_segment_summary - segment summary header
* @ss_datasum: checksum of data * @ss_datasum: checksum of data
* @ss_sumsum: checksum of segment summary * @ss_sumsum: checksum of segment summary
* @ss_magic: magic number * @ss_magic: magic number
@ -683,9 +683,9 @@ struct nilfs_sufile_header {
/** /**
* nilfs_suinfo - segment usage information * nilfs_suinfo - segment usage information
* @sui_lastmod: * @sui_lastmod: timestamp of last modification
* @sui_nblocks: * @sui_nblocks: number of written blocks in segment
* @sui_flags: * @sui_flags: segment usage flags
*/ */
struct nilfs_suinfo { struct nilfs_suinfo {
__u64 sui_lastmod; __u64 sui_lastmod;
@ -716,9 +716,10 @@ enum {
}; };
/** /**
* struct nilfs_cpmode - * struct nilfs_cpmode - change checkpoint mode structure
* @cc_cno: * @cm_cno: checkpoint number
* @cc_mode: * @cm_mode: mode of checkpoint
* @cm_pad: padding
*/ */
struct nilfs_cpmode { struct nilfs_cpmode {
__u64 cm_cno; __u64 cm_cno;
@ -728,11 +729,11 @@ struct nilfs_cpmode {
/** /**
* struct nilfs_argv - argument vector * struct nilfs_argv - argument vector
* @v_base: * @v_base: pointer on data array from userspace
* @v_nmembs: * @v_nmembs: number of members in data array
* @v_size: * @v_size: size of data array in bytes
* @v_flags: * @v_flags: flags
* @v_index: * @v_index: start number of target data items
*/ */
struct nilfs_argv { struct nilfs_argv {
__u64 v_base; __u64 v_base;
@ -743,9 +744,9 @@ struct nilfs_argv {
}; };
/** /**
* struct nilfs_period - * struct nilfs_period - period of checkpoint numbers
* @p_start: * @p_start: start checkpoint number (inclusive)
* @p_end: * @p_end: end checkpoint number (exclusive)
*/ */
struct nilfs_period { struct nilfs_period {
__u64 p_start; __u64 p_start;
@ -753,7 +754,7 @@ struct nilfs_period {
}; };
/** /**
* struct nilfs_cpstat - * struct nilfs_cpstat - checkpoint statistics
* @cs_cno: checkpoint number * @cs_cno: checkpoint number
* @cs_ncps: number of checkpoints * @cs_ncps: number of checkpoints
* @cs_nsss: number of snapshots * @cs_nsss: number of snapshots
@ -765,7 +766,7 @@ struct nilfs_cpstat {
}; };
/** /**
* struct nilfs_sustat - * struct nilfs_sustat - segment usage statistics
* @ss_nsegs: number of segments * @ss_nsegs: number of segments
* @ss_ncleansegs: number of clean segments * @ss_ncleansegs: number of clean segments
* @ss_ndirtysegs: number of dirty segments * @ss_ndirtysegs: number of dirty segments
@ -784,10 +785,10 @@ struct nilfs_sustat {
/** /**
* struct nilfs_vinfo - virtual block number information * struct nilfs_vinfo - virtual block number information
* @vi_vblocknr: * @vi_vblocknr: virtual block number
* @vi_start: * @vi_start: start checkpoint number (inclusive)
* @vi_end: * @vi_end: end checkpoint number (exclusive)
* @vi_blocknr: * @vi_blocknr: disk block number
*/ */
struct nilfs_vinfo { struct nilfs_vinfo {
__u64 vi_vblocknr; __u64 vi_vblocknr;
@ -797,7 +798,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 { struct nilfs_vdesc {
__u64 vd_ino; __u64 vd_ino;
@ -811,7 +820,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 { struct nilfs_bdesc {
__u64 bd_ino; __u64 bd_ino;