src/site/apt/faq.apt

   1  ----
   2  FAQ
   3  ----
   4  Haruaki Tamada
   5  ----
   6  2007-06-11
   7  ----
   8
   9 {FAQ}
  10
  11  *{{{#What is Stigmata}What is Stigmata}}
  12
  13  *{{{#What is birthmark}What is birthmark}}
  14
  15  *{{{#Why did We name the tool Stigmata}Why did We name the tool Stigmata}}
  16
  17  *{{{#What kind of features does Stigmata have}What kind of features does Stigmata have}}
  18
  19  *{{{#What is the limitation of extracting birthmarks}What is the limitation of extracting birthmarks}}
  20
  21 *{What is Stigmata}
  22
  23  Stigmata is a toolkit for birthmarking Java class files.  Extracting
  24 birthmarks from Java class files directly and comparing them.  And
  25 analyzing birthmarks in multi-dimensional scaling.
  26
  27 *{What is birthmark}
  28
  29  A birthmark is a unique and native characteristics of a program.  The
  30 birthmark provides a way to detect stolen software without embedding
  31 any additional information before distribution.
  32
  33  For more details, see {{{definition.html}Definitions}}.
  34
  35 *{Why did We name the tool Stigmata}
  36
  37  Birthmark is marks that appear on a person's body in the same places
  38  as those made on Jesus Christ's body when he was nailed to a cross.
  39
  40  {{http://dictionary.cambridge.org/define.asp?key=78150&dict=CALD}}
  41
  42  We liken birthmarks to holy sign of programs.
  43
  44 *{What kind of features does Stigmata have}
  45
  46  Stigmata have general mode and expert mode.  In general mode, we can
  47 extract certain birthmarks from jar file directly, and compare
  48 extracted birthmarks. Additionally, analyzing extracted birthmarks
  49 with MDS (multi-dimensional scaling).
  50
  51  In expert mode, it added to general mode, we can define the new
  52 birthmark, and a new filter (filtering the result of comparing).
  53
  54  Moreover, a part of extracting/comparing birthmarks is provided as
  55 plug-ins, you can define original birthmark plug-in and easily install
  56 it to Stigmata.
  57
  58 *{What is the limitation of extracting birthmarks}
  59
  60  Stigmata loads a target class by StigmataClassLoader when
  61 birthmarks were extracted from the class.  Therefore, extracting
  62 birthmarks from sealed classes will be failed.
  63
  64  For example, let <S> be a set of classes included in sealed jar file
  65 <SomeArchive-X.X.jar>, then, <<<SecurityException>>> will be thrown
  66 when extracting birthmarks from other version sealed jar file
  67 (SomeArchive-X.Y.jar).
  68
  69  This limitation is occured only when extracting IS birthmark.  IS
  70 birthmark is inheritance structure birthmark, and to extract it to
  71 find super class from loaded classes pool.  So, difference version
  72 cannot be applied.
  73
  74 **References
  75
  76  *{{{http://java.sun.com/docs/books/tutorial/deployment/jar/}Lesson: Packaging Programs in JAR Files}}
  77
  78  []