1 // SPDX-License-Identifier: GPL-2.0+
3 * NILFS checkpoint file.
5 * Copyright (C) 2006-2008 Nippon Telegraph and Telephone Corporation.
7 * Written by Koji Sato.
10 #include <linux/kernel.h>
12 #include <linux/string.h>
13 #include <linux/buffer_head.h>
14 #include <linux/errno.h>
19 static inline unsigned long
20 nilfs_cpfile_checkpoints_per_block(const struct inode *cpfile)
22 return NILFS_MDT(cpfile)->mi_entries_per_block;
25 /* block number from the beginning of the file */
27 nilfs_cpfile_get_blkoff(const struct inode *cpfile, __u64 cno)
29 __u64 tcno = cno + NILFS_MDT(cpfile)->mi_first_entry_offset - 1;
31 tcno = div64_ul(tcno, nilfs_cpfile_checkpoints_per_block(cpfile));
32 return (unsigned long)tcno;
37 nilfs_cpfile_get_offset(const struct inode *cpfile, __u64 cno)
39 __u64 tcno = cno + NILFS_MDT(cpfile)->mi_first_entry_offset - 1;
41 return do_div(tcno, nilfs_cpfile_checkpoints_per_block(cpfile));
44 static __u64 nilfs_cpfile_first_checkpoint_in_block(const struct inode *cpfile,
47 return (__u64)nilfs_cpfile_checkpoints_per_block(cpfile) * blkoff
48 + 1 - NILFS_MDT(cpfile)->mi_first_entry_offset;
52 nilfs_cpfile_checkpoints_in_block(const struct inode *cpfile,
57 nilfs_cpfile_checkpoints_per_block(cpfile) -
58 nilfs_cpfile_get_offset(cpfile, curr),
62 static inline int nilfs_cpfile_is_in_first(const struct inode *cpfile,
65 return nilfs_cpfile_get_blkoff(cpfile, cno) == 0;
69 nilfs_cpfile_block_add_valid_checkpoints(const struct inode *cpfile,
70 struct buffer_head *bh,
74 struct nilfs_checkpoint *cp = kaddr + bh_offset(bh);
77 count = le32_to_cpu(cp->cp_checkpoints_count) + n;
78 cp->cp_checkpoints_count = cpu_to_le32(count);
83 nilfs_cpfile_block_sub_valid_checkpoints(const struct inode *cpfile,
84 struct buffer_head *bh,
88 struct nilfs_checkpoint *cp = kaddr + bh_offset(bh);
91 WARN_ON(le32_to_cpu(cp->cp_checkpoints_count) < n);
92 count = le32_to_cpu(cp->cp_checkpoints_count) - n;
93 cp->cp_checkpoints_count = cpu_to_le32(count);
97 static inline struct nilfs_cpfile_header *
98 nilfs_cpfile_block_get_header(const struct inode *cpfile,
99 struct buffer_head *bh,
102 return kaddr + bh_offset(bh);
105 static struct nilfs_checkpoint *
106 nilfs_cpfile_block_get_checkpoint(const struct inode *cpfile, __u64 cno,
107 struct buffer_head *bh,
110 return kaddr + bh_offset(bh) + nilfs_cpfile_get_offset(cpfile, cno) *
111 NILFS_MDT(cpfile)->mi_entry_size;
114 static void nilfs_cpfile_block_init(struct inode *cpfile,
115 struct buffer_head *bh,
118 struct nilfs_checkpoint *cp = kaddr + bh_offset(bh);
119 size_t cpsz = NILFS_MDT(cpfile)->mi_entry_size;
120 int n = nilfs_cpfile_checkpoints_per_block(cpfile);
123 nilfs_checkpoint_set_invalid(cp);
124 cp = (void *)cp + cpsz;
128 static inline int nilfs_cpfile_get_header_block(struct inode *cpfile,
129 struct buffer_head **bhp)
131 return nilfs_mdt_get_block(cpfile, 0, 0, NULL, bhp);
134 static inline int nilfs_cpfile_get_checkpoint_block(struct inode *cpfile,
137 struct buffer_head **bhp)
139 return nilfs_mdt_get_block(cpfile,
140 nilfs_cpfile_get_blkoff(cpfile, cno),
141 create, nilfs_cpfile_block_init, bhp);
145 * nilfs_cpfile_find_checkpoint_block - find and get a buffer on cpfile
146 * @cpfile: inode of cpfile
147 * @start_cno: start checkpoint number (inclusive)
148 * @end_cno: end checkpoint number (inclusive)
149 * @cnop: place to store the next checkpoint number
150 * @bhp: place to store a pointer to buffer_head struct
152 * Return Value: On success, it returns 0. On error, the following negative
153 * error code is returned.
155 * %-ENOMEM - Insufficient memory available.
159 * %-ENOENT - no block exists in the range.
161 static int nilfs_cpfile_find_checkpoint_block(struct inode *cpfile,
162 __u64 start_cno, __u64 end_cno,
164 struct buffer_head **bhp)
166 unsigned long start, end, blkoff;
169 if (unlikely(start_cno > end_cno))
172 start = nilfs_cpfile_get_blkoff(cpfile, start_cno);
173 end = nilfs_cpfile_get_blkoff(cpfile, end_cno);
175 ret = nilfs_mdt_find_block(cpfile, start, end, &blkoff, bhp);
177 *cnop = (blkoff == start) ? start_cno :
178 nilfs_cpfile_first_checkpoint_in_block(cpfile, blkoff);
182 static inline int nilfs_cpfile_delete_checkpoint_block(struct inode *cpfile,
185 return nilfs_mdt_delete_block(cpfile,
186 nilfs_cpfile_get_blkoff(cpfile, cno));
190 * nilfs_cpfile_read_checkpoint - read a checkpoint entry in cpfile
191 * @cpfile: checkpoint file inode
192 * @cno: number of checkpoint entry to read
193 * @root: nilfs root object
194 * @ifile: ifile's inode to read and attach to @root
196 * This function imports checkpoint information from the checkpoint file and
197 * stores it to the inode file given by @ifile and the nilfs root object
200 * Return: 0 on success, or the following negative error code on failure.
201 * * %-EINVAL - Invalid checkpoint.
202 * * %-ENOMEM - Insufficient memory available.
203 * * %-EIO - I/O error (including metadata corruption).
205 int nilfs_cpfile_read_checkpoint(struct inode *cpfile, __u64 cno,
206 struct nilfs_root *root, struct inode *ifile)
208 struct buffer_head *cp_bh;
209 struct nilfs_checkpoint *cp;
213 if (cno < 1 || cno > nilfs_mdt_cno(cpfile))
216 down_read(&NILFS_MDT(cpfile)->mi_sem);
217 ret = nilfs_cpfile_get_checkpoint_block(cpfile, cno, 0, &cp_bh);
218 if (unlikely(ret < 0)) {
224 kaddr = kmap_local_page(cp_bh->b_page);
225 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, cp_bh, kaddr);
226 if (nilfs_checkpoint_invalid(cp)) {
231 ret = nilfs_read_inode_common(ifile, &cp->cp_ifile_inode);
234 * Since this inode is on a checkpoint entry, treat errors
235 * as metadata corruption.
237 nilfs_err(cpfile->i_sb,
238 "ifile inode (checkpoint number=%llu) corrupted",
239 (unsigned long long)cno);
244 /* Configure the nilfs root object */
245 atomic64_set(&root->inodes_count, le64_to_cpu(cp->cp_inodes_count));
246 atomic64_set(&root->blocks_count, le64_to_cpu(cp->cp_blocks_count));
253 up_read(&NILFS_MDT(cpfile)->mi_sem);
258 * nilfs_cpfile_create_checkpoint - create a checkpoint entry on cpfile
259 * @cpfile: checkpoint file inode
260 * @cno: number of checkpoint to set up
262 * This function creates a checkpoint with the number specified by @cno on
263 * cpfile. If the specified checkpoint entry already exists due to a past
264 * failure, it will be reused without returning an error.
265 * In either case, the buffer of the block containing the checkpoint entry
266 * and the cpfile inode are made dirty for inclusion in the write log.
268 * Return: 0 on success, or the following negative error code on failure.
269 * * %-ENOMEM - Insufficient memory available.
270 * * %-EIO - I/O error (including metadata corruption).
271 * * %-EROFS - Read only filesystem
273 int nilfs_cpfile_create_checkpoint(struct inode *cpfile, __u64 cno)
275 struct buffer_head *header_bh, *cp_bh;
276 struct nilfs_cpfile_header *header;
277 struct nilfs_checkpoint *cp;
281 if (WARN_ON_ONCE(cno < 1))
284 down_write(&NILFS_MDT(cpfile)->mi_sem);
285 ret = nilfs_cpfile_get_header_block(cpfile, &header_bh);
286 if (unlikely(ret < 0)) {
287 if (ret == -ENOENT) {
288 nilfs_error(cpfile->i_sb,
289 "checkpoint creation failed due to metadata corruption.");
294 ret = nilfs_cpfile_get_checkpoint_block(cpfile, cno, 1, &cp_bh);
295 if (unlikely(ret < 0))
298 kaddr = kmap_local_page(cp_bh->b_page);
299 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, cp_bh, kaddr);
300 if (nilfs_checkpoint_invalid(cp)) {
301 /* a newly-created checkpoint */
302 nilfs_checkpoint_clear_invalid(cp);
303 if (!nilfs_cpfile_is_in_first(cpfile, cno))
304 nilfs_cpfile_block_add_valid_checkpoints(cpfile, cp_bh,
308 kaddr = kmap_local_page(header_bh->b_page);
309 header = nilfs_cpfile_block_get_header(cpfile, header_bh,
311 le64_add_cpu(&header->ch_ncheckpoints, 1);
313 mark_buffer_dirty(header_bh);
318 /* Force the buffer and the inode to become dirty */
319 mark_buffer_dirty(cp_bh);
321 nilfs_mdt_mark_dirty(cpfile);
327 up_write(&NILFS_MDT(cpfile)->mi_sem);
332 * nilfs_cpfile_finalize_checkpoint - fill in a checkpoint entry in cpfile
333 * @cpfile: checkpoint file inode
334 * @cno: checkpoint number
335 * @root: nilfs root object
336 * @blkinc: number of blocks added by this checkpoint
337 * @ctime: checkpoint creation time
338 * @minor: minor checkpoint flag
340 * This function completes the checkpoint entry numbered by @cno in the
341 * cpfile with the data given by the arguments @root, @blkinc, @ctime, and
344 * Return: 0 on success, or the following negative error code on failure.
345 * * %-ENOMEM - Insufficient memory available.
346 * * %-EIO - I/O error (including metadata corruption).
348 int nilfs_cpfile_finalize_checkpoint(struct inode *cpfile, __u64 cno,
349 struct nilfs_root *root, __u64 blkinc,
350 time64_t ctime, bool minor)
352 struct buffer_head *cp_bh;
353 struct nilfs_checkpoint *cp;
357 if (WARN_ON_ONCE(cno < 1))
360 down_write(&NILFS_MDT(cpfile)->mi_sem);
361 ret = nilfs_cpfile_get_checkpoint_block(cpfile, cno, 0, &cp_bh);
362 if (unlikely(ret < 0)) {
368 kaddr = kmap_local_page(cp_bh->b_page);
369 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, cp_bh, kaddr);
370 if (unlikely(nilfs_checkpoint_invalid(cp))) {
376 cp->cp_snapshot_list.ssl_next = 0;
377 cp->cp_snapshot_list.ssl_prev = 0;
378 cp->cp_inodes_count = cpu_to_le64(atomic64_read(&root->inodes_count));
379 cp->cp_blocks_count = cpu_to_le64(atomic64_read(&root->blocks_count));
380 cp->cp_nblk_inc = cpu_to_le64(blkinc);
381 cp->cp_create = cpu_to_le64(ctime);
382 cp->cp_cno = cpu_to_le64(cno);
385 nilfs_checkpoint_set_minor(cp);
387 nilfs_checkpoint_clear_minor(cp);
389 nilfs_write_inode_common(root->ifile, &cp->cp_ifile_inode);
390 nilfs_bmap_write(NILFS_I(root->ifile)->i_bmap, &cp->cp_ifile_inode);
395 up_write(&NILFS_MDT(cpfile)->mi_sem);
399 nilfs_error(cpfile->i_sb,
400 "checkpoint finalization failed due to metadata corruption.");
406 * nilfs_cpfile_delete_checkpoints - delete checkpoints
407 * @cpfile: inode of checkpoint file
408 * @start: start checkpoint number
409 * @end: end checkpoint number
411 * Description: nilfs_cpfile_delete_checkpoints() deletes the checkpoints in
412 * the period from @start to @end, excluding @end itself. The checkpoints
413 * which have been already deleted are ignored.
415 * Return Value: On success, 0 is returned. On error, one of the following
416 * negative error codes is returned.
420 * %-ENOMEM - Insufficient amount of memory available.
422 * %-EINVAL - invalid checkpoints.
424 int nilfs_cpfile_delete_checkpoints(struct inode *cpfile,
428 struct buffer_head *header_bh, *cp_bh;
429 struct nilfs_cpfile_header *header;
430 struct nilfs_checkpoint *cp;
431 size_t cpsz = NILFS_MDT(cpfile)->mi_entry_size;
434 unsigned long tnicps;
435 int ret, ncps, nicps, nss, count, i;
437 if (unlikely(start == 0 || start > end)) {
438 nilfs_err(cpfile->i_sb,
439 "cannot delete checkpoints: invalid range [%llu, %llu)",
440 (unsigned long long)start, (unsigned long long)end);
444 down_write(&NILFS_MDT(cpfile)->mi_sem);
446 ret = nilfs_cpfile_get_header_block(cpfile, &header_bh);
452 for (cno = start; cno < end; cno += ncps) {
453 ncps = nilfs_cpfile_checkpoints_in_block(cpfile, cno, end);
454 ret = nilfs_cpfile_get_checkpoint_block(cpfile, cno, 0, &cp_bh);
463 kaddr = kmap_local_page(cp_bh->b_page);
464 cp = nilfs_cpfile_block_get_checkpoint(
465 cpfile, cno, cp_bh, kaddr);
467 for (i = 0; i < ncps; i++, cp = (void *)cp + cpsz) {
468 if (nilfs_checkpoint_snapshot(cp)) {
470 } else if (!nilfs_checkpoint_invalid(cp)) {
471 nilfs_checkpoint_set_invalid(cp);
477 mark_buffer_dirty(cp_bh);
478 nilfs_mdt_mark_dirty(cpfile);
479 if (!nilfs_cpfile_is_in_first(cpfile, cno)) {
481 nilfs_cpfile_block_sub_valid_checkpoints(
482 cpfile, cp_bh, kaddr, nicps);
488 nilfs_cpfile_delete_checkpoint_block(
492 nilfs_err(cpfile->i_sb,
493 "error %d deleting checkpoint block",
505 kaddr = kmap_local_page(header_bh->b_page);
506 header = nilfs_cpfile_block_get_header(cpfile, header_bh,
508 le64_add_cpu(&header->ch_ncheckpoints, -(u64)tnicps);
509 mark_buffer_dirty(header_bh);
510 nilfs_mdt_mark_dirty(cpfile);
519 up_write(&NILFS_MDT(cpfile)->mi_sem);
523 static void nilfs_cpfile_checkpoint_to_cpinfo(struct inode *cpfile,
524 struct nilfs_checkpoint *cp,
525 struct nilfs_cpinfo *ci)
527 ci->ci_flags = le32_to_cpu(cp->cp_flags);
528 ci->ci_cno = le64_to_cpu(cp->cp_cno);
529 ci->ci_create = le64_to_cpu(cp->cp_create);
530 ci->ci_nblk_inc = le64_to_cpu(cp->cp_nblk_inc);
531 ci->ci_inodes_count = le64_to_cpu(cp->cp_inodes_count);
532 ci->ci_blocks_count = le64_to_cpu(cp->cp_blocks_count);
533 ci->ci_next = le64_to_cpu(cp->cp_snapshot_list.ssl_next);
536 static ssize_t nilfs_cpfile_do_get_cpinfo(struct inode *cpfile, __u64 *cnop,
537 void *buf, unsigned int cisz,
540 struct nilfs_checkpoint *cp;
541 struct nilfs_cpinfo *ci = buf;
542 struct buffer_head *bh;
543 size_t cpsz = NILFS_MDT(cpfile)->mi_entry_size;
544 __u64 cur_cno = nilfs_mdt_cno(cpfile), cno = *cnop;
550 return -ENOENT; /* checkpoint number 0 is invalid */
551 down_read(&NILFS_MDT(cpfile)->mi_sem);
553 for (n = 0; n < nci; cno += ncps) {
554 ret = nilfs_cpfile_find_checkpoint_block(
555 cpfile, cno, cur_cno - 1, &cno, &bh);
557 if (likely(ret == -ENOENT))
561 ncps = nilfs_cpfile_checkpoints_in_block(cpfile, cno, cur_cno);
563 kaddr = kmap_local_page(bh->b_page);
564 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, bh, kaddr);
565 for (i = 0; i < ncps && n < nci; i++, cp = (void *)cp + cpsz) {
566 if (!nilfs_checkpoint_invalid(cp)) {
567 nilfs_cpfile_checkpoint_to_cpinfo(cpfile, cp,
569 ci = (void *)ci + cisz;
579 ci = (void *)ci - cisz;
580 *cnop = ci->ci_cno + 1;
584 up_read(&NILFS_MDT(cpfile)->mi_sem);
588 static ssize_t nilfs_cpfile_do_get_ssinfo(struct inode *cpfile, __u64 *cnop,
589 void *buf, unsigned int cisz,
592 struct buffer_head *bh;
593 struct nilfs_cpfile_header *header;
594 struct nilfs_checkpoint *cp;
595 struct nilfs_cpinfo *ci = buf;
596 __u64 curr = *cnop, next;
597 unsigned long curr_blkoff, next_blkoff;
601 down_read(&NILFS_MDT(cpfile)->mi_sem);
604 ret = nilfs_cpfile_get_header_block(cpfile, &bh);
607 kaddr = kmap_local_page(bh->b_page);
608 header = nilfs_cpfile_block_get_header(cpfile, bh, kaddr);
609 curr = le64_to_cpu(header->ch_snapshot_list.ssl_next);
616 } else if (unlikely(curr == ~(__u64)0)) {
621 curr_blkoff = nilfs_cpfile_get_blkoff(cpfile, curr);
622 ret = nilfs_cpfile_get_checkpoint_block(cpfile, curr, 0, &bh);
623 if (unlikely(ret < 0)) {
625 ret = 0; /* No snapshots (started from a hole block) */
628 kaddr = kmap_local_page(bh->b_page);
630 cp = nilfs_cpfile_block_get_checkpoint(cpfile, curr, bh, kaddr);
631 curr = ~(__u64)0; /* Terminator */
632 if (unlikely(nilfs_checkpoint_invalid(cp) ||
633 !nilfs_checkpoint_snapshot(cp)))
635 nilfs_cpfile_checkpoint_to_cpinfo(cpfile, cp, ci);
636 ci = (void *)ci + cisz;
638 next = le64_to_cpu(cp->cp_snapshot_list.ssl_next);
640 break; /* reach end of the snapshot list */
642 next_blkoff = nilfs_cpfile_get_blkoff(cpfile, next);
643 if (curr_blkoff != next_blkoff) {
646 ret = nilfs_cpfile_get_checkpoint_block(cpfile, next,
648 if (unlikely(ret < 0)) {
649 WARN_ON(ret == -ENOENT);
652 kaddr = kmap_local_page(bh->b_page);
655 curr_blkoff = next_blkoff;
663 up_read(&NILFS_MDT(cpfile)->mi_sem);
668 * nilfs_cpfile_get_cpinfo - get information on checkpoints
669 * @cpfile: checkpoint file inode
670 * @cnop: place to pass a starting checkpoint number and receive a
671 * checkpoint number to continue the search
672 * @mode: mode of checkpoints that the caller wants to retrieve
673 * @buf: buffer for storing checkpoints' information
674 * @cisz: byte size of one checkpoint info item in array
675 * @nci: number of checkpoint info items to retrieve
677 * nilfs_cpfile_get_cpinfo() searches for checkpoints in @mode state
678 * starting from the checkpoint number stored in @cnop, and stores
679 * information about found checkpoints in @buf.
680 * The buffer pointed to by @buf must be large enough to store information
681 * for @nci checkpoints. If at least one checkpoint information is
682 * successfully retrieved, @cnop is updated to point to the checkpoint
683 * number to continue searching.
685 * Return: Count of checkpoint info items stored in the output buffer on
686 * success, or the following negative error code on failure.
687 * * %-EINVAL - Invalid checkpoint mode.
688 * * %-ENOMEM - Insufficient memory available.
689 * * %-EIO - I/O error (including metadata corruption).
690 * * %-ENOENT - Invalid checkpoint number specified.
693 ssize_t nilfs_cpfile_get_cpinfo(struct inode *cpfile, __u64 *cnop, int mode,
694 void *buf, unsigned int cisz, size_t nci)
697 case NILFS_CHECKPOINT:
698 return nilfs_cpfile_do_get_cpinfo(cpfile, cnop, buf, cisz, nci);
700 return nilfs_cpfile_do_get_ssinfo(cpfile, cnop, buf, cisz, nci);
707 * nilfs_cpfile_delete_checkpoint -
711 int nilfs_cpfile_delete_checkpoint(struct inode *cpfile, __u64 cno)
713 struct nilfs_cpinfo ci;
717 nci = nilfs_cpfile_do_get_cpinfo(cpfile, &tcno, &ci, sizeof(ci), 1);
720 else if (nci == 0 || ci.ci_cno != cno)
722 else if (nilfs_cpinfo_snapshot(&ci))
725 return nilfs_cpfile_delete_checkpoints(cpfile, cno, cno + 1);
728 static struct nilfs_snapshot_list *
729 nilfs_cpfile_block_get_snapshot_list(const struct inode *cpfile,
731 struct buffer_head *bh,
734 struct nilfs_cpfile_header *header;
735 struct nilfs_checkpoint *cp;
736 struct nilfs_snapshot_list *list;
739 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, bh, kaddr);
740 list = &cp->cp_snapshot_list;
742 header = nilfs_cpfile_block_get_header(cpfile, bh, kaddr);
743 list = &header->ch_snapshot_list;
748 static int nilfs_cpfile_set_snapshot(struct inode *cpfile, __u64 cno)
750 struct buffer_head *header_bh, *curr_bh, *prev_bh, *cp_bh;
751 struct nilfs_cpfile_header *header;
752 struct nilfs_checkpoint *cp;
753 struct nilfs_snapshot_list *list;
755 unsigned long curr_blkoff, prev_blkoff;
760 return -ENOENT; /* checkpoint number 0 is invalid */
761 down_write(&NILFS_MDT(cpfile)->mi_sem);
763 ret = nilfs_cpfile_get_checkpoint_block(cpfile, cno, 0, &cp_bh);
766 kaddr = kmap_local_page(cp_bh->b_page);
767 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, cp_bh, kaddr);
768 if (nilfs_checkpoint_invalid(cp)) {
773 if (nilfs_checkpoint_snapshot(cp)) {
780 ret = nilfs_cpfile_get_header_block(cpfile, &header_bh);
783 kaddr = kmap_local_page(header_bh->b_page);
784 header = nilfs_cpfile_block_get_header(cpfile, header_bh, kaddr);
785 list = &header->ch_snapshot_list;
790 prev = le64_to_cpu(list->ssl_prev);
792 prev_blkoff = nilfs_cpfile_get_blkoff(cpfile, prev);
794 if (curr_blkoff != prev_blkoff) {
797 ret = nilfs_cpfile_get_checkpoint_block(cpfile, curr,
801 kaddr = kmap_local_page(curr_bh->b_page);
803 curr_blkoff = prev_blkoff;
804 cp = nilfs_cpfile_block_get_checkpoint(
805 cpfile, curr, curr_bh, kaddr);
806 list = &cp->cp_snapshot_list;
807 prev = le64_to_cpu(list->ssl_prev);
812 ret = nilfs_cpfile_get_checkpoint_block(cpfile, prev, 0,
821 kaddr = kmap_local_page(curr_bh->b_page);
822 list = nilfs_cpfile_block_get_snapshot_list(
823 cpfile, curr, curr_bh, kaddr);
824 list->ssl_prev = cpu_to_le64(cno);
827 kaddr = kmap_local_page(cp_bh->b_page);
828 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, cp_bh, kaddr);
829 cp->cp_snapshot_list.ssl_next = cpu_to_le64(curr);
830 cp->cp_snapshot_list.ssl_prev = cpu_to_le64(prev);
831 nilfs_checkpoint_set_snapshot(cp);
834 kaddr = kmap_local_page(prev_bh->b_page);
835 list = nilfs_cpfile_block_get_snapshot_list(
836 cpfile, prev, prev_bh, kaddr);
837 list->ssl_next = cpu_to_le64(cno);
840 kaddr = kmap_local_page(header_bh->b_page);
841 header = nilfs_cpfile_block_get_header(cpfile, header_bh, kaddr);
842 le64_add_cpu(&header->ch_nsnapshots, 1);
845 mark_buffer_dirty(prev_bh);
846 mark_buffer_dirty(curr_bh);
847 mark_buffer_dirty(cp_bh);
848 mark_buffer_dirty(header_bh);
849 nilfs_mdt_mark_dirty(cpfile);
863 up_write(&NILFS_MDT(cpfile)->mi_sem);
867 static int nilfs_cpfile_clear_snapshot(struct inode *cpfile, __u64 cno)
869 struct buffer_head *header_bh, *next_bh, *prev_bh, *cp_bh;
870 struct nilfs_cpfile_header *header;
871 struct nilfs_checkpoint *cp;
872 struct nilfs_snapshot_list *list;
878 return -ENOENT; /* checkpoint number 0 is invalid */
879 down_write(&NILFS_MDT(cpfile)->mi_sem);
881 ret = nilfs_cpfile_get_checkpoint_block(cpfile, cno, 0, &cp_bh);
884 kaddr = kmap_local_page(cp_bh->b_page);
885 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, cp_bh, kaddr);
886 if (nilfs_checkpoint_invalid(cp)) {
891 if (!nilfs_checkpoint_snapshot(cp)) {
897 list = &cp->cp_snapshot_list;
898 next = le64_to_cpu(list->ssl_next);
899 prev = le64_to_cpu(list->ssl_prev);
902 ret = nilfs_cpfile_get_header_block(cpfile, &header_bh);
906 ret = nilfs_cpfile_get_checkpoint_block(cpfile, next, 0,
915 ret = nilfs_cpfile_get_checkpoint_block(cpfile, prev, 0,
924 kaddr = kmap_local_page(next_bh->b_page);
925 list = nilfs_cpfile_block_get_snapshot_list(
926 cpfile, next, next_bh, kaddr);
927 list->ssl_prev = cpu_to_le64(prev);
930 kaddr = kmap_local_page(prev_bh->b_page);
931 list = nilfs_cpfile_block_get_snapshot_list(
932 cpfile, prev, prev_bh, kaddr);
933 list->ssl_next = cpu_to_le64(next);
936 kaddr = kmap_local_page(cp_bh->b_page);
937 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, cp_bh, kaddr);
938 cp->cp_snapshot_list.ssl_next = cpu_to_le64(0);
939 cp->cp_snapshot_list.ssl_prev = cpu_to_le64(0);
940 nilfs_checkpoint_clear_snapshot(cp);
943 kaddr = kmap_local_page(header_bh->b_page);
944 header = nilfs_cpfile_block_get_header(cpfile, header_bh, kaddr);
945 le64_add_cpu(&header->ch_nsnapshots, -1);
948 mark_buffer_dirty(next_bh);
949 mark_buffer_dirty(prev_bh);
950 mark_buffer_dirty(cp_bh);
951 mark_buffer_dirty(header_bh);
952 nilfs_mdt_mark_dirty(cpfile);
966 up_write(&NILFS_MDT(cpfile)->mi_sem);
971 * nilfs_cpfile_is_snapshot -
972 * @cpfile: inode of checkpoint file
973 * @cno: checkpoint number
977 * Return Value: On success, 1 is returned if the checkpoint specified by
978 * @cno is a snapshot, or 0 if not. On error, one of the following negative
979 * error codes is returned.
983 * %-ENOMEM - Insufficient amount of memory available.
985 * %-ENOENT - No such checkpoint.
987 int nilfs_cpfile_is_snapshot(struct inode *cpfile, __u64 cno)
989 struct buffer_head *bh;
990 struct nilfs_checkpoint *cp;
995 * CP number is invalid if it's zero or larger than the
996 * largest existing one.
998 if (cno == 0 || cno >= nilfs_mdt_cno(cpfile))
1000 down_read(&NILFS_MDT(cpfile)->mi_sem);
1002 ret = nilfs_cpfile_get_checkpoint_block(cpfile, cno, 0, &bh);
1005 kaddr = kmap_local_page(bh->b_page);
1006 cp = nilfs_cpfile_block_get_checkpoint(cpfile, cno, bh, kaddr);
1007 if (nilfs_checkpoint_invalid(cp))
1010 ret = nilfs_checkpoint_snapshot(cp);
1011 kunmap_local(kaddr);
1015 up_read(&NILFS_MDT(cpfile)->mi_sem);
1020 * nilfs_cpfile_change_cpmode - change checkpoint mode
1021 * @cpfile: inode of checkpoint file
1022 * @cno: checkpoint number
1023 * @mode: mode of checkpoint
1025 * Description: nilfs_change_cpmode() changes the mode of the checkpoint
1026 * specified by @cno. The mode @mode is NILFS_CHECKPOINT or NILFS_SNAPSHOT.
1028 * Return Value: On success, 0 is returned. On error, one of the following
1029 * negative error codes is returned.
1031 * %-EIO - I/O error.
1033 * %-ENOMEM - Insufficient amount of memory available.
1035 * %-ENOENT - No such checkpoint.
1037 int nilfs_cpfile_change_cpmode(struct inode *cpfile, __u64 cno, int mode)
1042 case NILFS_CHECKPOINT:
1043 if (nilfs_checkpoint_is_mounted(cpfile->i_sb, cno))
1045 * Current implementation does not have to protect
1046 * plain read-only mounts since they are exclusive
1047 * with a read/write mount and are protected from the
1052 ret = nilfs_cpfile_clear_snapshot(cpfile, cno);
1054 case NILFS_SNAPSHOT:
1055 return nilfs_cpfile_set_snapshot(cpfile, cno);
1062 * nilfs_cpfile_get_stat - get checkpoint statistics
1063 * @cpfile: inode of checkpoint file
1064 * @cpstat: pointer to a structure of checkpoint statistics
1066 * Description: nilfs_cpfile_get_stat() returns information about checkpoints.
1068 * Return Value: On success, 0 is returned, and checkpoints information is
1069 * stored in the place pointed by @cpstat. On error, one of the following
1070 * negative error codes is returned.
1072 * %-EIO - I/O error.
1074 * %-ENOMEM - Insufficient amount of memory available.
1076 int nilfs_cpfile_get_stat(struct inode *cpfile, struct nilfs_cpstat *cpstat)
1078 struct buffer_head *bh;
1079 struct nilfs_cpfile_header *header;
1083 down_read(&NILFS_MDT(cpfile)->mi_sem);
1085 ret = nilfs_cpfile_get_header_block(cpfile, &bh);
1088 kaddr = kmap_local_page(bh->b_page);
1089 header = nilfs_cpfile_block_get_header(cpfile, bh, kaddr);
1090 cpstat->cs_cno = nilfs_mdt_cno(cpfile);
1091 cpstat->cs_ncps = le64_to_cpu(header->ch_ncheckpoints);
1092 cpstat->cs_nsss = le64_to_cpu(header->ch_nsnapshots);
1093 kunmap_local(kaddr);
1097 up_read(&NILFS_MDT(cpfile)->mi_sem);
1102 * nilfs_cpfile_read - read or get cpfile inode
1103 * @sb: super block instance
1104 * @cpsize: size of a checkpoint entry
1105 * @raw_inode: on-disk cpfile inode
1106 * @inodep: buffer to store the inode
1108 int nilfs_cpfile_read(struct super_block *sb, size_t cpsize,
1109 struct nilfs_inode *raw_inode, struct inode **inodep)
1111 struct inode *cpfile;
1114 if (cpsize > sb->s_blocksize) {
1115 nilfs_err(sb, "too large checkpoint size: %zu bytes", cpsize);
1117 } else if (cpsize < NILFS_MIN_CHECKPOINT_SIZE) {
1118 nilfs_err(sb, "too small checkpoint size: %zu bytes", cpsize);
1122 cpfile = nilfs_iget_locked(sb, NULL, NILFS_CPFILE_INO);
1123 if (unlikely(!cpfile))
1125 if (!(cpfile->i_state & I_NEW))
1128 err = nilfs_mdt_init(cpfile, NILFS_MDT_GFP, 0);
1132 nilfs_mdt_set_entry_size(cpfile, cpsize,
1133 sizeof(struct nilfs_cpfile_header));
1135 err = nilfs_read_inode_common(cpfile, raw_inode);
1139 unlock_new_inode(cpfile);
1144 iget_failed(cpfile);