transaction.c 32.1 KB
Newer Older
C
Chris Mason 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
/*
 * Copyright (C) 2007 Oracle.  All rights reserved.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public
 * License v2 as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public
 * License along with this program; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 021110-1307, USA.
 */

C
Chris Mason 已提交
19
#include <linux/fs.h>
20
#include <linux/slab.h>
C
Chris Mason 已提交
21
#include <linux/sched.h>
22
#include <linux/writeback.h>
23
#include <linux/pagemap.h>
24
#include <linux/blkdev.h>
C
Chris Mason 已提交
25 26 27
#include "ctree.h"
#include "disk-io.h"
#include "transaction.h"
28
#include "locking.h"
29
#include "tree-log.h"
C
Chris Mason 已提交
30

31 32
#define BTRFS_ROOT_TRANS_TAG 0

33
static noinline void put_transaction(struct btrfs_transaction *transaction)
C
Chris Mason 已提交
34
{
C
Chris Mason 已提交
35
	WARN_ON(transaction->use_count == 0);
C
Chris Mason 已提交
36
	transaction->use_count--;
C
Chris Mason 已提交
37
	if (transaction->use_count == 0) {
C
Chris Mason 已提交
38
		list_del_init(&transaction->list);
C
Chris Mason 已提交
39 40
		memset(transaction, 0, sizeof(*transaction));
		kmem_cache_free(btrfs_transaction_cachep, transaction);
C
Chris Mason 已提交
41
	}
C
Chris Mason 已提交
42 43
}

J
Josef Bacik 已提交
44 45 46 47 48 49
static noinline void switch_commit_root(struct btrfs_root *root)
{
	free_extent_buffer(root->commit_root);
	root->commit_root = btrfs_root_node(root);
}

C
Chris Mason 已提交
50 51 52
/*
 * either allocate a new transaction or hop into the existing one
 */
53
static noinline int join_transaction(struct btrfs_root *root)
C
Chris Mason 已提交
54 55 56 57
{
	struct btrfs_transaction *cur_trans;
	cur_trans = root->fs_info->running_transaction;
	if (!cur_trans) {
C
Chris Mason 已提交
58 59
		cur_trans = kmem_cache_alloc(btrfs_transaction_cachep,
					     GFP_NOFS);
C
Chris Mason 已提交
60
		BUG_ON(!cur_trans);
61
		root->fs_info->generation++;
62 63
		cur_trans->num_writers = 1;
		cur_trans->num_joined = 0;
64
		cur_trans->transid = root->fs_info->generation;
C
Chris Mason 已提交
65 66 67
		init_waitqueue_head(&cur_trans->writer_wait);
		init_waitqueue_head(&cur_trans->commit_wait);
		cur_trans->in_commit = 0;
68
		cur_trans->blocked = 0;
69
		cur_trans->use_count = 1;
C
Chris Mason 已提交
70
		cur_trans->commit_done = 0;
C
Chris Mason 已提交
71
		cur_trans->start_time = get_seconds();
72

73
		cur_trans->delayed_refs.root = RB_ROOT;
74
		cur_trans->delayed_refs.num_entries = 0;
75 76
		cur_trans->delayed_refs.num_heads_ready = 0;
		cur_trans->delayed_refs.num_heads = 0;
77
		cur_trans->delayed_refs.flushing = 0;
78
		cur_trans->delayed_refs.run_delayed_start = 0;
79 80
		spin_lock_init(&cur_trans->delayed_refs.lock);

81
		INIT_LIST_HEAD(&cur_trans->pending_snapshots);
C
Chris Mason 已提交
82
		list_add_tail(&cur_trans->list, &root->fs_info->trans_list);
83
		extent_io_tree_init(&cur_trans->dirty_pages,
84 85
				     root->fs_info->btree_inode->i_mapping,
				     GFP_NOFS);
86 87 88
		spin_lock(&root->fs_info->new_trans_lock);
		root->fs_info->running_transaction = cur_trans;
		spin_unlock(&root->fs_info->new_trans_lock);
89 90 91
	} else {
		cur_trans->num_writers++;
		cur_trans->num_joined++;
C
Chris Mason 已提交
92
	}
93

C
Chris Mason 已提交
94 95 96
	return 0;
}

C
Chris Mason 已提交
97
/*
C
Chris Mason 已提交
98 99 100 101
 * this does all the record keeping required to make sure that a reference
 * counted root is properly recorded in a given transaction.  This is required
 * to make sure the old root from before we joined the transaction is deleted
 * when the transaction commits
C
Chris Mason 已提交
102
 */
103 104
static noinline int record_root_in_trans(struct btrfs_trans_handle *trans,
					 struct btrfs_root *root)
105
{
106
	if (root->ref_cows && root->last_trans < trans->transid) {
107
		WARN_ON(root == root->fs_info->extent_root);
108 109 110 111 112 113 114 115 116 117
		WARN_ON(root->commit_root != root->node);

		radix_tree_tag_set(&root->fs_info->fs_roots_radix,
			   (unsigned long)root->root_key.objectid,
			   BTRFS_ROOT_TRANS_TAG);
		root->last_trans = trans->transid;
		btrfs_init_reloc_root(trans, root);
	}
	return 0;
}
118

119 120 121 122 123
int btrfs_record_root_in_trans(struct btrfs_trans_handle *trans,
			       struct btrfs_root *root)
{
	if (!root->ref_cows)
		return 0;
124

125 126 127 128
	mutex_lock(&root->fs_info->trans_mutex);
	if (root->last_trans == trans->transid) {
		mutex_unlock(&root->fs_info->trans_mutex);
		return 0;
129
	}
130 131 132

	record_root_in_trans(trans, root);
	mutex_unlock(&root->fs_info->trans_mutex);
133 134 135
	return 0;
}

C
Chris Mason 已提交
136 137 138 139
/* wait for commit against the current transaction to become unblocked
 * when this is done, it is safe to start a new transaction, but the current
 * transaction might not be fully on disk.
 */
