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
36 #include "os_string.hpp"
39 #include "cli_retrace.hpp"
41 static const char *synopsis = "Dump frame images obtained from a trace.";
46 std::cout << "usage apitrace dump-images [OPTIONS] TRACE_FILE\n"
49 " -h, --help show this help message and exit\n"
50 " --calls=CALLSET dump images only for specified calls\n"
51 " (default value is \"*/frame\" which\n"
52 " which dumps an image for each frame)\n"
53 " --call-nos[=BOOL] use call numbers in image filenames,\n"
54 " otherwise use sequental numbers (default=yes)\n"
55 " -o, --output=PREFIX prefix to use in naming output files\n"
56 " (default is trace filename without extension)\n"
61 CALLS_OPT = CHAR_MAX + 1,
68 const static struct option
70 {"help", no_argument, 0, 'h'},
71 {"calls", required_argument, 0, CALLS_OPT},
72 {"call-nos", optional_argument, 0, CALL_NOS_OPT},
73 {"output", required_argument, 0, 'o'},
78 command(int argc, char *argv[])
81 const char *calls = NULL;
82 const char *traceName = NULL;
83 const char *output = NULL;
87 while ((opt = getopt_long(argc, argv, shortOptions, longOptions, NULL)) != -1) {
96 call_nos = "--call-nos=";
97 call_nos.append(optarg);
103 std::cerr << "error: unexpected option `" << opt << "`\n";
109 if (optind >= argc) {
110 std::cerr << "error: apitrace dump-images requires a trace file as an argument.\n";
115 if (optind < argc - 1) {
116 std::cerr << "error: apitrace dump-images can accept only a single trace file argument.\n";
121 traceName = argv[optind];
123 if (output == NULL) {
125 prefix.trimDirectory();
126 prefix.trimExtension();
128 output = prefix.str();
131 std::vector<const char *> opts;
133 opts.push_back("-s");
134 opts.push_back(output);
135 opts.push_back("-S");
137 opts.push_back(calls);
139 opts.push_back("*/frame");
140 if (!call_nos.empty()) {
141 opts.push_back(call_nos.c_str());
144 return executeRetrace(opts, traceName);
147 const Command dump_images_command = {