Add Debian 13 packaging for g15stats

2026-09-07 16:13:47 +03:00
20 changed files with 422 additions and 0 deletions
@@ -0,0 +1,53 @@
 Debian packaging import and fork provenance
 ==========================================
 Imported on 2026-09-07 from the official Debian archive:
 https://archive.debian.org/debian/pool/main/g/g15stats/
 SHA-256 (filenames relative to that URL):
 79289e9f182e086dc5bfe0b1b594fedc36ad7610ee1daec19b05d44c4494d3fa  g15stats_1.9.2-2.dsc
 ce724380069ee62563f2898b1bbd0afb80bb632cb6dbf3d1747871f7cdfefbb3  g15stats_1.9.2-2.diff.gz
 9dda49a3f09e66ce738ceecb07f2c0fef7ecd5ecbd06e435b340dfca35a37da4  g15stats_1.9.2.orig.tar.gz
 The diff (2316 bytes) and orig tarball (25190 bytes) match the SHA-256
 checksums in the downloaded .dsc. The .dsc's own checksum was computed
 locally. The byte-exact .dsc and diff are retained in debian/provenance/;
 the diff preserves ALL original debian files, the manual and linker fix.
 The tarball can be downloaded from the URL above and verified independently.
 Checksum matching alone does not authenticate the uploader's PGP signature.
 Verification was attempted with Debian 13's debian-keyring,
 debian-maintainers and debian-nonupload keyrings: gpgv reported
 "No public key" for DSA key F9935424B1DF9A57 (signature dated 2011-03-15).
 No successful signature verification is claimed here.
 Archive package: g15stats 1.9.2-2, source format 1.0, maintained by
 Giacomo Catenazzi <cate@debian.org>. Original Debian packaging copyright:
 2008 Giacomo A. Catenazzi, GPL-2-or-later. All three historical changelog
 entries remain unchanged. The archive adds g15stats.1 outside debian/;
 it is now debian/g15stats.1, extended for the fork, retaining Mike Lampard's
 author credit. The archive's only upstream source patch adds -lpthread -lm
 to Makefile.am, credited to Bhavani Shankar in the changelog (#554382).
 Both libraries already appear in the fork: do not apply that patch twice.
 All nine archived debian files were imported. control, rules, docs, install,
 manpages, watch and copyright were adapted; changelog was prepended;
 compat was raised from 5 to 13, with Build-Depends: debhelper (>= 13~).
 Obsolete CDBS cleanup and SourceForge watching were replaced, not omitted
 without a record. No archived quilt series existed.
 Upstream snapshot (unmodified tracked files in the orig archive):
 Menelkir master 95de11a526346b3d9fd33df051b330c36b1c8a16
 Commit date: 2024-06-09; subject: Update README.rst
 Upstream: https://gitlab.com/menelkir/g15stats
 Local fork origin: https://gt.uo1.net/mikhail/g15stats
 Version rationale: git describe gives 3.0.3-13-g95de11a and the tracked
 Arch PKGBUILD declares 3.0.3. configure.ac instead has stale AC_INIT=3.0
 and VERSION=3.0.1, including at tag 3.0.3. Therefore this package is
 3.0.3+git20240609.95de11a-1~local1, NOT Debian's old 1.9.2 nor a new
 upstream release. The quilt patch aligns the embedded version and modernizes
 only the build system. Runtime engine files remain untouched.
 The new changelog/patch identity is the configured local Git user,
 Mikhail Yevchenko <m.ṥῥẚɱ.ѓѐḿởύḙ@uo1.net>; it does not impersonate
 the historical Debian maintainer or claim upstream authorship.
@@ -0,0 +1,52 @@
 g15stats for Debian 13 (local fork package)
 =========================================
 This packaging targets Linux and debhelper compatibility 13. See PROVENANCE
 for the complete Debian 1.9.2-2 import, licensing and snapshot version choice.
 All upstream modifications are in debian/patches; do not build in the checkout
 when you want it to remain pristine.
 Clean source preparation (outside the checkout)
 ----------------------------------------------
 Export ONLY tracked upstream files at commit
 95de11a526346b3d9fd33df051b330c36b1c8a16 using git archive, with directory
 prefix g15stats-3.0.3+git20240609.95de11a/. Compress with xz to produce
 g15stats_3.0.3+git20240609.95de11a.orig.tar.xz. Extract in a temporary build
 directory, then copy this debian/ directory into it. Never tar the working
 checkout: .git, quilt state and untracked build outputs must not be included.
 In a disposable Debian 13 container, install build-essential, debhelper,
 autoconf, automake, libtool, pkgconf, libgtop2-dev, libg15-dev,
 libg15render-dev and libg15daemon-client-dev (apt-get build-dep on the staged
 source directory also resolves Build-Depends). Install lintian for QA.
 If the already-built local G15 libraries are available, install their runtime
 and development .deb files instead of the distro G15 libraries. Keep libgtop
 and other dependencies from Debian 13. Do not install packages on the host.
 Run dpkg-buildpackage -S -us -uc in the staged source directory. In another
 empty directory/container, extract the resulting .dsc with dpkg-source -x,
 then run dpkg-buildpackage -b -us -uc. Source packages here are unsigned;
 dpkg-source --no-check is appropriate only after independently checking the
 locally produced source artifact checksums. Lint both source and binary
 .changes with lintian --fail-on error. Keep logs and all artifacts outside
 the checkout. A second independent extraction/build checks rebuildability;
 bit-for-bit reproducibility is a separate claim requiring comparison.
 Safe smoke test
 ---------------
 Install the resulting binary in a disposable container with no USB mappings,
 no host networking and no privileged mode. Suppress service startup using
 policy-rc.d before installing g15daemon. Run debian/tests/help, which compares
 timeout-bounded --help and -h output. These exit before any daemon connection,
 sensor access or keyboard thread. Do not invoke the normal client or -d.
 The same test is declared as a superficial autopkgtest.
 Scope and limitations
 ---------------------
 No service/init, udev rule, keyboard macro or automatic startup is shipped.
 The existing runtime code has not been safety-certified or rewritten: legacy
 sensor paths, argument parsing, array bounds, string handling and threading
 need separate runtime review. Build/CLI tests do not validate hardware, LCD
 rendering, live daemon interaction, battery support or other architectures.
 Use --info-rotate, not the incorrectly documented short form -ir; see the
 manual for the existing parser discrepancy.
@@ -0,0 +1,36 @@
 g15stats (3.0.3+git20240609.95de11a-1~local1) UNRELEASED; urgency=medium
  * Import Debian 1.9.2-2 packaging and manual, retaining its changelog,
    attribution and checksum-recorded archive provenance.
  * Package Menelkir master 95de11a526346b3d9fd33df051b330c36b1c8a16,
    a post-3.0.3 snapshot, rather than mislabelling this fork as 1.9.2.
  * Use debhelper compat 13, 3.0 (quilt), direct build dependencies,
    rootless builds and all Debian hardening flags on Debian 13.
  * Quilt build fixes preserve compiler flags, link libgtop correctly,
    remove the bare include flag and align the embedded snapshot version.
  * Extend the archived manual and add isolated CLI smoke tests.
    Do not install init scripts or automatically start the client.
 -- Mikhail Yevchenko <m.ṥῥẚɱ.ѓѐḿởύḙ@uo1.net>  Mon, 07 Sep 2026 15:47:05 +0300
 g15stats (1.9.2-2) unstable; urgency=low
  * Supports binutils-gold linker, writing explicitly our library
    dependencies. Patch from Bhavani Shankar (Closes: #554382). 
 -- Giacomo Catenazzi <cate@debian.org>  Tue, 15 Mar 2011 08:04:59 +0100
 g15stats (1.9.2-1) unstable; urgency=low
  * New upstream version (Closes: #530548).
  * Add support for automake and autoconf
 -- Giacomo Catenazzi <cate@debian.org>  Tue, 04 Aug 2009 13:15:38 +0200
 g15stats (1.0-1) unstable; urgency=low
  * Initial release. (Closes: #439792).
 -- Giacomo Catenazzi <cate@debian.org>  Tue, 18 Mar 2008 08:09:06 +0100
@@ -0,0 +1 @@
 13
@@ -0,0 +1,38 @@
 Source: g15stats
 Section: utils
 Priority: optional
 Maintainer: Mikhail Yevchenko <m.ṥῥẚɱ.ѓѐḿởύḙ@uo1.net>
 Build-Depends: debhelper (>= 13~),
 autoconf,
 automake,
 libg15-dev,
 libg15daemon-client-dev,
 libg15render-dev,
 libgtop2-dev,
 libtool,
 pkgconf
 Standards-Version: 4.7.2
 Rules-Requires-Root: no
 Homepage: https://gitlab.com/menelkir/g15stats
 Package: g15stats
 Architecture: linux-any
 Depends: g15daemon, ${shlibs:Depends}, ${misc:Depends}
 Description: system statistics display client for G15Daemon
 Displays system statistics on the LCD of supported Logitech keyboards
 through g15daemon.
 .
 CPU Screen displays graphs of User/System/Nice and Idle time, along with
 LoadAVG and Uptime.
 .
 Memory Screen displays Memory Total & Free, and graph of Used vs
 Buffered+Cached Memory.
 .
 Swap Screen displays Used, Free and Total swap space, along with the number
 of pages currently paged in/out.
 .
 Network Screen displays Total bytes In/Out, history graph, Peak speed.
 .
 Additional screens show CPU frequency, battery charge, temperature and
 fan speed where supported by the system's sensors.
@@ -0,0 +1,40 @@
 This package was debianized by Giacomo A. Catenazzi <cate@debian.org> on
 Sat, 15 Sep 2007 08:32:51 +0200.
 It was downloaded from http://g15daemon.sourceforge.net/
 Upstream Authors (also see AUTHORS):
    Mike Lampard <mlampard@users.sourceforge.net>
    Antonio Bartolini <robynhub@gmail.com>
    Piotr Czarnecki <czarnyckm@users.sf.net>
    Daniel Menelkir <dmenelkir@gmail.com>
 Copyright: 
    Copyright (c) 2006-2007 Mike Lampard
    Copyright (c) 2008-2010 Mike Lampard (g15stats.c)
 License:
    g15daemon is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
    g15daemon is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
 License can be found in the file `/usr/share/common-licenses/GPL-2'.
 The Debian packaging is (C) 2008, Giacomo A. Catenazzi <cate@debian.org> and
 is licensed under the GPL v2 (or later), see `/usr/share/common-licenses/GPL-2'.
 Local packaging additions are Copyright (c) 2026 Mikhail Yevchenko
 <m.ṥῥẚɱ.ѓѐḿởύḙ@uo1.net>, licensed under GPL v2 or later.
 The imported manual names Mike Lampard as author; its Debian archive origin
 and subsequent local updates are documented in debian/PROVENANCE.
 The original Debian diff, including the original copyright notice, is retained
 unchanged in debian/provenance/. No authorship of the fork is claimed here.
@@ -0,0 +1,4 @@
 README
 AUTHORS
 debian/README.Debian
 debian/PROVENANCE
@@ -0,0 +1,87 @@
 .\" Imported from Debian 1.9.2-2; see debian/PROVENANCE for attribution.
 .TH "g15stats" "1" "7 September 2026" "G15Daemon - g15stats" "G15Daemon User Manual"
 .SH "NAME"
 g15stats \- system statistics display client for G15Daemon
 .SH "SYNOPSIS"
 .B g15stats
 .RI [ options ]
 .SH "DESCRIPTION"
 The program provides usage meters for the LCD on
 supported Logitech keyboards, using g15daemon:
 .PP
 CPU Screen displays graphs of User/System/Nice and Idle time, along with
 LoadAVG and Uptime.
 .PP
 Memory Screen displays Memory Total & Free, and graph of Used vs
 Buffered+Cached Memory.
 .PP
 Swap Screen displays Used, Free and Total swap space, along with the number
 of pages currently paged in/out.
 .PP
 Network Screen displays Total bytes In/Out, history graph, Peak speed.
 .PP
 The summary, CPU frequency, battery, temperature and fan screens display
 additional statistics where the relevant system sensors are available.
 .SH "OPTIONS"
 g15stats understands the following options:
 .br
 .P
 .HP
 \-h,--help          show usage information.
 .P
 .HP
 \-d,--daemon        run in background.
 .P
 .HP
 \-i,--interface [interface]  monitor network interface [interface] ie -i eth0.
 .P
 .HP
 \-nsa,--net-scale-absolute   scale net graphs against maximum speed seen.
 .TP
 .BR \-u , " --unicore"
 Display unicore graphs on the CPU screen.
 .TP
 .BI "\-r, --refresh " seconds
 Set the refresh interval from 1 to 300 seconds (default: 1).
 .TP
 .BI "\-t, --temperature " id
 Select the temperature hwmon sensor (0 to 3).
 .TP
 .BI "\-f, --fan " id
 Select the fan hwmon sensor (0 to 3).
 .TP
 .BI "\-gt, --global-temp " id
 Show this temperature probe instead of the maximum on the summary screen.
 .TP
 .BR \-df , " --disable-freq"
 Disable CPU frequency monitoring.
 .TP
 .B --info-rotate
 Rotate the bottom information bar. Use the long option: the fork documents
 \-ir in its help, but its parser checks \-rc and also treats that prefix as
 \-r. The documented short form \-ir is not supported correctly.
 .TP
 .BR \-vc , " --variable-cpu"
 Recalculate the CPU count for systems supporting CPU hotplug.
 .SH "KEYS"
 L2 selects the previous screen; L3 selects the next screen.
 L4 selects an alternative view where available; L5 changes the bottom bar.
 .SH "NOTES"
 Normal operation requires a running g15daemon. This package does not install
 or enable a g15stats service. Run the client as an ordinary user.
 The help options exit before connecting to g15daemon.
 Sensor availability depends on the kernel and hardware; legacy battery
 paths may be unavailable on modern systems.
 .SH "AUTHOR"
 Mike Lampard
 .SH "SEE ALSO"
 .BR g15daemon (1),
 .BR libg15 (3)
@@ -0,0 +1 @@
 usr/bin/g15stats
@@ -0,0 +1 @@
 debian/g15stats.1
@@ -0,0 +1,47 @@
 Description: Preserve Debian flags and use conventional automake linking
 Remove the bare -I (which consumes the next compiler argument), pass GTOP
 libraries after objects, and let debhelper install selected documentation.
 The historical Bhavani Shankar explicit pthread/math linkage fix is already
 present in this fork and remains intact. Align stale configure versions with
 the pinned post-3.0.3 snapshot (see debian/PROVENANCE).
 Author: Mikhail Yevchenko <m.ṥῥẚɱ.ѓѐḿởύḙ@uo1.net>
 Forwarded: not-needed
 Last-Update: 2026-09-07
 --- a/configure.ac
 +++ b/configure.ac
@@ -1,7 +1,5 @@
 -AC_INIT([g15stats],[3.0],[dmenelkir@gmail.com])
 +AC_INIT([g15stats],[3.0.3+git20240609.95de11a],[dmenelkir@gmail.com])
 -PACKAGE=g15stats
 -VERSION=3.0.1
 AC_PREFIX_DEFAULT(/usr)
 AC_CONFIG_AUX_DIR(config)
 -AM_INIT_AUTOMAKE($PACKAGE, $VERSION)
 +AM_INIT_AUTOMAKE([foreign])
@@ -26,6 +24,4 @@
 CPPFLAGS="$CPPFLAGS $GTOP_CFLAGS"
 -CFLAGS="$CPPFLAGS $GTOP_CFLAGS"
 -LDFLAGS="$LDFLAGS $GTOP_LIBS"
 AC_CONFIG_FILES([Makefile])
 AC_OUTPUT
 --- a/Makefile.am
 +++ b/Makefile.am
@@ -2,12 +2,8 @@
 -AM_CFLAGS = -Wall @CFLAGS@ -I$(top_builddir) -I$(top_srcdir)
 +AM_CFLAGS = -Wall
 +AM_CPPFLAGS = -I$(top_builddir) -I$(top_srcdir)
 METASOURCES = AUTO
 bin_PROGRAMS = g15stats
 noinst_HEADERS = g15stats.h
 -docdir = @docdir@
 -doc_DATA = README ChangeLog AUTHORS NEWS COPYING
 -
 -LIBS = -lg15daemon_client -lg15render -lpthread -lm -lrt
 -IMCLUDES = -I
 -g15stats_LDFLAGS = -avoid-version
 +g15stats_LDADD = -lg15daemon_client -lg15render -lpthread -lm -lrt $(GTOP_LIBS)
 g15stats_SOURCES =  g15stats.c g15stats.h
@@ -0,0 +1 @@
 modern-build.patch
@@ -0,0 +1,29 @@
 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 Format: 1.0
 Source: g15stats
 Binary: g15stats
 Architecture: any
 Version: 1.9.2-2
 Maintainer: Giacomo Catenazzi <cate@debian.org>
 Homepage: http://www.g15tools.com
 Standards-Version: 3.8.2
 Build-Depends: cdbs, debhelper (>= 5), autotools-dev, libxtst-dev, libfreetype6-dev, libusb-dev, libgtop2-dev, libg15-dev, libg15render-dev (>= 1.2-3), libg15daemon-client-dev, automake, libtool, autoconf
 Checksums-Sha1: 
 b53ea7414bd47b68a73aaa8f548d36f50b47aa09 25190 g15stats_1.9.2.orig.tar.gz
 245c96ab8267a31c5e1ebebe91307e8ff99bb976 2316 g15stats_1.9.2-2.diff.gz
 Checksums-Sha256: 
 9dda49a3f09e66ce738ceecb07f2c0fef7ecd5ecbd06e435b340dfca35a37da4 25190 g15stats_1.9.2.orig.tar.gz
 ce724380069ee62563f2898b1bbd0afb80bb632cb6dbf3d1747871f7cdfefbb3 2316 g15stats_1.9.2-2.diff.gz
 Files: 
 beb285f739127e91b97af465e6b53c4a 25190 g15stats_1.9.2.orig.tar.gz
 bec0a80e18f8905d4d70a1c9fc575043 2316 g15stats_1.9.2-2.diff.gz
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.11 (GNU/Linux)
 iEYEARECAAYFAk1/EkEACgkQ+ZNUJLHfmlclzQCeMMSD3P7ix2G7M8JJnlfTbqBS
 4U4AnjhLSSPFun2rWQirQ5w9D7ubM3gC
 =ounU
 -----END PGP SIGNATURE-----
@@ -0,0 +1,10 @@
 #!/usr/bin/make -f
 export DEB_BUILD_MAINT_OPTIONS = hardening=+all
 %:
 	dh $@
 override_dh_auto_install:
 	dh_auto_install --destdir=debian/tmp
@@ -0,0 +1 @@
 3.0 (quilt)
@@ -0,0 +1 @@
 debian/provenance/g15stats_1.9.2-2.diff.gz
@@ -0,0 +1,3 @@
 Tests: help
 Depends: @
 Restrictions: superficial
@@ -0,0 +1,12 @@
 #!/bin/sh
 set -eu
 # Help returns before daemon connection, sensor polling or keyboard threads.
 # Run only in an isolated testbed without USB device passthrough.
 work=$(mktemp -d)
 trap 'rm -rf "$work"' EXIT HUP INT TERM
 timeout 5 g15stats --help > "$work/long"
 timeout 5 g15stats -h > "$work/short"
 cmp "$work/long" "$work/short"
 grep -F 'g15stats 3.0.3+git20240609.95de11a' "$work/long"
 grep -F -- '--interface' "$work/long"
 grep -F -- '--refresh' "$work/long"
@@ -0,0 +1,5 @@
 version=4
 # Local post-3.0.3 snapshot: see PROVENANCE; no upstream signatures available.
 opts="mode=git, pgpmode=none, dversionmangle=s/\+git.*//" \
 https://gitlab.com/menelkir/g15stats.git refs/tags/@ANY_VERSION@