cli-app/cper-convert.c

/**
 * A user-space application linking to the CPER-JSON conversion library which allows for easy
 * conversion between CPER and CPER-JSON formats. 
 * 
 * Author: Lawrence.Tang@arm.com
 **/

#include <stdio.h>
#include <string.h>
#include <libgen.h>
#include <limits.h>
#include "json.h"
#include "../cper-parse.h"
#include "../json-schema.h"

void cper_to_json(int argc, char *argv[]);
void json_to_cper(int argc, char *argv[]);
void print_help(void);

int main(int argc, char *argv[])
{
	//Ensure at least one argument is present.
	if (argc < 2) {
		printf("Invalid number of arguments. See 'cper-convert --help' for command information.\n");
		return -1;
	}

	//Run the requested command.
	if (strcmp(argv[1], "to-json") == 0)
		cper_to_json(argc, argv);
	else if (strcmp(argv[1], "to-cper") == 0)
		json_to_cper(argc, argv);
	else if (strcmp(argv[1], "--help") == 0)
		print_help();
	else {
		printf("Unrecognised argument '%s'. See 'cper-convert --help' for command information.\n",
		       argv[1]);
		return -1;
	}

	return 0;
}

//Command for converting a provided CPER log file into JSON.
void cper_to_json(int argc, char *argv[])
{
	if (argc < 3) {
		printf("Insufficient number of arguments for 'to-json'. See 'cper-convert --help' for command information.\n");
		return;
	}

	//Get a handle for the log file.
	FILE *cper_file = fopen(argv[2], "r");
	if (cper_file == NULL) {
		printf("Could not open provided CPER file '%s', file handle returned null.\n",
		       argv[2]);
		return;
	}

	//Convert.
	json_object *ir = cper_to_ir(cper_file);
	fclose(cper_file);
	const char *json_output =
		json_object_to_json_string_ext(ir, JSON_C_TO_STRING_PRETTY);

	//Check whether there is a "--out" argument, if there is, then output to file instead.
	//Otherwise, just send to console.
	if (argc != 5) {
		printf("%s\n", json_output);
		return;
	}

	//File out argument exists. Argument valid?
	if (strcmp(argv[3], "--out") != 0) {
		printf("Invalid argument '%s' for command 'to-json'. See 'cper-convert --help' for command information.\n",
		       argv[3]);
		return;
	}

	//Try to open a file handle to the desired output file.
	FILE *json_file = fopen(argv[4], "w");
	if (json_file == NULL) {
		printf("Could not get a handle for output file '%s', file handle returned null.\n",
		       argv[4]);
		return;
	}

	//Write out to file.
	fwrite(json_output, strlen(json_output), 1, json_file);
	fclose(json_file);
}

//Command for converting a provided CPER-JSON JSON file to CPER binary.
void json_to_cper(int argc, char *argv[])
{
	if (argc < 5) {
		printf("Insufficient number of arguments for 'to-cper'. See 'cper-convert --help' for command information.\n");
		return;
	}

	//Read JSON IR from file.
	json_object *ir = json_object_from_file(argv[2]);
	if (ir == NULL) {
		printf("Could not read JSON from file '%s', import returned null.\n",
		       argv[2]);
		return;
	}

	//Are we skipping validation?
	int do_validate = 1;
	if (argc >= 6 && argc < 8) {
		if (strcmp(argv[5], "--no-validate") == 0) {
			do_validate = 0;
		}
	}

	//Validate the JSON against specification, unless otherwise specified.
	if (do_validate) {
		char *specification_path = NULL;

		//Is there a specification file path?
		if (argc >= 7 &&
		    strcmp(argv[argc - 2], "--specification") == 0) {
			specification_path = argv[argc - 1];
		} else {
			//Make the specification path the assumed default (application directory + specification/cper-json.json).
			specification_path = malloc(PATH_MAX);
			char *dir = dirname(argv[0]);
			strcpy(specification_path, dir);
			strcat(specification_path,
			       "/specification/cper-json.json");
		}

		//Enable debug mode if indicated.
		for (int i = 5; i < argc; i++) {
			if (strcmp(argv[i], "--debug") == 0) {
				validate_schema_debug_enable();
				printf("debug enabled.\n");
				break;
			}
		}

		//Attempt to verify with the the specification.
		char *error_message = malloc(JSON_ERROR_MSG_MAX_LEN);
		int success = validate_schema_from_file(specification_path, ir,
							error_message);

		//Free specification path (if necessary).
		if (argc == 5)
			free(specification_path);

		//If failed, early exit before conversion.
		if (!success) {
			printf("JSON format validation failed: %s\n",
			       error_message);
			free(error_message);
			return;
		}
		free(error_message);
	}

	//Attempt a conversion.
	//Open a read for the output file.
	FILE *cper_file = fopen(argv[4], "w");
	if (cper_file == NULL) {
		printf("Could not open output file '%s', file handle returned null.\n",
		       argv[4]);
		return;
	}

	//Run the converter.
	ir_to_cper(ir, cper_file);
	fclose(cper_file);
}

//Command for printing help information.
void print_help(void)
{
	printf(":: to-json cper.file [--out file.name]\n");
	printf("\tConverts the provided CPER log file into JSON, by default outputting to console. If '--out' is specified,\n");
	printf("\tThe outputted JSON will be written to the provided file name instead.\n");
	printf("\n:: to-cper cper.json --out file.name [--no-validate] [--debug] [--specification some/spec/path.json]\n");
	printf("\tConverts the provided CPER-JSON JSON file into CPER binary. An output file must be specified with '--out'.\n");
	printf("\tBy default, the provided JSON will try to be validated against a specification. If no specification file path\n");
	printf("\tis provided with '--specification', then it will default to 'argv[0] + /specification/cper-json.json'.\n");
	printf("\tIf the '--no-validate' argument is set, then the provided JSON will not be validated. Be warned, this may cause\n");
	printf("\tpremature exit/unexpected behaviour in CPER output.\n");
	printf("\n:: --help\n");
	printf("\tDisplays help information to the console.\n");
}