X-Recipient: archive-cygwin AT delorie DOT com X-Original-To: cygwin AT cygwin DOT com Delivered-To: cygwin AT cygwin DOT com DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org C26A53858D34 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=huarp.harvard.edu Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=allen AT huarp DOT harvard DOT edu Subject: Re: How to check cygwin version? To: cygwin AT cygwin DOT com References:

From: Norton Allen Message-ID: <0c35113f-7b72-56d0-a032-b0cfa045f7ee@huarp.harvard.edu> Date: Thu, 2 Jul 2020 11:34:11 -0400 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 MIME-Version: 1.0 In-Reply-To: Content-Language: en-US X-Spam-Status: No, score=-4.8 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, KAM_SHORT, RCVD_IN_DNSWL_LOW, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: cygwin AT cygwin DOT com X-Mailman-Version: 2.1.29 Precedence: list List-Id: General Cygwin discussions and problem reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="us-ascii"; Format="flowed" Errors-To: cygwin-bounces AT cygwin DOT com Sender: "Cygwin" On 7/2/2020 1:20 AM, Brian Inglis wrote: > On 2020-07-01 07:36, Jeffrey Walton via Cygwin wrote: >> I think the documentation leaves a lot to be desired... I'm trying to >> tell someone what version of Cygwin I am using. >> >> There's a FAQ item at >> https://cygwin.com/faq/faq.html#faq.what.version. It gives this >> useless advice: >> >> To find the version of the Cygwin DLL installed, you can use uname >> as on Linux or cygcheck. Refer to each command's --help output and >> the Cygwin User's Guide for more information. >> >> OK, let's try it: >> >> $ cygcheck -v >> Usage: cygcheck [-v] [-h] PROGRAM >> cygcheck -c [-d] [PACKAGE] >> cygcheck -s [-r] [-v] [-h] >> cygcheck -k >> ... >> >> OK, -v is what we need: >> >> $ cygcheck -v cygwin >> cygcheck: could not find 'cygwin' >> >> OK, another failure. >> >> RTFM does not work. Why the hell don't you just state how to check the >> god damn version? > Do you think it would help if this FAQ entry were changed to read: > > 1.5. What version of Cygwin is this, anyway? > To find the version of the Cygwin DLL installed, you can use any of the > Cygwin commands uname -a, uname -srvm, head /proc/version as on Linux, or > cygcheck -V. Refer to each command's --help output or the Cygwin User's Guide > for more information. > > and please make any further comments, feedback, or suggestions you think would > help with this entry. > > Running the suggested commands with their --help options would have shown you: > > $ uname --help > Usage: uname [OPTION]... > Print certain system information. With no OPTION, same as -s. > > -a, --all print all information, in the following order, > except omit -p and -i if unknown: > -s, --kernel-name print the kernel name > -n, --nodename print the network node hostname > -r, --kernel-release print the kernel release > -v, --kernel-version print the kernel version > -m, --machine print the machine hardware name > -p, --processor print the processor type (non-portable) > -i, --hardware-platform print the hardware platform (non-portable) > -o, --operating-system print the operating system > --help display this help and exit > --version output version information and exit > > GNU coreutils online help: > Full documentation at: > or available locally via: info '(coreutils) uname invocation' > > $ cygcheck --help > Usage: cygcheck [-v] [-h] PROGRAM > cygcheck -c [-d] [PACKAGE] > cygcheck -s [-r] [-v] [-h] > cygcheck -k > cygcheck -f FILE [FILE]... > cygcheck -l [PACKAGE]... > cygcheck -p REGEXP > cygcheck --delete-orphaned-installation-keys > cygcheck -h > > List system information, check installed packages, or query package database. > > At least one command option or a PROGRAM is required, as shown above. > > PROGRAM list library (DLL) dependencies of PROGRAM > -c, --check-setup show installed version of PACKAGE and verify integrity > (or for all installed packages if none specified) > -d, --dump-only just list packages, do not verify (with -c) > -s, --sysinfo produce diagnostic system information (implies -c) > -r, --registry also scan registry for Cygwin settings (with -s) > -k, --keycheck perform a keyboard check session (must be run from a > plain console only, not from a pty/rxvt/xterm) > -f, --find-package find the package to which FILE belongs > -l, --list-package list contents of PACKAGE (or all packages if none given) > -p, --package-query search for REGEXP in the entire cygwin.com package > repository (requires internet connectivity) > --delete-orphaned-installation-keys > Delete installation keys of old, now unused > installations from the registry. Requires the right > to change the registry. > -v, --verbose produce more verbose output > -h, --help annotate output with explanatory comments when given > with another command, otherwise print this help > -V, --version print the version of cygcheck and exit > > Note: -c, -f, and -l only report on packages that are currently installed. To > search all official Cygwin packages use -p instead. The -p REGEXP matches > package names, descriptions, and names of files/paths within all packages. > I think what is missing in all these suggestions is a clear statement that for Cygwin's purposes, the cygwin DLL is considered to be the 'kernel', so looking for the 'kernel release' gives you the DLL version. I think that leap is totally non-obvious. -- Problem reports: https://cygwin.com/problems.html FAQ: https://cygwin.com/faq/ Documentation: https://cygwin.com/docs.html Unsubscribe info: https://cygwin.com/ml/#unsubscribe-simple