[linux.git] / include / mtd / mtd-abi.h

/*
 * Copyright © 1999-2010 David Woodhouse <[email protected]> et al.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * 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., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 *
 */

#ifndef __MTD_ABI_H__
#define __MTD_ABI_H__

#include <linux/types.h>

struct erase_info_user {
	__u32 start;
	__u32 length;
};

struct erase_info_user64 {
	__u64 start;
	__u64 length;
};

struct mtd_oob_buf {
	__u32 start;
	__u32 length;
	unsigned char __user *ptr;
};

struct mtd_oob_buf64 {
	__u64 start;
	__u32 pad;
	__u32 length;
	__u64 usr_ptr;
};

/**
 * MTD operation modes
 *
 * @MTD_OPS_PLACE_OOB:	OOB data are placed at the given offset (default)
 * @MTD_OPS_AUTO_OOB:	OOB data are automatically placed at the free areas
 *			which are defined by the internal ecclayout
 * @MTD_OPS_RAW:	data are transferred as-is, with no error correction;
 *			this mode implies %MTD_OPS_PLACE_OOB
 *
 * These modes can be passed to ioctl(MEMWRITE) and are also used internally.
 * See notes on "MTD file modes" for discussion on %MTD_OPS_RAW vs.
 * %MTD_FILE_MODE_RAW.
 */
enum {
	MTD_OPS_PLACE_OOB = 0,
	MTD_OPS_AUTO_OOB = 1,
	MTD_OPS_RAW = 2,
};

/**
 * struct mtd_write_req - data structure for requesting a write operation
 *
 * @start:	start address
 * @len:	length of data buffer
 * @ooblen:	length of OOB buffer
 * @usr_data:	user-provided data buffer
 * @usr_oob:	user-provided OOB buffer
 * @mode:	MTD mode (see "MTD operation modes")
 * @padding:	reserved, must be set to 0
 *
 * This structure supports ioctl(MEMWRITE) operations, allowing data and/or OOB
 * writes in various modes. To write to OOB-only, set @usr_data == NULL, and to
 * write data-only, set @usr_oob == NULL. However, setting both @usr_data and
 * @usr_oob to NULL is not allowed.
 */
struct mtd_write_req {
	__u64 start;
	__u64 len;
	__u64 ooblen;
	__u64 usr_data;
	__u64 usr_oob;
	__u8 mode;
	__u8 padding[7];
};

#define MTD_ABSENT		0
#define MTD_RAM			1
#define MTD_ROM			2
#define MTD_NORFLASH		3
#define MTD_NANDFLASH		4
#define MTD_DATAFLASH		6
#define MTD_UBIVOLUME		7
#define MTD_MLCNANDFLASH	8

#define MTD_WRITEABLE		0x400	/* Device is writeable */
#define MTD_BIT_WRITEABLE	0x800	/* Single bits can be flipped */
#define MTD_NO_ERASE		0x1000	/* No erase necessary */
#define MTD_POWERUP_LOCK	0x2000	/* Always locked after reset */

/* Some common devices / combinations of capabilities */
#define MTD_CAP_ROM		0
#define MTD_CAP_RAM		(MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
#define MTD_CAP_NORFLASH	(MTD_WRITEABLE | MTD_BIT_WRITEABLE)
#define MTD_CAP_NANDFLASH	(MTD_WRITEABLE)

/* Obsolete ECC byte placement modes (used with obsolete MEMGETOOBSEL) */
#define MTD_NANDECC_OFF		0	// Switch off ECC (Not recommended)
#define MTD_NANDECC_PLACE	1	// Use the given placement in the structure (YAFFS1 legacy mode)
#define MTD_NANDECC_AUTOPLACE	2	// Use the default placement scheme
#define MTD_NANDECC_PLACEONLY	3	// Use the given placement in the structure (Do not store ecc result on read)
#define MTD_NANDECC_AUTOPL_USR 	4	// Use the given autoplacement scheme rather than using the default

