Matt Kline [Wed, 1 Apr 2015 20:55:58 +0000 (13:55 -0700)]
Update UBIFS mounting instructions
I recently spent several days attempting to mount a UBIFS image.
Efforts were hampered by seemingly outdated documentation,
the fact that much of the documentation was for UBI images,
not UBIFS ones, and the fact that the image was for NOR memory and
all documentation I found only referenced nandsim.
After some very kind help on IRC and from Artem Bityutskiy on the
mailing list, I was able to figure things out. I think it is only
fair that I contribute back and bring the web site up to date so
others don't face the same stumbling blocks.
This patch includes the following changes:
- Acknowledge that udev _does_ now create a block device
automatically for MTD.
- Provide instructions for mounting standalone UBIFS images as well
as UBI images.
- Mention mtdram and its usefulness in mounting UBIFS images made
for NOR memory.
Signed-off-by: Matt Kline <matthew.kline@flukenetworks.com> Signed-off-by: Brian Norris <computersforpeace@gmail.com>
Brian Norris [Sat, 20 Dec 2014 02:38:23 +0000 (18:38 -0800)]
footer: drop 'Last updated' and other buggy footer notices
These "last updated" messages are often wrong, and are rarely useful. We
could also drop the VAR_CVSID definitions from all the other source
files, but there's no need at the moment.
Signed-off-by: Brian Norris <computersforpeace@gmail.com>
The truly great NAND table that we have is rather difficult to follow because
it is big. Make this a bit easier by applying different background colors to
different rows. Alternate the colors with period = 4.
Signed-off-by: Artem Bityutskiy <artem.bityutskiy@linux.intel.com> Acked-by: Brian Norris <computersforpeace@gmail.com>
Mike Dunn [Sun, 13 May 2012 16:53:27 +0000 (09:53 -0700)]
mtd-www: add blurb about API changes and -EUCLEAN to doc/general
Here's my attempt at the documentation requested by Artem. There was no
discussion of the API, so it seemed like some general info was needed before
discussing EUCLEAN. Also mentioned the switch to the API wrappers.
Signed-off-by: Mike Dunn <mikedunn@newsguy.com> Signed-off-by: Artem Bityutskiy <artem.bityutskiy@linux.intel.com>
Brian Norris [Sat, 5 May 2012 04:04:58 +0000 (21:04 -0700)]
doc: update info for Linux 3.0
Although 'linux-2.6.git' is still a valid repository, the preferred name is
just 'linux.git', now that Linux has reached version 3.x. And David also has
his repository under 'linux-mtd.git' now, so we might as well redirect to the
modern naming.
So:
linux-2.6.git -> linux.git
mtd-2.6.git -> linux-mtd.git
Signed-off-by: Brian Norris <computersforpeace@gmail.com> Cc: David Woodhouse <dwmw2@infradead.org> Signed-off-by: Artem Bityutskiy <artem.bityutskiy@linux.intel.com>
Daniel Drake [Wed, 4 Apr 2012 21:27:06 +0000 (22:27 +0100)]
UBI FAQ: suggest omission of vol_size option
OLPC set vol_size based on the size of the target NAND and found out
that it resulted in some systems being unbootable, where such systems
had a lot of bad blocks on their flash.
For distributors such as OLPC wishing to maximize robustness in the
face of varying bad block counts, it makes a lot of sense to avoid
the vol_size option and let it be calculated automatically.
Document this.
Signed-off-by: Daniel Drake <dsd@laptop.org> Signed-off-by: Artem Bityutskiy <artem.bityutskiy@linux.intel.com>
Angus CLARK [Thu, 5 Jan 2012 16:13:56 +0000 (16:13 +0000)]
nand-data: update READID data for family of Micron devices
Update the READID data for the following Micron devices: MT29F4G08ABADA,
MT29F4G16ABADA, MT29F4G08ABBDA, MT29F4G16ABBDA, MT29F8G08ADBDA, MT29F8G16ADBDA,
MT29F8G08ADADA, MT29F8G16ADADA. (Problem with the second byte in the Full ID
column.)
Signed-off-by: Angus Clark <angus.clark@st.com> Acked-by: Brian Norris <computersforpeace@gmail.com>
Angus CLARK [Thu, 5 Jan 2012 16:13:55 +0000 (16:13 +0000)]
nand-data: rename duplicate Numonyx NAND01G devices as 'Rev C'
The table includes two entries for each of the following Numonyx devices:
NAND01GR3B2B, NAND01GW3B2B, NAND01GR4B2B, NAND01GW4B2B. After further analysis,
it seems that the data for the second set of entries actaully coresponds to the
'Rev C' version of the devices, rather than 'Rev B' as suggested by the names.
This patch renames the second set of entries with the 'Rev C' names.
Signed-off-by: Angus Clark <angus.clark@st.com> Acked-by: Brian Norris <computersforpeace@gmail.com>
Angus CLARK [Thu, 5 Jan 2012 16:13:54 +0000 (16:13 +0000)]
nand-data: updates to S30ML-P devices
Updates to Spansion S30ML-P devices:
- expand names to differentiate between x8 and x16 devices
- fix ID 5th byte: 0x01 to 0x10 (checked with datasheet; seems regression
introduced as part of commit 165cfaa9cdb1054bbafa98f24f179c6aa101fbe6
"nand-data: remove asterisks")
Signed-off-by: Angus Clark <angus.clark@st.com> Acked-by: Brian Norris <computersforpeace@gmail.com>
Angus CLARK [Tue, 6 Dec 2011 12:07:39 +0000 (12:07 +0000)]
nand-data: Samsung devices: fix ID Length = "5?"
Change the ID Length for Samsung devices K9F8G08B0M, K9F8G08U0M, K9F8G08U1M,
from "5?" to "5", as documented in the datasheets and verified on a K9F8G08B0M
device.
Signed-off-by: Angus Clark <angus.clark@st.com> Acked-by: Brian Norris <computersforpeace@gmail.com>
Angus CLARK [Tue, 6 Dec 2011 12:07:37 +0000 (12:07 +0000)]
nand-data: update TC58DVM72A1TG00 BBM info
Update Toshiba TC58DVM72A1TG00 bad block marker information to "1st page (6th
byte in OOB = non FFh)", as described in datasheet, and confirmed with Toshiba
engineers.
Signed-off-by: Angus Clark <angus.clark@st.com> Acked-by: Brian Norris <computersforpeace@gmail.com>
Brian Norris [Tue, 9 Aug 2011 22:05:31 +0000 (15:05 -0700)]
faq: general: add bug reporting FAQ
It's surprising to note that we do not have a general "how to send a bug
report" FAQ. This patch provides a starting point and (most importantly)
directs UBI/UBIFS users to the appropriate bug reporting information.
Signed-off-by: Brian Norris <computersforpeace@gmail.com> Signed-off-by: Artem Bityutskiy <dedekind1@gmail.com>
Brian Norris [Tue, 9 Aug 2011 22:03:54 +0000 (15:03 -0700)]
faq: ubi(fs): sending bug reports using `mtdinfo'
The `mtdinfo' utility (with the `-a' flag) is much more informative
than `cat /proc/mtd', so encourage users to use it if possible when
sending bug reports.
Signed-off-by: Brian Norris <computersforpeace@gmail.com> Signed-off-by: Artem Bityutskiy <dedekind1@gmail.com>
Brian Norris [Mon, 8 Aug 2011 19:37:16 +0000 (12:37 -0700)]
doc: update info on compiling mtd-utils
The recursive build system for mtd-utils was rewritten enough recently
such that the description regarding builing ubi-utils by typing `make'
from its subdirectory is now incorrect. Update the UBI docs to reflect
this.
Also, I copied and edited some basic info from the UBI docs to include
in the general description on compiling mtd-utils.
Signed-off-by: Brian Norris <computersforpeace@gmail.com> Signed-off-by: Artem Bityutskiy <dedekind1@gmail.com>
Brian Norris [Mon, 8 Aug 2011 19:37:14 +0000 (12:37 -0700)]
faq/doc: ubi(fs): move "bug report" questions to FAQ
The "How do I send XXX bug report?" questions belong in the FAQ
for easier access (plus, they're questions anyway). We can then
consolidate/link the bug report information to the "general" FAQ
to give a more unified location for bug reporting info.
Signed-off-by: Brian Norris <computersforpeace@gmail.com> Signed-off-by: Artem Bityutskiy <dedekind1@gmail.com>
Brian Norris [Tue, 19 Jul 2011 22:40:43 +0000 (15:40 -0700)]
nand-data: update ONFI detection stats
Chips that support ONFI will be detected properly; we don't rely on any
ID decoding for these, even if ID decoding would detect them correctly.
This patch just updates the "Full Support" field for certain ONFI-capable
chips and changes their "Detection Method" to "ONFI".
Signed-off-by: Brian Norris <computersforpeace@gmail.com> Signed-off-by: Artem Bityutskiy <dedekind1@gmail.com>
Brian Norris [Tue, 19 Jul 2011 22:40:41 +0000 (15:40 -0700)]
nand-data: remove asterisks
Asterisks (*) were added to indicate that support for certain NAND parts
was not yet integrated into the mainline kernel. Fixes have been merged
now, so remove the notes.
Signed-off-by: Brian Norris <computersforpeace@gmail.com> Signed-off-by: Artem Bityutskiy <dedekind1@gmail.com>
Several parts of the UBI and UBIFS documentation already mention the need to
use ubiformat when flashing UBIFS images. Add a new FAQ entry for the "free
space fixup" flag as an alternative in recent kernels, and put links to it in
these existing locations.
Artem Bityutskiy [Tue, 22 Mar 2011 13:28:19 +0000 (15:28 +0200)]
UBI/UBIFS: tell the truth about linux-next
Although the documentation states the linux-next branch of the
UBI and UBIFS trees is never re-based, I did re-base them several
times. So remove that statement.