doc/cod-format

   1 COD file structure
   2 ==================
   3
   4 To write the javeloader application, I need to understand the format of COD file.
   5
   6
   7 C structures :
   8 --------------
   9
  10 typedef struct {
  11
  12 } codfile_header_t;
  13
  14 typedef struct {
  15         int             flashid;
  16         uint    section_number;         //always 0
  17         uint    vtable_pointer;         //always 0
  18         time_t  timestamp;
  19         uint    user_version;
  20         uint    fieldref_pointer;
  21         ushort  maxtype_list_size;
  22         short   reserved;                       //always 0xFF
  23         int             data_section;           //always 0xFFFF
  24         int             module_info;            //always 0xFFFF
  25         ushort  version;
  26         ushort  code_size;
  27         ushort  data_size;
  28         ushort  flags;
  29 } code_header_t;
  30
  31 sizeof(code_header_t) = 0x2C;
  32
  33
  34 typedef struct {
  35         ubyte   flags;
  36         ubyte   version;
  37         ushort  num_icalls;
  38         ubyte   num_modules;
  39         ubyte   num_classes ;
  40         ushort  exported_string_offset;
  41         ushort  data_bytes_offset;
  42         ushort  empty_field;
  43         ushort  class_definitions;
  44         ushort  array_of_unknow_fields[14];
  45         ushort  aliases;
  46         ushort  array_of_unknow_fields[22];
  47 } data_header_t;
  48
  49 sizeof(data_header_t) = 0x34;
  50
  51
  52 Scheme :
  53 --------
  54
  55 +------------------------------------------+
  56 | COD file header (1)                      |
  57 +------------------------------------------+
  58 |   Code segment header                    |
  59 |     size = sizeof(code_header_t) = 0x2C  |
  60 +------------------------------------------+
  61 |   Code segment                           |
  62 |     size = code_header_t.code_size       |
  63 +------------------------------------------+
  64 |   Data segment header                    |
  65 |     size = sizeof(data_header_t) = 0x34  |
  66 +------------------------------------------+
  67 |   Data segment                           |
  68 |     size = code_header_t.data_size       |
  69 +------------------------------------------+
  70 +------------------------------------------+
  71 | COD file header (2)                      |
  72 +------------------------------------------+
  73 |   Code segment header                    |
  74 .                                          .
  75 .                                          .
  76 .                                          .
  77 +------------------------------------------+
  78
  79
  80 Sample (from Opera.cod) :
  81 -------------------------
  82
  83 00000000   50 4B 03 04  0A 00 00 00  00 00-AB 5C  6A 39-BE 5C  58 D1 CC 0D  PK.........\j9.\X...
  84                                                             COD size ^^^^^
  85 00000014   01 00 CC 0D  01 00 19 00  04 00                                  ..........
  86            ^^^^^ ^^^^^^^^^^^^        ^^ empty byte (after the string)
  87                    COD size   ^^ size of string
  88 00000014                                   6F 70  65 72 65 74  74 65 2D 68            operette-h
  89                                            [..............................
  90 00000028   69 66 69 2D  34 2E 32 62  65 74 61 2E  63 6F 64 FE  CA 00 00     ifi-4.2beta.cod....
  91            ................string........................] [..........] empty
  92 00000028                                                                DE                     .
  93 0000003C   C0 FF FF 00  00 00 00 00  00 00 00 E0  0E 18 49 00  00 00 00 00  ..............I.....
  94 00000050   00 00 00 22  00 FF FF FF  FF FF FF FF  FF FF FF 4E  00 08 DC 98  ..."...........N....
  95
  96 [...]
  97
  98 00010DD8   A2 03 0C 0E  08 02 04 FD  A2 03 4E 08  00 07 96 A3  03 1D 48 34  ..........N.......H4
  99 00010DEC   12 08 01 03  B5 A3 03 08  04 04 E8 A3  03 25 08 05  03 A7 A4 03  .............%......
 100 00010E00   00 00 00 00  00 00 00                                            .......
 101 00010E00                         50  4B 03 04 0A  00 00 00 00  00 AB 5C 6A         PK.........\j
 102 00010E14   39-D1 BD FC  C9-1C DD 00  00-1C DD 00  00-1B 00 00  00           9................
 103                                                      ^^ size of string
 104 00010E14                                                          6F 70 65                   ope
 105 00010E28   72 65 74 74  65 2D 68 69  66 69 2D 34  2E 32 62 65  74 61 2D 31  rette-hifi-4.2beta-1
 106 00010E3C   2E 63 6F 64                                                      .cod
 107 00010E3C                DE C0 FF FF  00 00 00 00  00 00 00 00  E0 0E 18 49      ...............I
 108 00010E50   00 00 00 00  00 00 00 00  1F 00 FF FF  FF FF FF FF  FF FF FF FF  ....................
 109 00010E64   4E 00 D8 A1  18 3B 01 00  50 29 DE 29  06 80 F8 01  15 0D FF 00  N....;..P).)........
 110 00010E78   00 20 0C FF  FF 4D 0C 46  2F 15 0D FF  FF 79 0E FF  FF 82 0E FF  . ...M.F/....y......
 111 00010E8C   FF 62 07 50  29 50 29 23  11 18 00 05  13 00 08 0E  6E 02 01 0A  .b.P)P)#........n...
 112 00010EA0   00 28 CC 0C  01 FF FF 02  69 00 03 00  6D 00 03 00  A0 04 DF A1  .(......i...m.......
 113 00010EB4   0A 6D 00 03  00 04 FF 01  00 01 55 28  1C 17 07 00  AE 11 CF 56  .m........U(.......V
 114
 115 [...]
 116
 117 0001EB54   00 00 00 00  00 00 00 00  50 4B 03 04  0A 00 00 00  00 00 AB 5C  ........PK.........\
 118 0001EB68   6A 39-24 41  BE 50 5C B0  00 00 5C B0  00-00-1B-00- 00-00 6F 70  j9$A.P\...\.......op
 119 0001EB7C   65 72 65 74  74 65 2D 68  69 66 69 2D  34 2E 32 62  65 74 61 2D  erette-hifi-4.2beta-
 120 0001EB90   32 2E 63 6F  64 DE C0 FF  FF 00 00 00  00 00 00 00  00 E0 0E 18  2.cod...............
 121
 122
 123 Sample (from Metro.cod) :
 124 -------------------------
 125
 126 00000000   50 4B 03 04  0A 00 00 00  00 00-A0 00  51 35-BA 9F  99 5D-30 CE  PK..........Q5...]0.
 127 00000014   00 00-30 CE  00-00-15-00--04-00-4D 65  74 72 6F 56  69 65 77 65  ..0.......MetroViewe
 128 00000028   72 2E 50 61  72 69 73 2E  63 6F 64 FE  CA 00 00 DE  C0 FF FF 00  r.Paris.cod.........
 129 0000003C   00 00 00 00  00 00 00 0F  10 34 45 00  00 00 00 00  00 00 00 21  .........4E........!
 130
 131
 132 0000CE54   6F 90 02 03  0F 03 A8 0F  03 04 00 02  AA 10 00 00  00 00 00 50  o..................P
 133 0000CE68   4B 03 04 0A  00 00 00 00  00 A0 00 51  35 7A C4 FE  22-34 B3-00  K..........Q5z.."4..
 134 0000CE7C   00-34 B3-00--00-17-00-00--00-4D 65 74  72 6F 56 69  65 77 65 72  .4.......MetroViewer
 135 0000CE90   2E 50 61 72  69 73 2D 31  2E 63 6F 64  DE C0 FF FF  00 00 00 00  .Paris-1.cod........
 136 0000CEA4   00 00 00 00  0F 10 34 45  00 00 00 00  00 00 00 00  05 00 FF FF  ......4E............
 137