/* OTP mode selection */
#define MTD_OTP_OFF		0
#define MTD_OTP_FACTORY		1
#define MTD_OTP_USER		2

struct mtd_info_user {
	__u8 type;
	__u32 flags;
	__u32 size;	/* Total size of the MTD */
	__u32 erasesize;
	__u32 writesize;
	__u32 oobsize;	/* Amount of OOB data per block (e.g. 16) */
	__u64 padding;	/* Old obsolete field; do not use */
};

struct region_info_user {
	__u32 offset;		/* At which this region starts,
				 * from the beginning of the MTD */
	__u32 erasesize;	/* For this region */
	__u32 numblocks;	/* Number of blocks in this region */
	__u32 regionindex;
};

struct otp_info {
	__u32 start;
	__u32 length;
	__u32 locked;
};

/*
 * Note, the following ioctl existed in the past and was removed:
 * #define MEMSETOOBSEL           _IOW('M', 9, struct nand_oobinfo)
 * Try to avoid adding a new ioctl with the same ioctl number.
 */

/* Get basic MTD characteristics info (better to use sysfs) */
#define MEMGETINFO		_IOR('M', 1, struct mtd_info_user)
/* Erase segment of MTD */
#define MEMERASE		_IOW('M', 2, struct erase_info_user)
/* Write out-of-band data from MTD */
#define MEMWRITEOOB		_IOWR('M', 3, struct mtd_oob_buf)
/* Read out-of-band data from MTD */
#define MEMREADOOB		_IOWR('M', 4, struct mtd_oob_buf)
/* Lock a chip (for MTD that supports it) */
#define MEMLOCK			_IOW('M', 5, struct erase_info_user)
/* Unlock a chip (for MTD that supports it) */
#define MEMUNLOCK		_IOW('M', 6, struct erase_info_user)
/* Get the number of different erase regions */
#define MEMGETREGIONCOUNT	_IOR('M', 7, int)
/* Get information about the erase region for a specific index */
#define MEMGETREGIONINFO	_IOWR('M', 8, struct region_info_user)
/* Get info about OOB modes (e.g., RAW, PLACE, AUTO) - legacy interface */
#define MEMGETOOBSEL		_IOR('M', 10, struct nand_oobinfo)
/* Check if an eraseblock is bad */
#define MEMGETBADBLOCK		_IOW('M', 11, __kernel_loff_t)
/* Mark an eraseblock as bad */
#define MEMSETBADBLOCK		_IOW('M', 12, __kernel_loff_t)
/* Set OTP (One-Time Programmable) mode (factory vs. user) */
#define OTPSELECT		_IOR('M', 13, int)
/* Get number of OTP (One-Time Programmable) regions */
#define OTPGETREGIONCOUNT	_IOW('M', 14, int)
/* Get all OTP (One-Time Programmable) info about MTD */
#define OTPGETREGIONINFO	_IOW('M', 15, struct otp_info)
/* Lock a given range of user data (must be in mode %MTD_FILE_MODE_OTP_USER) */
#define OTPLOCK			_IOR('M', 16, struct otp_info)
/* Get ECC layout (deprecated) */
#define ECCGETLAYOUT		_IOR('M', 17, struct nand_ecclayout_user)
/* Get statistics about corrected/uncorrected errors */
#define ECCGETSTATS		_IOR('M', 18, struct mtd_ecc_stats)
/* Set MTD mode on a per-file-descriptor basis (see "MTD file modes") */
#define MTDFILEMODE		_IO('M', 19)
/* Erase segment of MTD (supports 64-bit address) */
#define MEMERASE64		_IOW('M', 20, struct erase_info_user64)
/* Write data to OOB (64-bit version) */
#define MEMWRITEOOB64		_IOWR('M', 21, struct mtd_oob_buf64)
/* Read data from OOB (64-bit version) */
#define MEMREADOOB64		_IOWR('M', 22, struct mtd_oob_buf64)
/* Check if chip is locked (for MTD that supports it) */
#define MEMISLOCKED		_IOR('M', 23, struct erase_info_user)
/*
 * Most generic write interface; can write in-band and/or out-of-band in various
 * modes (see "struct mtd_write_req"). This ioctl is not supported for flashes
 * without OOB, e.g., NOR flash.
 */
