2 * Copyright (c) International Business Machines Corp., 2006
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.
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
12 * the GNU General Public License for more details.
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18 * Author: Artem Bityutskiy (Битюцкий Артём)
22 #include <linux/debugfs.h>
23 #include <linux/uaccess.h>
24 #include <linux/module.h>
28 * ubi_dump_flash - dump a region of flash.
29 * @ubi: UBI device description object
30 * @pnum: the physical eraseblock number to dump
31 * @offset: the starting offset within the physical eraseblock to dump
32 * @len: the length of the region to dump
34 void ubi_dump_flash(struct ubi_device
*ubi
, int pnum
, int offset
, int len
)
39 loff_t addr
= (loff_t
)pnum
* ubi
->peb_size
+ offset
;
44 err
= mtd_read(ubi
->mtd
, addr
, len
, &read
, buf
);
45 if (err
&& err
!= -EUCLEAN
) {
46 ubi_err(ubi
, "err %d while reading %d bytes from PEB %d:%d, read %zd bytes",
47 err
, len
, pnum
, offset
, read
);
51 ubi_msg(ubi
, "dumping %d bytes of data from PEB %d, offset %d",
53 print_hex_dump(KERN_DEBUG
, "", DUMP_PREFIX_OFFSET
, 32, 1, buf
, len
, 1);
60 * ubi_dump_ec_hdr - dump an erase counter header.
61 * @ec_hdr: the erase counter header to dump
63 void ubi_dump_ec_hdr(const struct ubi_ec_hdr
*ec_hdr
)
65 pr_err("Erase counter header dump:\n");
66 pr_err("\tmagic %#08x\n", be32_to_cpu(ec_hdr
->magic
));
67 pr_err("\tversion %d\n", (int)ec_hdr
->version
);
68 pr_err("\tec %llu\n", (long long)be64_to_cpu(ec_hdr
->ec
));
69 pr_err("\tvid_hdr_offset %d\n", be32_to_cpu(ec_hdr
->vid_hdr_offset
));
70 pr_err("\tdata_offset %d\n", be32_to_cpu(ec_hdr
->data_offset
));
71 pr_err("\timage_seq %d\n", be32_to_cpu(ec_hdr
->image_seq
));
72 pr_err("\thdr_crc %#08x\n", be32_to_cpu(ec_hdr
->hdr_crc
));
73 pr_err("erase counter header hexdump:\n");
74 print_hex_dump(KERN_DEBUG
, "", DUMP_PREFIX_OFFSET
, 32, 1,
75 ec_hdr
, UBI_EC_HDR_SIZE
, 1);
79 * ubi_dump_vid_hdr - dump a volume identifier header.
80 * @vid_hdr: the volume identifier header to dump
82 void ubi_dump_vid_hdr(const struct ubi_vid_hdr
*vid_hdr
)
84 pr_err("Volume identifier header dump:\n");
85 pr_err("\tmagic %08x\n", be32_to_cpu(vid_hdr
->magic
));
86 pr_err("\tversion %d\n", (int)vid_hdr
->version
);
87 pr_err("\tvol_type %d\n", (int)vid_hdr
->vol_type
);
88 pr_err("\tcopy_flag %d\n", (int)vid_hdr
->copy_flag
);
89 pr_err("\tcompat %d\n", (int)vid_hdr
->compat
);
90 pr_err("\tvol_id %d\n", be32_to_cpu(vid_hdr
->vol_id
));
91 pr_err("\tlnum %d\n", be32_to_cpu(vid_hdr
->lnum
));
92 pr_err("\tdata_size %d\n", be32_to_cpu(vid_hdr
->data_size
));
93 pr_err("\tused_ebs %d\n", be32_to_cpu(vid_hdr
->used_ebs
));
94 pr_err("\tdata_pad %d\n", be32_to_cpu(vid_hdr
->data_pad
));
95 pr_err("\tsqnum %llu\n",
96 (unsigned long long)be64_to_cpu(vid_hdr
->sqnum
));
97 pr_err("\thdr_crc %08x\n", be32_to_cpu(vid_hdr
->hdr_crc
));
98 pr_err("Volume identifier header hexdump:\n");
99 print_hex_dump(KERN_DEBUG
, "", DUMP_PREFIX_OFFSET
, 32, 1,
100 vid_hdr
, UBI_VID_HDR_SIZE
, 1);
104 * ubi_dump_vol_info - dump volume information.
105 * @vol: UBI volume description object
107 void ubi_dump_vol_info(const struct ubi_volume
*vol
)
109 pr_err("Volume information dump:\n");
110 pr_err("\tvol_id %d\n", vol
->vol_id
);
111 pr_err("\treserved_pebs %d\n", vol
->reserved_pebs
);
112 pr_err("\talignment %d\n", vol
->alignment
);
113 pr_err("\tdata_pad %d\n", vol
->data_pad
);
114 pr_err("\tvol_type %d\n", vol
->vol_type
);
115 pr_err("\tname_len %d\n", vol
->name_len
);
116 pr_err("\tusable_leb_size %d\n", vol
->usable_leb_size
);
117 pr_err("\tused_ebs %d\n", vol
->used_ebs
);
118 pr_err("\tused_bytes %lld\n", vol
->used_bytes
);
119 pr_err("\tlast_eb_bytes %d\n", vol
->last_eb_bytes
);
120 pr_err("\tcorrupted %d\n", vol
->corrupted
);
121 pr_err("\tupd_marker %d\n", vol
->upd_marker
);
123 if (vol
->name_len
<= UBI_VOL_NAME_MAX
&&
124 strnlen(vol
->name
, vol
->name_len
+ 1) == vol
->name_len
) {
125 pr_err("\tname %s\n", vol
->name
);
127 pr_err("\t1st 5 characters of name: %c%c%c%c%c\n",
128 vol
->name
[0], vol
->name
[1], vol
->name
[2],
129 vol
->name
[3], vol
->name
[4]);
134 * ubi_dump_vtbl_record - dump a &struct ubi_vtbl_record object.
135 * @r: the object to dump
136 * @idx: volume table index
138 void ubi_dump_vtbl_record(const struct ubi_vtbl_record
*r
, int idx
)
140 int name_len
= be16_to_cpu(r
->name_len
);
142 pr_err("Volume table record %d dump:\n", idx
);
143 pr_err("\treserved_pebs %d\n", be32_to_cpu(r
->reserved_pebs
));
144 pr_err("\talignment %d\n", be32_to_cpu(r
->alignment
));
145 pr_err("\tdata_pad %d\n", be32_to_cpu(r
->data_pad
));
146 pr_err("\tvol_type %d\n", (int)r
->vol_type
);
147 pr_err("\tupd_marker %d\n", (int)r
->upd_marker
);
148 pr_err("\tname_len %d\n", name_len
);
150 if (r
->name
[0] == '\0') {
151 pr_err("\tname NULL\n");
155 if (name_len
<= UBI_VOL_NAME_MAX
&&
156 strnlen(&r
->name
[0], name_len
+ 1) == name_len
) {
157 pr_err("\tname %s\n", &r
->name
[0]);
159 pr_err("\t1st 5 characters of name: %c%c%c%c%c\n",
160 r
->name
[0], r
->name
[1], r
->name
[2], r
->name
[3],
163 pr_err("\tcrc %#08x\n", be32_to_cpu(r
->crc
));
167 * ubi_dump_av - dump a &struct ubi_ainf_volume object.
168 * @av: the object to dump
170 void ubi_dump_av(const struct ubi_ainf_volume
*av
)
172 pr_err("Volume attaching information dump:\n");
173 pr_err("\tvol_id %d\n", av
->vol_id
);
174 pr_err("\thighest_lnum %d\n", av
->highest_lnum
);
175 pr_err("\tleb_count %d\n", av
->leb_count
);
176 pr_err("\tcompat %d\n", av
->compat
);
177 pr_err("\tvol_type %d\n", av
->vol_type
);
178 pr_err("\tused_ebs %d\n", av
->used_ebs
);
179 pr_err("\tlast_data_size %d\n", av
->last_data_size
);
180 pr_err("\tdata_pad %d\n", av
->data_pad
);
184 * ubi_dump_aeb - dump a &struct ubi_ainf_peb object.
185 * @aeb: the object to dump
186 * @type: object type: 0 - not corrupted, 1 - corrupted
188 void ubi_dump_aeb(const struct ubi_ainf_peb
*aeb
, int type
)
190 pr_err("eraseblock attaching information dump:\n");
191 pr_err("\tec %d\n", aeb
->ec
);
192 pr_err("\tpnum %d\n", aeb
->pnum
);
194 pr_err("\tlnum %d\n", aeb
->lnum
);
195 pr_err("\tscrub %d\n", aeb
->scrub
);
196 pr_err("\tsqnum %llu\n", aeb
->sqnum
);
201 * ubi_dump_mkvol_req - dump a &struct ubi_mkvol_req object.
202 * @req: the object to dump
204 void ubi_dump_mkvol_req(const struct ubi_mkvol_req
*req
)
208 pr_err("Volume creation request dump:\n");
209 pr_err("\tvol_id %d\n", req
->vol_id
);
210 pr_err("\talignment %d\n", req
->alignment
);
211 pr_err("\tbytes %lld\n", (long long)req
->bytes
);
212 pr_err("\tvol_type %d\n", req
->vol_type
);
213 pr_err("\tname_len %d\n", req
->name_len
);
215 memcpy(nm
, req
->name
, 16);
217 pr_err("\t1st 16 characters of name: %s\n", nm
);
221 * Root directory for UBI stuff in debugfs. Contains sub-directories which
222 * contain the stuff specific to particular UBI devices.
224 static struct dentry
*dfs_rootdir
;
227 * ubi_debugfs_init - create UBI debugfs directory.
229 * Create UBI debugfs directory. Returns zero in case of success and a negative
230 * error code in case of failure.
232 int ubi_debugfs_init(void)
234 if (!IS_ENABLED(CONFIG_DEBUG_FS
))
237 dfs_rootdir
= debugfs_create_dir("ubi", NULL
);
238 if (IS_ERR_OR_NULL(dfs_rootdir
)) {
239 int err
= dfs_rootdir
? PTR_ERR(dfs_rootdir
) : -ENODEV
;
241 pr_err("UBI error: cannot create \"ubi\" debugfs directory, error %d\n",
250 * ubi_debugfs_exit - remove UBI debugfs directory.
252 void ubi_debugfs_exit(void)
254 if (IS_ENABLED(CONFIG_DEBUG_FS
))
255 debugfs_remove(dfs_rootdir
);
258 /* Read an UBI debugfs file */
259 static ssize_t
dfs_file_read(struct file
*file
, char __user
*user_buf
,
260 size_t count
, loff_t
*ppos
)
262 unsigned long ubi_num
= (unsigned long)file
->private_data
;
263 struct dentry
*dent
= file
->f_path
.dentry
;
264 struct ubi_device
*ubi
;
265 struct ubi_debug_info
*d
;
269 ubi
= ubi_get_device(ubi_num
);
274 if (dent
== d
->dfs_chk_gen
)
276 else if (dent
== d
->dfs_chk_io
)
278 else if (dent
== d
->dfs_chk_fastmap
)
279 val
= d
->chk_fastmap
;
280 else if (dent
== d
->dfs_disable_bgt
)
281 val
= d
->disable_bgt
;
282 else if (dent
== d
->dfs_emulate_bitflips
)
283 val
= d
->emulate_bitflips
;
284 else if (dent
== d
->dfs_emulate_io_failures
)
285 val
= d
->emulate_io_failures
;
286 else if (dent
== d
->dfs_emulate_power_cut
) {
287 snprintf(buf
, sizeof(buf
), "%u\n", d
->emulate_power_cut
);
288 count
= simple_read_from_buffer(user_buf
, count
, ppos
,
291 } else if (dent
== d
->dfs_power_cut_min
) {
292 snprintf(buf
, sizeof(buf
), "%u\n", d
->power_cut_min
);
293 count
= simple_read_from_buffer(user_buf
, count
, ppos
,
296 } else if (dent
== d
->dfs_power_cut_max
) {
297 snprintf(buf
, sizeof(buf
), "%u\n", d
->power_cut_max
);
298 count
= simple_read_from_buffer(user_buf
, count
, ppos
,
314 count
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, 2);
321 /* Write an UBI debugfs file */
322 static ssize_t
dfs_file_write(struct file
*file
, const char __user
*user_buf
,
323 size_t count
, loff_t
*ppos
)
325 unsigned long ubi_num
= (unsigned long)file
->private_data
;
326 struct dentry
*dent
= file
->f_path
.dentry
;
327 struct ubi_device
*ubi
;
328 struct ubi_debug_info
*d
;
333 ubi
= ubi_get_device(ubi_num
);
338 buf_size
= min_t(size_t, count
, (sizeof(buf
) - 1));
339 if (copy_from_user(buf
, user_buf
, buf_size
)) {
344 if (dent
== d
->dfs_power_cut_min
) {
345 if (kstrtouint(buf
, 0, &d
->power_cut_min
) != 0)
348 } else if (dent
== d
->dfs_power_cut_max
) {
349 if (kstrtouint(buf
, 0, &d
->power_cut_max
) != 0)
352 } else if (dent
== d
->dfs_emulate_power_cut
) {
353 if (kstrtoint(buf
, 0, &val
) != 0)
356 d
->emulate_power_cut
= val
;
362 else if (buf
[0] == '0')
369 if (dent
== d
->dfs_chk_gen
)
371 else if (dent
== d
->dfs_chk_io
)
373 else if (dent
== d
->dfs_chk_fastmap
)
374 d
->chk_fastmap
= val
;
375 else if (dent
== d
->dfs_disable_bgt
)
376 d
->disable_bgt
= val
;
377 else if (dent
== d
->dfs_emulate_bitflips
)
378 d
->emulate_bitflips
= val
;
379 else if (dent
== d
->dfs_emulate_io_failures
)
380 d
->emulate_io_failures
= val
;
389 /* File operations for all UBI debugfs files */
390 static const struct file_operations dfs_fops
= {
391 .read
= dfs_file_read
,
392 .write
= dfs_file_write
,
395 .owner
= THIS_MODULE
,
399 * ubi_debugfs_init_dev - initialize debugfs for an UBI device.
400 * @ubi: UBI device description object
402 * This function creates all debugfs files for UBI device @ubi. Returns zero in
403 * case of success and a negative error code in case of failure.
405 int ubi_debugfs_init_dev(struct ubi_device
*ubi
)
408 unsigned long ubi_num
= ubi
->ubi_num
;
411 struct ubi_debug_info
*d
= &ubi
->dbg
;
413 if (!IS_ENABLED(CONFIG_DEBUG_FS
))
416 n
= snprintf(d
->dfs_dir_name
, UBI_DFS_DIR_LEN
+ 1, UBI_DFS_DIR_NAME
,
418 if (n
== UBI_DFS_DIR_LEN
) {
419 /* The array size is too small */
420 fname
= UBI_DFS_DIR_NAME
;
421 dent
= ERR_PTR(-EINVAL
);
425 fname
= d
->dfs_dir_name
;
426 dent
= debugfs_create_dir(fname
, dfs_rootdir
);
427 if (IS_ERR_OR_NULL(dent
))
432 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
434 if (IS_ERR_OR_NULL(dent
))
436 d
->dfs_chk_gen
= dent
;
439 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
441 if (IS_ERR_OR_NULL(dent
))
443 d
->dfs_chk_io
= dent
;
445 fname
= "chk_fastmap";
446 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
448 if (IS_ERR_OR_NULL(dent
))
450 d
->dfs_chk_fastmap
= dent
;
452 fname
= "tst_disable_bgt";
453 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
455 if (IS_ERR_OR_NULL(dent
))
457 d
->dfs_disable_bgt
= dent
;
459 fname
= "tst_emulate_bitflips";
460 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
462 if (IS_ERR_OR_NULL(dent
))
464 d
->dfs_emulate_bitflips
= dent
;
466 fname
= "tst_emulate_io_failures";
467 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
469 if (IS_ERR_OR_NULL(dent
))
471 d
->dfs_emulate_io_failures
= dent
;
473 fname
= "tst_emulate_power_cut";
474 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
476 if (IS_ERR_OR_NULL(dent
))
478 d
->dfs_emulate_power_cut
= dent
;
480 fname
= "tst_emulate_power_cut_min";
481 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
483 if (IS_ERR_OR_NULL(dent
))
485 d
->dfs_power_cut_min
= dent
;
487 fname
= "tst_emulate_power_cut_max";
488 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
490 if (IS_ERR_OR_NULL(dent
))
492 d
->dfs_power_cut_max
= dent
;
497 debugfs_remove_recursive(d
->dfs_dir
);
499 err
= dent
? PTR_ERR(dent
) : -ENODEV
;
500 ubi_err(ubi
, "cannot create \"%s\" debugfs file or directory, error %d\n",
506 * dbg_debug_exit_dev - free all debugfs files corresponding to device @ubi
507 * @ubi: UBI device description object
509 void ubi_debugfs_exit_dev(struct ubi_device
*ubi
)
511 if (IS_ENABLED(CONFIG_DEBUG_FS
))
512 debugfs_remove_recursive(ubi
->dbg
.dfs_dir
);
516 * ubi_dbg_power_cut - emulate a power cut if it is time to do so
517 * @ubi: UBI device description object
518 * @caller: Flags set to indicate from where the function is being called
520 * Returns non-zero if a power cut was emulated, zero if not.
522 int ubi_dbg_power_cut(struct ubi_device
*ubi
, int caller
)
526 if ((ubi
->dbg
.emulate_power_cut
& caller
) == 0)
529 if (ubi
->dbg
.power_cut_counter
== 0) {
530 ubi
->dbg
.power_cut_counter
= ubi
->dbg
.power_cut_min
;
532 if (ubi
->dbg
.power_cut_max
> ubi
->dbg
.power_cut_min
) {
533 range
= ubi
->dbg
.power_cut_max
- ubi
->dbg
.power_cut_min
;
534 ubi
->dbg
.power_cut_counter
+= prandom_u32() % range
;
539 ubi
->dbg
.power_cut_counter
--;
540 if (ubi
->dbg
.power_cut_counter
)
543 ubi_msg(ubi
, "XXXXXXXXXXXXXXX emulating a power cut XXXXXXXXXXXXXXXX");