375  * nand_fill_oob - [INTERN] Transfer client buffer to oob
377  * @oob: oob data buffer
378  * @len: oob data write length
379  * @ops: oob ops structure
381 static uint8_t *nand_fill_oob(struct nand_chip *chip, uint8_t *oob, size_t len,  in nand_fill_oob()  argument
388 	 * Initialise to all 0xFF, to avoid the possibility of left over OOB  in nand_fill_oob()
389 	 * data from a previous OOB read.  in nand_fill_oob()
397 		memcpy(chip->oob_poi + ops->ooboffs, oob, len);  in nand_fill_oob()
398 		return oob + len;  in nand_fill_oob()
401 		ret = mtd_ooblayout_set_databytes(mtd, oob, chip->oob_poi,  in nand_fill_oob()
404 		return oob + len;  in nand_fill_oob()
416  * @ops: oob operation description structure
549  * specify how to write bad block markers to OOB (chip->legacy.block_markbad).
553  *  (1) erase the affected block, to allow OOB marker to be written cleanly
554  *  (2) write bad block marker to OOB area of affected block (unless flag
569 		/* Attempt erase before marking OOB */  in nand_block_markbad_lowlevel()
575 		/* Write bad block marker to OOB */  in nand_block_markbad_lowlevel()
1097 	 * On small page NANDs, there's a dedicated command to access the OOB  in nand_fill_column_cycles()
1098 	 * area, and the column address is relative to the start of the OOB  in nand_fill_column_cycles()
1364  * nand_read_oob_op - Do a READ OOB operation
1367  * @offset_in_oob: offset within the OOB area
1371  * This function issues a READ OOB operation.
2715  * @extraoob: extra OOB buffer
2716  * @extraooblen: extra OOB length
2719  * Check if a data buffer and its associated ECC and OOB data contains only
2738  * 3/ The extraoob argument is optional, and should be used if some of your OOB
2741  *    extra OOB data to an ECC chunk.
2789  * @oob_required: caller requires OOB data read to chip->oob_poi
2804  * @oob_required: caller requires OOB data read to chip->oob_poi
2807  * Not for syndrome calculating ECC controllers, which use a special oob layout.
2834  * @oob_required: caller requires OOB data read to chip->oob_poi
2839  * eventually OOB) to be loaded in the NAND cache and sent over the
2842  * first reads the main data, and if the OOB data is requested too,
2875  * @oob_required: caller requires OOB data read to chip->oob_poi
2878  * We need a special oob layout and handling even when OOB isn't used.
2886 	uint8_t *oob = chip->oob_poi;  in nand_read_page_raw_syndrome()  local
2901 			ret = nand_read_data_op(chip, oob, chip->ecc.prepad,  in nand_read_page_raw_syndrome()
2906 			oob += chip->ecc.prepad;  in nand_read_page_raw_syndrome()
2909 		ret = nand_read_data_op(chip, oob, eccbytes, false, false);  in nand_read_page_raw_syndrome()
2913 		oob += eccbytes;  in nand_read_page_raw_syndrome()
2916 			ret = nand_read_data_op(chip, oob, chip->ecc.postpad,  in nand_read_page_raw_syndrome()
2921 			oob += chip->ecc.postpad;  in nand_read_page_raw_syndrome()
2925 	size = mtd->oobsize - (oob - chip->oob_poi);  in nand_read_page_raw_syndrome()
2927 		ret = nand_read_data_op(chip, oob, size, false, false);  in nand_read_page_raw_syndrome()
2939  * @oob_required: caller requires OOB data read to chip->oob_poi
3096  * @oob_required: caller requires OOB data read to chip->oob_poi
3099  * Not for syndrome calculating ECC controllers which need a special oob layout.
3167  * @oob_required: caller requires OOB data read to chip->oob_poi
3171  * need a special oob layout and handling.
3182 	uint8_t *oob = chip->oob_poi;  in nand_read_page_syndrome()  local
3199 			ret = nand_read_data_op(chip, oob, chip->ecc.prepad,  in nand_read_page_syndrome()
3204 			oob += chip->ecc.prepad;  in nand_read_page_syndrome()
3209 		ret = nand_read_data_op(chip, oob, eccbytes, false, false);  in nand_read_page_syndrome()
3213 		stat = chip->ecc.correct(chip, p, oob, NULL);  in nand_read_page_syndrome()
3215 		oob += eccbytes;  in nand_read_page_syndrome()
3218 			ret = nand_read_data_op(chip, oob, chip->ecc.postpad,  in nand_read_page_syndrome()
3223 			oob += chip->ecc.postpad;  in nand_read_page_syndrome()
3230 							   oob - eccpadbytes,  in nand_read_page_syndrome()
3244 	/* Calculate remaining oob bytes */  in nand_read_page_syndrome()
3245 	i = mtd->oobsize - (oob - chip->oob_poi);  in nand_read_page_syndrome()
3247 		ret = nand_read_data_op(chip, oob, i, false, false);  in nand_read_page_syndrome()
3256  * nand_transfer_oob - [INTERN] Transfer oob to client buffer
3258  * @oob: oob destination address
3259  * @ops: oob ops structure
3260  * @len: size of oob to transfer
3262 static uint8_t *nand_transfer_oob(struct nand_chip *chip, uint8_t *oob,  in nand_transfer_oob()  argument
3272 		memcpy(oob, chip->oob_poi + ops->ooboffs, len);  in nand_transfer_oob()
3273 		return oob + len;  in nand_transfer_oob()
3276 		ret = mtd_ooblayout_get_databytes(mtd, oob, chip->oob_poi,  in nand_transfer_oob()
3279 		return oob + len;  in nand_transfer_oob()
3324  * @ops: oob ops structure
3338 	uint8_t *bufpoi, *oob, *buf;  in nand_do_read_ops()  local
3357 	oob = ops->oobbuf;  in nand_do_read_ops()
3358 	oob_required = oob ? 1 : 0;  in nand_do_read_ops()
3376 		if (realpage != chip->pagecache.page || oob) {  in nand_do_read_ops()
3393 				 !oob)  in nand_do_read_ops()
3411 				if (!NAND_HAS_SUBPAGE_READ(chip) && !oob &&  in nand_do_read_ops()
3423 			if (unlikely(oob)) {  in nand_do_read_ops()
3427 					oob = nand_transfer_oob(chip, oob, ops,  in nand_do_read_ops()
3490 	if (oob)  in nand_do_read_ops()
3503  * nand_read_oob_std - [REPLACEABLE] the most common OOB data read function
3516  * nand_read_oob_syndrome - [REPLACEABLE] OOB data read function for HW ECC
3570  * nand_write_oob_std - [REPLACEABLE] the most common OOB data write function
3584  * nand_write_oob_syndrome - [REPLACEABLE] OOB data write function for HW ECC
3598 	 * data-ecc-data-ecc ... ecc-oob  in nand_write_oob_syndrome()
3600 	 * data-pad-ecc-pad-data-pad .... ecc-pad-oob  in nand_write_oob_syndrome()
3660  * @ops: oob operations description structure
3742  * @ops: oob operation description structure
3776  * @oob_required: must write chip->oob_poi to OOB
3791  * @oob_required: must write chip->oob_poi to OOB
3794  * Not for syndrome calculating ECC controllers, which use a special oob layout.
3821  * @oob_required: must write chip->oob_poi to OOB
3826  * eventually OOB) to be sent over the bus and effectively programmed
3829  * data, then eventually send the OOB data by latching more data
3857  * @oob_required: must write chip->oob_poi to OOB
3860  * We need a special oob layout and handling even when ECC isn't checked.
3869 	uint8_t *oob = chip->oob_poi;  in nand_write_page_raw_syndrome()  local
3884 			ret = nand_write_data_op(chip, oob, chip->ecc.prepad,  in nand_write_page_raw_syndrome()
3889 			oob += chip->ecc.prepad;  in nand_write_page_raw_syndrome()
3892 		ret = nand_write_data_op(chip, oob, eccbytes, false);  in nand_write_page_raw_syndrome()
3896 		oob += eccbytes;  in nand_write_page_raw_syndrome()
3899 			ret = nand_write_data_op(chip, oob, chip->ecc.postpad,  in nand_write_page_raw_syndrome()
3904 			oob += chip->ecc.postpad;  in nand_write_page_raw_syndrome()
3908 	size = mtd->oobsize - (oob - chip->oob_poi);  in nand_write_page_raw_syndrome()
3910 		ret = nand_write_data_op(chip, oob, size, false);  in nand_write_page_raw_syndrome()
3921  * @oob_required: must write chip->oob_poi to OOB
3950  * @oob_required: must write chip->oob_poi to OOB
3996  * @oob_required: must write chip->oob_poi to OOB
4033 		/* mask OOB of un-touched subpages by padding 0xFF */  in nand_write_subpage_hwecc()
4034 		/* if oob_required, preserve OOB metadata of written subpage */  in nand_write_subpage_hwecc()
4043 	/* copy calculated ECC for whole page to chip->buffer->oob */  in nand_write_subpage_hwecc()
4051 	/* write OOB buffer to NAND device */  in nand_write_subpage_hwecc()
4064  * @oob_required: must write chip->oob_poi to OOB
4068  * need a special oob layout and handling.
4078 	uint8_t *oob = chip->oob_poi;  in nand_write_page_syndrome()  local
4093 			ret = nand_write_data_op(chip, oob, chip->ecc.prepad,  in nand_write_page_syndrome()
4098 			oob += chip->ecc.prepad;  in nand_write_page_syndrome()
4101 		chip->ecc.calculate(chip, p, oob);  in nand_write_page_syndrome()
4103 		ret = nand_write_data_op(chip, oob, eccbytes, false);  in nand_write_page_syndrome()
4107 		oob += eccbytes;  in nand_write_page_syndrome()
4110 			ret = nand_write_data_op(chip, oob, chip->ecc.postpad,  in nand_write_page_syndrome()
4115 			oob += chip->ecc.postpad;  in nand_write_page_syndrome()
4119 	/* Calculate remaining oob bytes */  in nand_write_page_syndrome()
4120 	i = mtd->oobsize - (oob - chip->oob_poi);  in nand_write_page_syndrome()
4122 		ret = nand_write_data_op(chip, oob, i, false);  in nand_write_page_syndrome()
4136  * @oob_required: must write chip->oob_poi to OOB
4174  * @ops: oob operations description structure
4188 	uint8_t *oob = ops->oobbuf;  in nand_do_write_ops()  local
4191 	int oob_required = oob ? 1 : 0;  in nand_do_write_ops()
4227 	/* Don't allow multipage oob writes with offset */  in nand_do_write_ops()
4228 	if (oob && ops->ooboffs && (ops->ooboffs + ops->ooblen > oobmaxlen)) {  in nand_do_write_ops()
4262 		if (unlikely(oob)) {  in nand_do_write_ops()
4264 			oob = nand_fill_oob(chip, oob, len, ops);  in nand_do_write_ops()
4267 			/* We still need to erase leftover OOB data */  in nand_do_write_ops()
4295 	if (unlikely(oob))  in nand_do_write_ops()
4342  * @ops: oob operation description structure
5099 	pr_info("%d MiB, %s, erase size: %d KiB, page size: %d, OOB size: %d\n",  in nand_detect()
5691  * @oobavail: OOB size that the ECC engine can use
5694  * by the controller and the calculated ECC bytes fit within the chip's OOB.
5724 				pr_err("ECC (step, strength) = (%d, %d) does not fit in OOB",  in nand_check_ecc_caps()
5745  * @oobavail: OOB size that the ECC engine can use
5748  * number of ECC bytes (i.e. with the largest number of OOB-free bytes).
5829  * @oobavail: OOB size that the ECC engine can use
5832  * within the chip's OOB.  On success, the chosen ECC settings are set.
5899  * @oobavail: OOB size that the ECC engine can use
5908  *    to the chip's requirement. If available OOB size can't fit the chip
5993 	/* New bad blocks should be marked in OOB, flash-based BBT, or both */  in nand_scan_tail()
6015 	/* Set the internal oob buffer location, just after the page data */  in nand_scan_tail()
6038 			 * Expose the whole OOB area to users if ECC_NONE  in nand_scan_tail()
6050 			WARN(1, "No oob scheme defined for oobsize %d\n",  in nand_scan_tail()
6128 	/* For many systems, the standard OOB write also works for raw */  in nand_scan_tail()