#define MEMWRITE		_IOWR('M', 24, struct mtd_write_req)

/*
 * Obsolete legacy interface. Keep it in order not to break userspace
 * interfaces
 */
struct nand_oobinfo {
	__u32 useecc;
	__u32 eccbytes;
	__u32 oobfree[8][2];
	__u32 eccpos[32];
};

struct nand_oobfree {
	__u32 offset;
	__u32 length;
};

#define MTD_MAX_OOBFREE_ENTRIES	8
#define MTD_MAX_ECCPOS_ENTRIES	64
/*
 * OBSOLETE: ECC layout control structure. Exported to user-space via ioctl
 * ECCGETLAYOUT for backwards compatbility and should not be mistaken as a
 * complete set of ECC information. The ioctl truncates the larger internal
 * structure to retain binary compatibility with the static declaration of the
 * ioctl. Note that the "MTD_MAX_..._ENTRIES" macros represent the max size of
 * the user struct, not the MAX size of the internal struct nand_ecclayout.
 */
struct nand_ecclayout_user {
	__u32 eccbytes;
	__u32 eccpos[MTD_MAX_ECCPOS_ENTRIES];
	__u32 oobavail;
	struct nand_oobfree oobfree[MTD_MAX_OOBFREE_ENTRIES];
};

/**
 * struct mtd_ecc_stats - error correction stats
 *
 * @corrected:	number of corrected bits
 * @failed:	number of uncorrectable errors
 * @badblocks:	number of bad blocks in this partition
 * @bbtblocks:	number of blocks reserved for bad block tables
 */
struct mtd_ecc_stats {
	__u32 corrected;
	__u32 failed;
	__u32 badblocks;
	__u32 bbtblocks;
};

/*
 * MTD file modes - for read/write access to MTD
 *
 * @MTD_FILE_MODE_NORMAL:	OTP disabled, ECC enabled
 * @MTD_FILE_MODE_OTP_FACTORY:	OTP enabled in factory mode
 * @MTD_FILE_MODE_OTP_USER:	OTP enabled in user mode
 * @MTD_FILE_MODE_RAW:		OTP disabled, ECC disabled
 *
 * These modes can be set via ioctl(MTDFILEMODE). The mode mode will be retained
 * separately for each open file descriptor.
 *
 * Note: %MTD_FILE_MODE_RAW provides the same functionality as %MTD_OPS_RAW -
 * raw access to the flash, without error correction or autoplacement schemes.
 * Wherever possible, the MTD_OPS_* mode will override the MTD_FILE_MODE_* mode
 * (e.g., when using ioctl(MEMWRITE)), but in some cases, the MTD_FILE_MODE is
 * used out of necessity (e.g., `write()', ioctl(MEMWRITEOOB64)).
 */
enum mtd_file_modes {
	MTD_FILE_MODE_NORMAL = MTD_OTP_OFF,
	MTD_FILE_MODE_OTP_FACTORY = MTD_OTP_FACTORY,
	MTD_FILE_MODE_OTP_USER = MTD_OTP_USER,
	MTD_FILE_MODE_RAW,
};

#endif /* __MTD_ABI_H__ */
Commit	Line	Data
1da177e4	1	/*
a1452a37 DW	2	* Copyright © 1999-2010 David Woodhouse <[email protected]> et al.
	3	*
	4	* This program is free software; you can redistribute it and/or modify
	5	* it under the terms of the GNU General Public License as published by
	6	* the Free Software Foundation; either version 2 of the License, or
	7	* (at your option) any later version.
	8	*
	9	* This program is distributed in the hope that it will be useful,
	10	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	11	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	12	* GNU General Public License for more details.
	13	*
	14	* You should have received a copy of the GNU General Public License
	15	* along with this program; if not, write to the Free Software
	16	* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
	17	*
1da177e4 LT	18	*/
	19
	20	#ifndef __MTD_ABI_H__
	21	#define __MTD_ABI_H__
	22
