CMakeCache.txt
CMakeFiles
Makefile
+apitrace
build
cgltrace.cpp
d3d10trace.cpp
glxtrace.cpp
install_manifest.txt
qapitrace
-tracedump
traces
wgltrace.cpp
link_libraries (common)
-add_executable (tracedump tracedump.cpp)
-install (TARGETS tracedump RUNTIME DESTINATION bin)
-
-
##############################################################################
# API tracers
install (TARGETS glretrace RUNTIME DESTINATION bin)
+##############################################################################
+# CLI
+
+add_subdirectory(cli)
##############################################################################
# GUI
View the trace with
- /path/to/tracedump --color application.trace | less -R
+ /path/to/apitrace dump --color application.trace | less -R
Replay the trace with
* View the trace with
- \path\to\tracedump application.trace
+ \path\to\apitrace dump application.trace
* Replay the trace with
--- /dev/null
+add_executable (apitrace
+ cli_main.cpp
+ cli_dump.cpp
+)
+
+install (TARGETS apitrace RUNTIME DESTINATION bin)
--- /dev/null
+/*********************************************************************
+ *
+ * Copyright 2011 Intel Corporation
+ * All Rights Reserved.
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use, copy,
+ * modify, merge, publish, distribute, sublicense, and/or sell copies
+ * of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+ * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ *********************************************************************/
+
+#ifndef _APITRACE_CLI_HPP_
+#define _APITRACE_CLI_HPP_
+
+
+struct Command {
+ const char *name;
+ const char *synopsis;
+
+ typedef void (*Usage) (void);
+ Usage usage;
+
+ typedef int (*Function) (int argc, char *argv[]);
+ Function function;
+};
+
+
+extern const Command dump;
+
+
+#endif /* _APITRACE_CLI_HPP_ */
--- /dev/null
+/**************************************************************************
+ *
+ * Copyright 2010 VMware, Inc.
+ * All Rights Reserved.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ **************************************************************************/
+
+#include <string.h>
+
+#include "cli.hpp"
+
+#include "trace_parser.hpp"
+
+enum ColorOption {
+ COLOR_OPTION_NEVER = 0,
+ COLOR_OPTION_ALWAYS = 1,
+ COLOR_OPTION_AUTO = -1
+};
+
+static ColorOption color = COLOR_OPTION_AUTO;
+
+static const char *synopsis = "Dump given trace(s) to standard output.";
+
+static void
+usage(void)
+{
+ std::cout
+ << "usage: apitrace dump [OPTIONS] <trace-file>...\n"
+ << synopsis << "\n"
+ "\n"
+ " --color=<WHEN>\n"
+ " --colour=<WHEN> Colored syntax highlighting\n"
+ " WHEN is 'auto', 'always', or 'never'\n";
+}
+
+static int
+command(int argc, char *argv[])
+{
+ int i;
+
+ for (i = 0; i < argc; ++i) {
+ const char *arg = argv[i];
+
+ if (arg[0] != '-') {
+ break;
+ }
+
+ if (!strcmp(arg, "--")) {
+ break;
+ } else if (!strcmp(arg, "--help")) {
+ usage();
+ return 0;
+ } else if (!strcmp(arg, "--color=auto") ||
+ !strcmp(arg, "--colour=auto")) {
+ color = COLOR_OPTION_AUTO;
+ } else if (!strcmp(arg, "--color") ||
+ !strcmp(arg, "--colour") ||
+ !strcmp(arg, "--color=always") ||
+ !strcmp(arg, "--colour=always")) {
+ color = COLOR_OPTION_ALWAYS;
+ } else if (!strcmp(arg, "--color=never") ||
+ !strcmp(arg, "--colour=never") ||
+ !strcmp(arg, "--no-color") ||
+ !strcmp(arg, "--no-colour")) {
+ color = COLOR_OPTION_NEVER;
+ } else {
+ std::cerr << "error: unknown option " << arg << "\n";
+ usage();
+ return 1;
+ }
+ }
+
+ if (color == COLOR_OPTION_AUTO) {
+#ifdef _WIN32
+ color = COLOR_OPTION_ALWAYS;
+#else
+ color = isatty(1) ? COLOR_OPTION_ALWAYS : COLOR_OPTION_NEVER;
+#endif
+ }
+
+ for (; i < argc; ++i) {
+ trace::Parser p;
+
+ if (!p.open(argv[i])) {
+ std::cerr << "error: failed to open " << argv[i] << "\n";
+ return 1;
+ }
+
+ trace::Call *call;
+ while ((call = p.parse_call())) {
+ call->dump(std::cout, color);
+ delete call;
+ }
+ }
+
+ return 0;
+}
+
+const Command dump = {
+ "dump",
+ synopsis,
+ usage,
+ command
+};
--- /dev/null
+/*********************************************************************
+ *
+ * Copyright 2011 Intel Corporation
+ * All Rights Reserved.
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use, copy,
+ * modify, merge, publish, distribute, sublicense, and/or sell copies
+ * of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+ * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ *********************************************************************/
+
+
+/*
+ * Top-level application for accessing almost of apitrace
+ * functionality.
+ */
+
+#include <string.h>
+
+#include <iomanip>
+#include <iostream>
+
+#include "cli.hpp"
+
+#define ARRAY_SIZE(arr) (sizeof (arr) / sizeof (arr[0]))
+
+static const char *help_synopsis = "Print detailed help for the given command.";
+
+static void list_commands(void);
+
+static void
+help_usage()
+{
+ std::cout
+ << "usage: apitrace help [<command>]\n"
+ << help_synopsis << "\n"
+ "\n";
+
+ list_commands();
+}
+
+static int
+help_command(int argc, char *argv[]);
+
+const Command help = {
+ "help",
+ help_synopsis,
+ help_usage,
+ help_command
+};
+
+static const Command * commands[] = {
+ &dump,
+ &help,
+};
+
+static void
+usage(void)
+{
+ std::cout <<
+ "Usage: apitrace <command> [<args> ...]\n"
+ "Top-level command line frontend to apitrace.\n"
+ "\n";
+
+ list_commands();
+}
+
+static void
+list_commands(void) {
+ const Command *command;
+ int i, max_width = 0;
+
+ std::cout << "The available commands are as follows:\n\n";
+
+ std::cout << std::setiosflags(std::ios::left);
+
+ for (i = 0; i < ARRAY_SIZE(commands); i++) {
+ command = commands[i];
+ if (strlen(command->name) > max_width) {
+ max_width = strlen(command->name);
+ }
+ }
+
+ for (i = 0; i < ARRAY_SIZE(commands); i++) {
+ command = commands[i];
+
+ std::cout << " " << std::setw(max_width + 2) << command->name
+ << " " << command->synopsis << "\n";
+ }
+
+ std::cout << "\n"
+ "Use \"apitrace help <command>\" for more details on each command.\n";
+}
+
+
+static int
+help_command(int argc, char *argv[])
+{
+ const Command *command;
+ int i;
+
+ if (argc != 1) {
+ help_usage();
+ return 0;
+ }
+
+ char *command_name = argv[0];
+
+ for (i = 0; i < ARRAY_SIZE(commands); i++) {
+ command = commands[i];
+
+ if (strcmp(command_name, command->name) == 0) {
+ (command->usage) ();
+ return 0;
+ }
+ }
+
+ std::cerr << "Error: Unknown command: " << command_name
+ << " (see \"apitrace help\").\n";
+
+ return 1;
+}
+
+int
+main(int argc, char **argv)
+{
+ const char *command_name;
+ const Command *command;
+ int i;
+
+ for (i = 1; i < argc; ++i) {
+ const char *arg = argv[i];
+
+ if (arg[0] != '-') {
+ break;
+ }
+
+ if (strcmp(arg, "--help") == 0) {
+ return help_command(0, NULL);
+ } else {
+ std::cerr << "Error: unknown option " << arg << "\n";
+ usage();
+ return 1;
+ }
+ }
+
+ if (i == argc) {
+ usage();
+ return 1;
+ }
+
+ command_name = argv[i++];
+
+ argc -= i;
+ argv = &argv[i];
+
+ for (i = 0; i < ARRAY_SIZE(commands); i++) {
+ command = commands[i];
+
+ if (strcmp(command_name, command->name) == 0)
+ return (command->function) (argc, argv);
+ }
+
+ std::cerr << "Error: unknown command " << command_name
+ << " (see \"apitrace help\").\n";
+
+ return 1;
+}
connect(m_ui.actionOptions, SIGNAL(triggered()),
this, SLOT(showSettings()));
- connect(m_ui.callView, SIGNAL(activated(const QModelIndex &)),
+ connect(m_ui.callView->selectionModel(), SIGNAL(currentChanged(const QModelIndex &, const QModelIndex &)),
this, SLOT(callItemSelected(const QModelIndex &)));
connect(m_ui.callView, SIGNAL(customContextMenuRequested(QPoint)),
this, SLOT(customContextMenuRequested(QPoint)));
connect(m_ui.actionShowErrorsDock, SIGNAL(triggered(bool)),
m_ui.errorsDock, SLOT(setVisible(bool)));
connect(m_ui.errorsTreeWidget,
- SIGNAL(currentItemChanged(QTreeWidgetItem*, QTreeWidgetItem*)),
+ SIGNAL(itemActivated(QTreeWidgetItem*, int)),
this, SLOT(slotErrorSelected(QTreeWidgetItem*)));
}
set -e
-TRACEDUMP=${TRACEDUMP:-`dirname "$0"`/../tracedump}
+APITRACE=${APITRACE:-`dirname "$0"`/../apitrace}
-$TRACEDUMP
+$APITRACE dump
stripdump () {
- $TRACEDUMP --color=never "$1" \
+ $APITRACE dump --color=never "$1" \
| sed \
-e 's/\r$//g' \
-e 's/^[0-9]\+ //' \
+++ /dev/null
-/**************************************************************************
- *
- * Copyright 2010 VMware, Inc.
- * All Rights Reserved.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- *
- **************************************************************************/
-
-
-/*
- * Simple utility to dump a trace to standard output.
- */
-
-
-#include <string.h>
-
-#include "trace_parser.hpp"
-
-
-enum ColorOption {
- COLOR_OPTION_NEVER = 0,
- COLOR_OPTION_ALWAYS = 1,
- COLOR_OPTION_AUTO = -1
-};
-
-static ColorOption color = COLOR_OPTION_AUTO;
-
-
-static void usage(void) {
- std::cout <<
- "Usage: tracedump [OPTION] [TRACE]...\n"
- "Dump TRACE to standard output.\n"
- "\n"
- " --help display this help and exit\n"
- " --color[=WHEN]\n"
- " --colour[=WHEN] colored syntax highlighting;\n"
- " WHEN is 'always', 'never', or 'auto'\n"
- ;
-}
-
-
-int main(int argc, char **argv)
-{
- int i;
-
- for (i = 1; i < argc; ++i) {
- const char *arg = argv[i];
-
- if (arg[0] != '-') {
- break;
- }
-
- if (!strcmp(arg, "--")) {
- break;
- } else if (!strcmp(arg, "--help")) {
- usage();
- return 0;
- } else if (!strcmp(arg, "--color=auto") ||
- !strcmp(arg, "--colour=auto")) {
- color = COLOR_OPTION_AUTO;
- } else if (!strcmp(arg, "--color") ||
- !strcmp(arg, "--colour") ||
- !strcmp(arg, "--color=always") ||
- !strcmp(arg, "--colour=always")) {
- color = COLOR_OPTION_ALWAYS;
- } else if (!strcmp(arg, "--color=never") ||
- !strcmp(arg, "--colour=never") ||
- !strcmp(arg, "--no-color") ||
- !strcmp(arg, "--no-colour")) {
- color = COLOR_OPTION_NEVER;
- } else {
- std::cerr << "error: unknown option " << arg << "\n";
- usage();
- return 1;
- }
- }
-
- if (color == COLOR_OPTION_AUTO) {
-#ifdef _WIN32
- color = COLOR_OPTION_ALWAYS;
-#else
- color = isatty(1) ? COLOR_OPTION_ALWAYS : COLOR_OPTION_NEVER;
-#endif
- }
-
- for (; i < argc; ++i) {
- trace::Parser p;
-
- if (!p.open(argv[i])) {
- std::cerr << "error: failed to open " << argv[i] << "\n";
- return 1;
- }
-
- trace::Call *call;
- while ((call = p.parse_call())) {
- call->dump(std::cout, color);
- delete call;
- }
- }
-
- return 0;
-}