]>
git.proxmox.com Git - mirror_ovs.git/blob - lib/backtrace.h
2 * Copyright (c) 2009 Nicira, Inc.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
21 #include "openvswitch/dynamic-string.h"
23 /* log_backtrace() will save the backtrace of a running program
24 * into the log at the DEBUG level.
26 * To use it, insert the following code to where backtrace is
28 * #include "backtrace.h"
31 * // A message can be added with log_backtrace_msg("your message")
34 * A typical log will look like the following. The hex numbers listed after
35 * "backtrace" are the addresses of the backtrace.
37 * 2014-03-13T23:18:11.979Z|00002|backtrace(revalidator_6)|ERR|lib/dpif-netdev.c:1312: (backtrace: 0x00521f57 0x00460365 0x00463ea4 0x0046470b 0x0043b32d 0x0043bac3 0x0043bae2 0x0043943b 0x004c22b3 0x2b5b3ac94e9a 0x2b5b3b4a33fd)
39 * The following bash command can be used to view backtrace in
40 * a more readable form.
41 * addr2line -p -e vswitchd/ovs-vswitchd <cut-and-paste back traces>
43 * An typical run and output will look like:
44 * addr2line -p -e vswitchd/ovs-vswitchd 0x00521f57 0x00460365 0x00463ea4
45 * 0x0046470b 0x0043b32d 0x0043bac3 0x0043bae2 0x0043943b 0x004c22b3
46 * 0x2b5b3ac94e9a 0x2b5b3b4a33fd
48 * openvswitch/lib/backtrace.c:33
49 * openvswitch/lib/dpif-netdev.c:1312
50 * openvswitch/lib/dpif.c:937
51 * openvswitch/lib/dpif.c:1258
52 * openvswitch/ofproto/ofproto-dpif-upcall.c:1440
53 * openvswitch/ofproto/ofproto-dpif-upcall.c:1595
54 * openvswitch/ofproto/ofproto-dpif-upcall.c:160
55 * openvswitch/ofproto/ofproto-dpif-upcall.c:717
56 * openvswitch/lib/ovs-thread.c:268
61 #define log_backtrace() log_backtrace_at(NULL, OVS_SOURCE_LOCATOR);
62 #define log_backtrace_msg(msg) log_backtrace_at(msg, OVS_SOURCE_LOCATOR);
64 #define BACKTRACE_MAX_FRAMES 31
68 uintptr_t frames
[BACKTRACE_MAX_FRAMES
];
71 void backtrace_capture(struct backtrace
*);
72 void log_backtrace_at(const char *msg
, const char *where
);
74 #endif /* backtrace.h */