delorie.com/archives/browse.cgi   search  
Mail Archives: cygwin/2020/07/02/11:34:51

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: <CAH8yC8noPqzyKHyNVhfnsPB5umhMj0wDiAvz1Jur_7s9LCe7xg AT mail DOT gmail DOT com>
<f6c689bd-d40a-de0f-5c46-14053f0b1eef AT SystematicSw DOT ab DOT ca>
From: Norton Allen <allen AT huarp DOT harvard DOT edu>
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: <f6c689bd-d40a-de0f-5c46-14053f0b1eef@SystematicSw.ab.ca>
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
List-Id: General Cygwin discussions and problem reports <cygwin.cygwin.com>
List-Unsubscribe: <http://cygwin.com/mailman/options/cygwin>,
<mailto:cygwin-request AT cygwin DOT com?subject=unsubscribe>
List-Archive: <https://cygwin.com/pipermail/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-request AT cygwin DOT com?subject=help>
List-Subscribe: <http://cygwin.com/mailman/listinfo/cygwin>,
<mailto:cygwin-request AT cygwin DOT com?subject=subscribe>
Errors-To: cygwin-bounces AT cygwin DOT com
Sender: "Cygwin" <cygwin-bounces AT cygwin DOT com>

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: <http://www.gnu.org/software/coreutils/>
> Full documentation at: <http://www.gnu.org/software/coreutils/uname>
> 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

- Raw text -


  webmaster     delorie software   privacy  
  Copyright © 2019   by DJ Delorie     Updated Jul 2019