OSDN Git Service

update initialization process. make not existing history directory
[stigmata/stigmata-core.git] / README.txt
1
2                    Stigmata: Java birthmark toolkit
3                             version 1.2.0
4                    http://stigmata.sourceforge.jp/
5
6                               Copyright 2006-2007 Haruaki Tamada, Ph.D
7                                             Software Engineering Lab.,
8                            Graduate School of Information and Science,
9                              Nara Institute of Science and Technology,
10
11 * Overview
12
13     Stigmata is Java birthmark toolkit, which aims to detect the
14   theft of programs.  This tool can extract birthmarks from Java
15   class files directory, and compare them.
16
17     A birthmark is a set of special informations that the program
18   originally possesses.  The birthmark is carefully extracted from
19   critical portions of class file.  Hence, if a class file P has
20   the same birthmark as another class file Q's, Q is very likely to
21   be a copy of P.  Thus, the birthmark can be used as a simple but
22   powerful signature to distinguish doubtful class files (those
23   which seem to be copies).
24
25 * Features
26
27     Stigmata support the extracting birthmarks from Java class
28   files, and written in Java 5 with ASM.
29
30   The main features are:
31
32   - extraction of the four types of birthmarks directly from Java
33     class files (without source code),
34   - pairwise birthmark comparison of Java class files,
35   - Jar file and War file support,
36   - plug-in architecture for new birthmarks, and
37   - analysis of extracted birthmarks (MDS)
38
39 * Requirements
40
41   Stigmata requires following libraries.
42
43   - ASM 2.2.3 (http://asm.objectweb.org/)
44   - Jakarta Commons CLI 1.1 (http://commons.cafebabe.jp/xmlcli/)
45   - XmlCli 1.2.1 (http://talisman.sourceforge.jp/xmlcli/)
46   - Jama 1.0.2 (http://math.nist.gov/javanumerics/jama/)
47     stigmata-1.0.0 or later
48   - BrowserLauncher2 1.3 (http://browserlaunch2.sourceforge.net/)
49     stigmata-1.1.0 or later; as needed
50   - stax-api-1.0.1.jar (http://stax.codehaus.org/)
51     stigmata-1.2.0 or later
52   - stax-1.2.0.jar (http://stax.codehaus.org/)
53     stigmata-1.2.0 or later
54   - JUnit 4.1 (http://www.junit.org/) for testing.
55
56 * Author
57
58   Name:        Haruaki TAMADA, Ph.D.
59   Affiliation: Software Engineering Laboratory, Graduate School of
60                Information and Science, Nara Institute of Science and
61                Technology
62   E-mail:      harua-t[ at ]is.naist.jp
63   Web Page:    http://se.naist.jp/~harua-t/
64
65   Please notify us some bugs and requests to 
66   mailto:stigmata-info[ at ]lists.sourceforge.jp
67