cfe_generate_password.c

   1 static const char *title = \
   2 "Generate Broadcom CFE seeds and passwords for many popular modem/router devices\n"
   3 ;
   4 static const float VERSION = 1.3f;
   5
   6 static const char *copyright = \
   7 "Copyright 2015 TJ <hacker@iam.tj>\n"
   8 "Licenced on the terms of the GNU General Public Licence version 3\n"
   9 ;
  10
  11 static const char *help = \
  12 "This tool can generate passwords for use with many devices that contain Broadcom Common Firmware Environment (CFE) bootbase which has a debug mode that is enabled using the 'ATEN 1 XXXXXXXX' command, where XXXXXXXX is an eight digit hexadecimal 'password'.\n\n"
  13
  14 "It is NOT necessary to have the device generate a 'seed' using 'ATSE [MODEL-ID]' because this tool can generate the seed from the device's first (base) MAC address.\n\n"
  15
  16 "When the device generates a seed it combines the number of seconds since 1970-01-01 00:00:00 with the router MAC address. Both are encoded in a single 6-byte hexadecimal number\n\n"
  17
  18 "Each value is truncated to its 3 least significant bytes so, for example:\n\n"
  19
  20 " $ date +%F.%T; echo \"obase=16;$(date +%s)\" | bc\n"
  21 " 2016-03-26.23:06:32\n"
  22 " 56F715F8\n\n"
  23
  24 "and MAC Address: EC:43:F6:46:C0:80\n\n"
  25
  26 "becomes F715F8 concatenated with 46C080\n\n"
  27
  28 " CFE> ATSE DSL-2492GNAU-B1BC\n"
  29 " F715F846C080   <<<< last 3 bytes of MAC address\n"
  30 " ^^^^^^\n"
  31 "   seconds since 1970-01-01 00:00:00 (2016-03-26 23:06:32)\n\n"
  32
  33 "*NOTE: the default seed after power-up is 000000 so no time value needs to be specifed if 'ATSE <model-id-string>' has not been executed on the device.\n\n"
  34
  35 "Access to the device's console via a serial UART port, or a network telnet/ssh session, is required to enter the password.\n\n"
  36
  37 "So, for a device with base MAC address (reported by the CFE during boot) E.g:\n\n"
  38
  39 " CFE version 1.0.38-112.118 for BCM963268 (32bit,SP,BE)\n"
  40 "  ...\n"
  41 " Base MAC Address                  : ec:43:f6:46:c0:80\n"
  42 "  ...\n"
  43 " *** Press any key to stop auto run (1 seconds) ***\n"
  44 " CFE>\n\n"
  45
  46 "Using this tool do:\n\n"
  47
  48 " ./cfe_gen_pass -s ec:43:f6:46:c0:80 -p\n\n"
  49
  50 " MAC address: ec:43:f6:46:c0:80 Timestamp: 000000 Seed: 00000046c080 Password: 10f0a563\n\n"
  51
  52 "And on the device do:\n\n"
  53
  54 " CFE> ATEN 1 10f0a563\n"
  55 " OK\n"
  56 " *** command status = 0\n\n"
  57
  58 "The tool can accept a timestamp as 8 hexadecimal characters (useful for testing the algorithm):\n\n"
  59
  60 " ./cfe_gen_pass -t 0FF020 -s ec:43:f6:46:c0:80 -p\n\n"
  61
  62 "MAC address: ec:43:f6:46:c0:80 Timestamp: 0FF020 Seed: 0FF02046c080 Password: 110f65a3\n\n"
  63 ;
  64
  65 #include <stdio.h>
  66 #include <stdlib.h>
  67 #include <stdarg.h>
  68 #include <string.h>
  69 #include <time.h>
  70
  71 static const size_t TIMESTAMP_SIZE = 8;
  72 static const size_t SEED_SIZE = 12;
  73 static const size_t PASSWORD_SIZE = 8;
  74 static const size_t MESSAGE_SIZE = 128;
  75 static const size_t MAC_ADDR_SIZE = 17;
  76 static const size_t DATESTRING_SIZE = 20;
  77
  78 static void
  79 pr_usage()
  80 {
  81   fprintf(stderr, "%s\n",
  82     "Usage:\n"
  83     "  -v                   show version\n"
  84     "  -s 00:01:02:03:04:05 create seed from MAC address\n"
  85     "  -t [00000000]        seconds since 1970-01-01 (defaults to NOW) \n"
  86     "  -p [SEED]            generate password (with optional seed)\n\n"
  87     "  E.g. -s 01:02:03:04:05 \n"
  88     "       -s 01:02:03:04:05 -p\n"
  89     "       -p 000000030405\n"
  90   );
  91 }
  92
  93 static void
  94 pr_error_exit(unsigned int usage, const char *error, ...)
  95 {
  96  va_list args;
  97  char error_message[MESSAGE_SIZE + 1];
  98
  99  if (!error) return;
 100
 101  va_start(args, error);
 102  (void) vsnprintf(error_message, MESSAGE_SIZE + 1, error, args);
 103  va_end(args);
 104  fprintf(stderr, "Error: %s\n", error_message);
 105
 106  if (usage) pr_usage();
 107
 108  exit(EXIT_FAILURE);
 109 }
 110
 111 static const unsigned int passwords[8] = {
 112   0x10F0A563,
 113   0x887852B1,
 114   0xC43C2958,
 115   0x621E14AC,
 116   0x310F0A56,
 117   0x1887852B,
 118   0x8C43C295,
 119   0xC621E14A
 120 };
 121
 122 static unsigned int
 123 generate_seed(char *mac, char *timestamp, char *seed)
 124 {
 125   unsigned int result = 0;
 126   if (mac && strlen(mac) == MAC_ADDR_SIZE) {
 127     size_t i;
 128     char *mac_ptr = mac + 9;
 129     size_t ts_len = strlen(timestamp);
 130     if (ts_len == TIMESTAMP_SIZE) {
 131       for (i = 0; i < SEED_SIZE; ++i) {
 132         if (i < 6) // first half of seed is the truncated timestamp
 133           seed[i] = timestamp[i+2];
 134         else { // second half is the truncated MAC address
 135           if (*mac_ptr == ':' || *mac_ptr == '-')
 136             ++mac_ptr;
 137           seed[i] = *mac_ptr++;
 138         }
 139       }
 140       result = 1;
 141     } else
 142       pr_error_exit(0, "Timestamp ('%s') should be %d hexadecimal characters e.g: 56F715F8", timestamp, TIMESTAMP_SIZE);
 143   } else
 144    pr_error_exit(0, "MAC-ADDR should be %d characters, e.g: 00:01:02:03:04:05", MAC_ADDR_SIZE);
 145
 146   return result;
 147 }
 148
 149 static unsigned int
 150 generate_pass(char *seed, char *password)
 151 {
 152   unsigned int result = 0;
 153
 154   if (seed && strlen(seed) == SEED_SIZE) {
 155     unsigned int timestamp, byte, key, pass;
 156     timestamp = byte = 0;
 157     if(! sscanf(seed, "%06x", &timestamp))
 158       pr_error_exit(1, "unable to parse seed's timestamp");
 159     if (! sscanf(&seed[10], "%02x", &byte))
 160       pr_error_exit(1, "unable to parse seed's MAC address");
 161     key = byte & 0x07;
 162     pass = (passwords[key] + timestamp) ^ timestamp;
 163     snprintf(password, PASSWORD_SIZE + 1,  "%08x", pass);
 164     result = 1;
 165   } else
 166     pr_error_exit(0, "Seed should be %d hex characters", SEED_SIZE);
 167
 168   return result;
 169 }
 170
 171 int
 172 main(int argc, char **argv, char **env)
 173 {
 174   int result = 0;
 175
 176   if (argc == 1) {
 177     pr_usage();
 178   }
 179   else {
 180     unsigned int arg;
 181     char *MAC_ADDR = NULL;
 182     char timestamp[TIMESTAMP_SIZE + 1];
 183     char seed[SEED_SIZE + 1];
 184     char password[PASSWORD_SIZE + 1];
 185     char date_string[DATESTRING_SIZE + 1];
 186     unsigned int opt_seed, opt_pass, opt_ts;
 187     time_t ts = 0;
 188     struct tm *t = NULL;
 189     seed[0] = password[0] = timestamp[0] = 0;
 190     seed[SEED_SIZE] = password[PASSWORD_SIZE] = 0;
 191     opt_seed = opt_pass = opt_ts = 0;
 192     strncpy(timestamp, "00000000", TIMESTAMP_SIZE + 1);
 193
 194     for (arg = 1; arg < (unsigned) argc; ++arg) {
 195       size_t arg_len = strlen(argv[arg]);
 196
 197       if (argv[arg][0] == '-') {
 198         switch (argv[arg][1]) {
 199           case 's':
 200             opt_seed = 1;
 201             break;
 202           case 'p':
 203             opt_pass = 1;
 204             break;
 205           case 't':
 206             opt_ts = 1;
 207             break;
 208           case 'v':
 209             fprintf(stderr, "Version: %0.2f\n", VERSION);
 210         }
 211       } else if (opt_seed == 1) {
 212         MAC_ADDR = argv[arg];
 213         ++opt_seed;
 214       } else if (opt_pass == 1 && opt_seed == 0) {
 215         if (arg_len != SEED_SIZE)
 216           pr_error_exit(1, "seed length must be %d characters", SEED_SIZE);
 217
 218         strncpy(seed, argv[arg], SEED_SIZE);
 219         ++opt_pass;
 220       } else if (opt_ts == 1) {
 221         if (arg_len != TIMESTAMP_SIZE)
 222           pr_error_exit(1, "timestamp length must be %d hexadecimal characters", TIMESTAMP_SIZE);
 223
 224         strncpy(timestamp, argv[arg], TIMESTAMP_SIZE);
 225         ++opt_ts;
 226       }
 227     }
 228     if (! opt_seed && ! opt_pass)
 229       pr_usage();
 230     else if (opt_seed && opt_seed != 2)
 231       pr_error_exit(1, "seed requires MAC-ADDRESS");
 232     else if (! opt_seed && opt_pass && opt_pass != 2)
 233       pr_error_exit(1, "password on its own requires a pre-generated seed");
 234     else if (opt_seed && opt_pass && opt_pass != 1)
 235       pr_error_exit(1, "generating seed and password; cannot also accept pre-generated seed");
 236     else if (opt_pass == 2 && opt_ts)
 237       pr_error_exit(1, "seed already contains a timestamp; cannot over-ride it");
 238     else if (opt_ts == 1 || opt_pass == 2) { // no timestamp provided; use NOW
 239       ts = time(NULL);
 240       if (ts)
 241         snprintf(timestamp, TIMESTAMP_SIZE + 1, "%08lX", ts);
 242     }
 243
 244     if (opt_pass == 2) { // try to figure out the correct date-time from the seed
 245       // inherits the most significant 2 characters from the NOW time
 246       strncpy(timestamp+2, seed, 6);
 247       time_t tmp;
 248       if (sscanf(timestamp, "%08lx", &tmp))
 249         if (tmp > ts-3600 && tmp < ts+3600) // timestamps are so close they must be for the same date
 250           ts = tmp;
 251     }
 252
 253     if(opt_ts) { // ts needs to be valid to be converted to a time string
 254       if(! sscanf(timestamp, "%08lx", &ts))
 255         pr_error_exit(1, "converting timestamp string ('%s') to number", timestamp);
 256     }
 257     t = gmtime(&ts);
 258     strftime(date_string, DATESTRING_SIZE, "%F %T", t);
 259
 260     if (opt_seed)
 261       if (! generate_seed(MAC_ADDR, timestamp, seed))
 262         pr_error_exit(1, "unable to generate seed; aborting");
 263     if (opt_pass)
 264       if (! generate_pass(seed, password))
 265         pr_error_exit(0, "unable to generate password");
 266
 267     if (opt_seed || opt_pass)
 268       printf("MAC address: %s Timestamp: %s (%s) Seed: %s Password: %s\n", MAC_ADDR, timestamp, date_string, seed, password);
 269   }
 270
 271   return result;
 272 }
 273