Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
OCaml C Perl Shell Python Ruby CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
|.gnulib @ a0712c3|
hivex - by Richard W.M. Jones, firstname.lastname@example.org 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 --------------------- extra-tests/ Extra tests which need external test data. See hivex-test-data on http://git.annexia.org 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.