JehanneOS/newlib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Remove ill-advised cygwin_props

Browse Source 
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>
This commit is contained in:
Corinna Vinschen
2016-03-19 13:21:18 +01:00
parent d17977ccc7
commit e42f66d00f
5 changed files with 1 additions and 215 deletions
Download Patch File Download Diff File Expand all files Collapse all files

58
winsup/doc/utils.xml
View File

@ -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>