From 7a582da59905eeab32366cc741e51b1da567fa7a Mon Sep 17 00:00:00 2001 From: Joshua Daniel Franklin Date: Sat, 27 Aug 2005 01:32:36 +0000 Subject: [PATCH] 2005-08-26 Joshua Daniel Franklin * Makefile.in: Remove extra anchor to make NN4 happy. * faq.xml: Link to cygwin.com/license.html * faq-resources.xml: Link instead of duplicating info. * faq-using.xml: Split out services and network shares FAQ. * faq-what.xml: Link to cygwin.com/license.html --- winsup/doc/ChangeLog | 8 +++ winsup/doc/Makefile.in | 2 + winsup/doc/faq-resources.xml | 108 ++--------------------------------- winsup/doc/faq-using.xml | 15 +++-- winsup/doc/faq-what.xml | 4 +- winsup/doc/faq.xml | 2 +- 6 files changed, 28 insertions(+), 111 deletions(-) diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index d87b4a6d2..eea5ceb6d 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,11 @@ +2005-08-26 Joshua Daniel Franklin + + * Makefile.in: Remove extra anchor to make NN4 happy. + * faq.xml: Link to cygwin.com/license.html + * faq-resources.xml: Link instead of duplicating info. + * faq-using.xml: Split out services and network shares FAQ. + * faq-what.xml: Link to cygwin.com/license.html + 2005-08-17 Christopher Faylor * textbinary.sgml: Correct incorrect information about ability to diff --git a/winsup/doc/Makefile.in b/winsup/doc/Makefile.in index 5313ed965..4ecc82ac7 100644 --- a/winsup/doc/Makefile.in +++ b/winsup/doc/Makefile.in @@ -68,9 +68,11 @@ cygwin-api.sgml : cygwin-api.in.sgml ./doctool Makefile faq/faq.html : -xmlto html -o faq -m $(srcdir)/cygwin.dsl $(srcdir)/faq-sections.xml + -sed -i 's;;;g' faq/faq.*.html faq/faq-nochunks.html : -xmlto html -o faq -m $(srcdir)/cygwin.dsl $(srcdir)/faq.xml + -sed -i 's;;;g' faq/faq-nochunks.html ./doctool : doctool.c gcc -g $< -o $@ diff --git a/winsup/doc/faq-resources.xml b/winsup/doc/faq-resources.xml index 29ffb5ff4..9bf42f722 100644 --- a/winsup/doc/faq-resources.xml +++ b/winsup/doc/faq-resources.xml @@ -37,115 +37,15 @@ for a list of them.) What Cygwin mailing lists can I join? - Comprehensive information about the Cygwin mailing lists can be found at -http://cygwin.com/lists.html. - -To subscribe to the main list, send a message to -cygwin-subscribe@cygwin.com. To unsubscribe from the -main list, send a message to cygwin-unsubscribe@cygwin.com. -In both cases, the subject and body of the message are ignored. - -Similarly, to subscribe to the Cygwin announcements list, send a message -to cygwin-announce-subscribe@cygwin.com. To unsubscribe, -send a message to cygwin-announce-unsubscribe@cygwin.com. - -If you want to contribe to Cygwin tools & applications, rather than -the library itself, then you should subscribe to cygwin-apps. There -is also a low-volume list called cygwin-developers which is reserved -for knowledgeable people who regularly contribute to the Cygwin DLL. -Please do not ask for read-only access to this mailing list. Both -cygwin-developers and cygwin-apps are by-approval lists. The same -mechanism as described for the first two lists works for these as -well. - -There is a searchable archive of the main mailing list at -http://cygwin.com/ml/cygwin/. There is an alternate -archive, also searchable, at http://www.delorie.com/archives/. -You can also search at http://www.google.com/ and include -"cygwin" in the list of search terms. - -Cygwin mailing lists are not gatewayed to USENET, so anti-spam measures -in your email address are neither required nor appreciated. Also, avoid -sending HTML content to Cygwin mailing lists. +. - -Posting Guidelines (Or: Why won't you/the mailing list answer my questions?) + +What if I have a problem? (Or: Why won't you/the mailing list answer my questions?) - -If you follow these guidelines, you are much more likely to get a -helpful response from the Cygwin developers and/or the Cygwin community at -large: - -Read the User's Guide and the FAQ first. - -Check the mailing list archives. Your topic may have come up -before. (It may even have been answered!) Use the search facilities -at the links above. Try the alternate site if the main archive is not -producing search results. - -Explain your problem carefully and completely. "I installed Blah -and it doesn't work!" wastes everybody's time. It provides no -information for anyone to help you with your problem. You should -provide: - -A problem statement: How does it behave, how do you think it -should behave, and what makes you think it's broken? (Oh yeah, and what -is "it"?) - -Information about your Windows OS ("Win95 OSR2" or "NT4/SP3" or -"Win2K" or "Win98 SE" or ...). - -Details about your installation process, or attempts at same. (Internet or -Directory install? If the former, exactly when and from what mirror? -If the latter, which packages did you download? Which version of -setup.exe? Any subsequent updates?) - -Details about your Cygwin setup, accomplished by attaching -the output of 'cygcheck -s -v -r' to your message. (Do not paste the -output into your message.) - -A valid return address, so that a reply doesn't require manual editing of -the 'To:' header. - - - - -Your message must be relevant to the list. Messages that are -not directly related to Cygwin are considered off-topic and are -unwelcome. For example, the following are off-topic: - -General programming language questions - -General Windows programming questions - -General UNIX shell programming questions - -General application usage questions - -How to make millions by working at home - -Announcements from LaserJet toner cartridge suppliers - - - - -Read and obey ``How To Ask Questions The Smart Way'' by Eric -S. Raymond, at http://www.catb.org/~esr/faqs/smart-questions.html. - - - - -If you do not follow the above guidelines, you may still elicit a -response, but you may not appreciate it! - -For inquiries about support contracts and commercial licensing, visit -http://www.redhat.com/software/cygwin/. - -Beyond that, perhaps nobody has time to answer your question. Perhaps -nobody knows the answer. +Comprehensive information about reporting problems with Cygwin can be found at . diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml index ce66c9de2..2629dbe8b 100644 --- a/winsup/doc/faq-using.xml +++ b/winsup/doc/faq-using.xml @@ -50,7 +50,7 @@ with it now, refer to -Why don't my services work (or access network shares)? +Why don't my services work? Most Windows services run as a special user called SYSTEM. If you @@ -62,10 +62,17 @@ select "Install for All Users", or this script will do the trick: eval "`mount -m | sed -e 's/ -u / -s /g' -e 's/$/;/'`" + -The SYSTEM user cannot access network shares that require -authentication. For more information, see -http://cygwin.com/cygwin-ug-net/ntsec.html. + +Why can't my services access network shares? + + +When a service switches to a certain user, it is running as +SYSTEM impersonating the user account. During +impersonation, the user's password is not available and so non-public +network shares are not available. For more information, see +. Workarounds include using public network share that does not require authentication (for non-critical files), or running the service as diff --git a/winsup/doc/faq-what.xml b/winsup/doc/faq-what.xml index fb6c41ac3..8ff468530 100644 --- a/winsup/doc/faq-what.xml +++ b/winsup/doc/faq-what.xml @@ -28,7 +28,7 @@ standard Windows command shell. Wait a minute... Cygwin is only supported if you are paying for it, such as through a support contract with Red Hat. For information about getting a Red Hat support contract, see -http://www.redhat.com/software/tools/cygwin/. +. That said, Cygwin can be expected to run on all modern 32 bit versions of Windows, except Windows CE. This includes Windows 95/98/ME/NT/2000/XP. @@ -70,7 +70,7 @@ how the GNU General Public License may affect your use of these tools. In particular, if you intend to port a proprietary (non-GPL'd) application using Cygwin, you will need the proprietary-use license for the Cygwin library. This is available for purchase; please visit -http://www.redhat.com/software/tools/cygwin/ for more information. + for more information. All other questions should be sent to the project mailing list cygwin@cygwin.com. diff --git a/winsup/doc/faq.xml b/winsup/doc/faq.xml index 58dfbd5d8..8e2db662b 100644 --- a/winsup/doc/faq.xml +++ b/winsup/doc/faq.xml @@ -85,7 +85,7 @@ with source code available to all. Cygwin is currently available for proprietary use only through a proprietary-use license. Please see -http://www.redhat.com/software/cygwin/ for more information + for more information about the Red Hat Cygwin Product. In accordance with section 10 of the GPL, Red Hat, Inc. permits