cygcheck

The cygcheck program is a diagnostic utility that examines your system and reports the information that is significant to the proper operation of cygwin programs. It can give information about a specific program (or program) you are trying to run, general system information, or both. If you list one or more programs on the command line, it will diagnose the runtime environment of that program or programs. If you specify the -s option, it will give general system information. If you specify -s and list one or more programs on the command line, it reports on both specified programs.

The cygcheck program should be used to send information about your system to Cygnus for troubleshooting (if your support representative requests it). When asked to run this command, include all the options plus any commands with which you are having trouble, saving the output so that you can mail it to Cygnus. Use the following declaration at the C:\Cygnus> prompt.

The -v option causes the output to be more verbose. What this means is that additional information will be reported which is usually not interesting, such as the internal version numbers of DLLs, additional information about recursive DLL usage, and if a file in one directory in the PATH also occurs in other directories on the PATH.

The -r option causes cygcheck to search your registry for information that is relevent to Cygnus programs. These registry entries are the ones that have “Cygnus” in the name. If you are concerned about privacy, you may remove information from this report, keeping in mind that doing so makes it harder for Cygnus to diagnose the problem.

The -h option prints additional helpful messages in the report, at the beginning of each section. It also adds table column headings. While this is useful information, it also adds significantly to the size of the report; if you want a compact report or if you know what everything is already, don’t use this option.