blob: c9882c20f06a2e4e53242fe2e02dd7e411ab8d33 [file] [log] [blame]
Lawrence Tangd34f2b12022-07-19 15:36:31 +01001/**
Ed Tanousfedd4572024-07-12 13:56:00 -07002 * A user-space application for generating pseudo-random specification compliant CPER records.
3 *
Lawrence Tangd34f2b12022-07-19 15:36:31 +01004 * Author: Lawrence.Tang@arm.com
5 **/
6
7#include <stdio.h>
Lawrence Tang5f388a32022-08-08 10:49:02 +01008#include <stdlib.h>
Lawrence Tangd34f2b12022-07-19 15:36:31 +01009#include <string.h>
Thu Nguyene42fb482024-10-15 14:43:11 +000010#include <libcper/Cper.h>
11#include <libcper/generator/cper-generate.h>
12#include <libcper/generator/sections/gen-section.h>
Lawrence Tangd34f2b12022-07-19 15:36:31 +010013
14void print_help();
15
Lawrence Tange407b4c2022-07-21 13:54:01 +010016int main(int argc, char *argv[])
Lawrence Tangd34f2b12022-07-19 15:36:31 +010017{
Lawrence Tange407b4c2022-07-21 13:54:01 +010018 //If help requested, print help.
19 if (argc == 2 && strcmp(argv[1], "--help") == 0) {
20 print_help();
21 return 0;
22 }
Lawrence Tangd34f2b12022-07-19 15:36:31 +010023
Lawrence Tang5f388a32022-08-08 10:49:02 +010024 //Parse the command line arguments.
25 char *out_file = NULL;
Lawrence Tang617949e2022-08-08 14:21:42 +010026 char *single_section = NULL;
Lawrence Tang5f388a32022-08-08 10:49:02 +010027 char **sections = NULL;
28 UINT16 num_sections = 0;
29 for (int i = 1; i < argc; i++) {
30 if (strcmp(argv[i], "--out") == 0 && i < argc - 1) {
31 out_file = argv[i + 1];
32 i++;
Lawrence Tang617949e2022-08-08 14:21:42 +010033 } else if (strcmp(argv[i], "--single-section") == 0 &&
34 i < argc - 1) {
35 single_section = argv[i + 1];
36 i++;
Lawrence Tang5f388a32022-08-08 10:49:02 +010037 } else if (strcmp(argv[i], "--sections") == 0 && i < argc - 1) {
38 //All arguments after this must be section names.
39 num_sections = argc - i - 1;
40 sections = malloc(sizeof(char *) * num_sections);
41 i++;
Lawrence Tang617949e2022-08-08 14:21:42 +010042
John Chungf8fc7052024-05-03 20:05:29 +080043 for (int j = i; j < argc; j++) {
Lawrence Tang5f388a32022-08-08 10:49:02 +010044 sections[j - i] = argv[j];
John Chungf8fc7052024-05-03 20:05:29 +080045 }
Lawrence Tang5f388a32022-08-08 10:49:02 +010046 break;
47 } else {
48 printf("Unrecognised argument '%s'. For command information, refer to 'cper-generate --help'.\n",
49 argv[i]);
50 return -1;
51 }
52 }
53
54 //If no output file passed as argument, exit.
55 if (out_file == NULL) {
56 printf("No output file provided. For command information, refer to 'cper-generate --help'.\n");
John Chungf8fc7052024-05-03 20:05:29 +080057 if (sections) {
58 free(sections);
59 }
Lawrence Tange407b4c2022-07-21 13:54:01 +010060 return -1;
61 }
Lawrence Tangd34f2b12022-07-19 15:36:31 +010062
Lawrence Tange407b4c2022-07-21 13:54:01 +010063 //Open a file handle to write output.
Lawrence Tang5f388a32022-08-08 10:49:02 +010064 FILE *cper_file = fopen(out_file, "w");
Lawrence Tange407b4c2022-07-21 13:54:01 +010065 if (cper_file == NULL) {
66 printf("Could not get a handle for output file '%s', file handle returned null.\n",
Lawrence Tang5f388a32022-08-08 10:49:02 +010067 out_file);
John Chungf8fc7052024-05-03 20:05:29 +080068 if (sections) {
69 free(sections);
70 }
Lawrence Tange407b4c2022-07-21 13:54:01 +010071 return -1;
72 }
Lawrence Tangd34f2b12022-07-19 15:36:31 +010073
Lawrence Tang617949e2022-08-08 14:21:42 +010074 //Which type are we generating?
75 if (single_section != NULL && sections == NULL) {
76 generate_single_section_record(single_section, cper_file);
77 } else if (sections != NULL && single_section == NULL) {
78 generate_cper_record(sections, num_sections, cper_file);
79 } else {
80 //Invalid arguments.
81 printf("Invalid argument. Either both '--sections' and '--single-section' were set, or neither. For command information, refer to 'cper-generate --help'.\n");
John Chungf8fc7052024-05-03 20:05:29 +080082 if (sections) {
83 free(sections);
84 }
Lawrence Tang617949e2022-08-08 14:21:42 +010085 return -1;
86 }
Lawrence Tang5f388a32022-08-08 10:49:02 +010087
88 //Close & free remaining resources.
Lawrence Tange407b4c2022-07-21 13:54:01 +010089 fclose(cper_file);
John Chungf8fc7052024-05-03 20:05:29 +080090 if (sections != NULL) {
Lawrence Tang5f388a32022-08-08 10:49:02 +010091 free(sections);
John Chungf8fc7052024-05-03 20:05:29 +080092 }
Lawrence Tangd34f2b12022-07-19 15:36:31 +010093}
94
Lawrence Tangd34f2b12022-07-19 15:36:31 +010095//Prints command help for this CPER generator.
96void print_help()
97{
Lawrence Tang617949e2022-08-08 14:21:42 +010098 printf(":: --out cper.file [--sections section1 ...] [--single-section sectiontype]\n");
99 printf("\tGenerates a pseudo-random CPER file with the provided section types and outputs to the given file name.\n\n");
100 printf("\tWhen the '--sections' flag is set, all following arguments are section names, and a full CPER log is generated\n");
101 printf("\tcontaining the given sections.\n");
102 printf("\tWhen the '--single-section' flag is set, the next argument is the single section that should be generated, and\n");
103 printf("\ta single section (no header, only a section descriptor & section) CPER file is generated.\n\n");
Lawrence Tange407b4c2022-07-21 13:54:01 +0100104 printf("\tValid section type names are the following:\n");
John Chungf8fc7052024-05-03 20:05:29 +0800105 for (size_t i = 0; i < generator_definitions_len; i++) {
Lawrence Tangef9a3252022-08-24 16:03:18 +0100106 printf("\t\t- %s\n", generator_definitions[i].ShortName);
107 }
Lawrence Tange407b4c2022-07-21 13:54:01 +0100108 printf("\t\t- unknown\n");
109 printf("\n:: --help\n");
110 printf("\tDisplays help information to the console.\n");
John Chungf8fc7052024-05-03 20:05:29 +0800111}