2 * Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved.
3 * Copyright (C) 2004-2006 Red Hat, Inc. All rights reserved.
5 * This copyrighted material is made available to anyone wishing to use,
6 * modify, copy, or redistribute it subject to the terms and conditions
7 * of the GNU General Public License version 2.
10 #include <linux/module.h>
11 #include <linux/slab.h>
12 #include <linux/spinlock.h>
13 #include <linux/completion.h>
14 #include <linux/buffer_head.h>
15 #include <linux/gfs2_ondisk.h>
16 #include <linux/crc32.h>
17 #include <linux/crc32c.h>
18 #include <linux/ktime.h>
33 struct workqueue_struct *gfs_recovery_wq;
35 int gfs2_replay_read_block(struct gfs2_jdesc *jd, unsigned int blk,
36 struct buffer_head **bh)
38 struct gfs2_inode *ip = GFS2_I(jd->jd_inode);
39 struct gfs2_glock *gl = ip->i_gl;
45 error = gfs2_extent_map(&ip->i_inode, blk, &new, &dblock, &extlen);
49 gfs2_consist_inode(ip);
53 *bh = gfs2_meta_ra(gl, dblock, extlen);
58 int gfs2_revoke_add(struct gfs2_jdesc *jd, u64 blkno, unsigned int where)
60 struct list_head *head = &jd->jd_revoke_list;
61 struct gfs2_revoke_replay *rr;
64 list_for_each_entry(rr, head, rr_list) {
65 if (rr->rr_blkno == blkno) {
76 rr = kmalloc(sizeof(struct gfs2_revoke_replay), GFP_NOFS);
82 list_add(&rr->rr_list, head);
87 int gfs2_revoke_check(struct gfs2_jdesc *jd, u64 blkno, unsigned int where)
89 struct gfs2_revoke_replay *rr;
90 int wrap, a, b, revoke;
93 list_for_each_entry(rr, &jd->jd_revoke_list, rr_list) {
94 if (rr->rr_blkno == blkno) {
103 wrap = (rr->rr_where < jd->jd_replay_tail);
104 a = (jd->jd_replay_tail < where);
105 b = (where < rr->rr_where);
106 revoke = (wrap) ? (a || b) : (a && b);
111 void gfs2_revoke_clean(struct gfs2_jdesc *jd)
113 struct list_head *head = &jd->jd_revoke_list;
114 struct gfs2_revoke_replay *rr;
116 while (!list_empty(head)) {
117 rr = list_entry(head->next, struct gfs2_revoke_replay, rr_list);
118 list_del(&rr->rr_list);
124 * get_log_header - read the log header for a given segment
126 * @blk: the block to look at
127 * @lh: the log header to return
129 * Read the log header for a given segement in a given journal. Do a few
130 * sanity checks on it.
132 * Returns: 0 on success,
133 * 1 if the header was invalid or incomplete,
137 static int get_log_header(struct gfs2_jdesc *jd, unsigned int blk,
138 struct gfs2_log_header_host *head)
140 struct gfs2_log_header *lh;
141 struct buffer_head *bh;
145 error = gfs2_replay_read_block(jd, blk, &bh);
148 lh = (void *)bh->b_data;
150 hash = crc32(~0, lh, LH_V1_SIZE - 4);
151 hash = ~crc32_le_shift(hash, 4); /* assume lh_hash is zero */
153 crc = crc32c(~0, (void *)lh + LH_V1_SIZE + 4,
154 bh->b_size - LH_V1_SIZE - 4);
156 error = lh->lh_header.mh_magic != cpu_to_be32(GFS2_MAGIC) ||
157 lh->lh_header.mh_type != cpu_to_be32(GFS2_METATYPE_LH) ||
158 be32_to_cpu(lh->lh_blkno) != blk ||
159 be32_to_cpu(lh->lh_hash) != hash ||
160 (lh->lh_crc != 0 && be32_to_cpu(lh->lh_crc) != crc);
165 head->lh_sequence = be64_to_cpu(lh->lh_sequence);
166 head->lh_flags = be32_to_cpu(lh->lh_flags);
167 head->lh_tail = be32_to_cpu(lh->lh_tail);
168 head->lh_blkno = be32_to_cpu(lh->lh_blkno);
174 * find_good_lh - find a good log header
176 * @blk: the segment to start searching from
177 * @lh: the log header to fill in
178 * @forward: if true search forward in the log, else search backward
180 * Call get_log_header() to get a log header for a segment, but if the
181 * segment is bad, either scan forward or backward until we find a good one.
186 static int find_good_lh(struct gfs2_jdesc *jd, unsigned int *blk,
187 struct gfs2_log_header_host *head)
189 unsigned int orig_blk = *blk;
193 error = get_log_header(jd, *blk, head);
197 if (++*blk == jd->jd_blocks)
200 if (*blk == orig_blk) {
201 gfs2_consist_inode(GFS2_I(jd->jd_inode));
208 * jhead_scan - make sure we've found the head of the log
210 * @head: this is filled in with the log descriptor of the head
212 * At this point, seg and lh should be either the head of the log or just
213 * before. Scan forward until we find the head.
218 static int jhead_scan(struct gfs2_jdesc *jd, struct gfs2_log_header_host *head)
220 unsigned int blk = head->lh_blkno;
221 struct gfs2_log_header_host lh;
225 if (++blk == jd->jd_blocks)
228 error = get_log_header(jd, blk, &lh);
234 if (lh.lh_sequence == head->lh_sequence) {
235 gfs2_consist_inode(GFS2_I(jd->jd_inode));
238 if (lh.lh_sequence < head->lh_sequence)
248 * gfs2_find_jhead - find the head of a log
250 * @head: the log descriptor for the head of the log is returned here
252 * Do a binary search of a journal and find the valid log entry with the
253 * highest sequence number. (i.e. the log head)
258 int gfs2_find_jhead(struct gfs2_jdesc *jd, struct gfs2_log_header_host *head)
260 struct gfs2_log_header_host lh_1, lh_m;
261 u32 blk_1, blk_2, blk_m;
265 blk_2 = jd->jd_blocks - 1;
268 blk_m = (blk_1 + blk_2) / 2;
270 error = find_good_lh(jd, &blk_1, &lh_1);
274 error = find_good_lh(jd, &blk_m, &lh_m);
278 if (blk_1 == blk_m || blk_m == blk_2)
281 if (lh_1.lh_sequence <= lh_m.lh_sequence)
287 error = jhead_scan(jd, &lh_1);
297 * foreach_descriptor - go through the active part of the log
299 * @start: the first log header in the active region
300 * @end: the last log header (don't process the contents of this entry))
302 * Call a given function once for every log descriptor in the active
303 * portion of the log.
308 static int foreach_descriptor(struct gfs2_jdesc *jd, unsigned int start,
309 unsigned int end, int pass)
311 struct gfs2_sbd *sdp = GFS2_SB(jd->jd_inode);
312 struct buffer_head *bh;
313 struct gfs2_log_descriptor *ld;
317 unsigned int offset = sizeof(struct gfs2_log_descriptor);
318 offset += sizeof(__be64) - 1;
319 offset &= ~(sizeof(__be64) - 1);
321 while (start != end) {
322 error = gfs2_replay_read_block(jd, start, &bh);
325 if (gfs2_meta_check(sdp, bh)) {
329 ld = (struct gfs2_log_descriptor *)bh->b_data;
330 length = be32_to_cpu(ld->ld_length);
332 if (be32_to_cpu(ld->ld_header.mh_type) == GFS2_METATYPE_LH) {
333 struct gfs2_log_header_host lh;
334 error = get_log_header(jd, start, &lh);
336 gfs2_replay_incr_blk(jd, &start);
341 gfs2_consist_inode(GFS2_I(jd->jd_inode));
346 } else if (gfs2_metatype_check(sdp, bh, GFS2_METATYPE_LD)) {
350 ptr = (__be64 *)(bh->b_data + offset);
351 error = lops_scan_elements(jd, start, ld, ptr, pass);
358 gfs2_replay_incr_blk(jd, &start);
367 * clean_journal - mark a dirty journal as being clean
369 * @head: the head journal to start from
374 static void clean_journal(struct gfs2_jdesc *jd,
375 struct gfs2_log_header_host *head)
377 struct gfs2_sbd *sdp = GFS2_SB(jd->jd_inode);
379 sdp->sd_log_flush_head = head->lh_blkno;
380 gfs2_replay_incr_blk(jd, &sdp->sd_log_flush_head);
381 gfs2_write_log_header(sdp, jd, head->lh_sequence + 1, 0,
382 GFS2_LOG_HEAD_UNMOUNT | GFS2_LOG_HEAD_RECOVERY,
383 REQ_PREFLUSH | REQ_FUA | REQ_META | REQ_SYNC);
387 static void gfs2_recovery_done(struct gfs2_sbd *sdp, unsigned int jid,
388 unsigned int message)
392 char *envp[] = { env_jid, env_status, NULL };
393 struct lm_lockstruct *ls = &sdp->sd_lockstruct;
395 ls->ls_recover_jid_done = jid;
396 ls->ls_recover_jid_status = message;
397 sprintf(env_jid, "JID=%u", jid);
398 sprintf(env_status, "RECOVERY=%s",
399 message == LM_RD_SUCCESS ? "Done" : "Failed");
400 kobject_uevent_env(&sdp->sd_kobj, KOBJ_CHANGE, envp);
402 if (sdp->sd_lockstruct.ls_ops->lm_recovery_result)
403 sdp->sd_lockstruct.ls_ops->lm_recovery_result(sdp, jid, message);
406 void gfs2_recover_func(struct work_struct *work)
408 struct gfs2_jdesc *jd = container_of(work, struct gfs2_jdesc, jd_work);
409 struct gfs2_inode *ip = GFS2_I(jd->jd_inode);
410 struct gfs2_sbd *sdp = GFS2_SB(jd->jd_inode);
411 struct gfs2_log_header_host head;
412 struct gfs2_holder j_gh, ji_gh, thaw_gh;
413 ktime_t t_start, t_jlck, t_jhd, t_tlck, t_rep;
419 t_start = ktime_get();
420 if (sdp->sd_args.ar_spectator)
422 if (jd->jd_jid != sdp->sd_lockstruct.ls_jid) {
423 fs_info(sdp, "jid=%u: Trying to acquire journal lock...\n",
426 /* Acquire the journal lock so we can do recovery */
428 error = gfs2_glock_nq_num(sdp, jd->jd_jid, &gfs2_journal_glops,
430 LM_FLAG_NOEXP | LM_FLAG_TRY | GL_NOCACHE,
437 fs_info(sdp, "jid=%u: Busy\n", jd->jd_jid);
444 error = gfs2_glock_nq_init(ip->i_gl, LM_ST_SHARED,
445 LM_FLAG_NOEXP | GL_NOCACHE, &ji_gh);
449 fs_info(sdp, "jid=%u, already locked for use\n", jd->jd_jid);
452 t_jlck = ktime_get();
453 fs_info(sdp, "jid=%u: Looking at journal...\n", jd->jd_jid);
455 error = gfs2_jdesc_check(jd);
457 goto fail_gunlock_ji;
459 error = gfs2_find_jhead(jd, &head);
461 goto fail_gunlock_ji;
464 if (!(head.lh_flags & GFS2_LOG_HEAD_UNMOUNT)) {
465 fs_info(sdp, "jid=%u: Acquiring the transaction lock...\n",
468 /* Acquire a shared hold on the freeze lock */
470 error = gfs2_glock_nq_init(sdp->sd_freeze_gl, LM_ST_SHARED,
471 LM_FLAG_NOEXP | LM_FLAG_PRIORITY,
474 goto fail_gunlock_ji;
476 if (test_bit(SDF_RORECOVERY, &sdp->sd_flags)) {
478 } else if (test_bit(SDF_JOURNAL_CHECKED, &sdp->sd_flags)) {
479 if (!test_bit(SDF_JOURNAL_LIVE, &sdp->sd_flags))
482 if (sb_rdonly(sdp->sd_vfs)) {
483 /* check if device itself is read-only */
484 ro = bdev_read_only(sdp->sd_vfs->s_bdev);
486 fs_info(sdp, "recovery required on "
487 "read-only filesystem.\n");
488 fs_info(sdp, "write access will be "
489 "enabled during recovery.\n");
495 fs_warn(sdp, "jid=%u: Can't replay: read-only block "
496 "device\n", jd->jd_jid);
498 goto fail_gunlock_thaw;
501 t_tlck = ktime_get();
502 fs_info(sdp, "jid=%u: Replaying journal...\n", jd->jd_jid);
504 for (pass = 0; pass < 2; pass++) {
505 lops_before_scan(jd, &head, pass);
506 error = foreach_descriptor(jd, head.lh_tail,
507 head.lh_blkno, pass);
508 lops_after_scan(jd, error, pass);
510 goto fail_gunlock_thaw;
513 clean_journal(jd, &head);
515 gfs2_glock_dq_uninit(&thaw_gh);
517 fs_info(sdp, "jid=%u: Journal replayed in %lldms [jlck:%lldms, "
518 "jhead:%lldms, tlck:%lldms, replay:%lldms]\n",
519 jd->jd_jid, ktime_ms_delta(t_rep, t_start),
520 ktime_ms_delta(t_jlck, t_start),
521 ktime_ms_delta(t_jhd, t_jlck),
522 ktime_ms_delta(t_tlck, t_jhd),
523 ktime_ms_delta(t_rep, t_tlck));
526 gfs2_recovery_done(sdp, jd->jd_jid, LM_RD_SUCCESS);
529 gfs2_glock_dq_uninit(&ji_gh);
530 gfs2_glock_dq_uninit(&j_gh);
533 fs_info(sdp, "jid=%u: Done\n", jd->jd_jid);
537 gfs2_glock_dq_uninit(&thaw_gh);
540 gfs2_glock_dq_uninit(&ji_gh);
542 gfs2_glock_dq_uninit(&j_gh);
545 fs_info(sdp, "jid=%u: %s\n", jd->jd_jid, (error) ? "Failed" : "Done");
547 jd->jd_recover_error = error;
548 gfs2_recovery_done(sdp, jd->jd_jid, LM_RD_GAVEUP);
550 clear_bit(JDF_RECOVERY, &jd->jd_flags);
551 smp_mb__after_atomic();
552 wake_up_bit(&jd->jd_flags, JDF_RECOVERY);
555 int gfs2_recover_journal(struct gfs2_jdesc *jd, bool wait)
559 if (test_and_set_bit(JDF_RECOVERY, &jd->jd_flags))
562 /* we have JDF_RECOVERY, queue should always succeed */
563 rv = queue_work(gfs_recovery_wq, &jd->jd_work);
567 wait_on_bit(&jd->jd_flags, JDF_RECOVERY,
568 TASK_UNINTERRUPTIBLE);
570 return wait ? jd->jd_recover_error : 0;