C
Chris Mason 已提交
140
static void wait_current_trans(struct btrfs_root *root)
C
Chris Mason 已提交
141
{
142
	struct btrfs_transaction *cur_trans;
C
Chris Mason 已提交
143

144
	cur_trans = root->fs_info->running_transaction;
C
Chris Mason 已提交
145
	if (cur_trans && cur_trans->blocked) {
146 147
		DEFINE_WAIT(wait);
		cur_trans->use_count++;
C
Chris Mason 已提交
148
		while (1) {
149 150
			prepare_to_wait(&root->fs_info->transaction_wait, &wait,
					TASK_UNINTERRUPTIBLE);
151
			if (!cur_trans->blocked)
152
				break;
153 154 155
			mutex_unlock(&root->fs_info->trans_mutex);
			schedule();
			mutex_lock(&root->fs_info->trans_mutex);
156
		}
157
		finish_wait(&root->fs_info->transaction_wait, &wait);
158 159
		put_transaction(cur_trans);
	}
C
Chris Mason 已提交
160 161
}

162 163 164 165
enum btrfs_trans_type {
	TRANS_START,
	TRANS_JOIN,
	TRANS_USERSPACE,
166
	TRANS_JOIN_NOLOCK,
167 168
};

169 170 171 172 173 174 175 176 177
static int may_wait_transaction(struct btrfs_root *root, int type)
{
	if (!root->fs_info->log_root_recovering &&
	    ((type == TRANS_START && !root->fs_info->open_ioctl_trans) ||
	     type == TRANS_USERSPACE))
		return 1;
	return 0;
}

178
static struct btrfs_trans_handle *start_transaction(struct btrfs_root *root,
179
						    u64 num_items, int type)
C
Chris Mason 已提交
180
{
181 182
	struct btrfs_trans_handle *h;
	struct btrfs_transaction *cur_trans;
C
Chris Mason 已提交
183
	int ret;
184 185 186 187
again:
	h = kmem_cache_alloc(btrfs_trans_handle_cachep, GFP_NOFS);
	if (!h)
		return ERR_PTR(-ENOMEM);
C
Chris Mason 已提交
188

189 190
	if (type != TRANS_JOIN_NOLOCK)
		mutex_lock(&root->fs_info->trans_mutex);
191
	if (may_wait_transaction(root, type))
C
Chris Mason 已提交
192
		wait_current_trans(root);
193

C
Chris Mason 已提交
194 195
	ret = join_transaction(root);
	BUG_ON(ret);
196

197 198
	cur_trans = root->fs_info->running_transaction;
	cur_trans->use_count++;
199 200
	if (type != TRANS_JOIN_NOLOCK)
		mutex_unlock(&root->fs_info->trans_mutex);
201 202 203

	h->transid = cur_trans->transid;
	h->transaction = cur_trans;
C
Chris Mason 已提交
204
	h->blocks_used = 0;
205
	h->block_group = 0;
206
	h->bytes_reserved = 0;
207
	h->delayed_ref_updates = 0;
208
	h->block_rsv = NULL;
209

210 211 212 213 214 215 216
	smp_mb();
	if (cur_trans->blocked && may_wait_transaction(root, type)) {
		btrfs_commit_transaction(h, root);
		goto again;
	}

	if (num_items > 0) {
217
		ret = btrfs_trans_reserve_metadata(h, root, num_items);
218 219 220 221 222 223 224 225 226
		if (ret == -EAGAIN) {
			btrfs_commit_transaction(h, root);
			goto again;
		}
		if (ret < 0) {
			btrfs_end_transaction(h, root);
			return ERR_PTR(ret);
		}
	}
J
Josef Bacik 已提交
227

228 229
	if (type != TRANS_JOIN_NOLOCK)
		mutex_lock(&root->fs_info->trans_mutex);
230
	record_root_in_trans(h, root);
231 232
	if (type != TRANS_JOIN_NOLOCK)
		mutex_unlock(&root->fs_info->trans_mutex);
233 234 235

	if (!current->journal_info && type != TRANS_USERSPACE)
		current->journal_info = h;
C
Chris Mason 已提交
236 237 238
	return h;
}

239
struct btrfs_trans_handle *btrfs_start_transaction(struct btrfs_root *root,
240
						   int num_items)
241
{
242
	return start_transaction(root, num_items, TRANS_START);
243 244 245 246
}
struct btrfs_trans_handle *btrfs_join_transaction(struct btrfs_root *root,
						   int num_blocks)
{
247
	return start_transaction(root, 0, TRANS_JOIN);
248 249
}

250 251 252 253 254 255
struct btrfs_trans_handle *btrfs_join_transaction_nolock(struct btrfs_root *root,
							  int num_blocks)
{
	return start_transaction(root, 0, TRANS_JOIN_NOLOCK);
}

256 257 258
struct btrfs_trans_handle *btrfs_start_ioctl_transaction(struct btrfs_root *r,
							 int num_blocks)
{
259
	return start_transaction(r, 0, TRANS_USERSPACE);
260 261
}

C
Chris Mason 已提交
262
/* wait for a transaction commit to be fully complete */
263 264 265 266 267
static noinline int wait_for_commit(struct btrfs_root *root,
				    struct btrfs_transaction *commit)
{
	DEFINE_WAIT(wait);
	mutex_lock(&root->fs_info->trans_mutex);
C
Chris Mason 已提交
268
	while (!commit->commit_done) {
269 270 271 272 273 274 275 276 277 278 279 280 281
		prepare_to_wait(&commit->commit_wait, &wait,
				TASK_UNINTERRUPTIBLE);
		if (commit->commit_done)
			break;
		mutex_unlock(&root->fs_info->trans_mutex);
		schedule();
		mutex_lock(&root->fs_info->trans_mutex);
	}
	mutex_unlock(&root->fs_info->trans_mutex);
	finish_wait(&commit->commit_wait, &wait);
	return 0;
}

282
#if 0
C
Chris Mason 已提交
283
/*
C
Chris Mason 已提交
284 285
 * rate limit against the drop_snapshot code.  This helps to slow down new
 * operations if the drop_snapshot code isn't able to keep up.
C
Chris Mason 已提交
286
 */
