1/*
2 * debug.c - NTFS kernel debug support. Part of the Linux-NTFS project.
3 *
4 * Copyright (c) 2001-2004 Anton Altaparmakov
5 *
6 * This program/include file is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License as published
8 * by the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program/include file is distributed in the hope that it will be
12 * useful, but WITHOUT ANY WARRANTY; without even the implied warranty
13 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program (in the main directory of the Linux-NTFS
18 * distribution in the file COPYING); if not, write to the Free Software
19 * Foundation,Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
20 */
21
22#include "debug.h"
23
24/*
25 * A static buffer to hold the error string being displayed and a spinlock
26 * to protect concurrent accesses to it.
27 */
28static char err_buf[1024];
29static DEFINE_SPINLOCK(err_buf_lock);
30
31/**
32 * __ntfs_warning - output a warning to the syslog
33 * @function:	name of function outputting the warning
34 * @sb:		super block of mounted ntfs filesystem
35 * @fmt:	warning string containing format specifications
36 * @...:	a variable number of arguments specified in @fmt
37 *
38 * Outputs a warning to the syslog for the mounted ntfs filesystem described
39 * by @sb.
40 *
41 * @fmt and the corresponding @... is printf style format string containing
42 * the warning string and the corresponding format arguments, respectively.
43 *
44 * @function is the name of the function from which __ntfs_warning is being
45 * called.
46 *
47 * Note, you should be using debug.h::ntfs_warning(@sb, @fmt, @...) instead
48 * as this provides the @function parameter automatically.
49 */
50void __ntfs_warning(const char *function, const struct super_block *sb,
51		const char *fmt, ...)
52{
53	va_list args;
54	int flen = 0;
55
56#ifndef DEBUG
57	if (!printk_ratelimit())
58		return;
59#endif
60	if (function)
61		flen = strlen(function);
62	spin_lock(&err_buf_lock);
63	va_start(args, fmt);
64	vsnprintf(err_buf, sizeof(err_buf), fmt, args);
65	va_end(args);
66	if (sb)
67		printk(KERN_ERR "NTFS-fs warning (device %s): %s(): %s\n",
68				sb->s_id, flen ? function : "", err_buf);
69	else
70		printk(KERN_ERR "NTFS-fs warning: %s(): %s\n",
71				flen ? function : "", err_buf);
72	spin_unlock(&err_buf_lock);
73}
74
75/**
76 * __ntfs_error - output an error to the syslog
77 * @function:	name of function outputting the error
78 * @sb:		super block of mounted ntfs filesystem
79 * @fmt:	error string containing format specifications
80 * @...:	a variable number of arguments specified in @fmt
81 *
82 * Outputs an error to the syslog for the mounted ntfs filesystem described
83 * by @sb.
84 *
85 * @fmt and the corresponding @... is printf style format string containing
86 * the error string and the corresponding format arguments, respectively.
87 *
88 * @function is the name of the function from which __ntfs_error is being
89 * called.
90 *
91 * Note, you should be using debug.h::ntfs_error(@sb, @fmt, @...) instead
92 * as this provides the @function parameter automatically.
93 */
94void __ntfs_error(const char *function, const struct super_block *sb,
95		const char *fmt, ...)
96{
97	va_list args;
98	int flen = 0;
99
100#ifndef DEBUG
101	if (!printk_ratelimit())
102		return;
103#endif
104	if (function)
105		flen = strlen(function);
106	spin_lock(&err_buf_lock);
107	va_start(args, fmt);
108	vsnprintf(err_buf, sizeof(err_buf), fmt, args);
109	va_end(args);
110	if (sb)
111		printk(KERN_ERR "NTFS-fs error (device %s): %s(): %s\n",
112				sb->s_id, flen ? function : "", err_buf);
113	else
114		printk(KERN_ERR "NTFS-fs error: %s(): %s\n",
115				flen ? function : "", err_buf);
116	spin_unlock(&err_buf_lock);
117}
118
119#ifdef DEBUG
120
121/* If 1, output debug messages, and if 0, don't. */
122int debug_msgs = 0;
123
124void __ntfs_debug (const char *file, int line, const char *function,
125		const char *fmt, ...)
126{
127	va_list args;
128	int flen = 0;
129
130	if (!debug_msgs)
131		return;
132	if (function)
133		flen = strlen(function);
134	spin_lock(&err_buf_lock);
135	va_start(args, fmt);
136	vsnprintf(err_buf, sizeof(err_buf), fmt, args);
137	va_end(args);
138	printk(KERN_DEBUG "NTFS-fs DEBUG (%s, %d): %s(): %s\n", file, line,
139			flen ? function : "", err_buf);
140	spin_unlock(&err_buf_lock);
141}
142
143/* Dump a runlist. Caller has to provide synchronisation for @rl. */
144void ntfs_debug_dump_runlist(const runlist_element *rl)
145{
146	int i;
147	const char *lcn_str[5] = { "LCN_HOLE         ", "LCN_RL_NOT_MAPPED",
148				   "LCN_ENOENT       ", "LCN_unknown      " };
149
150	if (!debug_msgs)
151		return;
152	printk(KERN_DEBUG "NTFS-fs DEBUG: Dumping runlist (values in hex):\n");
153	if (!rl) {
154		printk(KERN_DEBUG "Run list not present.\n");
155		return;
156	}
157	printk(KERN_DEBUG "VCN              LCN               Run length\n");
158	for (i = 0; ; i++) {
159		LCN lcn = (rl + i)->lcn;
160
161		if (lcn < (LCN)0) {
162			int index = -lcn - 1;
163
164			if (index > -LCN_ENOENT - 1)
165				index = 3;
166			printk(KERN_DEBUG "%-16Lx %s %-16Lx%s\n",
167					(long long)(rl + i)->vcn, lcn_str[index],
168					(long long)(rl + i)->length,
169					(rl + i)->length ? "" :
170						" (runlist end)");
171		} else
172			printk(KERN_DEBUG "%-16Lx %-16Lx  %-16Lx%s\n",
173					(long long)(rl + i)->vcn,
174					(long long)(rl + i)->lcn,
175					(long long)(rl + i)->length,
176					(rl + i)->length ? "" :
177						" (runlist end)");
178		if (!(rl + i)->length)
179			break;
180	}
181}
182
183#endif
184