From 7794d807ecf173d2f01f28e516783b5bd84d6fe9 Mon Sep 17 00:00:00 2001 From: Heikki Hannikainen Date: Tue, 9 May 2017 02:07:37 +0300 Subject: [PATCH] IGATE-HINTS: Clarify forwarding packet data without decoding and re-encoding. --- doc/IGATE-HINTS.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/doc/IGATE-HINTS.md b/doc/IGATE-HINTS.md index 03b9683..dd25cfb 100644 --- a/doc/IGATE-HINTS.md +++ b/doc/IGATE-HINTS.md @@ -78,12 +78,17 @@ will pass the original packet unmodified. Treat APRS packets as arrays or buffers of binary bytes. Only after decoding the APRS packet, some fields such as the comment text and APRS text -message text should be UTF-8 decoded. +message text should be UTF-8 decoded for the purpose of displaying it on a +user interface. If your programming language or environment supports setting text encoding for a network socket, do not set UTF-8 encoding for the APRS-IS socket. Treat it as a binary stream. +When iGating, digipeating or otherwise forwarding packets, forward the +packet data payload as a binary buffer. Do not decode and re-encode as +UTF-8, as it may well break packets which do not happen to be UTF-8. + iGates dropping duplicate packets unnecessarily -------------------------------------------------