ccef7ab5 AB	23	#include <linux/types.h>
ccef7ab5 AB	24
1da177e4	25	struct erase_info_user {
ccef7ab5 AB	26	__u32 start;
ccef7ab5 AB	27	__u32 length;
1da177e4 LT	28	};
1da177e4 LT	29
0dc54e9f KC	30	struct erase_info_user64 {
	31	__u64 start;
	32	__u64 length;
	33	};
	34
1da177e4	35	struct mtd_oob_buf {
ccef7ab5 AB	36	__u32 start;
ccef7ab5 AB	37	__u32 length;
1da177e4 LT	38	unsigned char __user *ptr;
	39	};
	40
aea7cea9 KC	41	struct mtd_oob_buf64 {
	42	__u64 start;
	43	__u32 pad;
	44	__u32 length;
	45	__u64 usr_ptr;
	46	};
	47
4180f24a	48	/**
0612b9dd	49	* MTD operation modes
905c6bcd	50	*
4180f24a BN	51	* @MTD_OPS_PLACE_OOB: OOB data are placed at the given offset (default)
4180f24a BN	52	* @MTD_OPS_AUTO_OOB: OOB data are automatically placed at the free areas
0612b9dd	53	* which are defined by the internal ecclayout
4180f24a BN	54	* @MTD_OPS_RAW: data are transferred as-is, with no error correction;
	55	* this mode implies %MTD_OPS_PLACE_OOB
	56	*
	57	* These modes can be passed to ioctl(MEMWRITE) and are also used internally.
	58	* See notes on "MTD file modes" for discussion on %MTD_OPS_RAW vs.
	59	* %MTD_FILE_MODE_RAW.
905c6bcd BN	60	*/
905c6bcd BN	61	enum {
0612b9dd BN	62	MTD_OPS_PLACE_OOB = 0,
	63	MTD_OPS_AUTO_OOB = 1,
	64	MTD_OPS_RAW = 2,
905c6bcd BN	65	};
905c6bcd BN	66
4180f24a BN	67	/**
	68	* struct mtd_write_req - data structure for requesting a write operation
	69	*
	70	* @start: start address
	71	* @len: length of data buffer
	72	* @ooblen: length of OOB buffer
	73	* @usr_data: user-provided data buffer
	74	* @usr_oob: user-provided OOB buffer
	75	* @mode: MTD mode (see "MTD operation modes")
	76	* @padding: reserved, must be set to 0
	77	*
	78	* This structure supports ioctl(MEMWRITE) operations, allowing data and/or OOB
	79	* writes in various modes. To write to OOB-only, set @usr_data == NULL, and to
	80	* write data-only, set @usr_oob == NULL. However, setting both @usr_data and
	81	* @usr_oob to NULL is not allowed.
	82	*/
e99d8b08 BN	83	struct mtd_write_req {
	84	__u64 start;
	85	__u64 len;
	86	__u64 ooblen;
	87	__u64 usr_data;
	88	__u64 usr_oob;
	89	__u8 mode;
	90	__u8 padding[7];
	91	};
	92
