1 /*********************************************************************
3 * Copyright 2011 Jose Fonseca
4 * Copyright 2012 Intel Corporation
7 * Permission is hereby granted, free of charge, to any person
8 * obtaining a copy of this software and associated documentation
9 * files (the "Software"), to deal in the Software without
10 * restriction, including without limitation the rights to use, copy,
11 * modify, merge, publish, distribute, sublicense, and/or sell copies
12 * of the Software, and to permit persons to whom the Software is
13 * furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be
16 * included in all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
21 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
22 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
23 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
24 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27 *********************************************************************/
30 #include <limits.h> // for CHAR_MAX
34 #include "os_string.hpp"
37 #include "cli_retrace.hpp"
39 static const char *synopsis = "Dump frame images obtained from a trace.";
44 std::cout << "usage apitrace dump-images [OPTIONS] TRACE_FILE\n"
47 " -h, --help show this help message and exit\n"
48 " --calls=CALLSET dump images only for specified calls\n"
49 " (default value is \"*/frame\" which\n"
50 " which dumps an image for each frame)\n"
51 " --call-nos[=BOOL] use call numbers in image filenames,\n"
52 " otherwise use sequental numbers (default=yes)\n"
53 " -o, --output=PREFIX prefix to use in naming output files\n"
54 " (default is trace filename without extension)\n"
59 CALLS_OPT = CHAR_MAX + 1,
66 const static struct option
68 {"help", no_argument, 0, 'h'},
69 {"calls", required_argument, 0, CALLS_OPT},
70 {"call-nos", optional_argument, 0, CALL_NOS_OPT},
71 {"output", required_argument, 0, 'o'},
76 command(int argc, char *argv[])
79 const char *calls = NULL;
80 const char *traceName = NULL;
81 const char *output = NULL;
85 while ((opt = getopt_long(argc, argv, shortOptions, longOptions, NULL)) != -1) {
94 call_nos = std::string("--call-nos=") + optarg;
100 std::cerr << "error: unexpected option `" << opt << "`\n";
106 if (optind >= argc) {
107 std::cerr << "error: apitrace dump-images requires a trace file as an argument.\n";
112 if (optind < argc - 1) {
113 std::cerr << "error: apitrace dump-images can accept only a single trace file argument.\n";
118 traceName = argv[optind];
120 if (output == NULL) {
122 prefix.trimDirectory();
123 prefix.trimExtension();
125 output = prefix.str();
128 std::vector<const char *> opts;
130 opts.push_back("-s");
131 opts.push_back(output);
132 opts.push_back("-S");
134 opts.push_back(calls);
136 opts.push_back("*/frame");
137 if (!call_nos.empty()) {
138 opts.push_back(call_nos.c_str());
141 return executeRetrace(opts, traceName);
144 const Command dump_images_command = {