checkpoint.c 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783
  1. /*
  2. * linux/fs/jbd2/checkpoint.c
  3. *
  4. * Written by Stephen C. Tweedie <sct@redhat.com>, 1999
  5. *
  6. * Copyright 1999 Red Hat Software --- All Rights Reserved
  7. *
  8. * This file is part of the Linux kernel and is made available under
  9. * the terms of the GNU General Public License, version 2, or at your
  10. * option, any later version, incorporated herein by reference.
  11. *
  12. * Checkpoint routines for the generic filesystem journaling code.
  13. * Part of the ext2fs journaling system.
  14. *
  15. * Checkpointing is the process of ensuring that a section of the log is
  16. * committed fully to disk, so that that portion of the log can be
  17. * reused.
  18. */
  19. #include <linux/time.h>
  20. #include <linux/fs.h>
  21. #include <linux/jbd2.h>
  22. #include <linux/errno.h>
  23. #include <linux/slab.h>
  24. #include <linux/blkdev.h>
  25. #include <trace/events/jbd2.h>
  26. /*
  27. * Unlink a buffer from a transaction checkpoint list.
  28. *
  29. * Called with j_list_lock held.
  30. */
  31. static inline void __buffer_unlink_first(struct journal_head *jh)
  32. {
  33. transaction_t *transaction = jh->b_cp_transaction;
  34. jh->b_cpnext->b_cpprev = jh->b_cpprev;
  35. jh->b_cpprev->b_cpnext = jh->b_cpnext;
  36. if (transaction->t_checkpoint_list == jh) {
  37. transaction->t_checkpoint_list = jh->b_cpnext;
  38. if (transaction->t_checkpoint_list == jh)
  39. transaction->t_checkpoint_list = NULL;
  40. }
  41. }
  42. /*
  43. * Unlink a buffer from a transaction checkpoint(io) list.
  44. *
  45. * Called with j_list_lock held.
  46. */
  47. static inline void __buffer_unlink(struct journal_head *jh)
  48. {
  49. transaction_t *transaction = jh->b_cp_transaction;
  50. __buffer_unlink_first(jh);
  51. if (transaction->t_checkpoint_io_list == jh) {
  52. transaction->t_checkpoint_io_list = jh->b_cpnext;
  53. if (transaction->t_checkpoint_io_list == jh)
  54. transaction->t_checkpoint_io_list = NULL;
  55. }
  56. }
  57. /*
  58. * Move a buffer from the checkpoint list to the checkpoint io list
  59. *
  60. * Called with j_list_lock held
  61. */
  62. static inline void __buffer_relink_io(struct journal_head *jh)
  63. {
  64. transaction_t *transaction = jh->b_cp_transaction;
  65. __buffer_unlink_first(jh);
  66. if (!transaction->t_checkpoint_io_list) {
  67. jh->b_cpnext = jh->b_cpprev = jh;
  68. } else {
  69. jh->b_cpnext = transaction->t_checkpoint_io_list;
  70. jh->b_cpprev = transaction->t_checkpoint_io_list->b_cpprev;
  71. jh->b_cpprev->b_cpnext = jh;
  72. jh->b_cpnext->b_cpprev = jh;
  73. }
  74. transaction->t_checkpoint_io_list = jh;
  75. }
  76. /*
  77. * Try to release a checkpointed buffer from its transaction.
  78. * Returns 1 if we released it and 2 if we also released the
  79. * whole transaction.
  80. *
  81. * Requires j_list_lock
  82. * Called under jbd_lock_bh_state(jh2bh(jh)), and drops it
  83. */
  84. static int __try_to_free_cp_buf(struct journal_head *jh)
  85. {
  86. int ret = 0;
  87. struct buffer_head *bh = jh2bh(jh);
  88. if (jh->b_jlist == BJ_None && !buffer_locked(bh) &&
  89. !buffer_dirty(bh) && !buffer_write_io_error(bh)) {
  90. JBUFFER_TRACE(jh, "remove from checkpoint list");
  91. ret = __jbd2_journal_remove_checkpoint(jh) + 1;
  92. jbd_unlock_bh_state(bh);
  93. jbd2_journal_remove_journal_head(bh);
  94. BUFFER_TRACE(bh, "release");
  95. __brelse(bh);
  96. } else {
  97. jbd_unlock_bh_state(bh);
  98. }
  99. return ret;
  100. }
  101. /*
  102. * __jbd2_log_wait_for_space: wait until there is space in the journal.
  103. *
  104. * Called under j-state_lock *only*. It will be unlocked if we have to wait
  105. * for a checkpoint to free up some space in the log.
  106. */
  107. void __jbd2_log_wait_for_space(journal_t *journal)
  108. {
  109. int nblocks, space_left;
  110. assert_spin_locked(&journal->j_state_lock);
  111. nblocks = jbd_space_needed(journal);
  112. while (__jbd2_log_space_left(journal) < nblocks) {
  113. if (journal->j_flags & JBD2_ABORT)
  114. return;
  115. spin_unlock(&journal->j_state_lock);
  116. mutex_lock(&journal->j_checkpoint_mutex);
  117. /*
  118. * Test again, another process may have checkpointed while we
  119. * were waiting for the checkpoint lock. If there are no
  120. * transactions ready to be checkpointed, try to recover
  121. * journal space by calling cleanup_journal_tail(), and if
  122. * that doesn't work, by waiting for the currently committing
  123. * transaction to complete. If there is absolutely no way
  124. * to make progress, this is either a BUG or corrupted
  125. * filesystem, so abort the journal and leave a stack
  126. * trace for forensic evidence.
  127. */
  128. spin_lock(&journal->j_state_lock);
  129. spin_lock(&journal->j_list_lock);
  130. nblocks = jbd_space_needed(journal);
  131. space_left = __jbd2_log_space_left(journal);
  132. if (space_left < nblocks) {
  133. int chkpt = journal->j_checkpoint_transactions != NULL;
  134. tid_t tid = 0;
  135. if (journal->j_committing_transaction)
  136. tid = journal->j_committing_transaction->t_tid;
  137. spin_unlock(&journal->j_list_lock);
  138. spin_unlock(&journal->j_state_lock);
  139. if (chkpt) {
  140. jbd2_log_do_checkpoint(journal);
  141. } else if (jbd2_cleanup_journal_tail(journal) == 0) {
  142. /* We were able to recover space; yay! */
  143. ;
  144. } else if (tid) {
  145. jbd2_log_wait_commit(journal, tid);
  146. } else {
  147. printk(KERN_ERR "%s: needed %d blocks and "
  148. "only had %d space available\n",
  149. __func__, nblocks, space_left);
  150. printk(KERN_ERR "%s: no way to get more "
  151. "journal space in %s\n", __func__,
  152. journal->j_devname);
  153. WARN_ON(1);
  154. jbd2_journal_abort(journal, 0);
  155. }
  156. spin_lock(&journal->j_state_lock);
  157. } else {
  158. spin_unlock(&journal->j_list_lock);
  159. }
  160. mutex_unlock(&journal->j_checkpoint_mutex);
  161. }
  162. }
  163. /*
  164. * We were unable to perform jbd_trylock_bh_state() inside j_list_lock.
  165. * The caller must restart a list walk. Wait for someone else to run
  166. * jbd_unlock_bh_state().
  167. */
  168. static void jbd_sync_bh(journal_t *journal, struct buffer_head *bh)
  169. __releases(journal->j_list_lock)
  170. {
  171. get_bh(bh);
  172. spin_unlock(&journal->j_list_lock);
  173. jbd_lock_bh_state(bh);
  174. jbd_unlock_bh_state(bh);
  175. put_bh(bh);
  176. }
  177. /*
  178. * Clean up transaction's list of buffers submitted for io.
  179. * We wait for any pending IO to complete and remove any clean
  180. * buffers. Note that we take the buffers in the opposite ordering
  181. * from the one in which they were submitted for IO.
  182. *
  183. * Return 0 on success, and return <0 if some buffers have failed
  184. * to be written out.
  185. *
  186. * Called with j_list_lock held.
  187. */
  188. static int __wait_cp_io(journal_t *journal, transaction_t *transaction)
  189. {
  190. struct journal_head *jh;
  191. struct buffer_head *bh;
  192. tid_t this_tid;
  193. int released = 0;
  194. int ret = 0;
  195. this_tid = transaction->t_tid;
  196. restart:
  197. /* Did somebody clean up the transaction in the meanwhile? */
  198. if (journal->j_checkpoint_transactions != transaction ||
  199. transaction->t_tid != this_tid)
  200. return ret;
  201. while (!released && transaction->t_checkpoint_io_list) {
  202. jh = transaction->t_checkpoint_io_list;
  203. bh = jh2bh(jh);
  204. if (!jbd_trylock_bh_state(bh)) {
  205. jbd_sync_bh(journal, bh);
  206. spin_lock(&journal->j_list_lock);
  207. goto restart;
  208. }
  209. if (buffer_locked(bh)) {
  210. atomic_inc(&bh->b_count);
  211. spin_unlock(&journal->j_list_lock);
  212. jbd_unlock_bh_state(bh);
  213. wait_on_buffer(bh);
  214. /* the journal_head may have gone by now */
  215. BUFFER_TRACE(bh, "brelse");
  216. __brelse(bh);
  217. spin_lock(&journal->j_list_lock);
  218. goto restart;
  219. }
  220. if (unlikely(buffer_write_io_error(bh)))
  221. ret = -EIO;
  222. /*
  223. * Now in whatever state the buffer currently is, we know that
  224. * it has been written out and so we can drop it from the list
  225. */
  226. released = __jbd2_journal_remove_checkpoint(jh);
  227. jbd_unlock_bh_state(bh);
  228. jbd2_journal_remove_journal_head(bh);
  229. __brelse(bh);
  230. }
  231. return ret;
  232. }
  233. static void
  234. __flush_batch(journal_t *journal, int *batch_count)
  235. {
  236. int i;
  237. ll_rw_block(SWRITE, *batch_count, journal->j_chkpt_bhs);
  238. for (i = 0; i < *batch_count; i++) {
  239. struct buffer_head *bh = journal->j_chkpt_bhs[i];
  240. clear_buffer_jwrite(bh);
  241. BUFFER_TRACE(bh, "brelse");
  242. __brelse(bh);
  243. }
  244. *batch_count = 0;
  245. }
  246. /*
  247. * Try to flush one buffer from the checkpoint list to disk.
  248. *
  249. * Return 1 if something happened which requires us to abort the current
  250. * scan of the checkpoint list. Return <0 if the buffer has failed to
  251. * be written out.
  252. *
  253. * Called with j_list_lock held and drops it if 1 is returned
  254. * Called under jbd_lock_bh_state(jh2bh(jh)), and drops it
  255. */
  256. static int __process_buffer(journal_t *journal, struct journal_head *jh,
  257. int *batch_count, transaction_t *transaction)
  258. {
  259. struct buffer_head *bh = jh2bh(jh);
  260. int ret = 0;
  261. if (buffer_locked(bh)) {
  262. atomic_inc(&bh->b_count);
  263. spin_unlock(&journal->j_list_lock);
  264. jbd_unlock_bh_state(bh);
  265. wait_on_buffer(bh);
  266. /* the journal_head may have gone by now */
  267. BUFFER_TRACE(bh, "brelse");
  268. __brelse(bh);
  269. ret = 1;
  270. } else if (jh->b_transaction != NULL) {
  271. transaction_t *t = jh->b_transaction;
  272. tid_t tid = t->t_tid;
  273. transaction->t_chp_stats.cs_forced_to_close++;
  274. spin_unlock(&journal->j_list_lock);
  275. jbd_unlock_bh_state(bh);
  276. jbd2_log_start_commit(journal, tid);
  277. jbd2_log_wait_commit(journal, tid);
  278. ret = 1;
  279. } else if (!buffer_dirty(bh)) {
  280. ret = 1;
  281. if (unlikely(buffer_write_io_error(bh)))
  282. ret = -EIO;
  283. J_ASSERT_JH(jh, !buffer_jbddirty(bh));
  284. BUFFER_TRACE(bh, "remove from checkpoint");
  285. __jbd2_journal_remove_checkpoint(jh);
  286. spin_unlock(&journal->j_list_lock);
  287. jbd_unlock_bh_state(bh);
  288. jbd2_journal_remove_journal_head(bh);
  289. __brelse(bh);
  290. } else {
  291. /*
  292. * Important: we are about to write the buffer, and
  293. * possibly block, while still holding the journal lock.
  294. * We cannot afford to let the transaction logic start
  295. * messing around with this buffer before we write it to
  296. * disk, as that would break recoverability.
  297. */
  298. BUFFER_TRACE(bh, "queue");
  299. get_bh(bh);
  300. J_ASSERT_BH(bh, !buffer_jwrite(bh));
  301. set_buffer_jwrite(bh);
  302. journal->j_chkpt_bhs[*batch_count] = bh;
  303. __buffer_relink_io(jh);
  304. jbd_unlock_bh_state(bh);
  305. transaction->t_chp_stats.cs_written++;
  306. (*batch_count)++;
  307. if (*batch_count == JBD2_NR_BATCH) {
  308. spin_unlock(&journal->j_list_lock);
  309. __flush_batch(journal, batch_count);
  310. ret = 1;
  311. }
  312. }
  313. return ret;
  314. }
  315. /*
  316. * Perform an actual checkpoint. We take the first transaction on the
  317. * list of transactions to be checkpointed and send all its buffers
  318. * to disk. We submit larger chunks of data at once.
  319. *
  320. * The journal should be locked before calling this function.
  321. * Called with j_checkpoint_mutex held.
  322. */
  323. int jbd2_log_do_checkpoint(journal_t *journal)
  324. {
  325. transaction_t *transaction;
  326. tid_t this_tid;
  327. int result;
  328. jbd_debug(1, "Start checkpoint\n");
  329. /*
  330. * First thing: if there are any transactions in the log which
  331. * don't need checkpointing, just eliminate them from the
  332. * journal straight away.
  333. */
  334. result = jbd2_cleanup_journal_tail(journal);
  335. trace_jbd2_checkpoint(journal, result);
  336. jbd_debug(1, "cleanup_journal_tail returned %d\n", result);
  337. if (result <= 0)
  338. return result;
  339. /*
  340. * OK, we need to start writing disk blocks. Take one transaction
  341. * and write it.
  342. */
  343. result = 0;
  344. spin_lock(&journal->j_list_lock);
  345. if (!journal->j_checkpoint_transactions)
  346. goto out;
  347. transaction = journal->j_checkpoint_transactions;
  348. if (transaction->t_chp_stats.cs_chp_time == 0)
  349. transaction->t_chp_stats.cs_chp_time = jiffies;
  350. this_tid = transaction->t_tid;
  351. restart:
  352. /*
  353. * If someone cleaned up this transaction while we slept, we're
  354. * done (maybe it's a new transaction, but it fell at the same
  355. * address).
  356. */
  357. if (journal->j_checkpoint_transactions == transaction &&
  358. transaction->t_tid == this_tid) {
  359. int batch_count = 0;
  360. struct journal_head *jh;
  361. int retry = 0, err;
  362. while (!retry && transaction->t_checkpoint_list) {
  363. struct buffer_head *bh;
  364. jh = transaction->t_checkpoint_list;
  365. bh = jh2bh(jh);
  366. if (!jbd_trylock_bh_state(bh)) {
  367. jbd_sync_bh(journal, bh);
  368. retry = 1;
  369. break;
  370. }
  371. retry = __process_buffer(journal, jh, &batch_count,
  372. transaction);
  373. if (retry < 0 && !result)
  374. result = retry;
  375. if (!retry && (need_resched() ||
  376. spin_needbreak(&journal->j_list_lock))) {
  377. spin_unlock(&journal->j_list_lock);
  378. retry = 1;
  379. break;
  380. }
  381. }
  382. if (batch_count) {
  383. if (!retry) {
  384. spin_unlock(&journal->j_list_lock);
  385. retry = 1;
  386. }
  387. __flush_batch(journal, &batch_count);
  388. }
  389. if (retry) {
  390. spin_lock(&journal->j_list_lock);
  391. goto restart;
  392. }
  393. /*
  394. * Now we have cleaned up the first transaction's checkpoint
  395. * list. Let's clean up the second one
  396. */
  397. err = __wait_cp_io(journal, transaction);
  398. if (!result)
  399. result = err;
  400. }
  401. out:
  402. spin_unlock(&journal->j_list_lock);
  403. if (result < 0)
  404. jbd2_journal_abort(journal, result);
  405. else
  406. result = jbd2_cleanup_journal_tail(journal);
  407. return (result < 0) ? result : 0;
  408. }
  409. /*
  410. * Check the list of checkpoint transactions for the journal to see if
  411. * we have already got rid of any since the last update of the log tail
  412. * in the journal superblock. If so, we can instantly roll the
  413. * superblock forward to remove those transactions from the log.
  414. *
  415. * Return <0 on error, 0 on success, 1 if there was nothing to clean up.
  416. *
  417. * Called with the journal lock held.
  418. *
  419. * This is the only part of the journaling code which really needs to be
  420. * aware of transaction aborts. Checkpointing involves writing to the
  421. * main filesystem area rather than to the journal, so it can proceed
  422. * even in abort state, but we must not update the super block if
  423. * checkpointing may have failed. Otherwise, we would lose some metadata
  424. * buffers which should be written-back to the filesystem.
  425. */
  426. int jbd2_cleanup_journal_tail(journal_t *journal)
  427. {
  428. transaction_t * transaction;
  429. tid_t first_tid;
  430. unsigned long blocknr, freed;
  431. if (is_journal_aborted(journal))
  432. return 1;
  433. /* OK, work out the oldest transaction remaining in the log, and
  434. * the log block it starts at.
  435. *
  436. * If the log is now empty, we need to work out which is the
  437. * next transaction ID we will write, and where it will
  438. * start. */
  439. spin_lock(&journal->j_state_lock);
  440. spin_lock(&journal->j_list_lock);
  441. transaction = journal->j_checkpoint_transactions;
  442. if (transaction) {
  443. first_tid = transaction->t_tid;
  444. blocknr = transaction->t_log_start;
  445. } else if ((transaction = journal->j_committing_transaction) != NULL) {
  446. first_tid = transaction->t_tid;
  447. blocknr = transaction->t_log_start;
  448. } else if ((transaction = journal->j_running_transaction) != NULL) {
  449. first_tid = transaction->t_tid;
  450. blocknr = journal->j_head;
  451. } else {
  452. first_tid = journal->j_transaction_sequence;
  453. blocknr = journal->j_head;
  454. }
  455. spin_unlock(&journal->j_list_lock);
  456. J_ASSERT(blocknr != 0);
  457. /* If the oldest pinned transaction is at the tail of the log
  458. already then there's not much we can do right now. */
  459. if (journal->j_tail_sequence == first_tid) {
  460. spin_unlock(&journal->j_state_lock);
  461. return 1;
  462. }
  463. /* OK, update the superblock to recover the freed space.
  464. * Physical blocks come first: have we wrapped beyond the end of
  465. * the log? */
  466. freed = blocknr - journal->j_tail;
  467. if (blocknr < journal->j_tail)
  468. freed = freed + journal->j_last - journal->j_first;
  469. trace_jbd2_cleanup_journal_tail(journal, first_tid, blocknr, freed);
  470. jbd_debug(1,
  471. "Cleaning journal tail from %d to %d (offset %lu), "
  472. "freeing %lu\n",
  473. journal->j_tail_sequence, first_tid, blocknr, freed);
  474. journal->j_free += freed;
  475. journal->j_tail_sequence = first_tid;
  476. journal->j_tail = blocknr;
  477. spin_unlock(&journal->j_state_lock);
  478. /*
  479. * If there is an external journal, we need to make sure that
  480. * any data blocks that were recently written out --- perhaps
  481. * by jbd2_log_do_checkpoint() --- are flushed out before we
  482. * drop the transactions from the external journal. It's
  483. * unlikely this will be necessary, especially with a
  484. * appropriately sized journal, but we need this to guarantee
  485. * correctness. Fortunately jbd2_cleanup_journal_tail()
  486. * doesn't get called all that often.
  487. */
  488. if ((journal->j_fs_dev != journal->j_dev) &&
  489. (journal->j_flags & JBD2_BARRIER))
  490. blkdev_issue_flush(journal->j_fs_dev, GFP_KERNEL, NULL,
  491. BLKDEV_IFL_WAIT);
  492. if (!(journal->j_flags & JBD2_ABORT))
  493. jbd2_journal_update_superblock(journal, 1);
  494. return 0;
  495. }
  496. /* Checkpoint list management */
  497. /*
  498. * journal_clean_one_cp_list
  499. *
  500. * Find all the written-back checkpoint buffers in the given list and release them.
  501. *
  502. * Called with the journal locked.
  503. * Called with j_list_lock held.
  504. * Returns number of bufers reaped (for debug)
  505. */
  506. static int journal_clean_one_cp_list(struct journal_head *jh, int *released)
  507. {
  508. struct journal_head *last_jh;
  509. struct journal_head *next_jh = jh;
  510. int ret, freed = 0;
  511. *released = 0;
  512. if (!jh)
  513. return 0;
  514. last_jh = jh->b_cpprev;
  515. do {
  516. jh = next_jh;
  517. next_jh = jh->b_cpnext;
  518. /* Use trylock because of the ranking */
  519. if (jbd_trylock_bh_state(jh2bh(jh))) {
  520. ret = __try_to_free_cp_buf(jh);
  521. if (ret) {
  522. freed++;
  523. if (ret == 2) {
  524. *released = 1;
  525. return freed;
  526. }
  527. }
  528. }
  529. /*
  530. * This function only frees up some memory
  531. * if possible so we dont have an obligation
  532. * to finish processing. Bail out if preemption
  533. * requested:
  534. */
  535. if (need_resched())
  536. return freed;
  537. } while (jh != last_jh);
  538. return freed;
  539. }
  540. /*
  541. * journal_clean_checkpoint_list
  542. *
  543. * Find all the written-back checkpoint buffers in the journal and release them.
  544. *
  545. * Called with the journal locked.
  546. * Called with j_list_lock held.
  547. * Returns number of buffers reaped (for debug)
  548. */
  549. int __jbd2_journal_clean_checkpoint_list(journal_t *journal)
  550. {
  551. transaction_t *transaction, *last_transaction, *next_transaction;
  552. int ret = 0;
  553. int released;
  554. transaction = journal->j_checkpoint_transactions;
  555. if (!transaction)
  556. goto out;
  557. last_transaction = transaction->t_cpprev;
  558. next_transaction = transaction;
  559. do {
  560. transaction = next_transaction;
  561. next_transaction = transaction->t_cpnext;
  562. ret += journal_clean_one_cp_list(transaction->
  563. t_checkpoint_list, &released);
  564. /*
  565. * This function only frees up some memory if possible so we
  566. * dont have an obligation to finish processing. Bail out if
  567. * preemption requested:
  568. */
  569. if (need_resched())
  570. goto out;
  571. if (released)
  572. continue;
  573. /*
  574. * It is essential that we are as careful as in the case of
  575. * t_checkpoint_list with removing the buffer from the list as
  576. * we can possibly see not yet submitted buffers on io_list
  577. */
  578. ret += journal_clean_one_cp_list(transaction->
  579. t_checkpoint_io_list, &released);
  580. if (need_resched())
  581. goto out;
  582. } while (transaction != last_transaction);
  583. out:
  584. return ret;
  585. }
  586. /*
  587. * journal_remove_checkpoint: called after a buffer has been committed
  588. * to disk (either by being write-back flushed to disk, or being
  589. * committed to the log).
  590. *
  591. * We cannot safely clean a transaction out of the log until all of the
  592. * buffer updates committed in that transaction have safely been stored
  593. * elsewhere on disk. To achieve this, all of the buffers in a
  594. * transaction need to be maintained on the transaction's checkpoint
  595. * lists until they have been rewritten, at which point this function is
  596. * called to remove the buffer from the existing transaction's
  597. * checkpoint lists.
  598. *
  599. * The function returns 1 if it frees the transaction, 0 otherwise.
  600. *
  601. * This function is called with the journal locked.
  602. * This function is called with j_list_lock held.
  603. * This function is called with jbd_lock_bh_state(jh2bh(jh))
  604. */
  605. int __jbd2_journal_remove_checkpoint(struct journal_head *jh)
  606. {
  607. struct transaction_chp_stats_s *stats;
  608. transaction_t *transaction;
  609. journal_t *journal;
  610. int ret = 0;
  611. JBUFFER_TRACE(jh, "entry");
  612. if ((transaction = jh->b_cp_transaction) == NULL) {
  613. JBUFFER_TRACE(jh, "not on transaction");
  614. goto out;
  615. }
  616. journal = transaction->t_journal;
  617. __buffer_unlink(jh);
  618. jh->b_cp_transaction = NULL;
  619. if (transaction->t_checkpoint_list != NULL ||
  620. transaction->t_checkpoint_io_list != NULL)
  621. goto out;
  622. JBUFFER_TRACE(jh, "transaction has no more buffers");
  623. /*
  624. * There is one special case to worry about: if we have just pulled the
  625. * buffer off a running or committing transaction's checkpoing list,
  626. * then even if the checkpoint list is empty, the transaction obviously
  627. * cannot be dropped!
  628. *
  629. * The locking here around t_state is a bit sleazy.
  630. * See the comment at the end of jbd2_journal_commit_transaction().
  631. */
  632. if (transaction->t_state != T_FINISHED) {
  633. JBUFFER_TRACE(jh, "belongs to running/committing transaction");
  634. goto out;
  635. }
  636. /* OK, that was the last buffer for the transaction: we can now
  637. safely remove this transaction from the log */
  638. stats = &transaction->t_chp_stats;
  639. if (stats->cs_chp_time)
  640. stats->cs_chp_time = jbd2_time_diff(stats->cs_chp_time,
  641. jiffies);
  642. trace_jbd2_checkpoint_stats(journal->j_fs_dev->bd_dev,
  643. transaction->t_tid, stats);
  644. __jbd2_journal_drop_transaction(journal, transaction);
  645. kfree(transaction);
  646. /* Just in case anybody was waiting for more transactions to be
  647. checkpointed... */
  648. wake_up(&journal->j_wait_logspace);
  649. ret = 1;
  650. out:
  651. JBUFFER_TRACE(jh, "exit");
  652. return ret;
  653. }
  654. /*
  655. * journal_insert_checkpoint: put a committed buffer onto a checkpoint
  656. * list so that we know when it is safe to clean the transaction out of
  657. * the log.
  658. *
  659. * Called with the journal locked.
  660. * Called with j_list_lock held.
  661. */
  662. void __jbd2_journal_insert_checkpoint(struct journal_head *jh,
  663. transaction_t *transaction)
  664. {
  665. JBUFFER_TRACE(jh, "entry");
  666. J_ASSERT_JH(jh, buffer_dirty(jh2bh(jh)) || buffer_jbddirty(jh2bh(jh)));
  667. J_ASSERT_JH(jh, jh->b_cp_transaction == NULL);
  668. jh->b_cp_transaction = transaction;
  669. if (!transaction->t_checkpoint_list) {
  670. jh->b_cpnext = jh->b_cpprev = jh;
  671. } else {
  672. jh->b_cpnext = transaction->t_checkpoint_list;
  673. jh->b_cpprev = transaction->t_checkpoint_list->b_cpprev;
  674. jh->b_cpprev->b_cpnext = jh;
  675. jh->b_cpnext->b_cpprev = jh;
  676. }
  677. transaction->t_checkpoint_list = jh;
  678. }
  679. /*
  680. * We've finished with this transaction structure: adios...
  681. *
  682. * The transaction must have no links except for the checkpoint by this
  683. * point.
  684. *
  685. * Called with the journal locked.
  686. * Called with j_list_lock held.
  687. */
  688. void __jbd2_journal_drop_transaction(journal_t *journal, transaction_t *transaction)
  689. {
  690. assert_spin_locked(&journal->j_list_lock);
  691. if (transaction->t_cpnext) {
  692. transaction->t_cpnext->t_cpprev = transaction->t_cpprev;
  693. transaction->t_cpprev->t_cpnext = transaction->t_cpnext;
  694. if (journal->j_checkpoint_transactions == transaction)
  695. journal->j_checkpoint_transactions =
  696. transaction->t_cpnext;
  697. if (journal->j_checkpoint_transactions == transaction)
  698. journal->j_checkpoint_transactions = NULL;
  699. }
  700. J_ASSERT(transaction->t_state == T_FINISHED);
  701. J_ASSERT(transaction->t_buffers == NULL);
  702. J_ASSERT(transaction->t_forget == NULL);
  703. J_ASSERT(transaction->t_iobuf_list == NULL);
  704. J_ASSERT(transaction->t_shadow_list == NULL);
  705. J_ASSERT(transaction->t_log_list == NULL);
  706. J_ASSERT(transaction->t_checkpoint_list == NULL);
  707. J_ASSERT(transaction->t_checkpoint_io_list == NULL);
  708. J_ASSERT(transaction->t_updates == 0);
  709. J_ASSERT(journal->j_committing_transaction != transaction);
  710. J_ASSERT(journal->j_running_transaction != transaction);
  711. jbd_debug(1, "Dropping transaction %d, all done\n", transaction->t_tid);
  712. }