mirror of
https://github.com/KhronosGroup/SPIRV-Tools
synced 2024-10-21 04:20:05 +00:00
996a814ae3
This is experimental, and has not tests. It's been used to debug validation of structured control flow. - Has a legend describing special arcs to merge blocks and continue targets. - Labels the function entry block, with the Id of the function.
138 lines
4.3 KiB
C++
138 lines
4.3 KiB
C++
// Copyright (c) 2015-2016 The Khronos Group Inc.
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person obtaining a
|
|
// copy of this software and/or associated documentation files (the
|
|
// "Materials"), to deal in the Materials without restriction, including
|
|
// without limitation the rights to use, copy, modify, merge, publish,
|
|
// distribute, sublicense, and/or sell copies of the Materials, and to
|
|
// permit persons to whom the Materials are 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 Materials.
|
|
//
|
|
// MODIFICATIONS TO THIS FILE MAY MEAN IT NO LONGER ACCURATELY REFLECTS
|
|
// KHRONOS STANDARDS. THE UNMODIFIED, NORMATIVE VERSIONS OF KHRONOS
|
|
// SPECIFICATIONS AND HEADER INFORMATION ARE LOCATED AT
|
|
// https://www.khronos.org/registry/
|
|
//
|
|
// THE MATERIALS ARE 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
|
|
// MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
|
|
|
|
#include <cstdio>
|
|
#include <cstring>
|
|
#include <sstream>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "spirv-tools/libspirv.h"
|
|
#include "tools/io.h"
|
|
|
|
#include "bin_to_dot.h"
|
|
|
|
// Prints a program usage message to stdout.
|
|
static void print_usage(const char* argv0) {
|
|
printf(
|
|
R"(%s - Show the control flow graph in GraphiViz "dot" form. EXPERIMENTAL
|
|
|
|
Usage: %s [options] [<filename>]
|
|
|
|
The SPIR-V binary is read from <filename>. If no file is specified,
|
|
or if the filename is "-", then the binary is read from standard input.
|
|
|
|
Options:
|
|
|
|
-h, --help Print this help.
|
|
--version Display version information.
|
|
|
|
-o <filename> Set the output filename.
|
|
Output goes to standard output if this option is
|
|
not specified, or if the filename is "-".
|
|
)",
|
|
argv0, argv0);
|
|
}
|
|
|
|
int main(int argc, char** argv) {
|
|
const char* inFile = nullptr;
|
|
const char* outFile = nullptr; // Stays nullptr if printing to stdout.
|
|
|
|
for (int argi = 1; argi < argc; ++argi) {
|
|
if ('-' == argv[argi][0]) {
|
|
switch (argv[argi][1]) {
|
|
case 'h':
|
|
print_usage(argv[0]);
|
|
return 0;
|
|
case 'o': {
|
|
if (!outFile && argi + 1 < argc) {
|
|
outFile = argv[++argi];
|
|
} else {
|
|
print_usage(argv[0]);
|
|
return 1;
|
|
}
|
|
} break;
|
|
case '-': {
|
|
// Long options
|
|
if (0 == strcmp(argv[argi], "--help")) {
|
|
print_usage(argv[0]);
|
|
return 0;
|
|
} else if (0 == strcmp(argv[argi], "--version")) {
|
|
printf("%s EXPERIMENTAL\n", spvSoftwareVersionDetailsString());
|
|
printf("Target: %s\n",
|
|
spvTargetEnvDescription(SPV_ENV_UNIVERSAL_1_1));
|
|
return 0;
|
|
} else {
|
|
print_usage(argv[0]);
|
|
return 1;
|
|
}
|
|
} break;
|
|
case 0: {
|
|
// Setting a filename of "-" to indicate stdin.
|
|
if (!inFile) {
|
|
inFile = argv[argi];
|
|
} else {
|
|
fprintf(stderr, "error: More than one input file specified\n");
|
|
return 1;
|
|
}
|
|
} break;
|
|
default:
|
|
print_usage(argv[0]);
|
|
return 1;
|
|
}
|
|
} else {
|
|
if (!inFile) {
|
|
inFile = argv[argi];
|
|
} else {
|
|
fprintf(stderr, "error: More than one input file specified\n");
|
|
return 1;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Read the input binary.
|
|
std::vector<uint32_t> contents;
|
|
if (!ReadFile<uint32_t>(inFile, "rb", &contents)) return 1;
|
|
spv_context context = spvContextCreate(SPV_ENV_UNIVERSAL_1_1);
|
|
spv_diagnostic diagnostic = nullptr;
|
|
|
|
std::stringstream ss;
|
|
auto error = BinaryToDot(context, contents.data(), contents.size(), &ss, &diagnostic);
|
|
if (error) {
|
|
spvDiagnosticPrint(diagnostic);
|
|
spvDiagnosticDestroy(diagnostic);
|
|
spvContextDestroy(context);
|
|
return error;
|
|
}
|
|
std::string str = ss.str();
|
|
WriteFile(outFile, "w", str.data(), str.size());
|
|
|
|
spvDiagnosticDestroy(diagnostic);
|
|
spvContextDestroy(context);
|
|
|
|
return 0;
|
|
}
|