root/arch/x86/tools/insn_sanity.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. usage
  2. dump_field
  3. dump_insn
  4. dump_stream
  5. init_random_seed
  6. read_next_insn
  7. generate_insn
  8. parse_args
  9. main

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  * x86 decoder sanity test - based on test_get_insn.c
   4  *
   5  * Copyright (C) IBM Corporation, 2009
   6  * Copyright (C) Hitachi, Ltd., 2011
   7  */
   8 
   9 #include <stdlib.h>
  10 #include <stdio.h>
  11 #include <string.h>
  12 #include <assert.h>
  13 #include <unistd.h>
  14 #include <sys/types.h>
  15 #include <sys/stat.h>
  16 #include <fcntl.h>
  17 
  18 #define unlikely(cond) (cond)
  19 #define ARRAY_SIZE(a)   (sizeof(a)/sizeof(a[0]))
  20 
  21 #include <asm/insn.h>
  22 #include <inat.c>
  23 #include <insn.c>
  24 
  25 /*
  26  * Test of instruction analysis against tampering.
  27  * Feed random binary to instruction decoder and ensure not to
  28  * access out-of-instruction-buffer.
  29  */
  30 
  31 #define DEFAULT_MAX_ITER        10000
  32 #define INSN_NOP 0x90
  33 
  34 static const char       *prog;          /* Program name */
  35 static int              verbose;        /* Verbosity */
  36 static int              x86_64;         /* x86-64 bit mode flag */
  37 static unsigned int     seed;           /* Random seed */
  38 static unsigned long    iter_start;     /* Start of iteration number */
  39 static unsigned long    iter_end = DEFAULT_MAX_ITER;    /* End of iteration number */
  40 static FILE             *input_file;    /* Input file name */
  41 
  42 static void usage(const char *err)
  43 {
  44         if (err)
  45                 fprintf(stderr, "%s: Error: %s\n\n", prog, err);
  46         fprintf(stderr, "Usage: %s [-y|-n|-v] [-s seed[,no]] [-m max] [-i input]\n", prog);
  47         fprintf(stderr, "\t-y   64bit mode\n");
  48         fprintf(stderr, "\t-n   32bit mode\n");
  49         fprintf(stderr, "\t-v   Verbosity(-vv dumps any decoded result)\n");
  50         fprintf(stderr, "\t-s   Give a random seed (and iteration number)\n");
  51         fprintf(stderr, "\t-m   Give a maximum iteration number\n");
  52         fprintf(stderr, "\t-i   Give an input file with decoded binary\n");
  53         exit(1);
  54 }
  55 
  56 static void dump_field(FILE *fp, const char *name, const char *indent,
  57                        struct insn_field *field)
  58 {
  59         fprintf(fp, "%s.%s = {\n", indent, name);
  60         fprintf(fp, "%s\t.value = %d, bytes[] = {%x, %x, %x, %x},\n",
  61                 indent, field->value, field->bytes[0], field->bytes[1],
  62                 field->bytes[2], field->bytes[3]);
  63         fprintf(fp, "%s\t.got = %d, .nbytes = %d},\n", indent,
  64                 field->got, field->nbytes);
  65 }
  66 
  67 static void dump_insn(FILE *fp, struct insn *insn)
  68 {
  69         fprintf(fp, "Instruction = {\n");
  70         dump_field(fp, "prefixes", "\t",        &insn->prefixes);
  71         dump_field(fp, "rex_prefix", "\t",      &insn->rex_prefix);
  72         dump_field(fp, "vex_prefix", "\t",      &insn->vex_prefix);
  73         dump_field(fp, "opcode", "\t",          &insn->opcode);
  74         dump_field(fp, "modrm", "\t",           &insn->modrm);
  75         dump_field(fp, "sib", "\t",             &insn->sib);
  76         dump_field(fp, "displacement", "\t",    &insn->displacement);
  77         dump_field(fp, "immediate1", "\t",      &insn->immediate1);
  78         dump_field(fp, "immediate2", "\t",      &insn->immediate2);
  79         fprintf(fp, "\t.attr = %x, .opnd_bytes = %d, .addr_bytes = %d,\n",
  80                 insn->attr, insn->opnd_bytes, insn->addr_bytes);
  81         fprintf(fp, "\t.length = %d, .x86_64 = %d, .kaddr = %p}\n",
  82                 insn->length, insn->x86_64, insn->kaddr);
  83 }
  84 
  85 static void dump_stream(FILE *fp, const char *msg, unsigned long nr_iter,
  86                         unsigned char *insn_buff, struct insn *insn)
  87 {
  88         int i;
  89 
  90         fprintf(fp, "%s:\n", msg);
  91 
  92         dump_insn(fp, insn);
  93 
  94         fprintf(fp, "You can reproduce this with below command(s);\n");
  95 
  96         /* Input a decoded instruction sequence directly */
  97         fprintf(fp, " $ echo ");
  98         for (i = 0; i < MAX_INSN_SIZE; i++)
  99                 fprintf(fp, " %02x", insn_buff[i]);
 100         fprintf(fp, " | %s -i -\n", prog);
 101 
 102         if (!input_file) {
 103                 fprintf(fp, "Or \n");
 104                 /* Give a seed and iteration number */
 105                 fprintf(fp, " $ %s -s 0x%x,%lu\n", prog, seed, nr_iter);
 106         }
 107 }
 108 
 109 static void init_random_seed(void)
 110 {
 111         int fd;
 112 
 113         fd = open("/dev/urandom", O_RDONLY);
 114         if (fd < 0)
 115                 goto fail;
 116 
 117         if (read(fd, &seed, sizeof(seed)) != sizeof(seed))
 118                 goto fail;
 119 
 120         close(fd);
 121         return;
 122 fail:
 123         usage("Failed to open /dev/urandom");
 124 }
 125 
 126 /* Read given instruction sequence from the input file */
 127 static int read_next_insn(unsigned char *insn_buff)
 128 {
 129         char buf[256]  = "", *tmp;
 130         int i;
 131 
 132         tmp = fgets(buf, ARRAY_SIZE(buf), input_file);
 133         if (tmp == NULL || feof(input_file))
 134                 return 0;
 135 
 136         for (i = 0; i < MAX_INSN_SIZE; i++) {
 137                 insn_buff[i] = (unsigned char)strtoul(tmp, &tmp, 16);
 138                 if (*tmp != ' ')
 139                         break;
 140         }
 141 
 142         return i;
 143 }
 144 
 145 static int generate_insn(unsigned char *insn_buff)
 146 {
 147         int i;
 148 
 149         if (input_file)
 150                 return read_next_insn(insn_buff);
 151 
 152         /* Fills buffer with random binary up to MAX_INSN_SIZE */
 153         for (i = 0; i < MAX_INSN_SIZE - 1; i += 2)
 154                 *(unsigned short *)(&insn_buff[i]) = random() & 0xffff;
 155 
 156         while (i < MAX_INSN_SIZE)
 157                 insn_buff[i++] = random() & 0xff;
 158 
 159         return i;
 160 }
 161 
 162 static void parse_args(int argc, char **argv)
 163 {
 164         int c;
 165         char *tmp = NULL;
 166         int set_seed = 0;
 167 
 168         prog = argv[0];
 169         while ((c = getopt(argc, argv, "ynvs:m:i:")) != -1) {
 170                 switch (c) {
 171                 case 'y':
 172                         x86_64 = 1;
 173                         break;
 174                 case 'n':
 175                         x86_64 = 0;
 176                         break;
 177                 case 'v':
 178                         verbose++;
 179                         break;
 180                 case 'i':
 181                         if (strcmp("-", optarg) == 0)
 182                                 input_file = stdin;
 183                         else
 184                                 input_file = fopen(optarg, "r");
 185                         if (!input_file)
 186                                 usage("Failed to open input file");
 187                         break;
 188                 case 's':
 189                         seed = (unsigned int)strtoul(optarg, &tmp, 0);
 190                         if (*tmp == ',') {
 191                                 optarg = tmp + 1;
 192                                 iter_start = strtoul(optarg, &tmp, 0);
 193                         }
 194                         if (*tmp != '\0' || tmp == optarg)
 195                                 usage("Failed to parse seed");
 196                         set_seed = 1;
 197                         break;
 198                 case 'm':
 199                         iter_end = strtoul(optarg, &tmp, 0);
 200                         if (*tmp != '\0' || tmp == optarg)
 201                                 usage("Failed to parse max_iter");
 202                         break;
 203                 default:
 204                         usage(NULL);
 205                 }
 206         }
 207 
 208         /* Check errors */
 209         if (iter_end < iter_start)
 210                 usage("Max iteration number must be bigger than iter-num");
 211 
 212         if (set_seed && input_file)
 213                 usage("Don't use input file (-i) with random seed (-s)");
 214 
 215         /* Initialize random seed */
 216         if (!input_file) {
 217                 if (!set_seed)  /* No seed is given */
 218                         init_random_seed();
 219                 srand(seed);
 220         }
 221 }
 222 
 223 int main(int argc, char **argv)
 224 {
 225         struct insn insn;
 226         int insns = 0;
 227         int errors = 0;
 228         unsigned long i;
 229         unsigned char insn_buff[MAX_INSN_SIZE * 2];
 230 
 231         parse_args(argc, argv);
 232 
 233         /* Prepare stop bytes with NOPs */
 234         memset(insn_buff + MAX_INSN_SIZE, INSN_NOP, MAX_INSN_SIZE);
 235 
 236         for (i = 0; i < iter_end; i++) {
 237                 if (generate_insn(insn_buff) <= 0)
 238                         break;
 239 
 240                 if (i < iter_start)     /* Skip to given iteration number */
 241                         continue;
 242 
 243                 /* Decode an instruction */
 244                 insn_init(&insn, insn_buff, sizeof(insn_buff), x86_64);
 245                 insn_get_length(&insn);
 246 
 247                 if (insn.next_byte <= insn.kaddr ||
 248                     insn.kaddr + MAX_INSN_SIZE < insn.next_byte) {
 249                         /* Access out-of-range memory */
 250                         dump_stream(stderr, "Error: Found an access violation", i, insn_buff, &insn);
 251                         errors++;
 252                 } else if (verbose && !insn_complete(&insn))
 253                         dump_stream(stdout, "Info: Found an undecodable input", i, insn_buff, &insn);
 254                 else if (verbose >= 2)
 255                         dump_insn(stdout, &insn);
 256                 insns++;
 257         }
 258 
 259         fprintf((errors) ? stderr : stdout,
 260                 "%s: %s: decoded and checked %d %s instructions with %d errors (seed:0x%x)\n",
 261                 prog,
 262                 (errors) ? "Failure" : "Success",
 263                 insns,
 264                 (input_file) ? "given" : "random",
 265                 errors,
 266                 seed);
 267 
 268         return errors ? 1 : 0;
 269 }

/* [<][>][^][v][top][bottom][index][help] */