4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
22 * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
23 * Copyright (c) 2013 by Delphix. All rights reserved.
26 #include <sys/zfs_context.h>
28 #if !defined(_KERNEL) || !defined(__linux__)
31 kmutex_t zfs_dbgmsgs_lock
;
32 int zfs_dbgmsg_maxsize
= 1<<20; /* 1MB */
36 * Enable various debugging features.
41 * zfs_recover can be set to nonzero to attempt to recover from
42 * otherwise-fatal errors, typically caused by on-disk corruption. When
43 * set, calls to zfs_panic_recover() will turn into warning messages.
49 zfs_panic_recover(const char *fmt
, ...)
54 vcmn_err(zfs_recover
? CE_WARN
: CE_PANIC
, fmt
, adx
);
59 * Debug logging is enabled by default for production kernel builds.
60 * The overhead for this is negligible and the logs can be valuable when
61 * debugging. For non-production user space builds all debugging except
62 * logging is enabled since performance is no longer a concern.
67 #if !defined(_KERNEL) || !defined(__linux__)
68 list_create(&zfs_dbgmsgs
, sizeof (zfs_dbgmsg_t
),
69 offsetof(zfs_dbgmsg_t
, zdm_node
));
70 mutex_init(&zfs_dbgmsgs_lock
, NULL
, MUTEX_DEFAULT
, NULL
);
75 zfs_flags
= ZFS_DEBUG_DPRINTF
;
76 spl_debug_set_mask(spl_debug_get_mask() | SD_DPRINTF
);
77 spl_debug_set_subsys(spl_debug_get_subsys() | SS_USER1
);
79 zfs_flags
= ~ZFS_DEBUG_DPRINTF
;
87 #if !defined(_KERNEL) || !defined(__linux__)
90 while ((zdm
= list_remove_head(&zfs_dbgmsgs
)) != NULL
) {
91 int size
= sizeof (zfs_dbgmsg_t
) + strlen(zdm
->zdm_msg
);
93 zfs_dbgmsg_size
-= size
;
95 mutex_destroy(&zfs_dbgmsgs_lock
);
96 ASSERT0(zfs_dbgmsg_size
);
101 #if !defined(_KERNEL) || !defined(__linux__)
103 * Print these messages by running:
104 * echo ::zfs_dbgmsg | mdb -k
106 * Monitor these messages by running:
107 * dtrace -q -n 'zfs-dbgmsg{printf("%s\n", stringof(arg0))}'
110 zfs_dbgmsg(const char *fmt
, ...)
117 size
= vsnprintf(NULL
, 0, fmt
, adx
);
121 * There is one byte of string in sizeof (zfs_dbgmsg_t), used
122 * for the terminating null.
124 zdm
= kmem_alloc(sizeof (zfs_dbgmsg_t
) + size
, KM_SLEEP
);
125 zdm
->zdm_timestamp
= gethrestime_sec();
128 (void) vsnprintf(zdm
->zdm_msg
, size
+ 1, fmt
, adx
);
131 DTRACE_PROBE1(zfs__dbgmsg
, char *, zdm
->zdm_msg
);
133 mutex_enter(&zfs_dbgmsgs_lock
);
134 list_insert_tail(&zfs_dbgmsgs
, zdm
);
135 zfs_dbgmsg_size
+= sizeof (zfs_dbgmsg_t
) + size
;
136 while (zfs_dbgmsg_size
> zfs_dbgmsg_maxsize
) {
137 zdm
= list_remove_head(&zfs_dbgmsgs
);
138 size
= sizeof (zfs_dbgmsg_t
) + strlen(zdm
->zdm_msg
);
139 kmem_free(zdm
, size
);
140 zfs_dbgmsg_size
-= size
;
142 mutex_exit(&zfs_dbgmsgs_lock
);
146 zfs_dbgmsg_print(const char *tag
)
150 (void) printf("ZFS_DBGMSG(%s):\n", tag
);
151 mutex_enter(&zfs_dbgmsgs_lock
);
152 for (zdm
= list_head(&zfs_dbgmsgs
); zdm
;
153 zdm
= list_next(&zfs_dbgmsgs
, zdm
))
154 (void) printf("%s\n", zdm
->zdm_msg
);
155 mutex_exit(&zfs_dbgmsgs_lock
);
160 module_param(zfs_flags
, int, 0644);
161 MODULE_PARM_DESC(zfs_flags
, "Set additional debugging flags");
163 module_param(zfs_recover
, int, 0644);
164 MODULE_PARM_DESC(zfs_recover
, "Set to attempt to recover from fatal errors");