[patch] update documentation Was: cygwin-host-setup does not install sshd

2005-05-17 Thread Brian Dessent
admin wrote:
> 
> Thanks so much that worked like a charm.
> 
> >"umount -A" to remove all mounts, and then delete the cygwin install
> >directory.  Rummaging around in the registry is not recommended.
> >
> 
> http://www.cygwin.com/faq/faq_2.html#SEC20 <---  when removing the two 
> registry values suggested there didnt work, i just removed anything, like i 
> do when we get malware :).  I figured that would get it.
> 
> >It sounds like you still have a sshd service installed that is
> >referencing a nonexistent path.  Type "cygrunsrv -Q sshd" to see if
> >there is such a service, and if so "cygrunsrv -R ssh" and then rerun
> >ssh-host-config.
> >
> i did, and it was, and that worked.  Some values in the registry "could not 
> be deleted"  i didnt really pay attention to which, i guess one was the 
> running ssh server.

I have to admit, the documentation could be a little more clear about
the fact that you need to remove services.  I've also often read that
people encounter problems when trying to delete the Cygwin tree because
they encounter files with permissions that don't allow the file to be
deleted (e.g. files created by SYSTEM.)

I therefore propose the following rewrite of the "How do I uninstall all
of Cygwin" entry in the FAQ.  This version is much more wordy, I admit. 
But since it seems to come up every so often I feel a little
hand-holding in the FAQ can't hurt.  Rather than saying basically to
delete the folder and the registry key and "you're on your own for the
other stuff", this gives a list of steps that should cover everything.

2005-05-17  Brian Dessent  <[EMAIL PROTECTED]>

* install.texinfo ("How do I uninstall..."): Rewrite to cover
removing services, dealing with permissions, and other common
tasks for removing Cygwin completely.Index: install.texinfo
===
RCS file: /cvs/src/src/winsup/doc/install.texinfo,v
retrieving revision 1.52
diff -u -r1.52 install.texinfo
--- install.texinfo 29 Jan 2005 22:35:17 -  1.52
+++ install.texinfo 18 May 2005 03:15:57 -
@@ -252,29 +252,60 @@
 
 @subsection How do I uninstall @strong{all} of Cygwin?
 
-Setup has no automatic uninstall facility.  Just delete everything
-manually:
+Setup has no automatic uninstall facility.  The recommended method to remove 
all 
+of Cygwin is as follows:
 
[EMAIL PROTECTED] @bullet
[EMAIL PROTECTED] Cygwin shortcuts on the Desktop and Start Menu
-
[EMAIL PROTECTED] The registry tree @samp{Software\Cygnus Solutions} under
[EMAIL PROTECTED] and/or @code{HKEY_CURRENT_USER}.
-
[EMAIL PROTECTED] Anything under the Cygwin root folder, @samp{C:\cygwin} by
-default.
[EMAIL PROTECTED]
 
[EMAIL PROTECTED] Anything created by setup in its temporary working directory.
[EMAIL PROTECTED] Remove all Cygwin services.  If a service is currently 
running, it must 
+first be stopped with @samp{cygrunsrv -E name}, where @samp{name} 
+is the name of the service.  Then use @samp{cygrunsrv -R name} to uninstall 
the 
+service from the registry.  Repeat this for all services that you installed.  
+Common services that might have been installed are @code{sshd}, @code{cron}, 
[EMAIL PROTECTED], @code{inetd}, @code{apache}, and so on.
+
[EMAIL PROTECTED] Remove all mount information with @samp{umount -A}.  If you 
want to 
+save your mount points for a later reinstall, first save the output of 
[EMAIL PROTECTED] -m} as described at 
[EMAIL PROTECTED]://cygwin.com/cygwin-ug-net/using-utils.html#mount}.
 
[EMAIL PROTECTED] itemize
[EMAIL PROTECTED] Close all Cygwin command prompts, xterms, etc. and stop the 
X11 server if 
+it is running.
 
-It's up to you to deal with other changes you made to your system, such
-as installing the inetd service, altering system paths, etc.  Setup
-would not have done any of these things for you.
[EMAIL PROTECTED] Delete the Cygwin root folder and all subfolders.  If you get 
an error 
+that an object is in use, then ensure that you've stopped all services and 
+closed all Cygwin programs.  If you get a 'Permission Denied' error then you 
+will need to modify the permissions and/or ownership of the files or folders 
+that are causing the error.  For example, sometimes files used by system 
+services end up owned by the SYSTEM account and not writable by regular users. 
 