C
Chris Mason 已提交
287
static void throttle_on_drops(struct btrfs_root *root)
288 289
{
	struct btrfs_fs_info *info = root->fs_info;
C
Chris Mason 已提交
290
	int harder_count = 0;
291

C
Chris Mason 已提交
292
harder:
293 294 295 296 297 298 299 300 301 302 303 304 305 306 307
	if (atomic_read(&info->throttles)) {
		DEFINE_WAIT(wait);
		int thr;
		thr = atomic_read(&info->throttle_gen);

		do {
			prepare_to_wait(&info->transaction_throttle,
					&wait, TASK_UNINTERRUPTIBLE);
			if (!atomic_read(&info->throttles)) {
				finish_wait(&info->transaction_throttle, &wait);
				break;
			}
			schedule();
			finish_wait(&info->transaction_throttle, &wait);
		} while (thr == atomic_read(&info->throttle_gen));
C
Chris Mason 已提交
308 309 310 311 312 313 314 315 316 317 318 319 320
		harder_count++;

		if (root->fs_info->total_ref_cache_size > 1 * 1024 * 1024 &&
		    harder_count < 2)
			goto harder;

		if (root->fs_info->total_ref_cache_size > 5 * 1024 * 1024 &&
		    harder_count < 10)
			goto harder;

		if (root->fs_info->total_ref_cache_size > 10 * 1024 * 1024 &&
		    harder_count < 20)
			goto harder;
321 322
	}
}
323
#endif
324

C
Chris Mason 已提交
325 326 327
void btrfs_throttle(struct btrfs_root *root)
{
	mutex_lock(&root->fs_info->trans_mutex);
328 329
	if (!root->fs_info->open_ioctl_trans)
		wait_current_trans(root);
C
Chris Mason 已提交
330 331 332
	mutex_unlock(&root->fs_info->trans_mutex);
}

333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358
static int should_end_transaction(struct btrfs_trans_handle *trans,
				  struct btrfs_root *root)
{
	int ret;
	ret = btrfs_block_rsv_check(trans, root,
				    &root->fs_info->global_block_rsv, 0, 5);
	return ret ? 1 : 0;
}

int btrfs_should_end_transaction(struct btrfs_trans_handle *trans,
				 struct btrfs_root *root)
{
	struct btrfs_transaction *cur_trans = trans->transaction;
	int updates;

	if (cur_trans->blocked || cur_trans->delayed_refs.flushing)
		return 1;

	updates = trans->delayed_ref_updates;
	trans->delayed_ref_updates = 0;
	if (updates)
		btrfs_run_delayed_refs(trans, root, updates);

	return should_end_transaction(trans, root);
}

359
static int __btrfs_end_transaction(struct btrfs_trans_handle *trans,
360
			  struct btrfs_root *root, int throttle, int lock)
C
Chris Mason 已提交
361
{
362
	struct btrfs_transaction *cur_trans = trans->transaction;
363
	struct btrfs_fs_info *info = root->fs_info;
364 365 366 367 368 369 370 371
	int count = 0;

	while (count < 4) {
		unsigned long cur = trans->delayed_ref_updates;
		trans->delayed_ref_updates = 0;
		if (cur &&
		    trans->transaction->delayed_refs.num_heads_ready > 64) {
			trans->delayed_ref_updates = 0;
372 373 374 375 376 377 378

			/*
			 * do a full flush if the transaction is trying
			 * to close
			 */
			if (trans->transaction->delayed_refs.flushing)
				cur = 0;
379 380 381 382 383
			btrfs_run_delayed_refs(trans, root, cur);
		} else {
			break;
		}
		count++;
384 385
	}

386 387
	btrfs_trans_release_metadata(trans, root);

388
	if (lock && !root->fs_info->open_ioctl_trans &&
389 390 391
	    should_end_transaction(trans, root))
		trans->transaction->blocked = 1;

392
	if (lock && cur_trans->blocked && !cur_trans->in_commit) {
393 394 395 396 397 398
		if (throttle)
			return btrfs_commit_transaction(trans, root);
		else
			wake_up_process(info->transaction_kthread);
	}

399 400
	if (lock)
		mutex_lock(&info->trans_mutex);
401
	WARN_ON(cur_trans != info->running_transaction);
402
	WARN_ON(cur_trans->num_writers < 1);
C
Chris Mason 已提交
403
	cur_trans->num_writers--;
404

C
Chris Mason 已提交
405 406 407
	if (waitqueue_active(&cur_trans->writer_wait))
		wake_up(&cur_trans->writer_wait);
	put_transaction(cur_trans);
408 409
	if (lock)
		mutex_unlock(&info->trans_mutex);
J
Josef Bacik 已提交
410 411 412

	if (current->journal_info == trans)
		current->journal_info = NULL;
C
Chris Mason 已提交
413
	memset(trans, 0, sizeof(*trans));
C
Chris Mason 已提交
414
	kmem_cache_free(btrfs_trans_handle_cachep, trans);
415

Y
Yan, Zheng 已提交
416 417 418
	if (throttle)
		btrfs_run_delayed_iputs(root);

C
Chris Mason 已提交
419 420 421
	return 0;
}

422 423 424
int btrfs_end_transaction(struct btrfs_trans_handle *trans,
			  struct btrfs_root *root)
{
425
	return __btrfs_end_transaction(trans, root, 0, 1);
426 427 428 429 430
}

int btrfs_end_transaction_throttle(struct btrfs_trans_handle *trans,
				   struct btrfs_root *root)
{
431 432 433 434 435 436 437
	return __btrfs_end_transaction(trans, root, 1, 1);
}

int btrfs_end_transaction_nolock(struct btrfs_trans_handle *trans,
				 struct btrfs_root *root)
{
	return __btrfs_end_transaction(trans, root, 0, 0);
438 439
}

C
Chris Mason 已提交
440 441 442
/*
 * when btree blocks are allocated, they have some corresponding bits set for
 * them in one of two extent_io trees.  This is used to make sure all of
443
 * those extents are sent to disk but does not wait on them
C
Chris Mason 已提交
444
 */
445
int btrfs_write_marked_extents(struct btrfs_root *root,
446
			       struct extent_io_tree *dirty_pages, int mark)
