options: add cache mode for known hops

Port the mtr085 cache mode as a long-only option for current upstream.  Upstream already uses -x for XML output, so this keeps the user-facing short-option namespace unchanged and exposes only --cache SECONDS.

Ported-from: yvs2014/mtr085@0700269ce0f3f501fc33ec98176101f2f4f733eb

Ported-from: yvs2014/mtr085@0cab98cf8d2e0648f8e1bdd52da5d3122d3c091d

Original-author: yvs <VSYakovetsky@gmail.com>

Merge pull request #618 from Komzpa/darafei/merge-useful-hostname

refactor(dns): share hostname usefulness helper

Merge pull request #619 from Komzpa/darafei/document-braille-displaymode

docs: document braille display mode

Merge pull request #620 from Komzpa/darafei/idn-ai-idn

net: resolve IDN hostnames with AI_IDN

Merge pull request #621 from Komzpa/darafei/target-port-syntax

options: accept target ports in host arguments

Merge pull request #572 from Komzpa/darafei/split-mode-terminal-keys

split: read terminal keys without curses

Merge pull request #578 from Komzpa/darafei/quiet-missing-setcap

fix(install): honor transformed packet helper

options: accept target ports in host arguments

net: resolve IDN hostnames with AI_IDN

docs: document braille display mode

Merge pull request #577 from Komzpa/darafei/parse-quoted-mtr-options

options: parse quoted MTR_OPTIONS arguments

Merge pull request #581 from Komzpa/darafei/rename-udp-checksum-helper

packet: rename shared UDP checksum helper

Merge pull request #586 from Komzpa/darafei/preflight-report-targets

report: preflight multiple target families

Merge pull request #587 from Komzpa/darafei/document-stripchart-markers

docs: explain stripchart markers

Merge pull request #582 from Komzpa/darafei/test-ttl-option-validation

test: cover TTL option validation

Merge pull request #591 from Komzpa/darafei/document-raw-time-units

docs: clarify raw ping time units

Merge pull request #590 from Komzpa/darafei/add-appstream-metadata

desktop: install AppStream metadata

Merge pull request #589 from Komzpa/darafei/report-on-interrupt

report: print partial output on interrupt

Merge pull request #593 from Komzpa/darafei/static-analysis-fixes

fix: address static analyzer findings

Merge pull request #592 from Komzpa/darafei/xml-host-address-attrs

xml: expose hub host address separately

Merge pull request #595 from Komzpa/darafei/gcc-analyzer-fixes

fix(mpls): print stack flag without suffix

refactor(dns): share hostname usefulness helper

Merge pull request #596 from Komzpa/darafei/gtk-formatters-snprintf

fix(gtk): bound formatter output

Merge pull request #599 from Komzpa/darafei/cygwin-initialize-icmp-remote

fix(cygwin): initialize ICMP reply address

Merge pull request #601 from Komzpa/darafei/mtr-packet-startup-hint

fix(cmdpipe): clarify mtr-packet startup failures

Merge pull request #603 from Komzpa/darafei/cleanup-dns-processes

fix(dns): harden resolver lifecycle and results

Merge pull request #604 from Komzpa/darafei/ipv6-bindtodevice-capability

fix(packet): retain bind-to-device capability

Merge pull request #606 from Komzpa/darafei/remove-csv-close-dead-loop

refactor(csv): remove unused close loop

Merge pull request #607 from Komzpa/darafei/remove-csv-separator-note

docs: align CSV separator description

Merge pull request #612 from Komzpa/darafei/document-asn-disable

docs: clarify ASN lookup defaults

Merge pull request #613 from Komzpa/darafei/report-hop-errors

fix(report): show hop errors in report outputs

Merge pull request #614 from Komzpa/darafei/explain-packet-permission-denied

fix(cmdpipe): explain probe permission errors

Merge branch 'master' of github.com:traviscross/mtr

Fixed some irritating compiler warnings

Merge pull request #571 from Komzpa/codex/document-default-ports

packet: document and constrain default UDP ports

desktop: install AppStream metadata

fix(report): show hop errors in report outputs

fix(dns): check resolver pipe setup failures

fix(dns): ignore empty PTR hostnames

report: print partial output on interrupt

fix(install): honor transformed packet helper

fix(cmdpipe): explain probe permission errors

docs: clarify ASN lookup defaults

docs: align CSV separator description

refactor(csv): remove unused close loop

fix(packet): retain bind-to-device capability

fix(dns): terminate resolver subprocesses on exit

fix(cmdpipe): clarify mtr-packet startup failures

fix(cygwin): initialize ICMP reply address

fix(gtk): bound formatter output

fix(mpls): print stack flag without suffix

fix: address static analyzer findings

xml: expose hub host address separately

docs: clarify raw ping time units

docs: explain stripchart markers

report: preflight multiple target families

test: cover TTL option validation

packet: rename shared UDP checksum helper

options: parse quoted MTR_OPTIONS arguments

fix: read split mode keys without curses

packet: avoid privileged default udp source ports

Merge pull request #570 from Komzpa/codex/fix-ci-workflow

ci: fix GitHub Actions test workflow

docs: document default trace ports

ci: fix GitHub Actions test workflow

Merge branch 'master' of github.com:traviscross/mtr

Added explanation why restricively running under sudo is not a good idea

Merge pull request #569 from Komzpa/fixer-throttle-curses-redraws

ui: throttle curses redraws during packet bursts

ui: throttle curses redraws during packet bursts

Merge pull request #568 from mayconrcmello/fix/cygwin-braille

