From dcd088846754d298ed0c426827d457cbde7bebc2 Mon Sep 17 00:00:00 2001 From: tama3 Date: Mon, 11 Jun 2007 09:58:30 +0000 Subject: [PATCH] update document git-svn-id: svn+ssh://svn.sourceforge.jp/svnroot/stigmata/trunk@125 acee48c3-7b26-0410-bdac-b3d0e5314bbc --- src/site/apt/definition.apt | 59 ++++++++++++++++++++++ src/site/apt/download.apt | 2 +- src/site/apt/dtd.apt | 120 ++++++++++++++++++++++++++++++++++++++++++++ src/site/apt/faq.apt | 55 ++++++++++++++++++++ src/site/apt/index.apt | 9 ++-- src/site/site.xml | 3 ++ 6 files changed, 243 insertions(+), 5 deletions(-) create mode 100755 src/site/apt/definition.apt create mode 100755 src/site/apt/dtd.apt create mode 100755 src/site/apt/faq.apt diff --git a/src/site/apt/definition.apt b/src/site/apt/definition.apt new file mode 100755 index 0000000..b62d216 --- /dev/null +++ b/src/site/apt/definition.apt @@ -0,0 +1,59 @@ + ---- + Definitions + ---- + Haruaki Tamada + ---- + 2007-06-11 + ---- + +Definitions + +*Birthmark + + Let

, be programs and be a set of characteristics +extracted from

by a certain method . Then is called a + of

iff both of the following conditions are satisfied. + +*Conditions of Birthmark + + First condition means that the birthmark is not extra information and +is required for

to run. Hence, extracting a birthmark does not +require extra code as watermarking does. Second condition states that +the same birthmark has to be obtained from copied programs. By +contraposition, if birthmarks and are different, then +

is different from holds. That is, we can guarantee that is +not a copy of

. + + [[1]] is obtained from

itself without any extra information. + + [[2]]If is copied from

, then + +*Properties of Birthmark + + Hopefully, a birthmark will satisfy the following properties. These +properties strengthen Condition 2 of birthmark definition. First +property specifies of the birthmark against +program transformation. Preservation property specifies that the same +birthmark must be obtained from

and converted to . However, +there exist many ways to transform a program into an equivalent +one. Hence, in reality, it is difficult to extract strong enough +birthmarks to perfectly satisfy preservation property. + + Second property specifies the of the +birthmark, stating that: even though the specification of

and +is the same, if implemented separately, different birthmarks should be +extracted. In general, the detail of two independent programs is +almost never completely the same. However, in the case that

and + are both programs, extracted birthmarks could become the +same, even if

and are written independently. Those properties +should be tuned within an allowable range at the user's discretion. + +**Preservation + + For obtained from

by any program transformation, holds. + +**Distinction + + For

and such that same specification, if

and are +written independently, then . diff --git a/src/site/apt/download.apt b/src/site/apt/download.apt index aea1b51..3645748 100755 --- a/src/site/apt/download.apt +++ b/src/site/apt/download.apt @@ -117,5 +117,5 @@ $ svn checkout http://svn.sourceforge.jp/svnroot/stigmata/trunk/ stigmata You can brouse the source code from following link. - {{{http://svn.sourceforge.jp/cgi-bin/viewcvs.cgi/?root=stigmata}http://svn.sourceforge.jp/cgi-bin/viewcvs.cgi/?root=stigmata}} + {{http://svn.sourceforge.jp/cgi-bin/viewcvs.cgi/?root=stigmata}} diff --git a/src/site/apt/dtd.apt b/src/site/apt/dtd.apt new file mode 100755 index 0000000..c6f4376 --- /dev/null +++ b/src/site/apt/dtd.apt @@ -0,0 +1,120 @@ + ---- + DTD + ---- + Haruaki Tamada + ---- + 2006-12-12 + ---- + +Overview + + Stigmata supports two types of xml file. One is + {{{#Stigmata setting xml}configuration settings}} of Stigmata. Another is + {{{#Birthmarking result xml}result of birthmarking}}. + +{Stigmata setting xml} + + This dtd is defined for configuration settings of Stigmata. A xml +file formatted in this dtd can be specified <<<--config-file>>> option +of Stigmata. + +*DTD + +---- + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +---- + +{Birthmarking result xml} + + This dtd is defined for a result of Stigmata. The result of Stigmata +is birthmark service list, list of extracted birthmarks, and +similarities between all combinations of class files. Those +information is shown as xml file formatted in this DTD. + +*DTD + +---- + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +---- \ No newline at end of file diff --git a/src/site/apt/faq.apt b/src/site/apt/faq.apt new file mode 100755 index 0000000..68beeba --- /dev/null +++ b/src/site/apt/faq.apt @@ -0,0 +1,55 @@ + ---- + FAQ + ---- + Haruaki Tamada + ---- + 2007-06-11 + ---- + +{FAQ} + + *{{{#What is stigmata}What is stigmata}} + + *{{{#What is birthmark}What is birthmark}} + + *{{{#Why did I name it stigmata}Why did I name it stigmata}} + + *{{{#What kind of features does stigmata have}What kind of features does stigmata have}} + +*{What is stigmata} + + Stigmata is a toolkit for birthmarking Java class files. Extracting +birthmarks from Java class files directly and comparing them. And +analyzing birthmarks in multi-dimensional scaling. + +*{What is birthmark} + + A birthmark is a unique and native characteristics of a program. The +birthmark provides a way to detect stolen software without embedding +any additional information before distribution. + + For more defails, see {{{definition.html}Definitions}}. + +*{Why did I name it stigmata} + + Birthmark is marks that appear on a person's body in the same places + as those made on Jesus Christ's body when he was nailed to a cross. + + {{http://dictionary.cambridge.org/define.asp?key=78150&dict=CALD}} + + We liken birthmarks to holy sign of programs. + +*{What kind of features does stigmata have} + + Stigmata have general mode and expert mode. In general mode, we can +extract certain birthmarks from jar file directly, and compare +extracted birthmarks. Additionally, analyzing extracted birthmarks +with MDS (multi-dimensional scaling). + + In expert mode, it added to general mode, we can define the new +birthmark, and a new filter (filtering the result of comparing). + + Moreover, a part of extracting/comparing birthmarks is provided as +plugins, you can define original birthmark plugin and easily install +it to Stigmata. + diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt index 1e9f946..c73dbaa 100755 --- a/src/site/apt/index.apt +++ b/src/site/apt/index.apt @@ -9,9 +9,10 @@ Overview Stigmata is rewrite almost every source code based on <<>> -which available at http://se.naist.jp/jbirth. Stigmata aims to detect -the theft of programs, too. This tool can extract birthmarks from -Java class files, and compare them. Differences from <<>> are +which available at {{http://se.naist.jp/jbirth}}. Stigmata aims to +detect the theft of programs, too. This tool can extract birthmarks +from Java class files, and compare them. Differences from +<<>> are * using spi (service provider interface) architecture for birthmark implementation @@ -66,7 +67,7 @@ Related Tools *{{{http://www.e-t.com/jshrink.html}JShrink}} - *{{{http://www.drjava.de/obfuscator/}Marvin Obfuscator }} + *{{{http://www.drjava.de/obfuscator/}Marvin Obfuscator}} *{{{http://proguard.sourceforge.net/}ProGuard}} diff --git a/src/site/site.xml b/src/site/site.xml index 85d9b37..d1720a0 100755 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -36,6 +36,9 @@

+ + + -- 2.11.0