C
Chris Mason 已提交
447
{
448
	int ret;
449
	int err = 0;
450 451 452
	int werr = 0;
	struct page *page;
	struct inode *btree_inode = root->fs_info->btree_inode;
453
	u64 start = 0;
454 455
	u64 end;
	unsigned long index;
456

C
Chris Mason 已提交
457
	while (1) {
458
		ret = find_first_extent_bit(dirty_pages, start, &start, &end,
459
					    mark);
460
		if (ret)
461
			break;
C
Chris Mason 已提交
462
		while (start <= end) {
463 464
			cond_resched();

465
			index = start >> PAGE_CACHE_SHIFT;
466
			start = (u64)(index + 1) << PAGE_CACHE_SHIFT;
C
Chris Mason 已提交
467
			page = find_get_page(btree_inode->i_mapping, index);
468 469
			if (!page)
				continue;
C
Chris Mason 已提交
470 471 472 473 474 475 476 477

			btree_lock_page_hook(page);
			if (!page->mapping) {
				unlock_page(page);
				page_cache_release(page);
				continue;
			}

478 479 480 481 482 483 484 485 486
			if (PageWriteback(page)) {
				if (PageDirty(page))
					wait_on_page_writeback(page);
				else {
					unlock_page(page);
					page_cache_release(page);
					continue;
				}
			}
487 488 489 490 491 492
			err = write_one_page(page, 0);
			if (err)
				werr = err;
			page_cache_release(page);
		}
	}
493 494 495 496 497 498 499 500 501 502 503 504
	if (err)
		werr = err;
	return werr;
}

/*
 * when btree blocks are allocated, they have some corresponding bits set for
 * them in one of two extent_io trees.  This is used to make sure all of
 * those extents are on disk for transaction or log commit.  We wait
 * on all the pages and clear them from the dirty pages state tree
 */
int btrfs_wait_marked_extents(struct btrfs_root *root,
505
			      struct extent_io_tree *dirty_pages, int mark)
506 507 508 509 510 511 512 513 514 515
{
	int ret;
	int err = 0;
	int werr = 0;
	struct page *page;
	struct inode *btree_inode = root->fs_info->btree_inode;
	u64 start = 0;
	u64 end;
	unsigned long index;

C
Chris Mason 已提交
516
	while (1) {
517 518
		ret = find_first_extent_bit(dirty_pages, start, &start, &end,
					    mark);
519 520 521
		if (ret)
			break;

522
		clear_extent_bits(dirty_pages, start, end, mark, GFP_NOFS);
C
Chris Mason 已提交
523
		while (start <= end) {
524 525 526 527 528 529
			index = start >> PAGE_CACHE_SHIFT;
			start = (u64)(index + 1) << PAGE_CACHE_SHIFT;
			page = find_get_page(btree_inode->i_mapping, index);
			if (!page)
				continue;
			if (PageDirty(page)) {
C
Chris Mason 已提交
530 531
				btree_lock_page_hook(page);
				wait_on_page_writeback(page);
532 533 534 535
				err = write_one_page(page, 0);
				if (err)
					werr = err;
			}
536
			wait_on_page_writeback(page);
537 538 539 540
			page_cache_release(page);
			cond_resched();
		}
	}
541 542 543
	if (err)
		werr = err;
	return werr;
C
Chris Mason 已提交
544 545
}

546 547 548 549 550 551
/*
 * when btree blocks are allocated, they have some corresponding bits set for
 * them in one of two extent_io trees.  This is used to make sure all of
 * those extents are on disk for transaction or log commit
 */
int btrfs_write_and_wait_marked_extents(struct btrfs_root *root,
552
				struct extent_io_tree *dirty_pages, int mark)
553 554 555 556
{
	int ret;
	int ret2;

557 558
	ret = btrfs_write_marked_extents(root, dirty_pages, mark);
	ret2 = btrfs_wait_marked_extents(root, dirty_pages, mark);
559 560 561
	return ret || ret2;
}

562 563 564 565 566 567 568 569 570
int btrfs_write_and_wait_transaction(struct btrfs_trans_handle *trans,
				     struct btrfs_root *root)
{
	if (!trans || !trans->transaction) {
		struct inode *btree_inode;
		btree_inode = root->fs_info->btree_inode;
		return filemap_write_and_wait(btree_inode->i_mapping);
	}
	return btrfs_write_and_wait_marked_extents(root,
571 572
					   &trans->transaction->dirty_pages,
					   EXTENT_DIRTY);
573 574
}

C
Chris Mason 已提交
575 576 577 578 579 580 581 582 583 584
/*
 * this is used to update the root pointer in the tree of tree roots.
 *
 * But, in the case of the extent allocation tree, updating the root
 * pointer may allocate blocks which may change the root of the extent
 * allocation tree.
 *
 * So, this loops and repeats and makes sure the cowonly root didn't
 * change while the root pointer was being updated in the metadata.
 */
585 586
static int update_cowonly_root(struct btrfs_trans_handle *trans,
			       struct btrfs_root *root)
C
Chris Mason 已提交
587 588
{
	int ret;
589
	u64 old_root_bytenr;
590
	u64 old_root_used;
591
	struct btrfs_root *tree_root = root->fs_info->tree_root;
C
Chris Mason 已提交
592

593
	old_root_used = btrfs_root_used(&root->root_item);
594
	btrfs_write_dirty_block_groups(trans, root);
595

C
Chris Mason 已提交
596
	while (1) {
597
		old_root_bytenr = btrfs_root_bytenr(&root->root_item);
598 599
		if (old_root_bytenr == root->node->start &&
		    old_root_used == btrfs_root_used(&root->root_item))
C
Chris Mason 已提交
600
			break;
601

602
		btrfs_set_root_node(&root->root_item, root->node);
C
Chris Mason 已提交
603
		ret = btrfs_update_root(trans, tree_root,
604 605
					&root->root_key,
					&root->root_item);
C
Chris Mason 已提交
606
		BUG_ON(ret);
607

608
		old_root_used = btrfs_root_used(&root->root_item);
609
		ret = btrfs_write_dirty_block_groups(trans, root);
610
		BUG_ON(ret);
611
	}
612 613 614 615

	if (root != root->fs_info->extent_root)
		switch_commit_root(root);

616 617 618
	return 0;
}

C
Chris Mason 已提交
619 620 621
/*
 * update all the cowonly tree roots on disk
 */
622 623
static noinline int commit_cowonly_roots(struct btrfs_trans_handle *trans,
					 struct btrfs_root *root)
