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("error %d while reading %d bytes from PEB %d:%d, "
47 "read %zd bytes", err
, len
, pnum
, offset
, read
);
51 ubi_msg("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 printk(KERN_DEBUG
"Erase counter header dump:\n");
66 printk(KERN_DEBUG
"\tmagic %#08x\n",
67 be32_to_cpu(ec_hdr
->magic
));
68 printk(KERN_DEBUG
"\tversion %d\n", (int)ec_hdr
->version
);
69 printk(KERN_DEBUG
"\tec %llu\n",
70 (long long)be64_to_cpu(ec_hdr
->ec
));
71 printk(KERN_DEBUG
"\tvid_hdr_offset %d\n",
72 be32_to_cpu(ec_hdr
->vid_hdr_offset
));
73 printk(KERN_DEBUG
"\tdata_offset %d\n",
74 be32_to_cpu(ec_hdr
->data_offset
));
75 printk(KERN_DEBUG
"\timage_seq %d\n",
76 be32_to_cpu(ec_hdr
->image_seq
));
77 printk(KERN_DEBUG
"\thdr_crc %#08x\n",
78 be32_to_cpu(ec_hdr
->hdr_crc
));
79 printk(KERN_DEBUG
"erase counter header hexdump:\n");
80 print_hex_dump(KERN_DEBUG
, "", DUMP_PREFIX_OFFSET
, 32, 1,
81 ec_hdr
, UBI_EC_HDR_SIZE
, 1);
85 * ubi_dump_vid_hdr - dump a volume identifier header.
86 * @vid_hdr: the volume identifier header to dump
88 void ubi_dump_vid_hdr(const struct ubi_vid_hdr
*vid_hdr
)
90 printk(KERN_DEBUG
"Volume identifier header dump:\n");
91 printk(KERN_DEBUG
"\tmagic %08x\n", be32_to_cpu(vid_hdr
->magic
));
92 printk(KERN_DEBUG
"\tversion %d\n", (int)vid_hdr
->version
);
93 printk(KERN_DEBUG
"\tvol_type %d\n", (int)vid_hdr
->vol_type
);
94 printk(KERN_DEBUG
"\tcopy_flag %d\n", (int)vid_hdr
->copy_flag
);
95 printk(KERN_DEBUG
"\tcompat %d\n", (int)vid_hdr
->compat
);
96 printk(KERN_DEBUG
"\tvol_id %d\n", be32_to_cpu(vid_hdr
->vol_id
));
97 printk(KERN_DEBUG
"\tlnum %d\n", be32_to_cpu(vid_hdr
->lnum
));
98 printk(KERN_DEBUG
"\tdata_size %d\n", be32_to_cpu(vid_hdr
->data_size
));
99 printk(KERN_DEBUG
"\tused_ebs %d\n", be32_to_cpu(vid_hdr
->used_ebs
));
100 printk(KERN_DEBUG
"\tdata_pad %d\n", be32_to_cpu(vid_hdr
->data_pad
));
101 printk(KERN_DEBUG
"\tsqnum %llu\n",
102 (unsigned long long)be64_to_cpu(vid_hdr
->sqnum
));
103 printk(KERN_DEBUG
"\thdr_crc %08x\n", be32_to_cpu(vid_hdr
->hdr_crc
));
104 printk(KERN_DEBUG
"Volume identifier header hexdump:\n");
105 print_hex_dump(KERN_DEBUG
, "", DUMP_PREFIX_OFFSET
, 32, 1,
106 vid_hdr
, UBI_VID_HDR_SIZE
, 1);
109 #ifdef CONFIG_MTD_UBI_DEBUG
112 * ubi_dump_vol_info - dump volume information.
113 * @vol: UBI volume description object
115 void ubi_dump_vol_info(const struct ubi_volume
*vol
)
117 printk(KERN_DEBUG
"Volume information dump:\n");
118 printk(KERN_DEBUG
"\tvol_id %d\n", vol
->vol_id
);
119 printk(KERN_DEBUG
"\treserved_pebs %d\n", vol
->reserved_pebs
);
120 printk(KERN_DEBUG
"\talignment %d\n", vol
->alignment
);
121 printk(KERN_DEBUG
"\tdata_pad %d\n", vol
->data_pad
);
122 printk(KERN_DEBUG
"\tvol_type %d\n", vol
->vol_type
);
123 printk(KERN_DEBUG
"\tname_len %d\n", vol
->name_len
);
124 printk(KERN_DEBUG
"\tusable_leb_size %d\n", vol
->usable_leb_size
);
125 printk(KERN_DEBUG
"\tused_ebs %d\n", vol
->used_ebs
);
126 printk(KERN_DEBUG
"\tused_bytes %lld\n", vol
->used_bytes
);
127 printk(KERN_DEBUG
"\tlast_eb_bytes %d\n", vol
->last_eb_bytes
);
128 printk(KERN_DEBUG
"\tcorrupted %d\n", vol
->corrupted
);
129 printk(KERN_DEBUG
"\tupd_marker %d\n", vol
->upd_marker
);
131 if (vol
->name_len
<= UBI_VOL_NAME_MAX
&&
132 strnlen(vol
->name
, vol
->name_len
+ 1) == vol
->name_len
) {
133 printk(KERN_DEBUG
"\tname %s\n", vol
->name
);
135 printk(KERN_DEBUG
"\t1st 5 characters of name: %c%c%c%c%c\n",
136 vol
->name
[0], vol
->name
[1], vol
->name
[2],
137 vol
->name
[3], vol
->name
[4]);
142 * ubi_dump_vtbl_record - dump a &struct ubi_vtbl_record object.
143 * @r: the object to dump
144 * @idx: volume table index
146 void ubi_dump_vtbl_record(const struct ubi_vtbl_record
*r
, int idx
)
148 int name_len
= be16_to_cpu(r
->name_len
);
150 printk(KERN_DEBUG
"Volume table record %d dump:\n", idx
);
151 printk(KERN_DEBUG
"\treserved_pebs %d\n",
152 be32_to_cpu(r
->reserved_pebs
));
153 printk(KERN_DEBUG
"\talignment %d\n", be32_to_cpu(r
->alignment
));
154 printk(KERN_DEBUG
"\tdata_pad %d\n", be32_to_cpu(r
->data_pad
));
155 printk(KERN_DEBUG
"\tvol_type %d\n", (int)r
->vol_type
);
156 printk(KERN_DEBUG
"\tupd_marker %d\n", (int)r
->upd_marker
);
157 printk(KERN_DEBUG
"\tname_len %d\n", name_len
);
159 if (r
->name
[0] == '\0') {
160 printk(KERN_DEBUG
"\tname NULL\n");
164 if (name_len
<= UBI_VOL_NAME_MAX
&&
165 strnlen(&r
->name
[0], name_len
+ 1) == name_len
) {
166 printk(KERN_DEBUG
"\tname %s\n", &r
->name
[0]);
168 printk(KERN_DEBUG
"\t1st 5 characters of name: %c%c%c%c%c\n",
169 r
->name
[0], r
->name
[1], r
->name
[2], r
->name
[3],
172 printk(KERN_DEBUG
"\tcrc %#08x\n", be32_to_cpu(r
->crc
));
176 * ubi_dump_sv - dump a &struct ubi_scan_volume object.
177 * @sv: the object to dump
179 void ubi_dump_sv(const struct ubi_scan_volume
*sv
)
181 printk(KERN_DEBUG
"Volume scanning information dump:\n");
182 printk(KERN_DEBUG
"\tvol_id %d\n", sv
->vol_id
);
183 printk(KERN_DEBUG
"\thighest_lnum %d\n", sv
->highest_lnum
);
184 printk(KERN_DEBUG
"\tleb_count %d\n", sv
->leb_count
);
185 printk(KERN_DEBUG
"\tcompat %d\n", sv
->compat
);
186 printk(KERN_DEBUG
"\tvol_type %d\n", sv
->vol_type
);
187 printk(KERN_DEBUG
"\tused_ebs %d\n", sv
->used_ebs
);
188 printk(KERN_DEBUG
"\tlast_data_size %d\n", sv
->last_data_size
);
189 printk(KERN_DEBUG
"\tdata_pad %d\n", sv
->data_pad
);
193 * ubi_dump_seb - dump a &struct ubi_scan_leb object.
194 * @seb: the object to dump
195 * @type: object type: 0 - not corrupted, 1 - corrupted
197 void ubi_dump_seb(const struct ubi_scan_leb
*seb
, int type
)
199 printk(KERN_DEBUG
"eraseblock scanning information dump:\n");
200 printk(KERN_DEBUG
"\tec %d\n", seb
->ec
);
201 printk(KERN_DEBUG
"\tpnum %d\n", seb
->pnum
);
203 printk(KERN_DEBUG
"\tlnum %d\n", seb
->lnum
);
204 printk(KERN_DEBUG
"\tscrub %d\n", seb
->scrub
);
205 printk(KERN_DEBUG
"\tsqnum %llu\n", seb
->sqnum
);
210 * ubi_dbg_dump_mkvol_req - dump a &struct ubi_mkvol_req object.
211 * @req: the object to dump
213 void ubi_dbg_dump_mkvol_req(const struct ubi_mkvol_req
*req
)
217 printk(KERN_DEBUG
"Volume creation request dump:\n");
218 printk(KERN_DEBUG
"\tvol_id %d\n", req
->vol_id
);
219 printk(KERN_DEBUG
"\talignment %d\n", req
->alignment
);
220 printk(KERN_DEBUG
"\tbytes %lld\n", (long long)req
->bytes
);
221 printk(KERN_DEBUG
"\tvol_type %d\n", req
->vol_type
);
222 printk(KERN_DEBUG
"\tname_len %d\n", req
->name_len
);
224 memcpy(nm
, req
->name
, 16);
226 printk(KERN_DEBUG
"\t1st 16 characters of name: %s\n", nm
);
230 * ubi_debugging_init_dev - initialize debugging for an UBI device.
231 * @ubi: UBI device description object
233 * This function initializes debugging-related data for UBI device @ubi.
234 * Returns zero in case of success and a negative error code in case of
237 int ubi_debugging_init_dev(struct ubi_device
*ubi
)
239 ubi
->dbg
= kzalloc(sizeof(struct ubi_debug_info
), GFP_KERNEL
);
247 * ubi_debugging_exit_dev - free debugging data for an UBI device.
248 * @ubi: UBI device description object
250 void ubi_debugging_exit_dev(struct ubi_device
*ubi
)
256 * Root directory for UBI stuff in debugfs. Contains sub-directories which
257 * contain the stuff specific to particular UBI devices.
259 static struct dentry
*dfs_rootdir
;
262 * ubi_debugfs_init - create UBI debugfs directory.
264 * Create UBI debugfs directory. Returns zero in case of success and a negative
265 * error code in case of failure.
267 int ubi_debugfs_init(void)
269 dfs_rootdir
= debugfs_create_dir("ubi", NULL
);
270 if (IS_ERR_OR_NULL(dfs_rootdir
)) {
271 int err
= dfs_rootdir
? -ENODEV
: PTR_ERR(dfs_rootdir
);
273 ubi_err("cannot create \"ubi\" debugfs directory, error %d\n",
282 * ubi_debugfs_exit - remove UBI debugfs directory.
284 void ubi_debugfs_exit(void)
286 debugfs_remove(dfs_rootdir
);
289 /* Read an UBI debugfs file */
290 static ssize_t
dfs_file_read(struct file
*file
, char __user
*user_buf
,
291 size_t count
, loff_t
*ppos
)
293 unsigned long ubi_num
= (unsigned long)file
->private_data
;
294 struct dentry
*dent
= file
->f_path
.dentry
;
295 struct ubi_device
*ubi
;
296 struct ubi_debug_info
*d
;
300 ubi
= ubi_get_device(ubi_num
);
305 if (dent
== d
->dfs_chk_gen
)
307 else if (dent
== d
->dfs_chk_io
)
309 else if (dent
== d
->dfs_disable_bgt
)
310 val
= d
->disable_bgt
;
311 else if (dent
== d
->dfs_emulate_bitflips
)
312 val
= d
->emulate_bitflips
;
313 else if (dent
== d
->dfs_emulate_io_failures
)
314 val
= d
->emulate_io_failures
;
327 count
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, 2);
334 /* Write an UBI debugfs file */
335 static ssize_t
dfs_file_write(struct file
*file
, const char __user
*user_buf
,
336 size_t count
, loff_t
*ppos
)
338 unsigned long ubi_num
= (unsigned long)file
->private_data
;
339 struct dentry
*dent
= file
->f_path
.dentry
;
340 struct ubi_device
*ubi
;
341 struct ubi_debug_info
*d
;
346 ubi
= ubi_get_device(ubi_num
);
351 buf_size
= min_t(size_t, count
, (sizeof(buf
) - 1));
352 if (copy_from_user(buf
, user_buf
, buf_size
)) {
359 else if (buf
[0] == '0')
366 if (dent
== d
->dfs_chk_gen
)
368 else if (dent
== d
->dfs_chk_io
)
370 else if (dent
== d
->dfs_disable_bgt
)
371 d
->disable_bgt
= val
;
372 else if (dent
== d
->dfs_emulate_bitflips
)
373 d
->emulate_bitflips
= val
;
374 else if (dent
== d
->dfs_emulate_io_failures
)
375 d
->emulate_io_failures
= val
;
384 /* File operations for all UBI debugfs files */
385 static const struct file_operations dfs_fops
= {
386 .read
= dfs_file_read
,
387 .write
= dfs_file_write
,
390 .owner
= THIS_MODULE
,
394 * ubi_debugfs_init_dev - initialize debugfs for an UBI device.
395 * @ubi: UBI device description object
397 * This function creates all debugfs files for UBI device @ubi. Returns zero in
398 * case of success and a negative error code in case of failure.
400 int ubi_debugfs_init_dev(struct ubi_device
*ubi
)
403 unsigned long ubi_num
= ubi
->ubi_num
;
406 struct ubi_debug_info
*d
= ubi
->dbg
;
408 n
= snprintf(d
->dfs_dir_name
, UBI_DFS_DIR_LEN
+ 1, UBI_DFS_DIR_NAME
,
410 if (n
== UBI_DFS_DIR_LEN
) {
411 /* The array size is too small */
412 fname
= UBI_DFS_DIR_NAME
;
413 dent
= ERR_PTR(-EINVAL
);
417 fname
= d
->dfs_dir_name
;
418 dent
= debugfs_create_dir(fname
, dfs_rootdir
);
419 if (IS_ERR_OR_NULL(dent
))
424 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
426 if (IS_ERR_OR_NULL(dent
))
428 d
->dfs_chk_gen
= dent
;
431 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
433 if (IS_ERR_OR_NULL(dent
))
435 d
->dfs_chk_io
= dent
;
437 fname
= "tst_disable_bgt";
438 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
440 if (IS_ERR_OR_NULL(dent
))
442 d
->dfs_disable_bgt
= dent
;
444 fname
= "tst_emulate_bitflips";
445 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
447 if (IS_ERR_OR_NULL(dent
))
449 d
->dfs_emulate_bitflips
= dent
;
451 fname
= "tst_emulate_io_failures";
452 dent
= debugfs_create_file(fname
, S_IWUSR
, d
->dfs_dir
, (void *)ubi_num
,
454 if (IS_ERR_OR_NULL(dent
))
456 d
->dfs_emulate_io_failures
= dent
;
461 debugfs_remove_recursive(d
->dfs_dir
);
463 err
= dent
? PTR_ERR(dent
) : -ENODEV
;
464 ubi_err("cannot create \"%s\" debugfs file or directory, error %d\n",
470 * dbg_debug_exit_dev - free all debugfs files corresponding to device @ubi
471 * @ubi: UBI device description object
473 void ubi_debugfs_exit_dev(struct ubi_device
*ubi
)
475 debugfs_remove_recursive(ubi
->dbg
->dfs_dir
);
478 #endif /* CONFIG_MTD_UBI_DEBUG */