1 /* SPDX-License-Identifier: GPL-2.0+ */
3 * NILFS Segment buffer prototypes and definitions
5 * Copyright (C) 2005-2008 Nippon Telegraph and Telephone Corporation.
7 * Written by Ryusuke Konishi.
10 #ifndef _NILFS_SEGBUF_H
11 #define _NILFS_SEGBUF_H
14 #include <linux/buffer_head.h>
15 #include <linux/bio.h>
16 #include <linux/completion.h>
19 * struct nilfs_segsum_info - On-memory segment summary
21 * @nfinfo: Number of file information structures
22 * @nblocks: Number of blocks included in the partial segment
23 * @nsumblk: Number of summary blocks
24 * @sumbytes: Byte count of segment summary
25 * @nfileblk: Total number of file blocks
26 * @seg_seq: Segment sequence number
27 * @cno: Checkpoint number
28 * @ctime: Creation time
29 * @next: Block number of the next full segment
31 struct nilfs_segsum_info {
34 unsigned long nblocks;
35 unsigned long nsumblk;
36 unsigned long sumbytes;
37 unsigned long nfileblk;
45 * struct nilfs_segment_buffer - Segment buffer
46 * @sb_super: back pointer to a superblock struct
47 * @sb_list: List head to chain this structure
48 * @sb_sum: On-memory segment summary
49 * @sb_segnum: Index number of the full segment
50 * @sb_nextnum: Index number of the next full segment
51 * @sb_fseg_start: Start block number of the full segment
52 * @sb_fseg_end: End block number of the full segment
53 * @sb_pseg_start: Disk block number of partial segment
54 * @sb_rest_blocks: Number of residual blocks in the current segment
55 * @sb_segsum_buffers: List of buffers for segment summaries
56 * @sb_payload_buffers: List of buffers for segment payload
57 * @sb_super_root: Pointer to buffer storing a super root block (if exists)
58 * @sb_nbio: Number of flying bio requests
59 * @sb_err: I/O error status
60 * @sb_bio_event: Completion event of log writing
62 struct nilfs_segment_buffer {
63 struct super_block *sb_super;
64 struct list_head sb_list;
66 /* Segment information */
67 struct nilfs_segsum_info sb_sum;
70 sector_t sb_fseg_start, sb_fseg_end;
71 sector_t sb_pseg_start;
72 unsigned int sb_rest_blocks;
75 struct list_head sb_segsum_buffers;
76 struct list_head sb_payload_buffers; /* including super root */
77 struct buffer_head *sb_super_root;
82 struct completion sb_bio_event;
85 #define NILFS_LIST_SEGBUF(head) \
86 list_entry((head), struct nilfs_segment_buffer, sb_list)
87 #define NILFS_NEXT_SEGBUF(segbuf) NILFS_LIST_SEGBUF((segbuf)->sb_list.next)
88 #define NILFS_PREV_SEGBUF(segbuf) NILFS_LIST_SEGBUF((segbuf)->sb_list.prev)
89 #define NILFS_LAST_SEGBUF(head) NILFS_LIST_SEGBUF((head)->prev)
90 #define NILFS_FIRST_SEGBUF(head) NILFS_LIST_SEGBUF((head)->next)
91 #define NILFS_SEGBUF_IS_LAST(segbuf, head) ((segbuf)->sb_list.next == (head))
93 #define nilfs_for_each_segbuf_before(s, t, h) \
94 for ((s) = NILFS_FIRST_SEGBUF(h); (s) != (t); \
95 (s) = NILFS_NEXT_SEGBUF(s))
97 #define NILFS_SEGBUF_FIRST_BH(head) \
98 (list_entry((head)->next, struct buffer_head, b_assoc_buffers))
99 #define NILFS_SEGBUF_NEXT_BH(bh) \
100 (list_entry((bh)->b_assoc_buffers.next, struct buffer_head, \
102 #define NILFS_SEGBUF_BH_IS_LAST(bh, head) ((bh)->b_assoc_buffers.next == head)
104 extern struct kmem_cache *nilfs_segbuf_cachep;
106 struct nilfs_segment_buffer *nilfs_segbuf_new(struct super_block *);
107 void nilfs_segbuf_free(struct nilfs_segment_buffer *);
108 void nilfs_segbuf_map(struct nilfs_segment_buffer *, __u64, unsigned long,
110 void nilfs_segbuf_map_cont(struct nilfs_segment_buffer *segbuf,
111 struct nilfs_segment_buffer *prev);
112 void nilfs_segbuf_set_next_segnum(struct nilfs_segment_buffer *, __u64,
114 int nilfs_segbuf_reset(struct nilfs_segment_buffer *, unsigned int, time64_t,
116 int nilfs_segbuf_extend_segsum(struct nilfs_segment_buffer *);
117 int nilfs_segbuf_extend_payload(struct nilfs_segment_buffer *,
118 struct buffer_head **);
119 void nilfs_segbuf_fill_in_segsum(struct nilfs_segment_buffer *);
121 static inline int nilfs_segbuf_simplex(struct nilfs_segment_buffer *segbuf)
123 unsigned int flags = segbuf->sb_sum.flags;
125 return (flags & (NILFS_SS_LOGBGN | NILFS_SS_LOGEND)) ==
126 (NILFS_SS_LOGBGN | NILFS_SS_LOGEND);
129 static inline int nilfs_segbuf_empty(struct nilfs_segment_buffer *segbuf)
131 return segbuf->sb_sum.nblocks == segbuf->sb_sum.nsumblk;
135 nilfs_segbuf_add_segsum_buffer(struct nilfs_segment_buffer *segbuf,
136 struct buffer_head *bh)
138 list_add_tail(&bh->b_assoc_buffers, &segbuf->sb_segsum_buffers);
139 segbuf->sb_sum.nblocks++;
140 segbuf->sb_sum.nsumblk++;
144 nilfs_segbuf_add_payload_buffer(struct nilfs_segment_buffer *segbuf,
145 struct buffer_head *bh)
147 list_add_tail(&bh->b_assoc_buffers, &segbuf->sb_payload_buffers);
148 segbuf->sb_sum.nblocks++;
152 nilfs_segbuf_add_file_buffer(struct nilfs_segment_buffer *segbuf,
153 struct buffer_head *bh)
156 nilfs_segbuf_add_payload_buffer(segbuf, bh);
157 segbuf->sb_sum.nfileblk++;
160 void nilfs_clear_logs(struct list_head *logs);
161 void nilfs_truncate_logs(struct list_head *logs,
162 struct nilfs_segment_buffer *last);
163 int nilfs_write_logs(struct list_head *logs, struct the_nilfs *nilfs);
164 int nilfs_wait_on_logs(struct list_head *logs);
165 void nilfs_add_checksums_on_logs(struct list_head *logs, u32 seed);
167 static inline void nilfs_destroy_logs(struct list_head *logs)
169 nilfs_truncate_logs(logs, NULL);
172 #endif /* _NILFS_SEGBUF_H */