624 625 626
{
	struct btrfs_fs_info *fs_info = root->fs_info;
	struct list_head *next;
627
	struct extent_buffer *eb;
628
	int ret;
629

630 631
	ret = btrfs_run_delayed_refs(trans, root, (unsigned long)-1);
	BUG_ON(ret);
632

633
	eb = btrfs_lock_root_node(fs_info->tree_root);
634
	btrfs_cow_block(trans, fs_info->tree_root, eb, NULL, 0, &eb);
635 636
	btrfs_tree_unlock(eb);
	free_extent_buffer(eb);
637

638 639
	ret = btrfs_run_delayed_refs(trans, root, (unsigned long)-1);
	BUG_ON(ret);
640

C
Chris Mason 已提交
641
	while (!list_empty(&fs_info->dirty_cowonly_roots)) {
642 643 644
		next = fs_info->dirty_cowonly_roots.next;
		list_del_init(next);
		root = list_entry(next, struct btrfs_root, dirty_list);
645

646
		update_cowonly_root(trans, root);
C
Chris Mason 已提交
647
	}
648 649 650 651 652

	down_write(&fs_info->extent_commit_sem);
	switch_commit_root(fs_info->extent_root);
	up_write(&fs_info->extent_commit_sem);

C
Chris Mason 已提交
653 654 655
	return 0;
}

C
Chris Mason 已提交
656 657 658 659 660
/*
 * dead roots are old snapshots that need to be deleted.  This allocates
 * a dirty root struct and adds it into the list of dead roots that need to
 * be deleted
 */
661
int btrfs_add_dead_root(struct btrfs_root *root)
662
{
Y
Yan Zheng 已提交
663
	mutex_lock(&root->fs_info->trans_mutex);
664
	list_add(&root->root_list, &root->fs_info->dead_roots);
Y
Yan Zheng 已提交
665
	mutex_unlock(&root->fs_info->trans_mutex);
666 667 668
	return 0;
}

C
Chris Mason 已提交
669
/*
670
 * update all the cowonly tree roots on disk
C
Chris Mason 已提交
671
 */
672 673
static noinline int commit_fs_roots(struct btrfs_trans_handle *trans,
				    struct btrfs_root *root)
674 675
{
	struct btrfs_root *gang[8];
676
	struct btrfs_fs_info *fs_info = root->fs_info;
677 678
	int i;
	int ret;
679 680
	int err = 0;

C
Chris Mason 已提交
681
	while (1) {
682 683
		ret = radix_tree_gang_lookup_tag(&fs_info->fs_roots_radix,
						 (void **)gang, 0,
684 685 686 687 688 689
						 ARRAY_SIZE(gang),
						 BTRFS_ROOT_TRANS_TAG);
		if (ret == 0)
			break;
		for (i = 0; i < ret; i++) {
			root = gang[i];
690 691 692
			radix_tree_tag_clear(&fs_info->fs_roots_radix,
					(unsigned long)root->root_key.objectid,
					BTRFS_ROOT_TRANS_TAG);
Y
Yan Zheng 已提交
693

694
			btrfs_free_log(trans, root);
695
			btrfs_update_reloc_root(trans, root);
696
			btrfs_orphan_commit_root(trans, root);
697

698
			if (root->commit_root != root->node) {
J
Josef Bacik 已提交
699
				switch_commit_root(root);
700 701 702
				btrfs_set_root_node(&root->root_item,
						    root->node);
			}
703 704

			err = btrfs_update_root(trans, fs_info->tree_root,
705 706
						&root->root_key,
						&root->root_item);
707 708
			if (err)
				break;
709 710
		}
	}
711
	return err;
712 713
}

C
Chris Mason 已提交
714 715 716 717
/*
 * defrag a given btree.  If cacheonly == 1, this won't read from the disk,
 * otherwise every leaf in the btree is read and defragged.
 */
718 719 720 721
int btrfs_defrag_root(struct btrfs_root *root, int cacheonly)
{
	struct btrfs_fs_info *info = root->fs_info;
	struct btrfs_trans_handle *trans;
722
	int ret;
723
	unsigned long nr;
724

725
	if (xchg(&root->defrag_running, 1))
726
		return 0;
727

728
	while (1) {
729 730 731 732
		trans = btrfs_start_transaction(root, 0);
		if (IS_ERR(trans))
			return PTR_ERR(trans);

733
		ret = btrfs_defrag_leaves(trans, root, cacheonly);
734

735
		nr = trans->blocks_used;
736
		btrfs_end_transaction(trans, root);
737
		btrfs_btree_balance_dirty(info->tree_root, nr);
738 739
		cond_resched();

740
		if (root->fs_info->closing || ret != -EAGAIN)
741 742 743
			break;
	}
	root->defrag_running = 0;
744
	return ret;
745 746
}

747
#if 0
748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764
/*
 * when dropping snapshots, we generate a ton of delayed refs, and it makes
 * sense not to join the transaction while it is trying to flush the current
 * queue of delayed refs out.
 *
 * This is used by the drop snapshot code only
 */
static noinline int wait_transaction_pre_flush(struct btrfs_fs_info *info)
{
	DEFINE_WAIT(wait);

	mutex_lock(&info->trans_mutex);
	while (info->running_transaction &&
	       info->running_transaction->delayed_refs.flushing) {
		prepare_to_wait(&info->transaction_wait, &wait,
				TASK_UNINTERRUPTIBLE);
		mutex_unlock(&info->trans_mutex);
765

766
		schedule();
767

768 769 770 771 772 773 774
		mutex_lock(&info->trans_mutex);
		finish_wait(&info->transaction_wait, &wait);
	}
	mutex_unlock(&info->trans_mutex);
	return 0;
}

C
Chris Mason 已提交
775 776 777 778
/*
 * Given a list of roots that need to be deleted, call btrfs_drop_snapshot on
 * all of them
 */