ui: fix braille display mode on Cygwin

I would find it neater to add a check for the header that cygwin uses, instead of checking for cygwin and just including that. This involves messing with the autoconf stuff which I'm not familiar with. So that's an item for the "todo list".

ui: fix braille display mode on Cygwin

Three issues prevented the braille display from rendering correctly
when mtr is built with Cygwin:

1. Wrong ncurses header: Cygwin ships <ncurses.h> as the non-wide
   variant, which does not declare addwstr() or add_wch(). Include
   <ncursesw/ncurses.h> instead when building with braille support.

2. Wrong output function: printw("%ls", wstr) relies on the C library
   wide-to-multibyte conversion path, which can misbehave when the
   locale is not fully set up before ncurses initialises. Use
   addwstr(), the proper ncursesw API, instead.

3. Locale and console codepage: setlocale(LC_ALL, "") on Cygwin
   inherits the Windows ANSI codepage (e.g. CP1252), breaking UTF-8
   output. Explicitly request C.UTF-8 and set the Windows console
   output codepage to 65001 (UTF-8) before initscr().

ui: replace non-BMP braille char U+1FB10 with U+28FF

🮐 (U+1FB10) lives outside the Basic Multilingual Plane and requires
a UTF-16 surrogate pair when wchar_t is 16 bits (Windows, Cygwin).
Passing a surrogate pair to wide-char ncurses functions produces
corrupted output on those platforms.

Replace all three uses with ⣿ (U+28FF), the filled braille pattern,
which is the visually closest BMP character and avoids the issue on
any platform where sizeof(wchar_t) == 2.

Merge pull request #567 from psumbera/solaris

packet: skip bind() on Solaris raw ICMPv4 sockets

packet: skip bind() on Solaris raw ICMPv4 sockets

Commit d529dbeefc6d ("Change UDP and ICMP sockets binding to accept a
source IP from the -a CLI option") started binding the shared IPv4 raw
ICMP send socket in construct_ip4_packet().

On Solaris/illumos this breaks default ICMP probes: bind() on that raw
socket can fail with EINVAL, and mtr exits with:

  mtr: mtr-packet reported invalid argument

This does not affect TCP or UDP probes, and mtr 0.95 worked because the
raw ICMPv4 path did not bind the socket.

Keep the pre-0.96 behavior on __sun by skipping bind() for raw ICMPv4
sockets. This restores default ICMP probing on Solaris/illumos without
changing Linux behavior.

Note that -a source address selection is not enforced for raw ICMPv4 on
Solaris/illumos, since those platforms cannot reliably use bind() on the
shared raw ICMP socket in this code path.

Merge pull request #565 from AradCohen/fix_dos_bug_and_add_fuzzing

dos fixed, oss fuzz integration added

fix: formatting in deconstruct unix II

fix: formatting in deconstruct unix

dos fixed, oss fuzz integration added

Merge pull request #563 from bluPhy/master

Fix typos in comments and docstrings across codebase

Fix typos in comments and docstrings across codebase

Corrected several spelling errors such as 'unparseable' to 'unparsable', 'paramters' to 'parameters', 'virutal' to 'virtual', 'withing' to 'within', and 'non-existant' to 'non-existent' in both source and test files to improve code clarity and documentation accuracy.

Included apple ASN fix

Merge pull request #558 from eakteam/patch-1

Update split.c : Report tenths of millisecond times like throughout the rest of MTR.

Update split.c

Enhanced the ping times from Int to Float values

Upgraded maxpacket to 64k. Fixes #553

Merge pull request #548 from dvallyanov/master

fix numhosts calculation. Improve -D (--due-ttl) option

fix numhosts calculation. Improve -D (--due-ttl) option

fix numhosts calculation. Improve -D (--due-ttl) option

- numhosts did not take fstTTL into account when calculating the number of hosts in a batch.
- maxUnknown or maxTTL values ​​are now taken into account after the set TTL value is reached,
  when the -D (--due-ttl) option is enabled.

Merge pull request #546 from dvallyanov/due-ttl-option

Add -D (--due-ttl) option.

Add -D (--due-ttl) option.

Specifies the minimum TTL value that must be reached when sending network probes.

Closes feature request #295

Merge pull request #540 from sevan/darwin-buildfix

Legacy IOS system build fix.

packet/construct_unix.c: Only set IPV6_TCLASS if defined.

Resolves build on legacy systems with IPv6 stacks which lack RFC 3542
support e.g Mac OS X, before 10.6.

packet/construct_unix.c: unused variable

ui/asn.c: No need to define BIND_8_COMPAT

Before OS X 10.6, defining BIND_8_COMPAT included arpa/nameser8_compat.h
which was removed in 10.6 and from then on included arpa/nameser_compat.h
until BIND_8_COMPAT was removed somewhere between macOS 10.13 & 10.15.

On systems before 10.6 this causes the build to break due to conflicts.

Merge pull request #538 from Plutor/master

Raw pings output time in usec. Correct args and docs.

Raw pings output time in usec. Correct args and docs.

(An alternate solution is to correct https://github.com/traviscross/mtr/blob/master/ui/net.c#L319, but that would potentially break workflows for users, so this is likely a more acceptable fix)

Added backticks around host. Fixes #536

The release script bumped the version number to 96

Added Arad Cohen to NEWS

Merge branch 'master' of github.com:traviscross/mtr

Added protection against use of MTR_PACKET under special circumstances

Merge pull request #534 from jlu5/fix/addrcmp-af-unspec

net: implement addrcmp for AF_UNSPEC