summaryrefslogtreecommitdiffstats
path: root/winsup/utils/utils.sgml
diff options
context:
space:
mode:
authorCorinna Vinschen <corinna@vinschen.de>2006-03-03 09:43:35 +0000
committerCorinna Vinschen <corinna@vinschen.de>2006-03-03 09:43:35 +0000
commit17c8ac3992639e7c5ec921d2fbd3856111be1b26 (patch)
tree243c4f3dbcfc35d187faf97e1ee4b150df7267f6 /winsup/utils/utils.sgml
parentdff8cd77009f992ddcc9df8785b6d82017ce15b5 (diff)
downloadcygnal-17c8ac3992639e7c5ec921d2fbd3856111be1b26.tar.gz
cygnal-17c8ac3992639e7c5ec921d2fbd3856111be1b26.tar.bz2
cygnal-17c8ac3992639e7c5ec921d2fbd3856111be1b26.zip
* regtool.cc (options): Add 'binary'.
(usage): Document 'load|unload|save' and '-b'. (find_key): Add 'options' parameter, add load/unload. (cmd_set): Add KT_BINARY case. (cmd_get): Add hex output in KT_BINARY case. (cmd_load): New function. (cmd_unload): New function. (set_privilege): New function. (cmd_save): New function. (commands): Add load, unload and save. (main): Add '-b' * utils.sgml (regtool): Document it.
Diffstat (limited to 'winsup/utils/utils.sgml')
-rw-r--r--winsup/utils/utils.sgml24
1 files changed, 23 insertions, 1 deletions
diff --git a/winsup/utils/utils.sgml b/winsup/utils/utils.sgml
index de6ab52c4..371bad615 100644
--- a/winsup/utils/utils.sgml
+++ b/winsup/utils/utils.sgml
@@ -1023,7 +1023,7 @@ option.
<sect2 id="regtool"><title>regtool</title>
<screen>
-Usage: regtool.exe [OPTION] (add | check | get | list | remove | unset) KEY
+Usage: regtool [OPTION] (add|check|get|list|remove|unset|load|unload|save) KEY
View or edit the Win32 registry
Actions:
@@ -1034,13 +1034,20 @@ Actions:
remove KEY remove KEY
set KEY\VALUE [data ...] set VALUE
unset KEY\VALUE removes VALUE from KEY
+ load KEY\SUBKEY PATH load hive from PATH into new SUBKEY
+ unload KEY\SUBKEY unload hive and remove SUBKEY
+ save KEY\SUBKEY PATH save SUBKEY into new hive PATH
Options for 'list' Action:
-k, --keys print only KEYs
-l, --list print only VALUEs
-p, --postfix like ls -p, appends '\' postfix to KEY names
+Options for 'get' Action:
+ -b, --binary print REG_BINARY data as hex bytes
+
Options for 'set' Action:
+ -b, --binary set type to REG_BINARY (hex args or '-')
-e, --expand-string set type to REG_EXPAND_SZ
-i, --integer set type to REG_DWORD
-m, --multi-string set type to REG_MULTI_SZ
@@ -1109,6 +1116,10 @@ accidentally removing too much.
</para>
<para>The <literal>set</literal> action sets a value within a key.
+<literal>-b</literal> means it's binary data (REG_BINARY).
+The binary values are specified as hex bytes in the argument list.
+If the argument is <literal>'-'</literal>, binary data is read
+from stdin instead.
<literal>-e</literal> means it's an expanding string (REG_EXPAND_SZ)
that contains embedded environment variables.
<literal>-i</literal> means the value is an integer (REG_DWORD).
@@ -1122,6 +1133,17 @@ a regular string.
The <literal>unset</literal> action removes a value from a key.
</para>
+<para>The <literal>load</literal> action adds a new subkey and loads
+the contents of a registry hive into it.
+The parent key must be HKEY_LOCAL_MACHINE or HKEY_USERS.
+The <literal>unload</literal> action unloads the file and removes
+the subkey.
+</para>
+
+<para>The <literal>save</literal> action saves a subkey into a
+registry hive.
+</para>
+
<para>
By default, the last "\" or "/" is assumed to be the separator between the
key and the value. You can use the <literal>-K</literal> option to provide