1da177e4	93	#define MTD_ABSENT 0
21c8db9e DW	94	#define MTD_RAM 1
21c8db9e DW	95	#define MTD_ROM 2
1da177e4 LT	96	#define MTD_NORFLASH 3
1da177e4 LT	97	#define MTD_NANDFLASH 4
8f15fd55	98	#define MTD_DATAFLASH 6
801c135c	99	#define MTD_UBIVOLUME 7
17a22826	100	#define MTD_MLCNANDFLASH 8
1da177e4	101
8ca9ed5d	102	#define MTD_WRITEABLE 0x400 /* Device is writeable */
5fa43394	103	#define MTD_BIT_WRITEABLE 0x800 /* Single bits can be flipped */
92cbfdcc	104	#define MTD_NO_ERASE 0x1000 /* No erase necessary */
e619a75f	105	#define MTD_POWERUP_LOCK 0x2000 /* Always locked after reset */
1da177e4	106
4180f24a	107	/* Some common devices / combinations of capabilities */
1da177e4	108	#define MTD_CAP_ROM 0
92cbfdcc	109	#define MTD_CAP_RAM (MTD_WRITEABLE \| MTD_BIT_WRITEABLE \| MTD_NO_ERASE)
5fa43394	110	#define MTD_CAP_NORFLASH (MTD_WRITEABLE \| MTD_BIT_WRITEABLE)
8ca9ed5d	111	#define MTD_CAP_NANDFLASH (MTD_WRITEABLE)
1da177e4	112
4180f24a	113	/* Obsolete ECC byte placement modes (used with obsolete MEMGETOOBSEL) */
1da177e4 LT	114	#define MTD_NANDECC_OFF 0 // Switch off ECC (Not recommended)
	115	#define MTD_NANDECC_PLACE 1 // Use the given placement in the structure (YAFFS1 legacy mode)
	116	#define MTD_NANDECC_AUTOPLACE 2 // Use the default placement scheme
	117	#define MTD_NANDECC_PLACEONLY 3 // Use the given placement in the structure (Do not store ecc result on read)
90e260c8	118	#define MTD_NANDECC_AUTOPL_USR 4 // Use the given autoplacement scheme rather than using the default
1da177e4	119
31f4233b NP	120	/* OTP mode selection */
	121	#define MTD_OTP_OFF 0
	122	#define MTD_OTP_FACTORY 1
	123	#define MTD_OTP_USER 2
	124
1da177e4	125	struct mtd_info_user {
ccef7ab5 AB	126	__u8 type;
ccef7ab5 AB	127	__u32 flags;
4180f24a	128	__u32 size; /* Total size of the MTD */
ccef7ab5 AB	129	__u32 erasesize;
ccef7ab5 AB	130	__u32 writesize;
4180f24a	131	__u32 oobsize; /* Amount of OOB data per block (e.g. 16) */
19fb4341	132	__u64 padding; /* Old obsolete field; do not use */
1da177e4 LT	133	};
	134
	135	struct region_info_user {
ccef7ab5	136	__u32 offset; /* At which this region starts,
4180f24a BN	137	* from the beginning of the MTD */
	138	__u32 erasesize; /* For this region */
	139	__u32 numblocks; /* Number of blocks in this region */
ccef7ab5	140	__u32 regionindex;
1da177e4 LT	141	};
1da177e4 LT	142
f77814dd	143	struct otp_info {
ccef7ab5 AB	144	__u32 start;
	145	__u32 length;
	146	__u32 locked;
f77814dd NP	147	};
f77814dd NP	148
93fad71c BN	149	/*
	150	* Note, the following ioctl existed in the past and was removed:
	151	* #define MEMSETOOBSEL _IOW('M', 9, struct nand_oobinfo)
	152	* Try to avoid adding a new ioctl with the same ioctl number.
	153	*/
	154