779
int btrfs_drop_dead_root(struct btrfs_root *root)
780 781
{
	struct btrfs_trans_handle *trans;
782
	struct btrfs_root *tree_root = root->fs_info->tree_root;
783
	unsigned long nr;
784
	int ret;
785

786 787 788 789 790 791 792
	while (1) {
		/*
		 * we don't want to jump in and create a bunch of
		 * delayed refs if the transaction is starting to close
		 */
		wait_transaction_pre_flush(tree_root->fs_info);
		trans = btrfs_start_transaction(tree_root, 1);
793

794 795 796 797 798 799 800
		/*
		 * we've joined a transaction, make sure it isn't
		 * closing right now
		 */
		if (trans->transaction->delayed_refs.flushing) {
			btrfs_end_transaction(trans, tree_root);
			continue;
801
		}
802

803 804 805
		ret = btrfs_drop_snapshot(trans, root);
		if (ret != -EAGAIN)
			break;
806

807 808 809 810
		ret = btrfs_update_root(trans, tree_root,
					&root->root_key,
					&root->root_item);
		if (ret)
811
			break;
812

813
		nr = trans->blocks_used;
814 815
		ret = btrfs_end_transaction(trans, tree_root);
		BUG_ON(ret);
816

817
		btrfs_btree_balance_dirty(tree_root, nr);
818
		cond_resched();
819
	}
820 821 822 823 824 825 826 827 828 829 830 831 832 833
	BUG_ON(ret);

	ret = btrfs_del_root(trans, tree_root, &root->root_key);
	BUG_ON(ret);

	nr = trans->blocks_used;
	ret = btrfs_end_transaction(trans, tree_root);
	BUG_ON(ret);

	free_extent_buffer(root->node);
	free_extent_buffer(root->commit_root);
	kfree(root);

	btrfs_btree_balance_dirty(tree_root, nr);
834
	return ret;
835
}
836
#endif
837

C
Chris Mason 已提交
838 839 840 841
/*
 * new snapshots need to be created at a very specific time in the
 * transaction commit.  This does the actual creation
 */
842
static noinline int create_pending_snapshot(struct btrfs_trans_handle *trans,
843 844 845 846
				   struct btrfs_fs_info *fs_info,
				   struct btrfs_pending_snapshot *pending)
{
	struct btrfs_key key;
847
	struct btrfs_root_item *new_root_item;
848 849
	struct btrfs_root *tree_root = fs_info->tree_root;
	struct btrfs_root *root = pending->root;
850 851
	struct btrfs_root *parent_root;
	struct inode *parent_inode;
852
	struct dentry *dentry;
853
	struct extent_buffer *tmp;
854
	struct extent_buffer *old;
855
	int ret;
856
	u64 to_reserve = 0;
857
	u64 index = 0;
858
	u64 objectid;
859

860 861
	new_root_item = kmalloc(sizeof(*new_root_item), GFP_NOFS);
	if (!new_root_item) {
862
		pending->error = -ENOMEM;
863 864
		goto fail;
	}
865

866
	ret = btrfs_find_free_objectid(trans, tree_root, 0, &objectid);
867 868
	if (ret) {
		pending->error = ret;
869
		goto fail;
870
	}
871

872
	btrfs_reloc_pre_snapshot(trans, pending, &to_reserve);
873 874 875 876
	btrfs_orphan_pre_snapshot(trans, pending, &to_reserve);

	if (to_reserve > 0) {
		ret = btrfs_block_rsv_add(trans, root, &pending->block_rsv,
877
					  to_reserve);
878 879 880 881 882 883
		if (ret) {
			pending->error = ret;
			goto fail;
		}
	}

884
	key.objectid = objectid;
885 886
	key.offset = (u64)-1;
	key.type = BTRFS_ROOT_ITEM_KEY;
887

888
	trans->block_rsv = &pending->block_rsv;
889

890 891 892
	dentry = pending->dentry;
	parent_inode = dentry->d_parent->d_inode;
	parent_root = BTRFS_I(parent_inode)->root;
893
	record_root_in_trans(trans, parent_root);
894

895 896 897
	/*
	 * insert the directory item
	 */
898
	ret = btrfs_set_inode_index(parent_inode, &index);
899
	BUG_ON(ret);
900
	ret = btrfs_insert_dir_item(trans, parent_root,
901 902 903
				dentry->d_name.name, dentry->d_name.len,
				parent_inode->i_ino, &key,
				BTRFS_FT_DIR, index);
904
	BUG_ON(ret);
905

906 907
	btrfs_i_size_write(parent_inode, parent_inode->i_size +
					 dentry->d_name.len * 2);
908 909 910
	ret = btrfs_update_inode(trans, parent_root, parent_inode);
	BUG_ON(ret);

911 912 913 914 915 916 917 918 919 920 921 922 923
	record_root_in_trans(trans, root);
	btrfs_set_root_last_snapshot(&root->root_item, trans->transid);
	memcpy(new_root_item, &root->root_item, sizeof(*new_root_item));

	old = btrfs_lock_root_node(root);
	btrfs_cow_block(trans, root, old, NULL, 0, &old);
	btrfs_set_lock_blocking(old);

	btrfs_copy_root(trans, root, old, &tmp, objectid);
	btrfs_tree_unlock(old);
	free_extent_buffer(old);

	btrfs_set_root_node(new_root_item, tmp);
924 925 926
	/* record when the snapshot was created in key.offset */
	key.offset = trans->transid;
	ret = btrfs_insert_root(trans, tree_root, &key, new_root_item);
927 928
	btrfs_tree_unlock(tmp);
	free_extent_buffer(tmp);
929
	BUG_ON(ret);
930

931 932 933 934
	/*
	 * insert root back/forward references
	 */
	ret = btrfs_add_root_ref(trans, tree_root, objectid,
935
				 parent_root->root_key.objectid,
936 937
				 parent_inode->i_ino, index,
				 dentry->d_name.name, dentry->d_name.len);
938 939
	BUG_ON(ret);

940 941 942
	key.offset = (u64)-1;
	pending->snap = btrfs_read_fs_root_no_name(root->fs_info, &key);
	BUG_ON(IS_ERR(pending->snap));
943

944
	btrfs_reloc_post_snapshot(trans, pending);
945
	btrfs_orphan_post_snapshot(trans, pending);
946
fail:
947
	kfree(new_root_item);
948 949
	btrfs_block_rsv_release(root, &pending->block_rsv, (u64)-1);
	return 0;
950 951
}

C
Chris Mason 已提交
952 953 954
/*
 * create all the snapshots we've scheduled for creation
 */
955 956
static noinline int create_pending_snapshots(struct btrfs_trans_handle *trans,
					     struct btrfs_fs_info *fs_info)
