summaryrefslogtreecommitdiffstats
path: root/winsup/doc
diff options
context:
space:
mode:
authorCorinna Vinschen <corinna@vinschen.de>2016-03-19 13:21:18 +0100
committerCorinna Vinschen <corinna@vinschen.de>2016-03-19 13:21:18 +0100
commite42f66d00f450a643e1920aa28037188aa1f2f7c (patch)
treeaac991408054a988bafae7864a1744546852255c /winsup/doc
parentd17977ccc70278101b605da51b6e96f8b3c9e44b (diff)
downloadcygnal-e42f66d00f450a643e1920aa28037188aa1f2f7c.tar.gz
cygnal-e42f66d00f450a643e1920aa28037188aa1f2f7c.tar.bz2
cygnal-e42f66d00f450a643e1920aa28037188aa1f2f7c.zip
Remove ill-advised cygwin_props
Cygwin_props have been invented to allow switching off the unique installation keys in the first place, supposedly for debugging. This never really was a good idea, after all we *want* the installations to be independent and there's no good reason to break that, not even for debugging purposes. Other than that, cygwin_props were meant to be used for some other global settings which never took place. There's just no good reason to tweak the DLL binary invisibly where a setting could be done in a file or the environment. This patch removes the cygwin_props entirely, including the related settings in cygcheck. cygwin: * cygprops.h: Remove file. * globals.cc (cygwin_props): Remove. * cygheap.cc (init_cygheap::init_installation_root): Drop removing installation key. utils: * cygcheck.cc: Drop including cygprops.h. Remove now unused option values. (unique_object_name_opt): Remove. (handle_unique_object_name): Remove function. (usage): Remove text for unique-object-names options. (longopts): Remove unique-object-names options. (main): Drop handling unique-object-names options. doc: * utils.xml (cygcheck): Remove text for unique-object-names options. Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
Diffstat (limited to 'winsup/doc')
-rw-r--r--winsup/doc/utils.xml58
1 files changed, 0 insertions, 58 deletions
diff --git a/winsup/doc/utils.xml b/winsup/doc/utils.xml
index a904c34fd..8c5a619b8 100644
--- a/winsup/doc/utils.xml
+++ b/winsup/doc/utils.xml
@@ -35,9 +35,6 @@ cygcheck -f FILE [FILE]...
cygcheck -l [PACKAGE]...
cygcheck -p REGEXP
cygcheck --delete-orphaned-installation-keys
-cygcheck --enable-unique-object-names Cygwin-DLL
-cygcheck --disable-unique-object-names Cygwin-DLL
-cygcheck --show-unique-object-names Cygwin-DLL
cygcheck -h
</screen>
</refsynopsisdiv>
@@ -63,15 +60,6 @@ At least one command option or a PROGRAM is required, as shown above.
Delete installation keys of old, now unused
installations from the registry. Requires the right
to change the registry.
- --enable-unique-object-names Cygwin-DLL
- --disable-unique-object-names Cygwin-DLL
- --show-unique-object-names Cygwin-DLL
- Enable, disable, or show the setting of the
- \"unique object names\" setting in the Cygwin DLL
- given as argument to this option. The DLL path must
- be given as valid Windows(!) path.
- See the users guide for more information.
- If you don't know what this means, don't change it.
-v, --verbose produce more verbose output
-h, --help annotate output with explanatory comments when given
with another command, otherwise print this help
@@ -227,52 +215,6 @@ coreutils-5.3.0-6 GNU core utilities (includes fileutils, sh-utils and t
which the installation doesn't exist anymore. To get rid of these
orphaned registry entries, use the <command>cygcheck
--delete-orphaned-installation-keys</command> command.</para>
-
- <para> Each Cygwin DLL generates a key value from its installation path.
- This value is not only stored in the registry, it's also used to generate
- global object names used for interprocess communication. This keeps
- different Cygwin installations separate. Processes running under a Cygwin
- DLL installed in C:\cygwin don't see processes running under a Cygwin DLL
- installed in C:\Program Files\cygwin. This allows running multiple
- versions of Cygwin DLLs without these versions to interfere with each
- other, or to run small third-party installations for a specific purpose
- independently from a Cygwin net distribution. </para>
-
- <para> For debugging purposes it could be desired that the various Cygwin
- DLLs use the same key, independently from their installation paths. If
- the DLLs have different versions, trying to run processes under these
- DLLs concurrently will result in error messages like this one:</para>
-
- <screen>
-*** shared version mismatch detected - 0x8A88009C/0x75BE0074.
-This problem is probably due to using incompatible versions of the Cygwin DLL.
-Search for cygwin1.dll using the Windows Start->Find/Search facility
-and delete all but the most recent version. The most recent version *should*
-reside in x:\\cygwin\\bin, where 'x' is the drive on which you have
-installed the cygwin distribution. Rebooting is also suggested if you
-are unable to find another Cygwin DLL.
-</screen>
-
- <para> To disable the usage of a unique key value of a certain Cygwin DLL,
- use the <command>cygcheck --disable-unique-object-names
- Cygwin-DLL</command> command. <literal>Cygwin-DLL</literal> is the
- Windows path (*not* a Cygwin POSIX path) to the DLL for which you want to
- disable this feature. Note that you have to stop all Cygwin processes
- running under this DLL, before you're allowed to change this setting. For
- instance, run <command>cygcheck</command> from a DOS command line for
- this purpose.</para>
-
- <para>To re-enable the usage of a unique key, use the <command>cygcheck
- --enable-unique-object-names Cygwin-DLL</command> command. This option
- has the same characteristics as the
- <literal>--disable-unique-object-names</literal> option</para>
-
- <para>Finally, you can use <command>cygcheck --show-unique-object-names
- Cygwin-DLL</command> to find out if the given Cygwin DLL use unique
- object names or not. In contrast to the <literal>--disable-...</literal>
- and <literal>--enable-...</literal> options, the
- <literal>--show-unique-object-names</literal> option also works for
- Cygwin DLLs which are currently in use.</para>
</refsect1>
</refentry>