] Add mtd panic_write function pointer
RFC PATCH 1/3 ] Add mtd panic_write function pointer
MTDs are well suited for logging critical data and the mtdoops driver allows kernel panics/oops to be written to flash in a blackbox flight recorder fashion allowing better debugging and analysis of crashes.
Any kernel oops in user context can be easily handled since the kernel continues as normal and any queued mtd writes are scheduled. Any kernel oops in interrupt context results in a panic and the delayed writes will not be scheduled however. The existing mtd->write function cannot be called in interrupt context so these messages can never be written to flash.
This patch adds a panic_write function pointer that drivers can optionally implement which can be called in interrupt context. It is only intended to be called when its known the kernel is about to panic and we need to write to succeed. Since the kernel is not going to be running for much longer, this function can break locks and delay to ensure the write succeeds (but not sleep).
--- drivers/mtd/mtdpart.c | 17 +++++++++++++++++ include/linux/mtd/mtd.h | 2 ++ 2 files changed, 19 insertions(+)
drivers/mtd/mtdpart.c +17 -0
@@ -151,6 +151,20 @@ static int part_write (struct mtd_info * len, retlen, buf); } +static int part_panic_write (struct mtd_info *mtd,loff_t to,size_t len, +size_t *retlen,const u_char *buf) +{ +struct mtd_part *part =PART (mtd); +if (!(mtd->flags &MTD_WRITEABLE )) +return -EROFS ; +if (to >= mtd->size) + len =0 ; +else if (to + len > mtd->size) + len = mtd->size - to; +return part->master->panic_write (part->master, to + part->offset, + len, retlen, buf); +} +static int part_write_oob (struct mtd_info *mtd,loff_t to,struct mtd_oob_ops *ops) {
@@ -352,6 +366,9 @@ int add_mtd_partitions(struct mtd_info * slave->mtd.read = part_read; slave->mtd.write = part_write; +if (master->panic_write) + slave->mtd.panic_write = part_panic_write; +if (master->point && master->unpoint){ slave->mtd.point = part_point; slave->mtd.unpoint = part_unpoint;
include/linux/mtd/mtd.h +2 -0
@@ -152,6 +152,8 @@ struct mtd_info {int (*read) (struct mtd_info *mtd,loff_t from,size_t len,size_t *retlen,u_char *buf);int (*write) (struct mtd_info *mtd,loff_t to,size_t len,size_t *retlen,const u_char *buf); +int (*panic_write) (struct mtd_info *mtd,loff_t to,size_t len,size_t *retlen,const u_char *buf); +int (*read_oob) (struct mtd_info *mtd,loff_t from,struct mtd_oob_ops *ops); int (*write_oob) (struct mtd_info *mtd, loff_t to,
Quoted 12 lines · Richard Purdie
MTDs are well suited for logging critical data and the mtdoops driver allows kernel panics/oops to be written to flash in a blackbox flight recorder fashion allowing better debugging and analysis of crashes.
Any kernel oops in user context can be easily handled since the kernel continues as normal and any queued mtd writes are scheduled. Any kernel oops in interrupt context results in a panic and the delayed writes will not be scheduled however. The existing
mtd->writefunction cannot be called in interrupt context so these messages can never be written to flash.
Quoted 6 lines
This patch adds a
panic_writefunction pointer that drivers can optionally implement which can be called in interrupt context. It is only intended to be called when its known the kernel is about to panic and we need to write to succeed. Since the kernel is not going to be running for much longer, this function can break locks and delay to ensure the write succeeds (but not sleep).
I like the description. So why is it not part of the patch proper?
Jörn
Signature · 3 lines
Beware of bugs in the above code; I have only proved it correct, but not tried it. -- Donald Knuth
Quoted 13 lines · Jörn Engel
Quoted 12 lines · Richard Purdie
MTDs are well suited for logging critical data and the mtdoops driver allows kernel panics/oops to be written to flash in a blackbox flight recorder fashion allowing better debugging and analysis of crashes.
Any kernel oops in user context can be easily handled since the kernel continues as normal and any queued mtd writes are scheduled. Any kernel oops in interrupt context results in a panic and the delayed writes will not be scheduled however. The existing
mtd->writefunction cannot be called in interrupt context so these messages can never be written to flash.
Quoted 8 lines
Quoted 6 lines
This patch adds a
panic_writefunction pointer that drivers can optionally implement which can be called in interrupt context. It is only intended to be called when its known the kernel is about to panic and we need to write to succeed. Since the kernel is not going to be running for much longer, this function can break locks and delay to ensure the write succeeds (but not sleep).I like the description. So why is it not part of the patch proper?
You mean add it to mtd.h?
Richard
Quoted 5 lines · Richard Purdie
Quoted 2 lines · Jörn Engel
I like the description. So why is it not part of the patch proper?
You mean add it to
mtd.h?
Yes. struct mtd_info, like many other kernel interfaces, is nearly impossible to use without either copying example code or reading the implementation (aka reverse-engineering the kernel). We could certainly do better than that. And for new additions we should.
Jörn
Signature · 4 lines
To announce that there must be no criticism of the President, or that we are to stand by the President, right or wrong, is not only unpatriotic and servile, but is morally treasonable to the American public. -- Theodore Roosevelt, Kansas City Star, 1918
Quoted 4 lines · Jörn Engel
Yes. struct
mtd_info, like many other kernel interfaces, is nearly impossible to use without either copying example code or reading the implementation (aka reverse-engineering the kernel). We could certainly do better than that. And for new additions we should.
Totally agreed, updated patch follows.
MTDs are well suited for logging critical data and the mtdoops driver allows kernel panics/oops to be written to flash in a blackbox flight recorder fashion allowing better debugging and analysis of crashes.
Any kernel oops in user context can be easily handled since the kernel continues as normal and any queued mtd writes are scheduled. Any kernel oops in interrupt context results in a panic and the delayed writes will not be scheduled however. The existing mtd->write function cannot be called in interrupt context so these messages can never be written to flash.
This patch adds a panic_write function pointer that drivers can optionally implement which can be called in interrupt context. It is only intended to be called when its known the kernel is about to panic and we need to write to succeed. Since the kernel is not going to be running for much longer, this function can break locks and delay to ensure the write succeeds (but not sleep).
--- drivers/mtd/mtdpart.c | 17 +++++++++++++++++ include/linux/mtd/mtd.h | 9 +++++++++ 2 files changed, 26 insertions(+)
drivers/mtd/mtdpart.c +17 -0
@@ -151,6 +151,20 @@ static int part_write (struct mtd_info * len, retlen, buf); } +static int part_panic_write (struct mtd_info *mtd,loff_t to,size_t len, +size_t *retlen,const u_char *buf) +{ +struct mtd_part *part =PART (mtd); +if (!(mtd->flags &MTD_WRITEABLE )) +return -EROFS ; +if (to >= mtd->size) + len =0 ; +else if (to + len > mtd->size) + len = mtd->size - to; +return part->master->panic_write (part->master, to + part->offset, + len, retlen, buf); +} +static int part_write_oob (struct mtd_info *mtd,loff_t to,struct mtd_oob_ops *ops) {
@@ -352,6 +366,9 @@ int add_mtd_partitions(struct mtd_info * slave->mtd.read = part_read; slave->mtd.write = part_write; +if (master->panic_write) + slave->mtd.panic_write = part_panic_write; +if (master->point && master->unpoint){ slave->mtd.point = part_point; slave->mtd.unpoint = part_unpoint;
include/linux/mtd/mtd.h +9 -0
@@ -152,6 +152,15 @@ struct mtd_info {int (*read) (struct mtd_info *mtd,loff_t from,size_t len,size_t *retlen,u_char *buf);int (*write) (struct mtd_info *mtd,loff_t to,size_t len,size_t *retlen,const u_char *buf); +/* In blackbox flight recorder like scenarios we want to make successful +writes in interrupt context. panic_write() is only intended to be +called when its known the kernel is about to panic and we need the +write to succeed. Since the kernel is not going to be running for much +longer, this function can break locks and delay to ensure the write +succeeds (but not sleep). */ + +int (*panic_write) (struct mtd_info *mtd,loff_t to,size_t len,size_t *retlen,const u_char *buf); +int (*read_oob) (struct mtd_info *mtd,loff_t from,struct mtd_oob_ops *ops); int (*write_oob) (struct mtd_info *mtd, loff_t to,
I've now shared these 3 patches as a git branch based on top of the current mtd-2.6 tree:
git://git.o-hand.com/linux-rpurdie mtd-panicwrite
Cheers,
Richard