2 * bmap.c - NILFS block mapping.
4 * Copyright (C) 2006-2008 Nippon Telegraph and Telephone Corporation.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
20 * Written by Koji Sato <koji@osrg.net>.
24 #include <linux/string.h>
25 #include <linux/errno.h>
35 struct inode
*nilfs_bmap_get_dat(const struct nilfs_bmap
*bmap
)
37 struct the_nilfs
*nilfs
= bmap
->b_inode
->i_sb
->s_fs_info
;
42 static int nilfs_bmap_convert_error(struct nilfs_bmap
*bmap
,
43 const char *fname
, int err
)
45 struct inode
*inode
= bmap
->b_inode
;
48 nilfs_error(inode
->i_sb
, fname
,
49 "broken bmap (inode number=%lu)\n", inode
->i_ino
);
56 * nilfs_bmap_lookup_at_level - find a data block or node block
60 * @ptrp: place to store the value associated to @key
62 * Description: nilfs_bmap_lookup_at_level() finds a record whose key
63 * matches @key in the block at @level of the bmap.
65 * Return Value: On success, 0 is returned and the record associated with @key
66 * is stored in the place pointed by @ptrp. On error, one of the following
67 * negative error codes is returned.
71 * %-ENOMEM - Insufficient amount of memory available.
73 * %-ENOENT - A record associated with @key does not exist.
75 int nilfs_bmap_lookup_at_level(struct nilfs_bmap
*bmap
, __u64 key
, int level
,
81 down_read(&bmap
->b_sem
);
82 ret
= bmap
->b_ops
->bop_lookup(bmap
, key
, level
, ptrp
);
84 ret
= nilfs_bmap_convert_error(bmap
, __func__
, ret
);
87 if (NILFS_BMAP_USE_VBN(bmap
)) {
88 ret
= nilfs_dat_translate(nilfs_bmap_get_dat(bmap
), *ptrp
,
95 up_read(&bmap
->b_sem
);
99 int nilfs_bmap_lookup_contig(struct nilfs_bmap
*bmap
, __u64 key
, __u64
*ptrp
,
104 down_read(&bmap
->b_sem
);
105 ret
= bmap
->b_ops
->bop_lookup_contig(bmap
, key
, ptrp
, maxblocks
);
106 up_read(&bmap
->b_sem
);
108 return nilfs_bmap_convert_error(bmap
, __func__
, ret
);
111 static int nilfs_bmap_do_insert(struct nilfs_bmap
*bmap
, __u64 key
, __u64 ptr
)
113 __u64 keys
[NILFS_BMAP_SMALL_HIGH
+ 1];
114 __u64 ptrs
[NILFS_BMAP_SMALL_HIGH
+ 1];
117 if (bmap
->b_ops
->bop_check_insert
!= NULL
) {
118 ret
= bmap
->b_ops
->bop_check_insert(bmap
, key
);
120 n
= bmap
->b_ops
->bop_gather_data(
121 bmap
, keys
, ptrs
, NILFS_BMAP_SMALL_HIGH
+ 1);
124 ret
= nilfs_btree_convert_and_insert(
125 bmap
, key
, ptr
, keys
, ptrs
, n
);
127 bmap
->b_u
.u_flags
|= NILFS_BMAP_LARGE
;
134 return bmap
->b_ops
->bop_insert(bmap
, key
, ptr
);
138 * nilfs_bmap_insert - insert a new key-record pair into a bmap
143 * Description: nilfs_bmap_insert() inserts the new key-record pair specified
144 * by @key and @rec into @bmap.
146 * Return Value: On success, 0 is returned. On error, one of the following
147 * negative error codes is returned.
151 * %-ENOMEM - Insufficient amount of memory available.
153 * %-EEXIST - A record associated with @key already exist.
155 int nilfs_bmap_insert(struct nilfs_bmap
*bmap
, __u64 key
, unsigned long rec
)
159 down_write(&bmap
->b_sem
);
160 ret
= nilfs_bmap_do_insert(bmap
, key
, rec
);
161 up_write(&bmap
->b_sem
);
163 return nilfs_bmap_convert_error(bmap
, __func__
, ret
);
166 static int nilfs_bmap_do_delete(struct nilfs_bmap
*bmap
, __u64 key
)
168 __u64 keys
[NILFS_BMAP_LARGE_LOW
+ 1];
169 __u64 ptrs
[NILFS_BMAP_LARGE_LOW
+ 1];
172 if (bmap
->b_ops
->bop_check_delete
!= NULL
) {
173 ret
= bmap
->b_ops
->bop_check_delete(bmap
, key
);
175 n
= bmap
->b_ops
->bop_gather_data(
176 bmap
, keys
, ptrs
, NILFS_BMAP_LARGE_LOW
+ 1);
179 ret
= nilfs_direct_delete_and_convert(
180 bmap
, key
, keys
, ptrs
, n
);
182 bmap
->b_u
.u_flags
&= ~NILFS_BMAP_LARGE
;
189 return bmap
->b_ops
->bop_delete(bmap
, key
);
193 * nilfs_bmap_seek_key - seek a valid entry and return its key
195 * @start: start key number
196 * @keyp: place to store valid key
198 * Description: nilfs_bmap_seek_key() seeks a valid key on @bmap
199 * starting from @start, and stores it to @keyp if found.
201 * Return Value: On success, 0 is returned. On error, one of the following
202 * negative error codes is returned.
206 * %-ENOMEM - Insufficient amount of memory available.
208 * %-ENOENT - No valid entry was found
210 int nilfs_bmap_seek_key(struct nilfs_bmap
*bmap
, __u64 start
, __u64
*keyp
)
214 down_read(&bmap
->b_sem
);
215 ret
= bmap
->b_ops
->bop_seek_key(bmap
, start
, keyp
);
216 up_read(&bmap
->b_sem
);
219 ret
= nilfs_bmap_convert_error(bmap
, __func__
, ret
);
223 int nilfs_bmap_last_key(struct nilfs_bmap
*bmap
, __u64
*keyp
)
227 down_read(&bmap
->b_sem
);
228 ret
= bmap
->b_ops
->bop_last_key(bmap
, keyp
);
229 up_read(&bmap
->b_sem
);
232 ret
= nilfs_bmap_convert_error(bmap
, __func__
, ret
);
237 * nilfs_bmap_delete - delete a key-record pair from a bmap
241 * Description: nilfs_bmap_delete() deletes the key-record pair specified by
244 * Return Value: On success, 0 is returned. On error, one of the following
245 * negative error codes is returned.
249 * %-ENOMEM - Insufficient amount of memory available.
251 * %-ENOENT - A record associated with @key does not exist.
253 int nilfs_bmap_delete(struct nilfs_bmap
*bmap
, __u64 key
)
257 down_write(&bmap
->b_sem
);
258 ret
= nilfs_bmap_do_delete(bmap
, key
);
259 up_write(&bmap
->b_sem
);
261 return nilfs_bmap_convert_error(bmap
, __func__
, ret
);
264 static int nilfs_bmap_do_truncate(struct nilfs_bmap
*bmap
, __u64 key
)
269 ret
= bmap
->b_ops
->bop_last_key(bmap
, &lastkey
);
276 while (key
<= lastkey
) {
277 ret
= nilfs_bmap_do_delete(bmap
, lastkey
);
280 ret
= bmap
->b_ops
->bop_last_key(bmap
, &lastkey
);
291 * nilfs_bmap_truncate - truncate a bmap to a specified key
295 * Description: nilfs_bmap_truncate() removes key-record pairs whose keys are
296 * greater than or equal to @key from @bmap.
298 * Return Value: On success, 0 is returned. On error, one of the following
299 * negative error codes is returned.
303 * %-ENOMEM - Insufficient amount of memory available.
305 int nilfs_bmap_truncate(struct nilfs_bmap
*bmap
, __u64 key
)
309 down_write(&bmap
->b_sem
);
310 ret
= nilfs_bmap_do_truncate(bmap
, key
);
311 up_write(&bmap
->b_sem
);
313 return nilfs_bmap_convert_error(bmap
, __func__
, ret
);
317 * nilfs_bmap_clear - free resources a bmap holds
320 * Description: nilfs_bmap_clear() frees resources associated with @bmap.
322 void nilfs_bmap_clear(struct nilfs_bmap
*bmap
)
324 down_write(&bmap
->b_sem
);
325 if (bmap
->b_ops
->bop_clear
!= NULL
)
326 bmap
->b_ops
->bop_clear(bmap
);
327 up_write(&bmap
->b_sem
);
331 * nilfs_bmap_propagate - propagate dirty state
335 * Description: nilfs_bmap_propagate() marks the buffers that directly or
336 * indirectly refer to the block specified by @bh dirty.
338 * Return Value: On success, 0 is returned. On error, one of the following
339 * negative error codes is returned.
343 * %-ENOMEM - Insufficient amount of memory available.
345 int nilfs_bmap_propagate(struct nilfs_bmap
*bmap
, struct buffer_head
*bh
)
349 down_write(&bmap
->b_sem
);
350 ret
= bmap
->b_ops
->bop_propagate(bmap
, bh
);
351 up_write(&bmap
->b_sem
);
353 return nilfs_bmap_convert_error(bmap
, __func__
, ret
);
357 * nilfs_bmap_lookup_dirty_buffers -
359 * @listp: pointer to buffer head list
361 void nilfs_bmap_lookup_dirty_buffers(struct nilfs_bmap
*bmap
,
362 struct list_head
*listp
)
364 if (bmap
->b_ops
->bop_lookup_dirty_buffers
!= NULL
)
365 bmap
->b_ops
->bop_lookup_dirty_buffers(bmap
, listp
);
369 * nilfs_bmap_assign - assign a new block number to a block
371 * @bhp: pointer to buffer head
372 * @blocknr: block number
373 * @binfo: block information
375 * Description: nilfs_bmap_assign() assigns the block number @blocknr to the
376 * buffer specified by @bh.
378 * Return Value: On success, 0 is returned and the buffer head of a newly
379 * create buffer and the block information associated with the buffer are
380 * stored in the place pointed by @bh and @binfo, respectively. On error, one
381 * of the following negative error codes is returned.
385 * %-ENOMEM - Insufficient amount of memory available.
387 int nilfs_bmap_assign(struct nilfs_bmap
*bmap
,
388 struct buffer_head
**bh
,
389 unsigned long blocknr
,
390 union nilfs_binfo
*binfo
)
394 down_write(&bmap
->b_sem
);
395 ret
= bmap
->b_ops
->bop_assign(bmap
, bh
, blocknr
, binfo
);
396 up_write(&bmap
->b_sem
);
398 return nilfs_bmap_convert_error(bmap
, __func__
, ret
);
402 * nilfs_bmap_mark - mark block dirty
407 * Description: nilfs_bmap_mark() marks the block specified by @key and @level
410 * Return Value: On success, 0 is returned. On error, one of the following
411 * negative error codes is returned.
415 * %-ENOMEM - Insufficient amount of memory available.
417 int nilfs_bmap_mark(struct nilfs_bmap
*bmap
, __u64 key
, int level
)
421 if (bmap
->b_ops
->bop_mark
== NULL
)
424 down_write(&bmap
->b_sem
);
425 ret
= bmap
->b_ops
->bop_mark(bmap
, key
, level
);
426 up_write(&bmap
->b_sem
);
428 return nilfs_bmap_convert_error(bmap
, __func__
, ret
);
432 * nilfs_bmap_test_and_clear_dirty - test and clear a bmap dirty state
435 * Description: nilfs_test_and_clear() is the atomic operation to test and
436 * clear the dirty state of @bmap.
438 * Return Value: 1 is returned if @bmap is dirty, or 0 if clear.
440 int nilfs_bmap_test_and_clear_dirty(struct nilfs_bmap
*bmap
)
444 down_write(&bmap
->b_sem
);
445 ret
= nilfs_bmap_dirty(bmap
);
446 nilfs_bmap_clear_dirty(bmap
);
447 up_write(&bmap
->b_sem
);
455 __u64
nilfs_bmap_data_get_key(const struct nilfs_bmap
*bmap
,
456 const struct buffer_head
*bh
)
458 struct buffer_head
*pbh
;
461 key
= page_index(bh
->b_page
) << (PAGE_CACHE_SHIFT
-
462 bmap
->b_inode
->i_blkbits
);
463 for (pbh
= page_buffers(bh
->b_page
); pbh
!= bh
; pbh
= pbh
->b_this_page
)
469 __u64
nilfs_bmap_find_target_seq(const struct nilfs_bmap
*bmap
, __u64 key
)
473 diff
= key
- bmap
->b_last_allocated_key
;
474 if ((nilfs_bmap_keydiff_abs(diff
) < NILFS_INODE_BMAP_SIZE
) &&
475 (bmap
->b_last_allocated_ptr
!= NILFS_BMAP_INVALID_PTR
) &&
476 (bmap
->b_last_allocated_ptr
+ diff
> 0))
477 return bmap
->b_last_allocated_ptr
+ diff
;
479 return NILFS_BMAP_INVALID_PTR
;
482 #define NILFS_BMAP_GROUP_DIV 8
483 __u64
nilfs_bmap_find_target_in_group(const struct nilfs_bmap
*bmap
)
485 struct inode
*dat
= nilfs_bmap_get_dat(bmap
);
486 unsigned long entries_per_group
= nilfs_palloc_entries_per_group(dat
);
487 unsigned long group
= bmap
->b_inode
->i_ino
/ entries_per_group
;
489 return group
* entries_per_group
+
490 (bmap
->b_inode
->i_ino
% NILFS_BMAP_GROUP_DIV
) *
491 (entries_per_group
/ NILFS_BMAP_GROUP_DIV
);
494 static struct lock_class_key nilfs_bmap_dat_lock_key
;
495 static struct lock_class_key nilfs_bmap_mdt_lock_key
;
498 * nilfs_bmap_read - read a bmap from an inode
500 * @raw_inode: on-disk inode
502 * Description: nilfs_bmap_read() initializes the bmap @bmap.
504 * Return Value: On success, 0 is returned. On error, the following negative
505 * error code is returned.
507 * %-ENOMEM - Insufficient amount of memory available.
509 int nilfs_bmap_read(struct nilfs_bmap
*bmap
, struct nilfs_inode
*raw_inode
)
511 if (raw_inode
== NULL
)
512 memset(bmap
->b_u
.u_data
, 0, NILFS_BMAP_SIZE
);
514 memcpy(bmap
->b_u
.u_data
, raw_inode
->i_bmap
, NILFS_BMAP_SIZE
);
516 init_rwsem(&bmap
->b_sem
);
518 bmap
->b_inode
= &NILFS_BMAP_I(bmap
)->vfs_inode
;
519 switch (bmap
->b_inode
->i_ino
) {
521 bmap
->b_ptr_type
= NILFS_BMAP_PTR_P
;
522 bmap
->b_last_allocated_key
= 0;
523 bmap
->b_last_allocated_ptr
= NILFS_BMAP_NEW_PTR_INIT
;
524 lockdep_set_class(&bmap
->b_sem
, &nilfs_bmap_dat_lock_key
);
526 case NILFS_CPFILE_INO
:
527 case NILFS_SUFILE_INO
:
528 bmap
->b_ptr_type
= NILFS_BMAP_PTR_VS
;
529 bmap
->b_last_allocated_key
= 0;
530 bmap
->b_last_allocated_ptr
= NILFS_BMAP_INVALID_PTR
;
531 lockdep_set_class(&bmap
->b_sem
, &nilfs_bmap_mdt_lock_key
);
533 case NILFS_IFILE_INO
:
534 lockdep_set_class(&bmap
->b_sem
, &nilfs_bmap_mdt_lock_key
);
537 bmap
->b_ptr_type
= NILFS_BMAP_PTR_VM
;
538 bmap
->b_last_allocated_key
= 0;
539 bmap
->b_last_allocated_ptr
= NILFS_BMAP_INVALID_PTR
;
543 return (bmap
->b_u
.u_flags
& NILFS_BMAP_LARGE
) ?
544 nilfs_btree_init(bmap
) : nilfs_direct_init(bmap
);
548 * nilfs_bmap_write - write back a bmap to an inode
550 * @raw_inode: on-disk inode
552 * Description: nilfs_bmap_write() stores @bmap in @raw_inode.
554 void nilfs_bmap_write(struct nilfs_bmap
*bmap
, struct nilfs_inode
*raw_inode
)
556 down_write(&bmap
->b_sem
);
557 memcpy(raw_inode
->i_bmap
, bmap
->b_u
.u_data
,
558 NILFS_INODE_BMAP_SIZE
* sizeof(__le64
));
559 if (bmap
->b_inode
->i_ino
== NILFS_DAT_INO
)
560 bmap
->b_last_allocated_ptr
= NILFS_BMAP_NEW_PTR_INIT
;
562 up_write(&bmap
->b_sem
);
565 void nilfs_bmap_init_gc(struct nilfs_bmap
*bmap
)
567 memset(&bmap
->b_u
, 0, NILFS_BMAP_SIZE
);
568 init_rwsem(&bmap
->b_sem
);
569 bmap
->b_inode
= &NILFS_BMAP_I(bmap
)->vfs_inode
;
570 bmap
->b_ptr_type
= NILFS_BMAP_PTR_U
;
571 bmap
->b_last_allocated_key
= 0;
572 bmap
->b_last_allocated_ptr
= NILFS_BMAP_INVALID_PTR
;
574 nilfs_btree_init_gc(bmap
);
577 void nilfs_bmap_save(const struct nilfs_bmap
*bmap
,
578 struct nilfs_bmap_store
*store
)
580 memcpy(store
->data
, bmap
->b_u
.u_data
, sizeof(store
->data
));
581 store
->last_allocated_key
= bmap
->b_last_allocated_key
;
582 store
->last_allocated_ptr
= bmap
->b_last_allocated_ptr
;
583 store
->state
= bmap
->b_state
;
586 void nilfs_bmap_restore(struct nilfs_bmap
*bmap
,
587 const struct nilfs_bmap_store
*store
)
589 memcpy(bmap
->b_u
.u_data
, store
->data
, sizeof(store
->data
));
590 bmap
->b_last_allocated_key
= store
->last_allocated_key
;
591 bmap
->b_last_allocated_ptr
= store
->last_allocated_ptr
;
592 bmap
->b_state
= store
->state
;