diff options
author | Corinna Vinschen <corinna@vinschen.de> | 2016-03-19 13:21:18 +0100 |
---|---|---|
committer | Corinna Vinschen <corinna@vinschen.de> | 2016-03-19 13:21:18 +0100 |
commit | e42f66d00f450a643e1920aa28037188aa1f2f7c (patch) | |
tree | aac991408054a988bafae7864a1744546852255c /winsup/doc | |
parent | d17977ccc70278101b605da51b6e96f8b3c9e44b (diff) | |
download | cygnal-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.xml | 58 |
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> |