NAME

hivexget - Get subkey from a Windows Registry binary "hive" file

SYNOPSIS

hivexget hivefile '\Path\To\SubKey'

hivexget hivefile '\Path\To\SubKey' name

NOTE

This is a low-level tool. For a more convenient way to navigate the Windows Registry in Windows virtual machines, see virt-win-reg(1). For proper regedit formatting, use hivexregedit(1).

DESCRIPTION

This program navigates through a Windows Registry binary "hive" file and extracts either all the (key, value) data pairs stored in that subkey or just the single named data item.

In the first form:

hivexget hivefile '\Path\To\SubKey'

hivefile is some Windows Registry binary hive, and \Path\To\Subkey is a path within that hive. NB the path is relative to the top of this hive, and is not the full path as you would use in Windows (eg. HKEY_LOCAL_MACHINE\SYSTEM is not a valid path).

If the subkey exists, then the output lists all data pairs under this subkey, in a format similar to regedit in Windows.

In the second form:

hivexget hivefile '\Path\To\SubKey' name

hivefile and path are as above. name is the name of the value of interest (use @ for the default value).

The corresponding data item is printed "raw" (ie. no processing or escaping) except:

  1. If it's a string we will convert it from Windows UTF-16 to UTF-8, if this conversion is possible. The string is printed with a single trailing newline.

  2. If it's a multiple-string value, each string is printed on a separate line.

  3. If it's a numeric value, it is printed as a decimal number.

SEE ALSO

hivex(3), hivexml(1), hivexsh(1), hivexregedit(1), virt-win-reg(1), guestfs(3), http://libguestfs.org/, virt-cat(1), virt-edit(1).

AUTHORS

Richard W.M. Jones (rjones at redhat dot com)

COPYRIGHT

Copyright (C) 2009 Red Hat Inc.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.