docs: changes/ver_linux: fix entries and add several tools

Some of the entries in both Documentation/process/changes.rst and
script/ver_linux were obsolete; update them to reflect the current way of
getting version information.

Many were missing altogether; add the relevant information for:

 bash, bc, bindgen, btrfs-progs, Clang, gdb,  GNU awk, GNU tar,
 GRUB, GRUB2, gtags, iptables, kmod, mcelog, mkimage, openssl,
 pahole, Python, Rust, Sphinx, squashfs-tools

Signed-off-by: Manuel Ebner <manuelebner@mailbox.org>
[jc: rewrote changelog]
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20260325194616.78093-2-manuelebner@mailbox.org>

diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst
index f9f6f5c47882582fd13b48d098cf8e43bd8ad107..bfad07ad017678aff593955c0e0a82563e278566 100644 (file)
--- a/Documentation/process/changes.rst
+++ b/Documentation/process/changes.rst
@@ -19,12 +19,13 @@ Current Minimal Requirements
 
 Upgrade to at **least** these software revisions before thinking you've
 encountered a bug!  If you're unsure what version you're currently
-running, the suggested command should tell you.
+running, the suggested command should tell you. For a list of the programs
+on your system including their version execute ./scripts/ver_linux
 
 Again, keep in mind that this list assumes you are already functionally
 running a Linux kernel.  Also, not all tools are necessary on all
 systems; obviously, if you don't have any PC Card hardware, for example,
-you probably needn't concern yourself with pcmciautils.
+you probably do not need to concern yourself with pcmciautils.
 
 ====================== ===============  ========================================
         Program        Minimal version       Command to check the version
@@ -40,7 +41,7 @@ flex                   2.5.35           flex --version
 bison                  2.0              bison --version
 pahole                 1.22             pahole --version
 util-linux             2.10o            mount --version
-kmod                   13               depmod -V
+kmod                   13               kmod -V
 e2fsprogs              1.41.4           e2fsck -V
 jfsutils               1.1.3            fsck.jfs -V
 xfsprogs               2.6.0            xfs_db -V
@@ -51,8 +52,8 @@ quota-tools            3.09             quota -V
 PPP                    2.4.0            pppd --version
 nfs-utils              1.0.5            showmount --version
 procps                 3.2.0            ps --version
-udev                   081              udevd --version
-grub                   0.93             grub --version || grub-install --version
+udev                   081              udevadm --version
+GRUB                   0.93             grub --version || grub-install --version
 mcelog                 0.6              mcelog --version
 iptables               1.4.2            iptables -V
 openssl & libcrypto    1.0.0            openssl version
@@ -62,7 +63,8 @@ GNU tar                1.28             tar --version
 gtags (optional)       6.6.5            gtags --version
 mkimage (optional)     2017.01          mkimage --version
 Python                 3.9.x            python3 --version
-GNU AWK (optional)     5.1.0            gawk --version
+GNU awk (optional)     5.1.0            gawk --version
+gdb                    7.2              gdb --version
 ====================== ===============  ========================================
 
 .. [#f1] Sphinx is needed only to build the Kernel documentation

diff --git a/scripts/ver_linux b/scripts/ver_linux
index d6f2362d37928518a5ace37fff3d2a87138f1bb6..fab0c68a6c524e66701cd9d0ce6203bb1ccc0912 100755 (executable)
--- a/scripts/ver_linux
+++ b/scripts/ver_linux
@@ -7,7 +7,7 @@
 
 BEGIN {
        usage = "If some fields are empty or look unusual you may have an old version.\n"
-       usage = usage "Compare to the current minimal requirements in Documentation/Changes.\n"
+       usage = usage "Compare to the current minimal requirements in Documentation/process/changes.rst\n"
        print usage
 
        system("uname -a")
@@ -18,22 +18,22 @@ BEGIN {
        libcpp = "(libg|stdc)[+]+[.]so([.][0-9]+)+$"
 
        printversion("GNU C", version("gcc -dumpversion"))
-       printversion("GNU Make", version("make --version"))
-       printversion("Binutils", version("ld -v"))
-       printversion("Util-linux", version("mount --version"))
+       printversion("GNU make", version("make --version"))
+       printversion("binutils", version("ld -v"))
+       printversion("util-linux", version("mount --version"))
        printversion("Mount", version("mount --version"))
        printversion("Module-init-tools", version("depmod -V"))
-       printversion("E2fsprogs", version("tune2fs"))
-       printversion("Jfsutils", version("fsck.jfs -V"))
-       printversion("Xfsprogs", version("xfs_db -V"))
-       printversion("Pcmciautils", version("pccardctl -V"))
+       printversion("e2fsprogs", version("e2fsck -V"))
+       printversion("jfsutils", version("fsck.jfs -V"))
+       printversion("xfsprogs", version("xfs_db -V"))
+       printversion("pcmciautils", version("pccardctl -V"))
        printversion("Pcmcia-cs", version("cardmgr -V"))
-       printversion("Quota-tools", version("quota -V"))
+       printversion("quota-tools", version("quota -V"))
        printversion("PPP", version("pppd --version"))
        printversion("Isdn4k-utils", version("isdnctrl"))
-       printversion("Nfs-utils", version("showmount --version"))
-       printversion("Bison", version("bison --version"))
-       printversion("Flex", version("flex --version"))
+       printversion("nfs-utils", version("showmount --version"))
+       printversion("bison", version("bison --version"))
+       printversion("flex", version("flex --version"))
 
        while ("ldconfig -p 2>/dev/null" | getline > 0)
                if ($NF ~ libc || $NF ~ libcpp)
@@ -41,13 +41,34 @@ BEGIN {
                                printversion("Linux C" ($NF ~ libcpp? "++" : "") " Library", ver)
 
        printversion("Dynamic linker (ldd)", version("ldd --version"))
-       printversion("Procps", version("ps --version"))
+       printversion("procps", version("ps --version"))
        printversion("Net-tools", version("ifconfig --version"))
        printversion("Kbd", version("loadkeys -V"))
        printversion("Console-tools", version("loadkeys -V"))
        printversion("Sh-utils", version("expr --v"))
-       printversion("Udev", version("udevadm --version"))
+       printversion("udev", version("udevadm --version"))
        printversion("Wireless-tools", version("iwconfig --version"))
+       printversion("bash", version("bash --version"))
+       printversion("bc", version("bc --version"))
+       printversion("bindgen", version("bindgen --version"))
+       printversion("btrfs-progs", version("btrfs --version"))
+       printversion("Clang", version("clang --version"))
+       printversion("gdb", version("gdb -version"))
+       printversion("GNU awk", version("gawk --version"))
+       printversion("GNU tar", version("tar --version"))
+       printversion("GRUB", version("grub-install --version"))
+       printversion("GRUB2", version("grub2-install --version"))
+       printversion("gtags", version("gtags --version"))
+       printversion("iptables", version("iptables -V"))
+       printversion("kmod", version("kmod -V"))
+       printversion("mcelog", version("mcelog --version"))
+       printversion("mkimage", version("mkimage --version"))
+       printversion("openssl", version("openssl version"))
+       printversion("pahole", version("pahole --version"))
+       printversion("Python", version("python3 -V"))
+       printversion("Rust", version("rustc --version"))
+       printversion("Sphinx", version("sphinx-build --version"))
+       printversion("squashfs-tools", version("mksquashfs -version"))
 
        while ("sort /proc/modules" | getline > 0) {
                mods = mods sep $1