X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=README;h=ae3d159e5cb8e755cce9ad7e5967dd0b03d9ed32;hb=d5ed3c8f348e4ce6bc944ae6312bf9d8bfe852d4;hp=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hpb=cb9cb9b7dcdf62310c7b543aaac0a82d7f4b9319;p=hivex.git

diff --git a/README b/README
index e69de29..ae3d159 100644
--- a/README
+++ b/README
@@ -0,0 +1,106 @@
+hivex - by Richard W.M. Jones, rjones@redhat.com
+Copyright (C) 2009-2010 Red Hat Inc.
+----------------------------------------------------------------------
+
+This is a self-contained library for reading and writing Windows
+Registry "hive" binary files.
+
+Unlike many other tools in this area, it doesn't use the textual .REG
+format for output, because parsing that is as much trouble as parsing
+the original binary format.  Instead it makes the file available
+through a C API, or there is a separate program to export the hive as
+XML.
+
+This library was derived from several sources:
+
+ . NTREG registry reader/writer library by Petter Nordahl-Hagen
+    (LGPL v2.1 licensed library and program)
+ . http://pogostick.net/~pnh/ntpasswd/WinReg.txt
+ . dumphive (a BSD-licensed Pascal program by Markus Stephany)
+ . http://www.sentinelchicken.com/data/TheWindowsNTRegistryFileFormat.pdf
+ . editreg program from Samba - this program was removed in later
+   versions of Samba, so you have to go back in the source repository
+   to find it (GPLv2+)
+ . http://amnesia.gtisc.gatech.edu/~moyix/suzibandit.ltd.uk/MSc/
+ . reverse engineering the format (see lib/tools/visualizer.ml)
+
+Like NTREG, this library only attempts to read Windows NT registry
+files (ie. not Windows 3.1 or Windows 95/98/ME).  See the link above
+for documentation on the older formats if you wish to read them.
+
+Unlike NTREG, this code is much more careful about handling error
+cases, corrupt and malicious registry files, and endianness.
+
+License
+-------
+
+The license for this library is LGPL v2.1, but not later versions.
+For full details, see the file LICENSE in this directory.
+
+Dependencies
+------------
+
+To just build the library, the dependencies are quite minimal.  You
+only need the following:
+
+- An ISO C compiler.
+
+- Perl tools 'pod2man' and 'pod2text'.
+
+These dependencies are needed for the tools:
+
+- Readline library (optional, to add command-line editing to hivexsh).
+
+- libxml2 (optional, for hivexml).
+
+If you want to make the generated files or change the API, then you
+will need the OCaml interpreter (/usr/bin/ocaml).
+
+To build the language bindings, you will need various extra packages.
+See the configure output for more details.
+
+Directories and tools
+---------------------
+
+generator/
+
+	Generator used to write a lot of boilerplate code for
+	header files, documentation, language bindings etc.
+	The API for hivex is specified in the generator.
+
+images/
+
+	Test hive files.  See images/README.
+
+lib/
+
+	The C library.
+
+ocaml/
+
+	OCaml bindings and tests.  The bindings are generated by
+	'generator/generator.ml'.
+
+perl/
+
+	Perl bindings and tests.  The bindings are generated by
+	'generator/generator.ml'.
+
+python/
+
+	NOTE: Python bindings are not yet written.  Your patches
+	are welcome (please modify generator/generator.ml to
+	add them).
+
+regedit/
+        Regedit-like registry merging tool.
+
+sh/
+
+	Interactive shell.  This also contains the old 'hivexget'
+	tool (originally written in C, now replaced by a hivexsh
+	shell script).
+
+xml/
+
+	hivexml program which converts hive files to XML.