| /* | 
 |  * YAFFS: Yet Another Flash File System. A NAND-flash specific file system. | 
 |  * | 
 |  * Copyright (C) 2002-2018 Aleph One Ltd. | 
 |  * | 
 |  * Created by Charles Manning <charles@aleph1.co.uk> | 
 |  * | 
 |  * This program is free software; you can redistribute it and/or modify | 
 |  * it under the terms of the GNU General Public License version 2 as | 
 |  * published by the Free Software Foundation. | 
 |  */ | 
 |  | 
 | /* Summaries write the useful part of the tags for the chunks in a block into an | 
 |  * an array which is written to the last n chunks of the block. | 
 |  * Reading the summaries gives all the tags for the block in one read. Much | 
 |  * faster. | 
 |  * | 
 |  * Chunks holding summaries are marked with tags making it look like | 
 |  * they are part of a fake file. | 
 |  * | 
 |  * The summary could also be used during gc. | 
 |  * | 
 |  */ | 
 |  | 
 | #include "yaffs_summary.h" | 
 | #include "yaffs_packedtags2.h" | 
 | #include "yaffs_nand.h" | 
 | #include "yaffs_getblockinfo.h" | 
 | #include "yaffs_bitmap.h" | 
 |  | 
 | /* | 
 |  * The summary is built up in an array of summary tags. | 
 |  * This gets written to the last one or two (maybe more) chunks in a block. | 
 |  * A summary header is written as the first part of each chunk of summary data. | 
 |  * The summary header must match or the summary is rejected. | 
 |  */ | 
 |  | 
 | /* Summary tags don't need the sequence number because that is redundant. */ | 
 | struct yaffs_summary_tags { | 
 | 	unsigned obj_id; | 
 | 	unsigned chunk_id; | 
 | 	unsigned n_bytes; | 
 | }; | 
 |  | 
 | /* Summary header */ | 
 | struct yaffs_summary_header { | 
 | 	unsigned version;	/* Must match current version */ | 
 | 	unsigned block;		/* Must be this block */ | 
 | 	unsigned seq;		/* Must be this sequence number */ | 
 | 	unsigned sum;		/* Just add up all the bytes in the tags */ | 
 | }; | 
 |  | 
 |  | 
 | static void yaffs_summary_clear(struct yaffs_dev *dev) | 
 | { | 
 | 	if (!dev->sum_tags) | 
 | 		return; | 
 | 	memset(dev->sum_tags, 0, dev->chunks_per_summary * | 
 | 		sizeof(struct yaffs_summary_tags)); | 
 | } | 
 |  | 
 |  | 
 | void yaffs_summary_deinit(struct yaffs_dev *dev) | 
 | { | 
 | 	kfree(dev->sum_tags); | 
 | 	dev->sum_tags = NULL; | 
 | 	kfree(dev->gc_sum_tags); | 
 | 	dev->gc_sum_tags = NULL; | 
 | 	dev->chunks_per_summary = 0; | 
 | } | 
 |  | 
 | int yaffs_summary_init(struct yaffs_dev *dev) | 
 | { | 
 | 	int sum_bytes; | 
 | 	int chunks_used; /* Number of chunks used by summary */ | 
 | 	int sum_tags_bytes; | 
 |  | 
 | 	sum_bytes = dev->param.chunks_per_block * | 
 | 			sizeof(struct yaffs_summary_tags); | 
 |  | 
 | 	chunks_used = (sum_bytes + dev->data_bytes_per_chunk - 1)/ | 
 | 			(dev->data_bytes_per_chunk - | 
 | 				sizeof(struct yaffs_summary_header)); | 
 |  | 
 | 	dev->chunks_per_summary = dev->param.chunks_per_block - chunks_used; | 
 | 	sum_tags_bytes = sizeof(struct yaffs_summary_tags) * | 
 | 				dev->chunks_per_summary; | 
 | 	dev->sum_tags = kmalloc(sum_tags_bytes, GFP_NOFS); | 
 | 	dev->gc_sum_tags = kmalloc(sum_tags_bytes, GFP_NOFS); | 
 | 	if (!dev->sum_tags || !dev->gc_sum_tags) { | 
 | 		yaffs_summary_deinit(dev); | 
 | 		return YAFFS_FAIL; | 
 | 	} | 
 |  | 
 | 	yaffs_summary_clear(dev); | 
 |  | 
 | 	return YAFFS_OK; | 
 | } | 
 |  | 
 | static unsigned yaffs_summary_sum(struct yaffs_dev *dev) | 
 | { | 
 | 	u8 *sum_buffer = (u8 *)dev->sum_tags; | 
 | 	int i; | 
 | 	unsigned sum = 0; | 
 |  | 
 | 	i = sizeof(struct yaffs_summary_tags) * | 
 | 				dev->chunks_per_summary; | 
 | 	while (i > 0) { | 
 | 		sum += *sum_buffer; | 
 | 		sum_buffer++; | 
 | 		i--; | 
 | 	} | 
 |  | 
 | 	return sum; | 
 | } | 
 |  | 
 | static int yaffs_summary_write(struct yaffs_dev *dev, int blk) | 
 | { | 
 | 	struct yaffs_ext_tags tags; | 
 | 	u8 *buffer; | 
 | 	u8 *sum_buffer = (u8 *)dev->sum_tags; | 
 | 	int n_bytes; | 
 | 	int chunk_in_nand; | 
 | 	int chunk_in_block; | 
 | 	int result; | 
 | 	int this_tx; | 
 | 	struct yaffs_summary_header hdr; | 
 | 	int sum_bytes_per_chunk = dev->data_bytes_per_chunk - sizeof(hdr); | 
 | 	struct yaffs_block_info *bi = yaffs_get_block_info(dev, blk); | 
 |  | 
 | 	buffer = yaffs_get_temp_buffer(dev); | 
 | 	n_bytes = sizeof(struct yaffs_summary_tags) * | 
 | 				dev->chunks_per_summary; | 
 | 	memset(&tags, 0, sizeof(struct yaffs_ext_tags)); | 
 | 	tags.obj_id = YAFFS_OBJECTID_SUMMARY; | 
 | 	tags.chunk_id = 1; | 
 | 	chunk_in_block = dev->chunks_per_summary; | 
 | 	chunk_in_nand = dev->alloc_block * dev->param.chunks_per_block + | 
 | 						dev->chunks_per_summary; | 
 | 	hdr.version = YAFFS_SUMMARY_VERSION; | 
 | 	hdr.block = blk; | 
 | 	hdr.seq = bi->seq_number; | 
 | 	hdr.sum = yaffs_summary_sum(dev); | 
 |  | 
 | 	do { | 
 | 		this_tx = n_bytes; | 
 | 		if (this_tx > sum_bytes_per_chunk) | 
 | 			this_tx = sum_bytes_per_chunk; | 
 | 		memcpy(buffer, &hdr, sizeof(hdr)); | 
 | 		memcpy(buffer + sizeof(hdr), sum_buffer, this_tx); | 
 | 		tags.n_bytes = this_tx + sizeof(hdr); | 
 | 		result = yaffs_wr_chunk_tags_nand(dev, chunk_in_nand, | 
 | 						buffer, &tags); | 
 |  | 
 | 		if (result != YAFFS_OK) | 
 | 			break; | 
 | 		yaffs_set_chunk_bit(dev, blk, chunk_in_block); | 
 | 		bi->pages_in_use++; | 
 | 		dev->n_free_chunks--; | 
 |  | 
 | 		n_bytes -= this_tx; | 
 | 		sum_buffer += this_tx; | 
 | 		chunk_in_nand++; | 
 | 		chunk_in_block++; | 
 | 		tags.chunk_id++; | 
 | 	} while (result == YAFFS_OK && n_bytes > 0); | 
 | 	yaffs_release_temp_buffer(dev, buffer); | 
 |  | 
 |  | 
 | 	if (result == YAFFS_OK) | 
 | 		bi->has_summary = 1; | 
 |  | 
 |  | 
 | 	return result; | 
 | } | 
 |  | 
 | int yaffs_summary_read(struct yaffs_dev *dev, | 
 | 			struct yaffs_summary_tags *st, | 
 | 			int blk) | 
 | { | 
 | 	struct yaffs_ext_tags tags; | 
 | 	u8 *buffer; | 
 | 	u8 *sum_buffer = (u8 *)st; | 
 | 	int n_bytes; | 
 | 	u32 chunk_id; | 
 | 	int chunk_in_nand; | 
 | 	int chunk_in_block; | 
 | 	int result; | 
 | 	int this_tx; | 
 | 	struct yaffs_summary_header hdr; | 
 | 	struct yaffs_block_info *bi = yaffs_get_block_info(dev, blk); | 
 | 	int sum_bytes_per_chunk = dev->data_bytes_per_chunk - sizeof(hdr); | 
 |  | 
 | 	buffer = yaffs_get_temp_buffer(dev); | 
 | 	n_bytes = sizeof(struct yaffs_summary_tags) * dev->chunks_per_summary; | 
 | 	chunk_in_block = dev->chunks_per_summary; | 
 | 	chunk_in_nand = blk * dev->param.chunks_per_block + | 
 | 							dev->chunks_per_summary; | 
 | 	chunk_id = 1; | 
 | 	do { | 
 | 		this_tx = n_bytes; | 
 | 		if (this_tx > sum_bytes_per_chunk) | 
 | 			this_tx = sum_bytes_per_chunk; | 
 | 		result = yaffs_rd_chunk_tags_nand(dev, chunk_in_nand, | 
 | 						buffer, &tags); | 
 |  | 
 | 		if (tags.chunk_id != chunk_id || | 
 | 			tags.obj_id != YAFFS_OBJECTID_SUMMARY || | 
 | 			tags.chunk_used == 0 || | 
 | 			tags.ecc_result > YAFFS_ECC_RESULT_FIXED || | 
 | 			tags.n_bytes != (this_tx + sizeof(hdr))) | 
 | 				result = YAFFS_FAIL; | 
 | 		if (result != YAFFS_OK) | 
 | 			break; | 
 |  | 
 | 		if (st == dev->sum_tags) { | 
 | 			/* If we're scanning then update the block info */ | 
 | 			yaffs_set_chunk_bit(dev, blk, chunk_in_block); | 
 | 			bi->pages_in_use++; | 
 | 		} | 
 | 		memcpy(&hdr, buffer, sizeof(hdr)); | 
 | 		memcpy(sum_buffer, buffer + sizeof(hdr), this_tx); | 
 | 		n_bytes -= this_tx; | 
 | 		sum_buffer += this_tx; | 
 | 		chunk_in_nand++; | 
 | 		chunk_in_block++; | 
 | 		chunk_id++; | 
 | 	} while (result == YAFFS_OK && n_bytes > 0); | 
 | 	yaffs_release_temp_buffer(dev, buffer); | 
 |  | 
 | 	if (result == YAFFS_OK) { | 
 | 		/* Verify header */ | 
 | 		if (hdr.version != YAFFS_SUMMARY_VERSION || | 
 | 		    hdr.seq != bi->seq_number || | 
 | 		    hdr.sum != yaffs_summary_sum(dev)) | 
 | 			result = YAFFS_FAIL; | 
 | 	} | 
 |  | 
 | 	if (st == dev->sum_tags && result == YAFFS_OK) | 
 | 		bi->has_summary = 1; | 
 |  | 
 | 	return result; | 
 | } | 
 |  | 
 | int yaffs_summary_add(struct yaffs_dev *dev, | 
 | 			struct yaffs_ext_tags *tags, | 
 | 			int chunk_in_nand) | 
 | { | 
 | 	struct yaffs_packed_tags2_tags_only tags_only; | 
 | 	struct yaffs_summary_tags *sum_tags; | 
 | 	int block_in_nand = chunk_in_nand / dev->param.chunks_per_block; | 
 | 	int chunk_in_block = chunk_in_nand % dev->param.chunks_per_block; | 
 |  | 
 | 	if (!dev->sum_tags) | 
 | 		return YAFFS_OK; | 
 |  | 
 | 	if (chunk_in_block >= 0 && chunk_in_block < dev->chunks_per_summary) { | 
 | 		yaffs_pack_tags2_tags_only(dev, &tags_only, tags); | 
 | 		sum_tags = &dev->sum_tags[chunk_in_block]; | 
 |  | 
 | 		sum_tags->chunk_id = tags_only.chunk_id; | 
 | 		sum_tags->n_bytes = tags_only.n_bytes; | 
 | 		sum_tags->obj_id = tags_only.obj_id; | 
 |  | 
 | 		if (chunk_in_block == dev->chunks_per_summary - 1) { | 
 | 			/* Time to write out the summary */ | 
 | 			yaffs_summary_write(dev, block_in_nand); | 
 | 			yaffs_summary_clear(dev); | 
 | 			yaffs_skip_rest_of_block(dev); | 
 | 		} | 
 | 	} | 
 | 	return YAFFS_OK; | 
 | } | 
 |  | 
 | int yaffs_summary_fetch(struct yaffs_dev *dev, | 
 | 			struct yaffs_ext_tags *tags, | 
 | 			int chunk_in_block) | 
 | { | 
 | 	struct yaffs_packed_tags2_tags_only tags_only; | 
 | 	struct yaffs_summary_tags *sum_tags; | 
 | 	if (chunk_in_block >= 0 && chunk_in_block < dev->chunks_per_summary) { | 
 | 		sum_tags = &dev->sum_tags[chunk_in_block]; | 
 | 		tags_only.chunk_id = sum_tags->chunk_id; | 
 | 		tags_only.n_bytes = sum_tags->n_bytes; | 
 | 		tags_only.obj_id = sum_tags->obj_id; | 
 | 		yaffs_unpack_tags2_tags_only(dev, tags, &tags_only); | 
 | 		return YAFFS_OK; | 
 | 	} | 
 | 	return YAFFS_FAIL; | 
 | } | 
 |  | 
 | void yaffs_summary_gc(struct yaffs_dev *dev, int blk) | 
 | { | 
 | 	struct yaffs_block_info *bi = yaffs_get_block_info(dev, blk); | 
 | 	u32 i; | 
 |  | 
 | 	if (!bi->has_summary) | 
 | 		return; | 
 |  | 
 | 	for (i = dev->chunks_per_summary; | 
 | 	     i < dev->param.chunks_per_block; | 
 | 	     i++) { | 
 | 		if (yaffs_check_chunk_bit(dev, blk, i)) { | 
 | 			yaffs_clear_chunk_bit(dev, blk, i); | 
 | 			bi->pages_in_use--; | 
 | 			dev->n_free_chunks++; | 
 | 		} | 
 | 	} | 
 | } |