4180f24a	155	/* Get basic MTD characteristics info (better to use sysfs) */
5bd34c09	156	#define MEMGETINFO _IOR('M', 1, struct mtd_info_user)
4180f24a	157	/* Erase segment of MTD */
5bd34c09	158	#define MEMERASE _IOW('M', 2, struct erase_info_user)
4180f24a	159	/* Write out-of-band data from MTD */
5bd34c09	160	#define MEMWRITEOOB _IOWR('M', 3, struct mtd_oob_buf)
4180f24a	161	/* Read out-of-band data from MTD */
5bd34c09	162	#define MEMREADOOB _IOWR('M', 4, struct mtd_oob_buf)
4180f24a	163	/* Lock a chip (for MTD that supports it) */
5bd34c09	164	#define MEMLOCK _IOW('M', 5, struct erase_info_user)
4180f24a	165	/* Unlock a chip (for MTD that supports it) */
5bd34c09	166	#define MEMUNLOCK _IOW('M', 6, struct erase_info_user)
4180f24a	167	/* Get the number of different erase regions */
1da177e4	168	#define MEMGETREGIONCOUNT _IOR('M', 7, int)
4180f24a	169	/* Get information about the erase region for a specific index */
1da177e4	170	#define MEMGETREGIONINFO _IOWR('M', 8, struct region_info_user)
4180f24a	171	/* Get info about OOB modes (e.g., RAW, PLACE, AUTO) - legacy interface */
1da177e4	172	#define MEMGETOOBSEL _IOR('M', 10, struct nand_oobinfo)
4180f24a	173	/* Check if an eraseblock is bad */
85efde6f	174	#define MEMGETBADBLOCK _IOW('M', 11, __kernel_loff_t)
4180f24a	175	/* Mark an eraseblock as bad */
85efde6f	176	#define MEMSETBADBLOCK _IOW('M', 12, __kernel_loff_t)
4180f24a	177	/* Set OTP (One-Time Programmable) mode (factory vs. user) */
31f4233b	178	#define OTPSELECT _IOR('M', 13, int)
4180f24a	179	/* Get number of OTP (One-Time Programmable) regions */
31f4233b	180	#define OTPGETREGIONCOUNT _IOW('M', 14, int)
4180f24a	181	/* Get all OTP (One-Time Programmable) info about MTD */
31f4233b	182	#define OTPGETREGIONINFO _IOW('M', 15, struct otp_info)
4180f24a	183	/* Lock a given range of user data (must be in mode %MTD_FILE_MODE_OTP_USER) */
5bd34c09	184	#define OTPLOCK _IOR('M', 16, struct otp_info)
4180f24a	185	/* Get ECC layout (deprecated) */
cc26c3cd	186	#define ECCGETLAYOUT _IOR('M', 17, struct nand_ecclayout_user)
4180f24a	187	/* Get statistics about corrected/uncorrected errors */
f1a28c02	188	#define ECCGETSTATS _IOR('M', 18, struct mtd_ecc_stats)
4180f24a	189	/* Set MTD mode on a per-file-descriptor basis (see "MTD file modes") */
f1a28c02	190	#define MTDFILEMODE _IO('M', 19)
4180f24a	191	/* Erase segment of MTD (supports 64-bit address) */
0dc54e9f	192	#define MEMERASE64 _IOW('M', 20, struct erase_info_user64)
4180f24a	193	/* Write data to OOB (64-bit version) */
aea7cea9	194	#define MEMWRITEOOB64 _IOWR('M', 21, struct mtd_oob_buf64)
4180f24a	195	/* Read data from OOB (64-bit version) */
aea7cea9	196	#define MEMREADOOB64 _IOWR('M', 22, struct mtd_oob_buf64)
4180f24a	197	/* Check if chip is locked (for MTD that supports it) */
9938424f	198	#define MEMISLOCKED _IOR('M', 23, struct erase_info_user)
4180f24a BN	199	/*
4180f24a BN	200	* Most generic write interface; can write in-band and/or out-of-band in various
2b00668f AB	201	* modes (see "struct mtd_write_req"). This ioctl is not supported for flashes
2b00668f AB	202	* without OOB, e.g., NOR flash.
4180f24a	203	*/
e99d8b08	204	#define MEMWRITE _IOWR('M', 24, struct mtd_write_req)
1da177e4	205
5bd34c09 TG	206	/*
	207	* Obsolete legacy interface. Keep it in order not to break userspace
	208	* interfaces
	209	*/