+
+The quickest way to delete the entire tree if you run into this problem is to 
+change the ownership of all files and folders to your account.  To do this in 
+Windows Explorer, right click on the root Cygwin folder, choose Properties, 
then 
+the Security tab.  Select Advanced, then go to the Owner tab and make sure 
your 
+account is listed as the owner.  Select the 'Replace owner on subcontainers 
and 
+objects' checkbox and press Ok.  After Explorer applies the changes you should 
+be able to delete the entire tree in one operation.  Note that you can also 
+achieve this in Cygwin by typing @samp{chown -R user /} or by using other 
to

Re: [patch] update documentation Was: cygwin-host-setup does not install sshd

2005-05-18 Thread Corinna Vinschen
On May 17 20:37, Brian Dessent wrote:
> 2005-05-17  Brian Dessent  <[EMAIL PROTECTED]>

http://cygwin.com/acronyms#PCYMTNQREAIYR ;-)

I'd send ChangeLogs always without the head line.

>   * install.texinfo ("How do I uninstall..."): Rewrite to cover
>   removing services, dealing with permissions, and other common
>   tasks for removing Cygwin completely.

Sounds good to me.  It might just be better to move the point

"Close all Cygwin command prompts, xterms, etc. and stop the X11 server [...]"

one item up and then to begin the next item with

"Open a single Cygwin command promt, remove all mount information with
 @samp{umount -A} [...]"

Do you see why?


Corinna


Re: [patch] update documentation Was: cygwin-host-setup does not install sshd

2005-05-18 Thread Brian Dessent
Corinna Vinschen wrote:

> > 2005-05-17  Brian Dessent  <[EMAIL PROTECTED]>
> 
> http://cygwin.com/acronyms#PCYMTNQREAIYR ;-)

Yeah, I know.  Spammers have had my address for some time, I don't feel
like hiding.  Me  SpamAssassin.  :)

> "Close all Cygwin command prompts, xterms, etc. and stop the X11 server [...]"
> 
> one item up and then to begin the next item with
> 
> "Open a single Cygwin command promt, remove all mount information with
>  @samp{umount -A} [...]"

Ah, right.  I guess I was trying to avoid saying "close down everything"
followed by "open a command prompt and..."  I combined the two steps
into one, hopefully less confusing.

2005-05-18  Brian Dessent  <[EMAIL PROTECTED]>

* install.texinfo ("How do I uninstall..."): Rewrite to cover
removing services, dealing with permissions, and other common
tasks for removing Cygwin completely.Index: install.texinfo
===
RCS file: /cvs/src/src/winsup/doc/install.texinfo,v
retrieving revision 1.52
diff -u -r1.52 install.texinfo
--- install.texinfo 29 Jan 2005 22:35:17 -  1.52
+++ install.texinfo 18 May 2005 10:33:20 -
@@ -252,29 +252,59 @@
 
 @subsection How do I uninstall @strong{all} of Cygwin?
 
-Setup has no automatic uninstall facility.  Just delete everything
-manually:
+Setup has no automatic uninstall facility.  The recommended method to remove 
all 
+of Cygwin is as follows:
 
[EMAIL PROTECTED] @bullet
[EMAIL PROTECTED] Cygwin shortcuts on the Desktop and Start Menu
-
[EMAIL PROTECTED] The registry tree @samp{Software\Cygnus Solutions} under
[EMAIL PROTECTED] and/or @code{HKEY_CURRENT_USER}.
-
[EMAIL PROTECTED] Anything under the Cygwin root folder, @samp{C:\cygwin} by
-default.
-
[EMAIL PROTECTED] Anything created by setup in its temporary working directory.
[EMAIL PROTECTED]
 
[EMAIL PROTECTED] itemize
[EMAIL PROTECTED] Remove all Cygwin services.  If a service is currently 
running, it must 
+first be stopped with @samp{cygrunsrv -E name}, where @samp{name} 
+is the name of the service.  Then use @samp{cygrunsrv -R name} to uninstall 
the 
+service from the registry.  Repeat this for all services that you installed.  
+Common services that might have been installed are @code{sshd}, @code{cron}, 
[EMAIL PROTECTED], @code{inetd}, @code{apache}, and so on.
+
[EMAIL PROTECTED] Stop the X11 server if it is running, and terminate any 
Cygwin programs 
+that might be running in the background.  Remove all mount information by 
typing 
[EMAIL PROTECTED] -A} and then exit the command prompt and ensure that no 
Cygwin 
+processes remain.  Note: If you want to save your mount points for a later 
+reinstall, first save the output of @samp{mount -m} as described at 
[EMAIL PROTECTED]://cygwin.com/cygwin-ug-net/using-utils.html#mount}.
 
