4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 only,
8 * as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License version 2 for more details (a copy is included
14 * in the LICENSE file that accompanied this code).
16 * You should have received a copy of the GNU General Public License
17 * version 2 along with this program; If not, see
18 * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
20 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21 * CA 95054 USA or visit www.sun.com if you need additional information or
27 * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
28 * Use is subject to license terms.
31 * This file is part of Lustre, http://www.lustre.org/
32 * Lustre is a trademark of Sun Microsystems, Inc.
34 * libcfs/libcfs/posix/posix_debug.c
36 * Userspace debugging.
40 # define DEBUG_SUBSYSTEM S_LNET
42 #include <libcfs/libcfs.h>
44 static char debug_file_name[1024];
45 unsigned int libcfs_subsystem_debug = ~(S_LNET | S_LND);
46 unsigned int libcfs_debug = 0;
49 #include <sys/utsname.h>
50 #endif /* HAVE_NETDB_H */
51 struct utsname *tmp_utsname;
52 static char source_nid[sizeof(tmp_utsname->nodename)];
54 static int source_pid;
55 int cfs_smp_processor_id = 1;
56 char libcfs_debug_file_path[1024];
59 int portals_do_debug_dumplog(void *arg)
61 printf("Look in %s\n", debug_file_name);
66 void portals_debug_print(void)
72 void libcfs_debug_dumplog(void)
74 printf("Look in %s\n", debug_file_name);
78 int libcfs_debug_init(unsigned long bufsize)
80 char *debug_mask = NULL;
81 char *debug_subsys = NULL;
84 struct utsname myname;
86 if (uname(&myname) == 0)
87 strcpy(source_nid, myname.nodename);
88 source_pid = getpid();
91 debug_mask = getenv("LIBLUSTRE_DEBUG_MASK");
93 libcfs_debug = (unsigned int) strtol(debug_mask, NULL, 0);
95 debug_subsys = getenv("LIBLUSTRE_DEBUG_SUBSYS");
97 libcfs_subsystem_debug =
98 (unsigned int) strtol(debug_subsys, NULL, 0);
100 debug_filename = getenv("LIBLUSTRE_DEBUG_BASE");
102 strncpy(libcfs_debug_file_path, debug_filename,
103 sizeof(libcfs_debug_file_path));
105 debug_filename = getenv("LIBLUSTRE_DEBUG_FILE");
107 strncpy(debug_file_name,debug_filename,sizeof(debug_file_name));
109 if (debug_file_name[0] == '\0' && libcfs_debug_file_path[0] != '\0')
110 snprintf(debug_file_name, sizeof(debug_file_name) - 1,
111 "%s-%s-"CFS_TIME_T".log", libcfs_debug_file_path,
112 source_nid, time(0));
114 if (strcmp(debug_file_name, "stdout") == 0 ||
115 strcmp(debug_file_name, "-") == 0) {
116 debug_file_fd = stdout;
117 } else if (strcmp(debug_file_name, "stderr") == 0) {
118 debug_file_fd = stderr;
119 } else if (debug_file_name[0] != '\0') {
120 debug_file_fd = fopen(debug_file_name, "w");
121 if (debug_file_fd == NULL)
122 fprintf(stderr, "%s: unable to open '%s': %s\n",
123 source_nid, debug_file_name, strerror(errno));
126 if (debug_file_fd == NULL)
127 debug_file_fd = stdout;
132 int libcfs_debug_cleanup(void)
134 if (debug_file_fd != stdout && debug_file_fd != stderr)
135 fclose(debug_file_fd);
139 int libcfs_debug_clear_buffer(void)
144 int libcfs_debug_mark_buffer(const char *text)
147 fprintf(debug_file_fd, "*******************************************************************************\n");
148 fprintf(debug_file_fd, "DEBUG MARKER: %s\n", text);
149 fprintf(debug_file_fd, "*******************************************************************************\n");
154 int libcfs_debug_msg(struct libcfs_debug_msg_data *msgdata,
155 const char *format, ...)
160 va_start(args, format);
161 rc = libcfs_debug_vmsg2(msgdata, format, args, NULL);
168 libcfs_debug_vmsg2(struct libcfs_debug_msg_data *msgdata,
169 const char *format1, va_list args,
170 const char *format2, ...)
176 char buf[CFS_PAGE_SIZE]; /* size 4096 used for compatimble
177 * with linux, where message can`t
178 * be exceed PAGE_SIZE */
180 char *prefix = "Lustre";
182 if ((!console) && (!debug_file_fd)) {
186 if (msgdata->msg_mask & (D_EMERG | D_ERROR))
187 prefix = "LustreError";
189 nob = snprintf(buf, sizeof(buf), "%s: %u-%s:(%s:%d:%s()): ", prefix,
190 source_pid, source_nid, msgdata->msg_file,
191 msgdata->msg_line, msgdata->msg_fn);
193 remain = sizeof(buf) - nob;
195 nob += vsnprintf(&buf[nob], remain, format1, args);
198 remain = sizeof(buf) - nob;
199 if ((format2) && (remain > 0)) {
200 va_start(ap, format2);
201 nob += vsnprintf(&buf[nob], remain, format2, ap);
205 if (debug_file_fd == NULL)
208 gettimeofday(&tv, NULL);
210 fprintf(debug_file_fd, CFS_TIME_T".%06lu:%u:%s:(%s:%d:%s()): %s",
211 tv.tv_sec, tv.tv_usec, source_pid, source_nid,
212 msgdata->msg_file, msgdata->msg_line, msgdata->msg_fn, buf);
218 * a helper function for RETURN(): the sole purpose is to save 8-16 bytes
219 * on the stack - function calling RETURN() doesn't need to allocate two
220 * additional 'rc' on the stack
222 long libcfs_log_return(struct libcfs_debug_msg_data *msgdata, long rc)
224 libcfs_debug_msg(msgdata, "Process leaving (rc=%lu : %ld : %lx)\n",
230 * a helper function for GOTO(): the sole purpose is to save 8-16 bytes
231 * on the stack - function calling GOTO() doesn't need to allocate two
232 * additional 'rc' on the stack
234 void libcfs_log_goto(struct libcfs_debug_msg_data *msgdata, const char *l,
237 libcfs_debug_msg(msgdata, "Process leaving via %s (rc=" LPLU " : "
238 LPLD " : " LPLX ")\n", l, (ulong_ptr_t) rc, rc, rc);