diff options
author | Corinna Vinschen <corinna@vinschen.de> | 2008-12-12 18:14:06 +0300 |
---|---|---|
committer | Corinna Vinschen <corinna@vinschen.de> | 2008-12-12 18:14:06 +0300 |
commit | baaa8b9140404b1fc7a4ad6b912201da32d8c890 (patch) | |
tree | 22c46889f28b966cba7c7d8f92b989292a339eec /winsup/doc | |
parent | 6b9838a3431b91778cedf561d9af26ff22457cf6 (diff) |
* pathnames.sgml: New section for /proc/registry. Document registry
name encoding.
Diffstat (limited to 'winsup/doc')
-rw-r--r-- | winsup/doc/ChangeLog | 5 | ||||
-rw-r--r-- | winsup/doc/pathnames.sgml | 49 |
2 files changed, 45 insertions, 9 deletions
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index de7ab0649..080b75089 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,8 @@ +2008-12-11 Christian Franke <franke@computer.org> + + * pathnames.sgml: New section for /proc/registry. Document registry + name encoding. + 2008-12-04 Corinna Vinschen <corinna@vinschen.de> * ntsec.sgml: Fix typo. diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml index 2daad6d2c..f501606b8 100644 --- a/winsup/doc/pathnames.sgml +++ b/winsup/doc/pathnames.sgml @@ -510,11 +510,23 @@ displays information such as what model and speed processor you have. </para> <para> One unique aspect of the Cygwin <filename>/proc</filename> filesystem -is <filename>/proc/registry</filename>, which displays the Windows -registry with each <literal>KEY</literal> as a directory and each -<literal>VALUE</literal> as a file. As anytime you deal with the -Windows registry, use caution since changes may result in an unstable -or broken system. There are additionally subdirectories called +is <filename>/proc/registry</filename>, see next section. +</para> +<para> +The Cygwin <filename>/proc</filename> is not as complete as the +one in Linux, but it provides significant capabilities. The +<systemitem>procps</systemitem> package contains several utilities +that use it. +</para> +</sect2> + +<sect2 id="pathnames-proc-registry"><title>The /proc/registry filesystem</title> +<para> +The <filename>/proc/registry</filename> filesystem provides read-only +access to the Windows registry. It displays each <literal>KEY</literal> +as a directory and each <literal>VALUE</literal> as a file. As anytime +you deal with the Windows registry, use caution since changes may result +in an unstable or broken system. There are additionally subdirectories called <filename>/proc/registry32</filename> and <filename>/proc/registry64</filename>. They are identical to <filename>/proc/registry</filename> on 32 bit host OSes. On 64 bit host OSes, <filename>/proc/registry32</filename> @@ -522,10 +534,29 @@ opens the 32 bit processes view on the registry, while <filename>/proc/registry64</filename> opens the 64 bit processes view. </para> <para> -The Cygwin <filename>/proc</filename> is not as complete as the -one in Linux, but it provides significant capabilities. The -<systemitem>procps</systemitem> package contains several utilities -that use it. +Reserved characters ('/', '\', ':', and '%') or reserved names +(<filename>.</filename> and <filename>..</filename>) are converted by +percent-encoding: +<screen> +<prompt>bash$</prompt> <userinput>regtool list -v '\HKEY_LOCAL_MACHINE\SYSTEM\MountedDevices'</userinput> +... +\DosDevices\C: (REG_BINARY) = cf a8 97 e8 00 08 fe f7 +... +<prompt>bash$</prompt> <userinput>cd /proc/registry/HKEY_LOCAL_MACHINE/SYSTEM</userinput> +<prompt>bash$</prompt> <userinput>ls -l MountedDevices</userinput> +... +-r--r----- 1 Admin SYSTEM 12 Dec 10 11:20 %5CDosDevices%5CC%3A +... +<prompt>bash$</prompt> <userinput>od -t x1 MountedDevices/%5CDosDevices%5CC%3A</userinput> +0000000 cf a8 97 e8 00 08 fe f7 01 00 00 00 +</screen> +The unnamed (default) value of a key can be accessed using the filename +<filename>@</filename>. +</para> +<para> +If a registry key contains a subkey and a value with the same name +<filename>foo</filename>, Cygwin displays the subkey as +<filename>foo</filename> and the value as <filename>foo%val</filename>. </para> </sect2> |