Added messages regarding config files and OS specific issues

[Jason White (via pkgsrc-wip) <commit-notify%pkgsrc.org@localhost>]

Module Name:	pkgsrc-wip
Committed By:	Jason White <jdwhite%menelos.com@localhost>
Pushed By:	jdwhite
Date:		Sat Oct 26 21:01:29 2024 -0500
Changeset:	349e956ee587c66f8bf74ffc1cce6982354ff4b8

Added Files:
	rtl_433/MESSAGE.Linux
	rtl_433/MESSAGE.NetBSD
	rtl_433/MESSAGE.common

Log Message:
Added messages regarding config files and OS specific issues

To see a diff of this commit:
https://wip.pkgsrc.org/cgi-bin/gitweb.cgi?p=pkgsrc-wip.git;a=commitdiff;h=349e956ee587c66f8bf74ffc1cce6982354ff4b8

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

diffstat:
 rtl_433/MESSAGE.Linux  | 25 +++++++++++++++++++++++++
 rtl_433/MESSAGE.NetBSD | 12 ++++++++++++
 rtl_433/MESSAGE.common | 12 ++++++++++++
 3 files changed, 49 insertions(+)

diffs:
diff --git a/rtl_433/MESSAGE.Linux b/rtl_433/MESSAGE.Linux
new file mode 100644
index 0000000000..2bedeb0b1e
--- /dev/null
+++ b/rtl_433/MESSAGE.Linux
@@ -0,0 +1,25 @@
+===========================================================================
+$NetBSD$
+
+If you see the following at runtime error:
+
+  Kernel driver is active, or device is claimed by second instance of librtlsdr.
+  In the first case, please either detach or blacklist the kernel module
+  (dvb_usb_rtl28xxu), or enable automatic detaching at compile time.
+
+check if dvb_usb_rtl28xxu is loaded as a kernel module with:
+
+  lsmod | grep dvb_usb_rtl28xxu
+
+If loaded, unload the kernel module (as root) with:
+
+  rmmod dvb_usb_rtl28xxu
+
+To blacklist this module at boot, create
+/etc/modprobe.d/dvb-blacklist.conf and add the following:
+
+  blacklist dvb_usb_rtl28xxu
+
+This is known to work with Fedora, Debian, and should work with variants of
+these Linux distributions.
+===========================================================================
diff --git a/rtl_433/MESSAGE.NetBSD b/rtl_433/MESSAGE.NetBSD
new file mode 100644
index 0000000000..bd282a0bc8
--- /dev/null
+++ b/rtl_433/MESSAGE.NetBSD
@@ -0,0 +1,12 @@
+===========================================================================
+$NetBSD$
+
+NOTE: limitations of rtl_433 on NetBSD.
+
+Due to limitations of NetBSD's usb(4)/ugen(4) driver[1], rtl_433 cannot
+detect Software Defined Radio (SDR) devices. However, rtl_433 can still
+read ('-r') and decode signal data from files written ('-w') by other
+rtl_433 instances or read from a rtl_tcp stream ('-d rtl_tcp{...}').
+
+[1] better explanation needed.
+===========================================================================
diff --git a/rtl_433/MESSAGE.common b/rtl_433/MESSAGE.common
new file mode 100644
index 0000000000..a72055960f
--- /dev/null
+++ b/rtl_433/MESSAGE.common
@@ -0,0 +1,12 @@
+===========================================================================
+$NetBSD$
+
+Example configuration files are installed in:
+${PREFIX}/share/examples/rtl_433/conf
+
+Example scripts are installed in:
+${PREFIX}/share/examples/rtl_433
+
+Additional documentation available in:
+${PREFIX}/share/doc/rtl_433
+===========================================================================