diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml index b6b152e4e..498315896 100644 --- a/winsup/doc/faq-using.xml +++ b/winsup/doc/faq-using.xml @@ -1419,4 +1419,65 @@ such as virtual memory paging and file caching. difficult to make fork() work reliably. + + + How do I fix find_fast_cwd warnings? + + Older Cygwin releases asked users to report problems to the mailing + list with the message: + + find_fast_cwd: WARNING: Couldn't compute FAST_CWD pointer. Please report + this problem to the public mailing list + + cygwin@cygwin.com + + Recent Cygwin releases changed this to the message: + + This typically occurs if you're using an older Cygwin version on a newer Windows. + Please update to the latest available Cygwin version from + + https://cygwin.com/. + If the problem persists, please see + + https://cygwin.com/problems.html. + + This happens when the Cygwin release you installed can not find out + how to get your current directory from the Windows release you are + using. + Unfortunately some projects and products still distribute older + Cygwin releases which do not support newer Windows releases, instead of + installing the current release from the Cygwin project. + They also may not provide any obvious way to keep the Cygwin packages + their application uses up to date with fixes for security issues and + upgrades. + The fix is simply downloading and running Cygwin Setup, following the + instructions in the Internet Setup section of + + Setting Up Cygwin in the Cygwin User's Guide. + When running Setup, you should not change most of the values + presented, just select the Next button in most + cases, as you already have a Cygwin release installed and only want to + upgrade your current installation. + You should make your own selection if the internet connection to your + system requires a proxy; and you must always pick an up to date Cygwin + download (mirror) site, preferably the site nearest to your system for + faster downloads, as shown with more details to help you choose on the + + Mirror Sites web page. + Cygwin Setup will download and apply updates to all packages required + for Cygwin itself and installed applications. + Any problems with applying updates, or the application after updates, + should be reported to the project or product vendor for follow up + action. + As Cygwin is a volunteer project, and we can not provide support for + older releases installed by projects or products, but would like to be + able to follow up to reduce reports of these issues if possible, it + would be helpful if you would send us a quick + + email to let us know where you obtained the application + which installed the older Cygwin release: whether it was purchased from + a vendor or a project downloaded from the Internet, any related web + pages, or other details you may have readily available. + +