957 958 959 960 961
{
	struct btrfs_pending_snapshot *pending;
	struct list_head *head = &trans->transaction->pending_snapshots;
	int ret;

Q
Qinghuang Feng 已提交
962
	list_for_each_entry(pending, head, list) {
963 964 965 966 967 968
		ret = create_pending_snapshot(trans, fs_info, pending);
		BUG_ON(ret);
	}
	return 0;
}

969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984
static void update_super_roots(struct btrfs_root *root)
{
	struct btrfs_root_item *root_item;
	struct btrfs_super_block *super;

	super = &root->fs_info->super_copy;

	root_item = &root->fs_info->chunk_root->root_item;
	super->chunk_root = root_item->bytenr;
	super->chunk_root_generation = root_item->generation;
	super->chunk_root_level = root_item->level;

	root_item = &root->fs_info->tree_root->root_item;
	super->root = root_item->bytenr;
	super->generation = root_item->generation;
	super->root_level = root_item->level;
985 986
	if (super->cache_generation != 0 || btrfs_test_opt(root, SPACE_CACHE))
		super->cache_generation = root_item->generation;
987 988
}

989 990 991 992 993 994 995 996 997 998
int btrfs_transaction_in_commit(struct btrfs_fs_info *info)
{
	int ret = 0;
	spin_lock(&info->new_trans_lock);
	if (info->running_transaction)
		ret = info->running_transaction->in_commit;
	spin_unlock(&info->new_trans_lock);
	return ret;
}

999 1000 1001 1002 1003 1004 1005 1006 1007 1008
int btrfs_transaction_blocked(struct btrfs_fs_info *info)
{
	int ret = 0;
	spin_lock(&info->new_trans_lock);
	if (info->running_transaction)
		ret = info->running_transaction->blocked;
	spin_unlock(&info->new_trans_lock);
	return ret;
}

C
Chris Mason 已提交
1009 1010 1011
int btrfs_commit_transaction(struct btrfs_trans_handle *trans,
			     struct btrfs_root *root)
{
1012 1013
	unsigned long joined = 0;
	unsigned long timeout = 1;
C
Chris Mason 已提交
1014
	struct btrfs_transaction *cur_trans;
C
Chris Mason 已提交
1015
	struct btrfs_transaction *prev_trans = NULL;
C
Chris Mason 已提交
1016
	DEFINE_WAIT(wait);
1017
	int ret;
1018 1019
	int should_grow = 0;
	unsigned long now = get_seconds();
1020
	int flush_on_commit = btrfs_test_opt(root, FLUSHONCOMMIT);
C
Chris Mason 已提交
1021

1022 1023
	btrfs_run_ordered_operations(root, 0);

1024 1025 1026 1027 1028 1029
	/* make a pass through all the delayed refs we have so far
	 * any runnings procs may add more while we are here
	 */
	ret = btrfs_run_delayed_refs(trans, root, 0);
	BUG_ON(ret);

1030 1031
	btrfs_trans_release_metadata(trans, root);

1032
	cur_trans = trans->transaction;
1033 1034 1035 1036
	/*
	 * set the flushing flag so procs in this transaction have to
	 * start sending their work down.
	 */
1037
	cur_trans->delayed_refs.flushing = 1;
1038

1039
	ret = btrfs_run_delayed_refs(trans, root, 0);
1040 1041
	BUG_ON(ret);

C
Chris Mason 已提交
1042
	mutex_lock(&root->fs_info->trans_mutex);
1043 1044
	if (cur_trans->in_commit) {
		cur_trans->use_count++;
C
Chris Mason 已提交
1045
		mutex_unlock(&root->fs_info->trans_mutex);
C
Chris Mason 已提交
1046
		btrfs_end_transaction(trans, root);
C
Chris Mason 已提交
1047

C
Chris Mason 已提交
1048 1049
		ret = wait_for_commit(root, cur_trans);
		BUG_ON(ret);
1050 1051

		mutex_lock(&root->fs_info->trans_mutex);
C
Chris Mason 已提交
1052
		put_transaction(cur_trans);
1053 1054
		mutex_unlock(&root->fs_info->trans_mutex);

C
Chris Mason 已提交
1055 1056
		return 0;
	}
1057

C
Chris Mason 已提交
1058
	trans->transaction->in_commit = 1;
1059
	trans->transaction->blocked = 1;
C
Chris Mason 已提交
1060 1061 1062 1063 1064 1065 1066 1067 1068 1069
	if (cur_trans->list.prev != &root->fs_info->trans_list) {
		prev_trans = list_entry(cur_trans->list.prev,
					struct btrfs_transaction, list);
		if (!prev_trans->commit_done) {
			prev_trans->use_count++;
			mutex_unlock(&root->fs_info->trans_mutex);

			wait_for_commit(root, prev_trans);

			mutex_lock(&root->fs_info->trans_mutex);
1070
			put_transaction(prev_trans);
C
Chris Mason 已提交
1071 1072
		}
	}
1073

1074 1075 1076
	if (now < cur_trans->start_time || now - cur_trans->start_time < 1)
		should_grow = 1;

1077
	do {
1078
		int snap_pending = 0;
1079
		joined = cur_trans->num_joined;
1080 1081 1082
		if (!list_empty(&trans->transaction->pending_snapshots))
			snap_pending = 1;

C
Chris Mason 已提交
1083
		WARN_ON(cur_trans != trans->transaction);
1084 1085
		if (cur_trans->num_writers > 1)
			timeout = MAX_SCHEDULE_TIMEOUT;
1086
		else if (should_grow)
1087 1088
			timeout = 1;

C
Chris Mason 已提交
1089
		mutex_unlock(&root->fs_info->trans_mutex);
1090

1091
		if (flush_on_commit || snap_pending) {
Y
Yan, Zheng 已提交
1092 1093
			btrfs_start_delalloc_inodes(root, 1);
			ret = btrfs_wait_ordered_extents(root, 0, 1);
1094
			BUG_ON(ret);
1095 1096
		}

1097 1098 1099 1100 1101 1102 1103 1104 1105
		/*
		 * rename don't use btrfs_join_transaction, so, once we
		 * set the transaction to blocked above, we aren't going
		 * to get any new ordered operations.  We can safely run
		 * it here and no for sure that nothing new will be added
		 * to the list
		 */
		btrfs_run_ordered_operations(root, 1);

1106 1107 1108
		prepare_to_wait(&cur_trans->writer_wait, &wait,
				TASK_UNINTERRUPTIBLE);

1109 1110 1111
		smp_mb();
		if (cur_trans->num_writers > 1 || should_grow)
			schedule_timeout(timeout);
1112

C
Chris Mason 已提交
1113
		mutex_lock(&root->fs_info->trans_mutex);
1114 1115
		finish_wait(&cur_trans->writer_wait, &wait);
	} while (cur_trans->num_writers > 1 ||
1116
		 (should_grow && cur_trans->num_joined != joined));
1117

1118 1119 1120
	ret = create_pending_snapshots(trans, root->fs_info);
	BUG_ON(ret);

1121 1122 1123
	ret = btrfs_run_delayed_refs(trans, root, (unsigned long)-1);
	BUG_ON(ret);

C
Chris Mason 已提交
1124
	WARN_ON(cur_trans != trans->transaction);
C
Chris Mason 已提交
1125

1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140
	/* btrfs_commit_tree_roots is responsible for getting the
	 * various roots consistent with each other.  Every pointer
	 * in the tree of tree roots has to point to the most up to date
	 * root for every subvolume and other tree.  So, we have to keep
	 * the tree logging code from jumping in and changing any
	 * of the trees.
	 *
	 * At this point in the commit, there can't be any tree-log
	 * writers, but a little lower down we drop the trans mutex
	 * and let new people in.  By holding the tree_log_mutex
	 * from now until after the super is written, we avoid races
	 * with the tree-log code.
	 */
	mutex_lock(&root->fs_info->tree_log_mutex);

1141
	ret = commit_fs_roots(trans, root);
1142 1143
	BUG_ON(ret);

1144
	/* commit_fs_roots gets rid of all the tree log roots, it is now
1145 1146 1147 1148
	 * safe to free the root of tree log roots
	 */
	btrfs_free_log_root_tree(trans, root->fs_info);

1149
	ret = commit_cowonly_roots(trans, root);
C
Chris Mason 已提交
1150
	BUG_ON(ret);
1151

1152 1153
	btrfs_prepare_extent_commit(trans, root);

C
Chris Mason 已提交
1154
	cur_trans = root->fs_info->running_transaction;
1155
	spin_lock(&root->fs_info->new_trans_lock);
C
Chris Mason 已提交
1156
	root->fs_info->running_transaction = NULL;
1157
	spin_unlock(&root->fs_info->new_trans_lock);
1158 1159 1160