1da177e4	210	struct nand_oobinfo {
ccef7ab5 AB	211	__u32 useecc;
	212	__u32 eccbytes;
	213	__u32 oobfree[8][2];
	214	__u32 eccpos[32];
1da177e4 LT	215	};
1da177e4 LT	216
5bd34c09	217	struct nand_oobfree {
ccef7ab5 AB	218	__u32 offset;
ccef7ab5 AB	219	__u32 length;
5bd34c09 TG	220	};
	221
	222	#define MTD_MAX_OOBFREE_ENTRIES 8
0ceacf36	223	#define MTD_MAX_ECCPOS_ENTRIES 64
5bd34c09	224	/*
0ceacf36 BN	225	* OBSOLETE: ECC layout control structure. Exported to user-space via ioctl
	226	* ECCGETLAYOUT for backwards compatbility and should not be mistaken as a
	227	* complete set of ECC information. The ioctl truncates the larger internal
	228	* structure to retain binary compatibility with the static declaration of the
	229	* ioctl. Note that the "MTD_MAX_..._ENTRIES" macros represent the max size of
	230	* the user struct, not the MAX size of the internal struct nand_ecclayout.
5bd34c09	231	*/
cc26c3cd	232	struct nand_ecclayout_user {
ccef7ab5	233	__u32 eccbytes;
0ceacf36	234	__u32 eccpos[MTD_MAX_ECCPOS_ENTRIES];
ccef7ab5	235	__u32 oobavail;
5bd34c09 TG	236	struct nand_oobfree oobfree[MTD_MAX_OOBFREE_ENTRIES];
	237	};
	238
f1a28c02	239	/**
ea9b6dcc	240	* struct mtd_ecc_stats - error correction stats
f1a28c02 TG	241	*
	242	* @corrected: number of corrected bits
	243	* @failed: number of uncorrectable errors
	244	* @badblocks: number of bad blocks in this partition
	245	* @bbtblocks: number of blocks reserved for bad block tables
	246	*/
	247	struct mtd_ecc_stats {
ccef7ab5 AB	248	__u32 corrected;
	249	__u32 failed;
	250	__u32 badblocks;
	251	__u32 bbtblocks;
f1a28c02 TG	252	};
	253
	254	/*
4180f24a BN	255	* MTD file modes - for read/write access to MTD
	256	*
	257	* @MTD_FILE_MODE_NORMAL: OTP disabled, ECC enabled
	258	* @MTD_FILE_MODE_OTP_FACTORY: OTP enabled in factory mode
	259	* @MTD_FILE_MODE_OTP_USER: OTP enabled in user mode
	260	* @MTD_FILE_MODE_RAW: OTP disabled, ECC disabled
	261	*
	262	* These modes can be set via ioctl(MTDFILEMODE). The mode mode will be retained
	263	* separately for each open file descriptor.
	264	*
	265	* Note: %MTD_FILE_MODE_RAW provides the same functionality as %MTD_OPS_RAW -
	266	* raw access to the flash, without error correction or autoplacement schemes.
	267	* Wherever possible, the MTD_OPS_* mode will override the MTD_FILE_MODE_* mode
	268	* (e.g., when using ioctl(MEMWRITE)), but in some cases, the MTD_FILE_MODE is
	269	* used out of necessity (e.g., `write()', ioctl(MEMWRITEOOB64)).
f1a28c02 TG	270	*/
f1a28c02 TG	271	enum mtd_file_modes {
beb133fc BN	272	MTD_FILE_MODE_NORMAL = MTD_OTP_OFF,
	273	MTD_FILE_MODE_OTP_FACTORY = MTD_OTP_FACTORY,
	274	MTD_FILE_MODE_OTP_USER = MTD_OTP_USER,
	275	MTD_FILE_MODE_RAW,
f1a28c02 TG	276	};
f1a28c02 TG	277
1da177e4	278	#endif /* __MTD_ABI_H__ */