2 // Copyright (C) 2015 LunarG, Inc.
4 // All rights reserved.
6 // Redistribution and use in source and binary forms, with or without
7 // modification, are permitted provided that the following conditions
10 // Redistributions of source code must retain the above copyright
11 // notice, this list of conditions and the following disclaimer.
13 // Redistributions in binary form must reproduce the above
14 // copyright notice, this list of conditions and the following
15 // disclaimer in the documentation and/or other materials provided
16 // with the distribution.
18 // Neither the name of 3Dlabs Inc. Ltd. nor the names of its
19 // contributors may be used to endorse or promote products derived
20 // from this software without specific prior written permission.
22 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
25 // FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
26 // COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
27 // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
28 // BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
29 // LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
30 // CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 // LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
32 // ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33 // POSSIBILITY OF SUCH DAMAGE.
41 #include "../SPIRV/SPVRemapper.h"
45 typedef unsigned int SpvWord;
47 // Poor man's basename: given a complete path, return file portion.
49 // Linux: /foo/bar/test -> test
50 // Win: c:\foo\bar\test -> test
51 // It's not very efficient, but that doesn't matter for our minimal-duty use.
52 // Using boost::filesystem would be better in many ways, but want to avoid that dependency.
54 // OS dependent path separator (avoiding boost::filesystem dependency)
56 char path_sep_char() { return '\\'; }
58 char path_sep_char() { return '/'; }
61 std::string basename(const std::string filename)
63 const size_t sepLoc = filename.find_last_of(path_sep_char());
65 return (sepLoc == filename.npos) ? filename : filename.substr(sepLoc+1);
68 void errHandler(const std::string& str) {
69 std::cout << str << std::endl;
73 void logHandler(const std::string& str) {
74 std::cout << str << std::endl;
77 // Read word stream from disk
78 void read(std::vector<SpvWord>& spv, const std::string& inFilename, int verbosity)
83 logHandler(std::string(" reading: ") + inFilename);
86 fp.open(inFilename, std::fstream::in | std::fstream::binary);
89 errHandler("error opening file for read: ");
91 // Reserve space (for efficiency, not for correctness)
93 spv.reserve(size_t(fp.tellg()) / sizeof(SpvWord));
98 fp.read((char *)&inWord, sizeof(inWord));
101 spv.push_back(inWord);
103 errHandler(std::string("error reading file: ") + inFilename);
108 void write(std::vector<SpvWord>& spv, const std::string& outFile, int verbosity)
111 errHandler("missing output filename.");
116 logHandler(std::string(" writing: ") + outFile);
118 fp.open(outFile, std::fstream::out | std::fstream::binary);
121 errHandler(std::string("error opening file for write: ") + outFile);
123 for (auto it = spv.cbegin(); it != spv.cend(); ++it) {
125 fp.write((char *)&word, sizeof(word));
127 errHandler(std::string("error writing file: ") + outFile);
130 // file is closed by destructor
133 // Print helpful usage message to stdout, and exit
134 void usage(const char* const name, const char* const msg = 0)
137 std::cout << msg << std::endl << std::endl;
139 std::cout << "Usage: " << std::endl;
141 std::cout << " " << basename(name)
142 << " [-v[v[...]] | --verbose [int]]"
143 << " [--map (all|types|names|funcs)]"
144 << " [--dce (all|types|funcs)]"
145 << " [--opt (all|loadstore)]"
146 << " [--strip-all | --strip all | -s]"
147 << " [--do-everything]"
148 << " --input | -i file1 [file2...] --output|-o DESTDIR"
151 std::cout << " " << basename(name) << " [--version | -V]" << std::endl;
152 std::cout << " " << basename(name) << " [--help | -?]" << std::endl;
157 // grind through each SPIR in turn
158 void execute(const std::vector<std::string>& inputFile, const std::string& outputDir,
159 int opts, int verbosity)
161 for (auto it = inputFile.cbegin(); it != inputFile.cend(); ++it) {
162 const std::string &filename = *it;
163 std::vector<SpvWord> spv;
164 read(spv, filename, verbosity);
165 spv::spirvbin_t(verbosity).remap(spv, opts);
167 const std::string outfile = outputDir + path_sep_char() + basename(filename);
169 write(spv, outfile, verbosity);
173 std::cout << "Done: " << inputFile.size() << " file(s) processed" << std::endl;
176 // Parse command line options
177 void parseCmdLine(int argc, char** argv, std::vector<std::string>& inputFile,
178 std::string& outputDir,
186 options = spv::spirvbin_t::NONE;
188 // Parse command line.
189 // boost::program_options would be quite a bit nicer, but we don't want to
190 // introduce a dependency on boost.
191 for (int a=1; a<argc; ) {
192 const std::string arg = argv[a];
194 if (arg == "--output" || arg == "-o") {
197 usage(argv[0], "--output requires an argument");
198 if (!outputDir.empty())
199 usage(argv[0], "--output can be provided only once");
201 outputDir = argv[a++];
203 // Remove trailing directory separator characters
204 while (!outputDir.empty() && outputDir.back() == path_sep_char())
205 outputDir.pop_back();
208 else if (arg == "-vv") { verbosity = 2; ++a; } // verbosity shortcuts
209 else if (arg == "-vvv") { verbosity = 3; ++a; } // ...
210 else if (arg == "-vvvv") { verbosity = 4; ++a; } // ...
211 else if (arg == "-vvvvv") { verbosity = 5; ++a; } // ...
213 else if (arg == "--verbose" || arg == "-v") {
219 int verb = ::strtol(argv[a], &end_ptr, 10);
220 // If we have not read to the end of the string or
221 // the string contained no elements, then we do not want to
223 if (*end_ptr == '\0' && end_ptr != argv[a]) {
229 else if (arg == "--version" || arg == "-V") {
230 std::cout << basename(argv[0]) << " version 0.97" << std::endl;
232 } else if (arg == "--input" || arg == "-i") {
233 // Collect input files
234 for (++a; a < argc && argv[a][0] != '-'; ++a)
235 inputFile.push_back(argv[a]);
236 } else if (arg == "--do-everything") {
238 options = options | spv::spirvbin_t::DO_EVERYTHING;
239 } else if (arg == "--strip-all" || arg == "-s") {
241 options = options | spv::spirvbin_t::STRIP;
242 } else if (arg == "--strip") {
244 if (strncmp(argv[a], "all", 3) == 0) {
245 options = options | spv::spirvbin_t::STRIP;
248 } else if (arg == "--dce") {
249 // Parse comma (or colon, etc) separated list of things to dce
251 for (const char* c = argv[a]; *c; ++c) {
252 if (strncmp(c, "all", 3) == 0) {
253 options = (options | spv::spirvbin_t::DCE_ALL);
255 } else if (strncmp(c, "*", 1) == 0) {
256 options = (options | spv::spirvbin_t::DCE_ALL);
258 } else if (strncmp(c, "funcs", 5) == 0) {
259 options = (options | spv::spirvbin_t::DCE_FUNCS);
261 } else if (strncmp(c, "types", 5) == 0) {
262 options = (options | spv::spirvbin_t::DCE_TYPES);
267 } else if (arg == "--map") {
268 // Parse comma (or colon, etc) separated list of things to map
270 for (const char* c = argv[a]; *c; ++c) {
271 if (strncmp(c, "all", 3) == 0) {
272 options = (options | spv::spirvbin_t::MAP_ALL);
274 } else if (strncmp(c, "*", 1) == 0) {
275 options = (options | spv::spirvbin_t::MAP_ALL);
277 } else if (strncmp(c, "types", 5) == 0) {
278 options = (options | spv::spirvbin_t::MAP_TYPES);
280 } else if (strncmp(c, "names", 5) == 0) {
281 options = (options | spv::spirvbin_t::MAP_NAMES);
283 } else if (strncmp(c, "funcs", 5) == 0) {
284 options = (options | spv::spirvbin_t::MAP_FUNCS);
289 } else if (arg == "--opt") {
291 for (const char* c = argv[a]; *c; ++c) {
292 if (strncmp(c, "all", 3) == 0) {
293 options = (options | spv::spirvbin_t::OPT_ALL);
295 } else if (strncmp(c, "*", 1) == 0) {
296 options = (options | spv::spirvbin_t::OPT_ALL);
298 } else if (strncmp(c, "loadstore", 9) == 0) {
299 options = (options | spv::spirvbin_t::OPT_LOADSTORE);
304 } else if (arg == "--help" || arg == "-?") {
307 usage(argv[0], "Unknown command line option");
314 int main(int argc, char** argv)
316 std::vector<std::string> inputFile;
317 std::string outputDir;
322 // handle errors by exiting
323 spv::spirvbin_t::registerErrorHandler(errHandler);
325 // Log messages to std::cout
326 spv::spirvbin_t::registerLogHandler(logHandler);
332 parseCmdLine(argc, argv, inputFile, outputDir, opts, verbosity);
334 if (outputDir.empty())
335 usage(argv[0], "Output directory required");
337 // Main operations: read, remap, and write.
338 execute(inputFile, outputDir, opts, verbosity);
340 // If we get here, everything went OK! Nothing more to be done.