mirror of
https://github.com/torvalds/linux.git
synced 2024-11-24 13:11:40 +00:00
525bab71fe
On serious situations, UBI may detect serious device corruption, and switch to read-only mode to protect the data and allow debugging. This commit exposes this ro-mode on sysfs, so it can be obtained by userspace tools. Signed-off-by: Ezequiel Garcia <ezequiel@vanguardiasur.com.ar> Signed-off-by: Richard Weinberger <richard@nod.at>
222 lines
7.1 KiB
Plaintext
222 lines
7.1 KiB
Plaintext
What: /sys/class/ubi/
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
The ubi/ class sub-directory belongs to the UBI subsystem and
|
|
provides general UBI information, per-UBI device information
|
|
and per-UBI volume information.
|
|
|
|
What: /sys/class/ubi/version
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
This file contains version of the latest supported UBI on-media
|
|
format. Currently it is 1, and there is no plan to change this.
|
|
However, if in the future UBI needs on-flash format changes
|
|
which cannot be done in a compatible manner, a new format
|
|
version will be added. So this is a mechanism for possible
|
|
future backward-compatible (but forward-incompatible)
|
|
improvements.
|
|
|
|
What: /sys/class/ubiX/
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
The /sys/class/ubi0, /sys/class/ubi1, etc directories describe
|
|
UBI devices (UBI device 0, 1, etc). They contain general UBI
|
|
device information and per UBI volume information (each UBI
|
|
device may have many UBI volumes)
|
|
|
|
What: /sys/class/ubi/ubiX/avail_eraseblocks
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Amount of available logical eraseblock. For example, one may
|
|
create a new UBI volume which has this amount of logical
|
|
eraseblocks.
|
|
|
|
What: /sys/class/ubi/ubiX/bad_peb_count
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Count of bad physical eraseblocks on the underlying MTD device.
|
|
|
|
What: /sys/class/ubi/ubiX/bgt_enabled
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Contains ASCII "0\n" if the UBI background thread is disabled,
|
|
and ASCII "1\n" if it is enabled.
|
|
|
|
What: /sys/class/ubi/ubiX/dev
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Major and minor numbers of the character device corresponding
|
|
to this UBI device (in <major>:<minor> format).
|
|
|
|
What: /sys/class/ubi/ubiX/eraseblock_size
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Maximum logical eraseblock size this UBI device may provide. UBI
|
|
volumes may have smaller logical eraseblock size because of their
|
|
alignment.
|
|
|
|
What: /sys/class/ubi/ubiX/max_ec
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Maximum physical eraseblock erase counter value.
|
|
|
|
What: /sys/class/ubi/ubiX/max_vol_count
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Maximum number of volumes which this UBI device may have.
|
|
|
|
What: /sys/class/ubi/ubiX/min_io_size
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Minimum input/output unit size. All the I/O may only be done
|
|
in fractions of the contained number.
|
|
|
|
What: /sys/class/ubi/ubiX/mtd_num
|
|
Date: January 2008
|
|
KernelVersion: 2.6.25
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Number of the underlying MTD device.
|
|
|
|
What: /sys/class/ubi/ubiX/reserved_for_bad
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Number of physical eraseblocks reserved for bad block handling.
|
|
|
|
What: /sys/class/ubi/ubiX/ro_mode
|
|
Date: April 2016
|
|
KernelVersion: 4.7
|
|
Contact: linux-mtd@lists.infradead.org
|
|
Description:
|
|
Contains ASCII "1\n" if the read-only flag is set on this
|
|
device, and "0\n" if it is cleared. UBI devices mark themselves
|
|
as read-only when they detect an unrecoverable error.
|
|
|
|
What: /sys/class/ubi/ubiX/total_eraseblocks
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Total number of good (not marked as bad) physical eraseblocks on
|
|
the underlying MTD device.
|
|
|
|
What: /sys/class/ubi/ubiX/volumes_count
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Count of volumes on this UBI device.
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
The /sys/class/ubi/ubiX/ubiX_0/, /sys/class/ubi/ubiX/ubiX_1/,
|
|
etc directories describe UBI volumes on UBI device X (volumes
|
|
0, 1, etc).
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/alignment
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Volume alignment - the value the logical eraseblock size of
|
|
this volume has to be aligned on. For example, 2048 means that
|
|
logical eraseblock size is multiple of 2048. In other words,
|
|
volume logical eraseblock size is UBI device logical eraseblock
|
|
size aligned to the alignment value.
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/corrupted
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Contains ASCII "0\n" if the UBI volume is OK, and ASCII "1\n"
|
|
if it is corrupted (e.g., due to an interrupted volume update).
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/data_bytes
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
The amount of data this volume contains. This value makes sense
|
|
only for static volumes, and for dynamic volume it equivalent
|
|
to the total volume size in bytes.
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/dev
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Major and minor numbers of the character device corresponding
|
|
to this UBI volume (in <major>:<minor> format).
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/name
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Volume name.
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/reserved_ebs
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Count of physical eraseblock reserved for this volume.
|
|
Equivalent to the volume size in logical eraseblocks.
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/type
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Volume type. Contains ASCII "dynamic\n" for dynamic volumes and
|
|
"static\n" for static volumes.
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/upd_marker
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Contains ASCII "0\n" if the update marker is not set for this
|
|
volume, and "1\n" if it is set. The update marker is set when
|
|
volume update starts, and cleaned when it ends. So the presence
|
|
of the update marker indicates that the volume is being updated
|
|
at the moment of the update was interrupted. The later may be
|
|
checked using the "corrupted" sysfs file.
|
|
|
|
What: /sys/class/ubi/ubiX/ubiX_Y/usable_eb_size
|
|
Date: July 2006
|
|
KernelVersion: 2.6.22
|
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
|
Description:
|
|
Logical eraseblock size of this volume. Equivalent to logical
|
|
eraseblock size of the device aligned on the volume alignment
|
|
value.
|