-It's up to you to deal with other changes you made to your system, such
-as installing the inetd service, altering system paths, etc.  Setup
-would not have done any of these things for you.
[EMAIL PROTECTED] Delete the Cygwin root folder and all subfolders.  If you get 
an error 
+that an object is in use, then ensure that you've stopped all services and 
+closed all Cygwin programs.  If you get a 'Permission Denied' error then you 
+will need to modify the permissions and/or ownership of the files or folders 
+that are causing the error.  For example, sometimes files used by system 
+services end up owned by the SYSTEM account and not writable by regular users. 
 
+
+The quickest way to delete the entire tree if you run into this problem is to 
+change the ownership of all files and folders to your account.  To do this in 
+Windows Explorer, right click on the root Cygwin folder, choose Properties, 
then 
+the Security tab.  Select Advanced, then go to the Owner tab and make sure 
your 
+account is listed as the owner.  Select the 'Replace owner on subcontainers 
and 
+objects' checkbox and press Ok.  After Explorer applies the changes you should 
+be able to delete the entire tree in one operation.  Note that you can also 
+achieve this in Cygwin by typing @samp{chown -R user /} or by using other 
tools 
+such as CACLS.EXE.
+
[EMAIL PROTECTED] Delete the Cygwin shortcuts on the Desktop and Start Menu, 
and anything 
+left by setup.exe in the download directory.  However, if you plan to 
reinstall 
+Cygwin it's a good idea to keep your setup.exe download directory since you 
can 
+reinstall the packages left in its cache without redownloading them.
+
[EMAIL PROTECTED] If you added Cygwin to your system path, you should remove it 
unless you 
+plan to reinstall Cygwin to the same location.  Similarly, if you set your 
+CYGWIN environment variable system-wide and don't plan to reinstall, you 
should 
+remove it.
+
[EMAIL PROTECTED] Finally, if you want to be thorough you can delete the 
registry tree 
[EMAIL PROTECTED] Solutions} under @code{HKEY_LOCAL_MACHINE} and/or 
[EMAIL PROTECTED]  However, if you followed 

Re: [patch] update documentation Was: cygwin-host-setup does not install sshd

2005-05-18 Thread Corinna Vinschen
On May 18 03:37, Brian Dessent wrote:
>   * install.texinfo ("How do I uninstall..."): Rewrite to cover
>   removing services, dealing with permissions, and other common
>   tasks for removing Cygwin completely.

Looks good.  Please check in.


Thanks,
Corinna

-- 
Corinna Vinschen  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader  mailto:cygwin@cygwin.com
Red Hat, Inc.


Re: [patch] update documentation Was: cygwin-host-setup does not install sshd

2005-05-18 Thread Brian Dessent
Corinna Vinschen wrote:

> Looks good.  Please check in.

Alright.  I am not sure how to push out the new version to the web site,
so someone else will have to do that (or tell me what to do - check in
the .html files into the website CVS or something?)

Brian


Re: [patch] update documentation Was: cygwin-host-setup does not install sshd

2005-05-18 Thread Corinna Vinschen
On May 18 04:59, Brian Dessent wrote:
> Corinna Vinschen wrote:
> 
> > Looks good.  Please check in.
> 
> Alright.  I am not sure how to push out the new version to the web site,
> so someone else will have to do that (or tell me what to do - check in
> the .html files into the website CVS or something?)

Yep.  cvs -d :ext:cygwin.com:/cvs/cygwin co htdocs


Corinna

-- 
Corinna Vinschen  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader  mailto:cygwin@cygwin.com
Red Hat, Inc.


Re: [patch] update documentation Was: cygwin-host-setup does not install sshd

2005-05-18 Thread Brian Dessent
Corinna Vinschen wrote:

> > Alright.  I am not sure how to push out the new version to the web site,
> > so someone else will have to do that (or tell me what to do - check in
> > the .html files into the website CVS or something?)
> 
> Yep.  cvs -d :ext:cygwin.com:/cvs/cygwin co htdocs

Got it, thanks.

Brian