[ethtool] Add AppStream metainfo XML with modalias documented supported

Commit Message

Petter Reinholdtsen Feb. 26, 2025, 10 p.m. UTC

I am not used to submitting patches like this, and hope I do not make
too many mistakes.  Please forgive me if I did.  This patch was
initially submitted to Debian as <URL: https://bugs.debian.org/1076629 >.

Here is the 'git format-patch' for it.

From 81e64589dd2ebdc194c8198165aa093361682e89 Mon Sep 17 00:00:00 2001
From: Petter Reinholdtsen <[e-mail]>
Date: Wed, 26 Feb 2025 22:36:03 +0100
Subject: [PATCH] Add AppStream metainfo XML with modalias documented supported
 hardware.

This ensure all Linux distributions supporting AppStream share
AppStream information for ethtool.

Hardware mappings allow AppStream clients like isenkram to propose
this package when supported hardware (ethernet card) is present.

Appstream is documented on
<URL: https://www.freedesktop.org/wiki/Distributions/AppStream/ >.
---
 Makefile.am                                      |  6 +++++-
 org.kernel.software.network.ethtool.metainfo.xml | 16 ++++++++++++++++
 2 files changed, 21 insertions(+), 1 deletion(-)
 create mode 100644 org.kernel.software.network.ethtool.metainfo.xml

Patch

diff --git a/Makefile.am b/Makefile.am
index 862886b..8d50ef6 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -3,7 +3,11 @@  AM_CPPFLAGS = -I$(top_srcdir)/uapi
 LDADD = -lm
 
 man_MANS = ethtool.8
-EXTRA_DIST = LICENSE ethtool.8 ethtool.spec.in aclocal.m4 ChangeLog autogen.sh
+EXTRA_DIST = LICENSE ethtool.8 ethtool.spec.in aclocal.m4 ChangeLog autogen.sh \
+             org.kernel.software.network.ethtool.metainfo.xml
+
+dist_metainfo_DATA = org.kernel.software.network.ethtool.metainfo.xml
+metainfodir = $(datarootdir)/metainfo
 
 sbin_PROGRAMS = ethtool
 ethtool_SOURCES = ethtool.c uapi/linux/const.h uapi/linux/ethtool.h internal.h \
diff --git a/org.kernel.software.network.ethtool.metainfo.xml b/org.kernel.software.network.ethtool.metainfo.xml
new file mode 100644
index 0000000..efe84c1
--- /dev/null
+++ b/org.kernel.software.network.ethtool.metainfo.xml
@@ -0,0 +1,16 @@ 
+<?xml version="1.0" encoding="UTF-8"?>
+<component type="desktop">
+  <id>org.kernel.software.network.ethtool</id>
+  <metadata_license>MIT</metadata_license>
+  <name>ethtool</name>
+  <summary>display or change Ethernet device settings</summary>
+  <description>
+    <p>ethtool can be used to query and change settings such as speed,
+    auto- negotiation and checksum offload on many network devices,
+    especially Ethernet devices.</p>
+  </description>
+  <url type="homepage">https://www.kernel.org/pub/software/network/ethtool/</url>
+  <provides>
+    <modalias>pci:v*d*sv*sd*bc02sc80i*</modalias>
+  </provides>
+</component>