1 /**************************************************************************
3 * Copyright 2011 Jose Fonseca
4 * Copyright 2010 VMware, Inc.
7 * Permission is hereby granted, free of charge, to any person obtaining a copy
8 * of this software and associated documentation files (the "Software"), to deal
9 * in the Software without restriction, including without limitation the rights
10 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 * copies of the Software, and to permit persons to whom the Software is
12 * furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included in
15 * all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25 **************************************************************************/
29 #include <limits.h> // for CHAR_MAX
33 #include "cli_pager.hpp"
35 #include "trace_parser.hpp"
36 #include "trace_dump.hpp"
37 #include "trace_callset.hpp"
41 COLOR_OPTION_NEVER = 0,
42 COLOR_OPTION_ALWAYS = 1,
43 COLOR_OPTION_AUTO = -1
46 static ColorOption color = COLOR_OPTION_AUTO;
48 static bool verbose = false;
50 static trace::CallSet calls(trace::FREQUENCY_ALL);
52 static const char *synopsis = "Dump given trace(s) to standard output.";
58 << "usage: apitrace dump [OPTIONS] TRACE_FILE...\n"
61 " -h, --help show this help message and exit\n"
62 " -v, --verbose verbose output\n"
63 " --calls=CALLSET only dump specified calls\n"
65 " --colour[=WHEN] colored syntax highlighting\n"
66 " WHEN is 'auto', 'always', or 'never'\n"
67 " --arg-names[=BOOL] dump argument names [default: yes]\n"
68 " --thread-ids=[=BOOL] dump thread ids [default: no]\n"
74 CALLS_OPT = CHAR_MAX + 1,
83 const static struct option
85 {"help", no_argument, 0, 'h'},
86 {"verbose", no_argument, 0, 'v'},
87 {"calls", required_argument, 0, CALLS_OPT},
88 {"colour", optional_argument, 0, COLOR_OPT},
89 {"color", optional_argument, 0, COLOR_OPT},
90 {"arg-names", optional_argument, 0, ARG_NAMES_OPT},
91 {"thread-ids", optional_argument, 0, THREAD_IDS_OPT},
96 boolOption(const char *option, bool default_ = true) {
100 if (strcmp(option, "0") == 0 ||
101 strcmp(option, "no") == 0 ||
102 strcmp(option, "false") == 0) {
105 if (strcmp(option, "0") == 0 ||
106 strcmp(option, "yes") == 0 ||
107 strcmp(option, "true") == 0) {
110 std::cerr << "error: unexpected bool " << option << "\n";
115 command(int argc, char *argv[])
117 trace::DumpFlags dumpFlags = 0;
118 bool dumpThreadIds = false;
120 // FIXME: avoid hacking around argc / argv
125 while ((opt = getopt_long(argc, argv, shortOptions, longOptions, NULL)) != -1) {
134 calls = trace::CallSet(optarg);
138 !strcmp(optarg, "always")) {
139 color = COLOR_OPTION_ALWAYS;
140 } else if (!strcmp(optarg, "auto")) {
141 color = COLOR_OPTION_AUTO;
142 } else if (!strcmp(optarg, "never")) {
143 color = COLOR_OPTION_NEVER;
145 std::cerr << "error: unknown color argument " << optarg << "\n";
150 if (boolOption(optarg)) {
151 dumpFlags &= ~trace::DUMP_FLAG_NO_ARG_NAMES;
153 dumpFlags |= trace::DUMP_FLAG_NO_ARG_NAMES;
157 dumpThreadIds = boolOption(optarg, true);
160 std::cerr << "error: unexpected option `" << opt << "`\n";
166 if (color == COLOR_OPTION_AUTO) {
168 color = COLOR_OPTION_ALWAYS;
170 color = isatty(1) ? COLOR_OPTION_ALWAYS : COLOR_OPTION_NEVER;
175 if (color == COLOR_OPTION_NEVER) {
176 dumpFlags |= trace::DUMP_FLAG_NO_COLOR;
179 for (int i = optind; i < argc; ++i) {
182 if (!p.open(argv[i])) {
183 std::cerr << "error: failed to open " << argv[i] << "\n";
188 while ((call = p.parse_call())) {
189 if (calls.contains(*call)) {
191 !(call->flags & trace::CALL_FLAG_VERBOSE)) {
193 std::cout << std::hex << call->thread_id << std::dec << " ";
195 trace::dump(*call, std::cout, dumpFlags);
205 const Command dump_command = {