From 5ee7c5081900358e2cf95a6b183c2e3e2e57e2f6 Mon Sep 17 00:00:00 2001 From: Joshua Daniel Franklin Date: Thu, 30 Sep 2004 05:03:52 +0000 Subject: 2004-09-30 Joshua Daniel Franklin * how-programming.texinfo: Add gcj note to WinMain@16 FAQ. * how-using.texinfo: Add FAQ about network shares and authentication. * install.texinfo: Add "Where is make" to FAQ subtitle. --- winsup/doc/ChangeLog | 6 ++++++ winsup/doc/how-programming.texinfo | 13 +++++++++---- winsup/doc/how-using.texinfo | 37 +++++++++++++++++++++++-------------- winsup/doc/install.texinfo | 5 ++--- 4 files changed, 40 insertions(+), 21 deletions(-) (limited to 'winsup/doc') diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index fff29ad0f..5206bcdbd 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,9 @@ +2004-09-30 Joshua Daniel Franklin + + * how-programming.texinfo: Add gcj note to WinMain@16 FAQ. + * how-using.texinfo: Add FAQ about network shares and authentication. + * install.texinfo: Add "Where is make" to FAQ subtitle. + 2004-09-24 Corinna Vinschen * cygwinenv.sgml: smbntsec is not on by default. diff --git a/winsup/doc/how-programming.texinfo b/winsup/doc/how-programming.texinfo index 0f9fc70f8..8c548af49 100644 --- a/winsup/doc/how-programming.texinfo +++ b/winsup/doc/how-programming.texinfo @@ -78,10 +78,9 @@ MAKE_MODE to "UNIX" (actually case is not significant) or "WIN32" @subsection Why the undefined reference to @samp{WinMain@@16}? -Try adding an empty main() function to one of your sources. - -Or, perhaps you have @samp{-lm} too early in the link command line. It -should be at the end: +If you're using @samp{gcc}, try adding an empty main() function to one +of your sources. Or, perhaps you have @samp{-lm} too early in the +link command line. It should be at the end: @example bash$ gcc hello.c -lm @@ -101,6 +100,12 @@ works, but This is an artifact of libm.a being a symbolic link to libcygwin.a. +If you're using GCJ, you need to pass a "--main" flag: + +@example +gcj --main=Hello Hello.java +@end example + @subsection How do I use Win32 API calls? @strong{(Please note: This section has not yet been updated for the latest diff --git a/winsup/doc/how-using.texinfo b/winsup/doc/how-using.texinfo index 63853fb6b..9d89c265a 100644 --- a/winsup/doc/how-using.texinfo +++ b/winsup/doc/how-using.texinfo @@ -27,24 +27,33 @@ containing packages, see @subsection Why is Cygwin suddenly @emph{so} slow? -If you recently upgraded the @samp{cygwin} package and suddenly -@emph{every} command takes a @emph{very} long time, then you probably -have the obsolete @code{//c} notation in your PATH. This now means -the @emph{network share} @code{c}, which will slow things down -tremendously if it does not exist. See then next FAQ entry. - -@subsection Why doesn't //c (for C:) work anymore? - -(Similarly for any drive letter, e.g. @code{//z} for @code{Z:}) - -This ``feature'' has long been deprecated, and no longer works at all -in the latest release. As of release 1.3.3, @code{//c} now means the -@emph{network share} @code{c}. - +If you recently upgraded and suddenly @emph{every} command takes a +@emph{very} long time, then something is probably attempting to +access a network share. You may have the obsolete @code{//c} +notation in your PATH or startup files. This now means the +@emph{network share} @code{c}, which will slow things down +tremendously if it does not exist. + +Using //c (for C:) doesn't work anymore. (Similarly for any drive +letter, e.g. @code{//z} for @code{Z:}) This ``feature'' has long been +deprecated, and no longer works at all in the latest release. As of +release 1.3.3, @code{//c} now means the @emph{network share} @code{c}. For a detailed discussion of why this change was made, and how deal with it now, refer to @file{http://sources.redhat.com/ml/cygwin/2001-09/msg00014.html}. +@subsection Why can't I access my network shares with @samp{cron}, or when using pubkey authentication with @samp{ssh}? + +Some Cygwin services normally run as the SYSTEM user, which has +certain limitations. Under the Windows authentication scheme, the +SYSTEM user cannot access network shares that require authentication. +For more information, see +@file{http://cygwin.com/cygwin-ug-net/ntsec.html}. + +Workarounds include using public network share that does not require +authentication (for non-critical files), or running the service as +your own user with @samp{cygrunsrv}. + @subsection How should I set my PATH? This is done for you in the file /etc/profile, which is sourced by bash diff --git a/winsup/doc/install.texinfo b/winsup/doc/install.texinfo index fd210d18a..3884ee477 100644 --- a/winsup/doc/install.texinfo +++ b/winsup/doc/install.texinfo @@ -90,8 +90,7 @@ disk if you are paranoid. This should be safe, but only if Cygwin Setup is not substituted by something malicious, and no mirror has been compromised. -@subsection What packages should I download? - +@subsection What packages should I download? Where are 'make', 'gcc', 'vi', etc? When using Cygwin Setup for the first time, the default is to install a minimal subset of packages. If you want anything beyond that, you will have to select it explicitly. See @@ -100,7 +99,7 @@ packages. If you want to build programs, of course you'll need @samp{gcc}, @samp{binutils}, @samp{make} and probably other packages from the -``Devel'' category. +``Devel'' category. Text editors can be found under ``Editors''. @subsection How do I just get everything? -- cgit v1.2.3