	btrfs_set_root_node(&root->fs_info->tree_root->root_item,
			    root->fs_info->tree_root->node);
J
Josef Bacik 已提交
1161
	switch_commit_root(root->fs_info->tree_root);
1162 1163 1164

	btrfs_set_root_node(&root->fs_info->chunk_root->root_item,
			    root->fs_info->chunk_root->node);
J
Josef Bacik 已提交
1165
	switch_commit_root(root->fs_info->chunk_root);
1166 1167

	update_super_roots(root);
1168 1169 1170 1171 1172 1173

	if (!root->fs_info->log_root_recovering) {
		btrfs_set_super_log_root(&root->fs_info->super_copy, 0);
		btrfs_set_super_log_root_level(&root->fs_info->super_copy, 0);
	}

1174 1175
	memcpy(&root->fs_info->super_for_commit, &root->fs_info->super_copy,
	       sizeof(root->fs_info->super_copy));
C
Chris Mason 已提交
1176

1177
	trans->transaction->blocked = 0;
1178

1179
	wake_up(&root->fs_info->transaction_wait);
1180

C
Chris Mason 已提交
1181
	mutex_unlock(&root->fs_info->trans_mutex);
C
Chris Mason 已提交
1182 1183
	ret = btrfs_write_and_wait_transaction(trans, root);
	BUG_ON(ret);
Y
Yan Zheng 已提交
1184
	write_ctree_super(trans, root, 0);
1185

1186 1187 1188 1189 1190 1191
	/*
	 * the super is written, we can safely allow the tree-loggers
	 * to go about their business
	 */
	mutex_unlock(&root->fs_info->tree_log_mutex);

1192
	btrfs_finish_extent_commit(trans, root);
1193

Z
Zheng Yan 已提交
1194 1195
	mutex_lock(&root->fs_info->trans_mutex);

C
Chris Mason 已提交
1196
	cur_trans->commit_done = 1;
1197

1198
	root->fs_info->last_trans_committed = cur_trans->transid;
J
Josef Bacik 已提交
1199

C
Chris Mason 已提交
1200
	wake_up(&cur_trans->commit_wait);
1201

C
Chris Mason 已提交
1202
	put_transaction(cur_trans);
C
Chris Mason 已提交
1203
	put_transaction(cur_trans);
1204

C
Chris Mason 已提交
1205
	mutex_unlock(&root->fs_info->trans_mutex);
1206

J
Josef Bacik 已提交
1207 1208 1209
	if (current->journal_info == trans)
		current->journal_info = NULL;

C
Chris Mason 已提交
1210
	kmem_cache_free(btrfs_trans_handle_cachep, trans);
Y
Yan, Zheng 已提交
1211 1212 1213 1214

	if (current != root->fs_info->transaction_kthread)
		btrfs_run_delayed_iputs(root);

C
Chris Mason 已提交
1215 1216 1217
	return ret;
}

C
Chris Mason 已提交
1218 1219 1220
/*
 * interface function to delete all the snapshots we have scheduled for deletion
 */
1221 1222
int btrfs_clean_old_snapshots(struct btrfs_root *root)
{
1223 1224 1225 1226 1227 1228
	LIST_HEAD(list);
	struct btrfs_fs_info *fs_info = root->fs_info;

	mutex_lock(&fs_info->trans_mutex);
	list_splice_init(&fs_info->dead_roots, &list);
	mutex_unlock(&fs_info->trans_mutex);
1229

1230 1231
	while (!list_empty(&list)) {
		root = list_entry(list.next, struct btrfs_root, root_list);
1232 1233 1234 1235
		list_del(&root->root_list);

		if (btrfs_header_backref_rev(root->node) <
		    BTRFS_MIXED_BACKREF_REV)
1236
			btrfs_drop_snapshot(root, NULL, 0);
1237
		else
1238
			btrfs_drop_snapshot(root, NULL, 1);
1239 1240 1241
	}
	return 0;
}