mono/dis/ChangeLog

   1 2003-10-10 Jackson Harper <jackson@ximian.com>
   2
   3         * dump.c: When dumping methodspecs dump the full methodspec with
   4         signature, and dump the signature.
   5
   6 2003-10-10 Jackson Harper <jackson@ximian.com>
   7
   8         * get.c/get.h: Add methods to get stringified methodspecs and
   9         method type parameters.
  10
  11 2003-10-09 Jackson Harper <jackson@ximian.com>
  12
  13         * main.c/get.c: Remove magic numbers, use constants.
  14
  15 2003-10-08 Jackson Harper <jackson@ximian.com>
  16
  17         * main.c (dis_genericparam): renamed to
  18         dis_generic_param_and_constraints, allow a table type to be passed
  19         to the method so this could be used with generic methods (It is
  20         not though).
  21         * get.c/get.h (get_generic_param): method to stringify generic
  22         type and method parameters.
  23         * get.c (dis_stringify_method_signature): Add generic parameters.
  24
  25 2003-10-08 Jackson Harper <jackson@ximian.com>
  26
  27         * main.c (dis_type): NULL cnst_block so we dont explode on
  28         interfaces.
  29         * main.c (dis_genericparam): oops, fix off-by-one error.
  30
  31 2003-10-08 Jackson Harper <jackson@ximian.com>
  32
  33         * get.c/get.h add method to get a methoddef from an index, simplify
  34         get_typd_or_methdef, use new get_methoddef to get the method
  35         because we have a method index not a method token.
  36
  37 2003-10-07 Jackson Harper <jackson@ximian.com>
  38
  39         * main.c: When dis. generic parameters the TypeOrMethodDef token
  40         only needs to be shifted 1 bit. Added dis of generic constraints.
  41         * get.c/get.h: New method for getting a TypeOrMethodDef token
  42         * dump.c: When dumping generic parameters and generic constraints
  43         output readable names instead of just tokens.
  44
  45 2003-10-01 Jackson Harper <jackson@latitudegeo.com>
  46
  47         * main.c: Fix visibility level names, when outputing pinvoke info
  48         quote the module and method names, properties have specialname,
  49         and rtspecialname flags (nothing else), dis global methods and
  50         fields FIXME: indentation issues.
  51         * get.h: declare get_fieldref_signature
  52         * get.c: Fix unsigned ints (not uint), single quote argument names
  53         (this is kinda a hack, ildasm will only single quote arg names
  54         that are ilasm keywords), remove fixme, we know what typedbyref
  55         means, output fieldref signatures instead of their token value.
  56
  57 2003-09-19 Jackson Harper <jackson@latitudegeo.com>
  58
  59         * dis-cil.c: Output fault blocks, and filter blocks. If in a
  60         filter block outptut 0xDC as endfilter if in a fault output as
  61         endfault.
  62
  63 2003-08-22  Zoltan Varga  <vargaz@freemail.hu>
  64
  65         * main.c (dis_event_list): Same for event methods.
  66
  67         * get.c (dis_stringify_method_signature): New argument specifying
  68         whenever to return a fully qualified method name.
  69         * dump.c main.c: Updated to work with the new function.
  70
  71         * main.c (dis_property_methods): Print fully qualified method names
  72         for property methods. Fixes #46221.
  73
  74 2003-07-22 Jackson Harper <jackson@latitudegeo.com>
  75
  76         * main.c: Dissasemble generic type parameters for type
  77         definitions. TODO: Sort type parameters by index, and
  78         auto-generate names for parameters that have no name.
  79
  80 Fri Jul 18 13:12:38 CEST 2003 Paolo Molaro <lupus@ximian.com>
  81
  82         * get.c: updates for array type representation changes.
  83
  84 2003-06-16 Jackson Harper <jackson@latitudegeo.com>
  85
  86         * get.c: Fix modopt and modreq
  87
  88 Thu May 29 12:21:47 CEST 2003 Paolo Molaro <lupus@ximian.com>
  89
  90         * dump.c, get.c: misc fixes.
  91
  92 Wed May 7 16:50:00 CEST 2003 Paolo Molaro <lupus@ximian.com>
  93
  94         * main.c: output custom attributes for method parameters.
  95
  96 Wed May 7 16:24:43 CEST 2003 Paolo Molaro <lupus@ximian.com>
  97
  98         * main.c: output nested types inside their nesting class.
  99
 100 2003-04-12  Zoltan Varga  <vargaz@freemail.hu>
 101
 102         * get.c (dis_stringify_modifiers): Print a space between custom modifers.
 103         * get.c (get_custom_mod): Handle multiple custom modifiers aka bug #30812.
 104         * main.c: Print klass name at the end of each method to make it easier
 105         to find a given method.
 106
 107 2003-03-31  Miguel de Icaza  <miguel@ximian.com>
 108
 109         * main.c: Sorted command line options table by name.
 110
 111         * dump.c: Add support for dumping the new generic tables.
 112
 113         * monodis.1: Update man page.
 114
 115 2003-03-09 Jackson Harper <jackson@latitudegeo.com>
 116
 117         * main.c: Ouput implements clause as a comma seperated list.
 118
 119 Thu Feb  6 02:43:23 PST 2003 Piers Haken <piersh@friskit.com>
 120
 121         * dump.c: more warning cleanups
 122
 123 Mon Jan 27 17:16:50 CET 2003 Paolo Molaro <lupus@ximian.com>
 124
 125         * get.c: decode also the size info in get_marshal_info()
 126         for ByValStr and ByValArray.
 127
 128 Tue Sep 24 11:48:53 CEST 2002 Paolo Molaro <lupus@ximian.com>
 129
 130         * main.c: use mono_type_size () to get the size of
 131         a blob of data for a type (Zoltan Varga spotted the bug).
 132
 133 2002-09-22  Gonzalo Paniagua Javier <gonzalo@ximian.com>
 134
 135         * get.c: closes bug #30814. Thanks to Zoltan Varga.
 136
 137 Mon Sep 16 18:49:55 CEST 2002 Paolo Molaro <lupus@ximian.com>
 138
 139         * main.c, get.c, dump.c: updates for changes in libmetadata.
 140
 141 Fri Sep 13 15:39:41 CEST 2002 Paolo Molaro <lupus@ximian.com>
 142
 143         * main.c: dump public key.
 144         * get.c, util.h, util.c: prettyfy data dumps.
 145
 146 2002-08-28  Dick Porter  <dick@ximian.com>
 147
 148         * Makefile.am: Export HOST_CC for w32 builds
 149
 150 Tue Aug 6 12:40:09 CEST 2002 Paolo Molaro <lupus@ximian.com>
 151
 152         * main.c: use mono_image_get_entry_point ().
 153
 154 Fri Jul 26 11:41:32 CEST 2002 Paolo Molaro <lupus@ximian.com>
 155
 156         * main.c, dump.h, dump.c: output hash value in File table.
 157         Add dumper function for DeclSecurity table.
 158
 159 Fri Jul 19 14:20:10 CEST 2002 Paolo Molaro <lupus@ximian.com>
 160
 161         * main.c: handle null parent.
 162
 163 2002-07-02  Martin Baulig  <martin@gnome.org>
 164
 165         * get.c (dis_stringify_object_with_class): New static function to
 166         stringify an object when we already have its class.
 167         (dis_stringify_object): Get the class and call dis_stringify_object().
 168         (get_method): Call dis_stringify_object_with_class() since we already
 169         have the object's class.
 170
 171 Thu Jun 20 11:50:38 CEST 2002 Paolo Molaro <lupus@ximian.com>
 172
 173         * main.c, dump.c, dump.h: code to dump the MethodImpl table.
 174
 175 Mon Jun 17 17:31:19 CEST 2002 Paolo Molaro <lupus@ximian.com>
 176
 177         * get.h, get.c: get_marshal_info() to get a marshal descriptor.
 178         * main.c, dump.h, dump.c: added code to dump the FieldMarshl table.
 179
 180 Tue Jun 11 14:11:12 CEST 2002 Paolo Molaro <lupus@ximian.com>
 181
 182         * get.c: handle modulerefs.
 183         * main.c: fix --mscorlib argument handling.
 184
 185 Fri Jun 7 19:39:43 CEST 2002 Paolo Molaro <lupus@ximian.com>
 186
 187         * get.c: handle typerefs of nested types. Don't print "."
 188         with an empty namespace.
 189
 190 Sat Jun 1 13:57:17 CEST 2002 Paolo Molaro <lupus@ximian.com>
 191
 192         * main.c: print byte values correctly.
 193
 194 2002-05-20  Martin Baulig  <martin@gnome.org>
 195
 196         * main.c: Added `--output=FILENAME' command line option.
 197
 198         * monodis.1: Documented it here.
 199
 200 Thu May 16 17:21:07 CEST 2002 Paolo Molaro <lupus@ximian.com>
 201
 202         * main.c, dump,c, get.h, get.c: diassemble custom attributes.
 203
 204 Wed May 15 16:02:56 CEST 2002 Paolo Molaro <lupus@ximian.com>
 205
 206         * main.c: output field RVA data.
 207
 208 Fri May 10 21:00:52 CEST 2002 Paolo Molaro <lupus@ximian.com>
 209
 210         * main.c: print field offset info if needed.
 211
 212 Wed May 1 17:07:56 CEST 2002 Paolo Molaro <lupus@ximian.com>
 213
 214         * dump.c, dump.h, main.c: dump ExportedTypes table.
 215         * get.c: fix get_module (), remove magic numbers.
 216         * monodis.1: update manpage (hi miguel!:)
 217
 218 Mon Apr 29 12:12:35 CEST 2002 Paolo Molaro <lupus@ximian.com>
 219
 220         * dump.c, dump.h, main.c: support for dumping the manifest resource table.
 221
 222 Mon Apr 15 11:35:05 CEST 2002 Paolo Molaro <lupus@ximian.com>
 223
 224         * dump.c, dump.h, get.c, get.h, main.c: support for dumping the
 225         module table and guid values.
 226
 227 Mon Apr 8 17:15:04 CEST 2002 Paolo Molaro <lupus@ximian.com>
 228
 229         * main.c: removed unneeded runtime invoke support.
 230
 231 Thu Mar 28 16:52:11 CET 2002 Paolo Molaro <lupus@ximian.com>
 232
 233         * dis-cil.c, dump.c, get.c, main.c, util.h: spring warning cleanup.
 234
 235 Thu Mar 28 11:29:58 CET 2002 Paolo Molaro <lupus@ximian.com>
 236
 237         * util.c: when an invalid flags combination is seen,
 238         return the string "invalid-flags", so disassembly can continue.
 239
 240 Tue Mar 19 18:15:29 CET 2002 Paolo Molaro <lupus@ximian.com>
 241
 242         * dis-cil.c: use unsigned for variables.
 243
 244 Sat Mar 16 19:13:57 CET 2002 Paolo Molaro <lupus@ximian.com>
 245
 246         * dump.c: handle TypeSpec token in memberref table dump.
 247
 248 2002-03-08  Nick Drochak  <ndrochak@gol.com>
 249
 250         * monodis.1: Add info about new parameter
 251         * main.c: Add flag to remember if user wants to us mscorlib for
 252         non-corilb assembly names
 253         * get.c(get_typedef): use mscorlib for assembly name only
 254         if user specifies it with a command line parameter. Default
 255         behavior is now to use actual assembly name.
 256
 257 Tue Mar 5 18:11:01 CET 2002 Paolo Molaro <lupus@ximian.com>
 258
 259         * dump.c: print index of the methodsemantics table.
 260         * main.cs: print event information.
 261
 262 Wed Feb 20 22:10:48 CET 2002 Paolo Molaro <lupus@ximian.com>
 263
 264         * dump.c: fix the fix and more complete custom attribute decoder.
 265
 266 Tue Feb 19 20:20:15 CET 2002 Paolo Molaro <lupus@ximian.com>
 267
 268         * dump.c: the prolog is before each arg in the custom attribute blob.
 269
 270 Mon Feb 18 15:48:38 CET 2002 Paolo Molaro <lupus@ximian.com>
 271
 272         * get.c: include last param.
 273
 274 Thu Feb 14 18:59:37 CET 2002 Paolo Molaro <lupus@ximian.com>
 275
 276         * main.c: output pack and size info if needed.
 277
 278 2002-02-13  Dietmar Maurer  <dietmar@ximian.com>
 279
 280         * *.c: s/MonoMetadata/MonoImage/
 281
 282 Tue Feb 12 14:33:53 CET 2002 Paolo Molaro <lupus@ximian.com>
 283
 284         * dump.c: make all the indexes printed starting from 1.
 285
 286 Fri Feb 8 19:28:31 CET 2002 Paolo Molaro <lupus@ximian.com>
 287
 288         * get.c: don't abort if a methodref is not found, usa alternative way
 289         to get the method name.
 290
 291 Fri Feb 8 12:29:41 CET 2002 Paolo Molaro <lupus@ximian.com>
 292
 293         * Makefile.am: correct linking order.
 294         * dis-cil.c: use opcode info from opcodes.h instead of a copy of the data.
 295
 296 Thu Jan 31 18:21:12 CET 2002 Paolo Molaro <lupus@ximian.com>
 297
 298         * dis-cil.c: reverse order when outputting start try blocks.
 299
 300 Mon Jan 14 17:00:23 CET 2002 Paolo Molaro <lupus@ximian.com>
 301
 302         * dump.c: more info in method table dump.
 303
 304 Mon Dec 24 17:24:13 CET 2001 Paolo Molaro <lupus@ximian.com>
 305
 306         * main.c, dump.h, dump.c: add dump_table_nestedclass().
 307         * dis-cil.c: output int64 as hex.
 308
 309 Tue Dec 18 18:48:00 CET 2001 Paolo Molaro <lupus@ximian.com>
 310
 311         * main.c: use mono_metadata_methods_from_property() and
 312         mono_metadata_properties_from_typedef() from metadata instead of
 313         custom code.
 314
 315 Tue Nov 27 16:31:52 CET 2001 Paolo Molaro <lupus@ximian.com>
 316
 317         * main.c: output a marker for method (used in debug support).
 318
 319 Mon Nov 19 11:32:28 CET 2001 Paolo Molaro <lupus@ximian.com>
 320
 321         * main.c: remove arch_create_jit_trampoline().
 322
 323 Thu Nov 15 17:42:03 CET 2001 Paolo Molaro <lupus@ximian.com>
 324
 325         * dump.c: decode more info in the constant table.
 326         * get.c: show literals the same way ildasm does.
 327         * main.c: decode literal values for fields.
 328
 329 Fri Nov 2 19:04:21 CET 2001 Paolo Molaro <lupus@ximian.com>
 330
 331         * main.c, dump, dump.c: decode the customattr table.
 332         * dump.c: handle also field signature when dumping the memberref
 333         table.
 334
 335 2001-11-07  Miguel de Icaza  <miguel@ximian.com>
 336
 337         * main.c (dis_property_methods): Added missing colon which avoided
 338         setting loc.t
 339
 340 2001-10-10  Dietmar Maurer  <dietmar@ximian.com>
 341
 342         * main.c (arch_compile_method):  added to compute vtable entry
 343
 344 Mon Oct 8 16:13:55 CEST 2001 Paolo Molaro <lupus@ximian.com>
 345
 346         * get.c, get.h: MonoArray changed in MonoArrayType.
 347         * main.c: guard against calling bsearch with a NULL pointer
 348         (pointed out by Laurent Rioux, smoux).
 349
 350 Thu Oct 4 19:05:56 CEST 2001 Paolo Molaro <lupus@ximian.com>
 351
 352         * dis-cil.c: fix printing of exception stuff.
 353         * dump.c: display some more info in the typedef table dump.
 354         * main.c: typo fix and method list fix.
 355
 356 2001-10-04  Dick Porter  <dick@ximian.com>
 357
 358         * meta.h: include mono-endian.h not endian.h
 359
 360 2001-10-02  Dietmar Maurer  <dietmar@ximian.com>
 361
 362         * get.c (get_method): always write namespace and class name.
 363
 364 2001-09-06  Miguel de Icaza  <miguel@ximian.com>
 365
 366         * monodis.1: Update man page.
 367
 368 Tue Aug 28 15:54:45 CEST 2001 Paolo Molaro <lupus@ximian.com>
 369
 370         * main.c, dump.c, dump.h, get.c: added dump_table_interfaceimpl ().
 371         Output info about interfaces when disassembling a type. Many small
 372         changes to make the output correct assembler.
 373
 374 Mon Aug 27 20:13:49 CEST 2001 Paolo Molaro <lupus@ximian.com>
 375
 376         * dis-cil.c, get.c: some endian fixes.
 377         * main.c: colon-separate version numbers. Print also namespace
 378         when outputting class information.
 379
 380 Fri Aug 24 16:10:12 CEST 2001 Paolo Molaro <lupus@ximian.com>
 381
 382         * get.c, main.c, get.h: updates for MonoParam merge in MonoType.
 383
 384 2001-08-24  Dietmar Maurer  <dietmar@ximian.com>
 385
 386         * main.c (disassemble_file): use assembly_open instead of image_open
 387
 388 Wed Aug 22 16:22:22 CEST 2001 Paolo Molaro <lupus@ximian.com>
 389
 390         * dis-cil.c: add a newline after branch instructions. Move
 391         end of exception handler code at the end.
 392
 393 Tue Aug 21 18:51:05 CEST 2001 Paolo Molaro <lupus@ximian.com>
 394
 395         * dis-cil.c: correctly print the label for multi-byte opcodes.
 396
 397 Mon Aug 20 19:33:34 CEST 2001 Paolo Molaro <lupus@ximian.com>
 398
 399         * util.c: add a space when decoding multiple flags.
 400         * dump.c, dump.h, main.c: decode the property map and
 401         methodsemantics tables. Disassemble property information
 402         to .property IL directives.
 403         * get.c: allow passing a NULL as method in dis_stringify_method ()
 404         if a methoddef_row is given.
 405
 406 2001-08-20  Dietmar Maurer  <dietmar@ximian.com>
 407
 408         * get.c (dis_stringify_type): support pinned values
 409
 410 Sat Aug 18 11:24:07 CEST 2001 Paolo Molaro <lupus@ximian.com>
 411
 412         * dump.c, get.c, get.h, main.c: dis_stringify_method_signature()
 413         gets an optional methodef_row index instead of a name, so it
 414         can figure out also the names and attributes of params.
 415         parse_method_signature() and free_method_signature() removed as
 416         they are useless now.
 417
 418 2001-08-17  Dietmar Maurer  <dietmar@ximian.com>
 419
 420         * main.c (pinvoke_info): bug fix - use the right column in the table
 421
 422 2001-08-14  Dietmar Maurer  <dietmar@ximian.com>
 423
 424         * get.c (dis_stringify_type): use strconcat instead of strjoin
 425
 426 Sat Aug 4 12:36:54 CEST 2001 Paolo Molaro <lupus@ximian.com>
 427
 428         * get.c, get.h, main.c, dump.c: implement dis_stringify_method_signature().
 429         More magic constants replaced by enum values (spotted at least 3 real bugs
 430         doing this). Print usage information if an unknown option is given.
 431         Print the full signature when dumping the method table.
 432         Changed method and field table dumps to show the typedef name the field
 433         or method belongs to.
 434
 435 Fri Aug 3 18:30:16 CEST 2001 Paolo Molaro <lupus@ximian.com>
 436
 437         * get.c (get_method): fix use of unitialized variable and
 438         remove magic constants all over the place.
 439
 440 Wed Aug 1 22:46:45 CEST 2001 Paolo Molaro <lupus@ximian.com>
 441
 442         * dis-cil.c: properly decode the switch opcode.
 443
 444 2001-08-01  Dietmar Maurer  <dietmar@ximian.com>
 445
 446         * get.c (get_token): decode typedef and typeref tokens
 447
 448         * main.c (dis_method_list): don't decode the next row, that is
 449         totally unnecessary
 450
 451 Tue Jul 31 17:48:11 CEST 2001 Paolo Molaro <lupus@ximian.com>
 452
 453         * dis-cil.c, dis-cil.h, dump.c, dump.h, get.c, get.h, main.c, push-pop.h:
 454         massive namespace cleanup.
 455         * main.c: dis_locals() now just strigifies a MonoMethodHeader.
 456
 457 2001-07-31  Dietmar Maurer  <dietmar@ximian.com>
 458
 459         * main.c (pinvoke_flags): impl.
 460
 461 Mon Jul 30 20:08:37 CEST 2001 Paolo Molaro <lupus@ximian.com>
 462
 463         * dis-cil.c, dis-cil.h, main.c: changes to disassemble also
 464         the information about try/catch/finally blocks.
 465
 466 2001-07-27  Dietmar Maurer  <dietmar@ximian.com>
 467
 468         * get.c (dis_stringify_type): return "void" if !type
 469         (dis_stringify_type): print type* instead of *type
 470
 471 Thu Jul 26 13:22:28 CEST 2001 Paolo Molaro <lupus@ximian.com>
 472
 473         * dis-cil.c, dump.c, get.c, main.c: updates to match changes in metadata.
 474         Removed dead code.
 475
 476 2001-07-17  Miguel de Icaza  <miguel@ximian.com>
 477
 478         * main.c (usage): Print out all the arguments.
 479
 480         * get.c, main.c, dump.c: Remove `expand', `get_encoded_value',
 481         `get_blob_encoded_size' and replaced with the proper functions
 482         from metadata.c
 483
 484 2001-07-15  Miguel de Icaza  <miguel@ximian.com>
 485
 486         * main.c (dis_code): Only display .entrypoint when we are dealing
 487         with a module that contains an entry point.  This removes a bunch
 488         of warnings for .dll dumping
 489
 490 Sun Jul 15 17:29:10 CEST 2001 Paolo Molaro <lupus@ximian.com>
 491
 492         * get.h,get.c: added some dis_stringify_object() functions:
 493         metadata decoding is now done in libmetadata. Still need to use
 494         them throughhout the code (and move other decode code to
 495         metadata). Fix also field decoding (band-aid until we load
 496         also referenced assemblies).
 497         * dis/main.c: start using the new routines.
 498
 499 2001-07-13  Miguel de Icaza  <miguel@ximian.com>
 500
 501         * get.c (get_method): GOOD. Implemented this other bad boy.
 502
 503 2001-07-12  Miguel de Icaza  <miguel@ximian.com>
 504
 505         * get.c (get_token_type): Implement TOKEN_TYPE_TYPE_SPEC.
 506         (get_typespec): Implement.
 507         (get_typedef_or_ref): Use get_typespec.
 508
 509         * dis-cil.c (dissasemble_cil): Implement InlineField
 510         (dissasemble_cil): Implement InlineTok.
 511
 512         * get.c (get_token, get_field): Implemented.  Worked around lame
 513         tables in the spec.
 514
 515 Wed Jul 11 18:52:15 CEST 2001 Paolo Molaro <lupus@ximian.com>
 516
 517         * dis-cil.c: output real name of local var.
 518         * dump.c: output more info about fields (flags and type). Properly decode
 519         Property signatures. Decode also method table.
 520         * main.c: Fix local variable info. Hopefully fix field and property list.
 521
 522 Mon Jul  9 16:39:41 CEST 2001 Paolo Molaro <lupus@ximian.com>
 523
 524         * dump.c: write stuff to output, not stderr. Give more info for properties.
 525         * dump.c,dump.h,main.c: implement dump_table_event(), dump_table_file(),
 526         dump_table_moduleref().
 527         * get.c: first attempt to decode string constants, need to find if and where
 528         this is actually specified.
 529
 530 Fri Jul  6 19:49:21 CEST 2001 Paolo Molaro <lupus@ximian.com>
 531
 532         * dump.c,dump.h: implement dump_table_property().
 533         * main.c: implement local variable info disassembling.
 534         Annotate entrypoint method. Remove memory leak in
 535         parse_method_signature ().
 536
 537 2001-07-04  Miguel de Icaza  <miguel@ximian.com>
 538
 539         * get.c (get_methodref_signature): Implement.
 540
 541         * dump.c (dump_table_memberref): Add memberref dumping.
 542
 543 Tue,  3 Jul 2001 18:32:10 +0200 Paolo Molaro <lupus@ximian.com>
 544
 545         * main.c: return on failure.
 546
 547 2001-07-02  Miguel de Icaza  <miguel@ximian.com>
 548
 549         * dis-cil.c (get_encoded_user_string): Return a string from the
 550         #US heap. o
 551
 552         * get.c (get_blob_encoded_size): Implement 23.1.4 decoding.
 553
 554 2001-07-01  Miguel de Icaza  <miguel@ximian.com>
 555
 556         * dis-cil.c: New file.  CIL opcode dissasembler.
 557
 558 2001-06-27  Miguel de Icaza  <miguel@ximian.com>
 559
 560         * main.c: Split code.
 561
 562 2001-06-22  Miguel de Icaza  <miguel@ximian.com>
 563
 564         * main.c: More work on the disassembler and on the understanding
 565         of the metadata file format.
 566