A highly configurable APRS I-gate/Digipeater Daemon
C Shell Makefile
Clone or download
Latest commit 13c6e79 Sep 18, 2017
Permalink
Failed to load latest commit information.
debian Merge patches from Debian downstream Oct 7, 2016
doc Manual: Updated contact info for maintainer Dec 18, 2016
rpm * rpm/aprx.spec.in: Feb 1, 2014
.gitignore Update .gitignore to quench .deb files Oct 3, 2014
ChangeLog beacon.c: Demote some nuisance logging to -dd level. Aug 29, 2014
INSTALL Prepare for v2.9.0 of Aprx Sep 14, 2016
LICENSE Added my name to the LICENSE Dec 11, 2016
Makefile.in Detect FreeBSD, use FreeBSD date(1) Mar 22, 2017
PROTOCOLS * README, ROADMAP, TODO, INSTALL, PROTOCOLS: Jun 7, 2010
README Update README - Fix spelling of verbose Nov 2, 2016
ROADMAP Added new ROADMAP file Sep 15, 2016
TIMESTAMP-AT-APRSIS TIMESTAMP-AT-APRSIS proposal text editing Jun 10, 2010
TODO doc snapshot, TODO snapshot Jul 11, 2014
VERSION Prepare for v2.9.0 of Aprx Sep 14, 2016
ViscousDigipeater.README Rename README.ViscousDigipeater -> ViscousDigipeater.README. Oct 22, 2009
ViscousDigipeaterTxEffect.png * rfbeacon.c: Oct 23, 2009
agwpesocket.c Revised source file intro comment. Sep 21, 2014
apparmor.aprx * apparmor.aprx, debian/rules, debian/dirs, debian/postint: Sep 4, 2012
aprsis.c Fix rename of variable in aprsis_readup Sep 29, 2016
aprx-complex.conf.in Put the "#telem-to-is true" samples on <interface> blocks. Mar 8, 2014
aprx-config.xsd * aprx-config.xsd: Jul 29, 2012
aprx-rxigate.conf.in Put the "#telem-to-is true" samples on <interface> blocks. Mar 8, 2014
aprx-stat.8.in Merge patches from Debian downstream Oct 7, 2016
aprx-stat.c Fix missing now from aprx-stat Mar 8, 2017
aprx.8.in Merge patches from Debian downstream Oct 7, 2016
aprx.c Prepare for v2.9.0 of Aprx Sep 14, 2016
aprx.conf.in Added missing comment char in default conf Dec 28, 2016
aprx.h Fixed TIMEFIX only inserting 000000h May 10, 2015
aprxpolls.c Revised source file intro comment. Sep 21, 2014
ax25.c Revised source file intro comment. Sep 21, 2014
beacon.c Fixed TIMEFIX only inserting 000000h May 10, 2015
cellmalloc.c Revised source file intro comment. Sep 21, 2014
cellmalloc.h Revised source file intro comment. Sep 21, 2014
config.c Bail out on unknown \ escapes to try and hide that Jun 17, 2015
config.h.in * configure.in: Mar 24, 2014
configure Replaced SVN release versioning with GIT Oct 1, 2014
configure.in Replaced SVN release versioning with GIT Oct 1, 2014
coverity-build-submit.sh Tool for Coverity testing of Aprx Apr 20, 2013
crc.c Revised source file intro comment. Sep 21, 2014
digipeater.c More strict on matching route aliases Dec 15, 2016
dprsgw.c Fixed build warnings that didn't require thought Sep 26, 2014
dupecheck.c Fix headers + strings for code copied from aprsc Apr 19, 2015
erlang.c Possible erlang aprx_stats fix. Aug 30, 2015
filter.c Fix headers + strings for code copied from aprsc Apr 19, 2015
historydb.c Fixed build warnings that didn't require thought Sep 26, 2014
historydb.h Revised source file intro comment. Sep 21, 2014
hlog.c Fix headers + strings for code copied from aprsc Apr 19, 2015
hlog.h Fix headers + strings for code copied from aprsc Apr 19, 2015
igate.c igate.c comment cleanup Sep 18, 2017
install-sh * configure.in, configure, Makefile.in, Makefile, config.h.in, Jan 12, 2008
interface.c Fixed no rf-gate w/o digi bug Apr 1, 2015
keyhash.c Revised source file intro comment. Sep 21, 2014
keyhash.h Revised source file intro comment. Sep 21, 2014
kiss.c Removed source code comments which had TODO/FIXME items which should … Sep 17, 2017
logrotate.aprx.in Configurability of logging parameter "dprslog" Dec 25, 2011
man-to-html.sh * digipeater.c, interface.c: May 29, 2010
netax25.c Revised source file intro comment. Sep 21, 2014
netresolver.c Fixed build warnings that didn't require thought Sep 26, 2014
parse_aprs.c Fix headers + strings for code copied from aprsc Apr 19, 2015
pbuf.c Revised source file intro comment. Sep 21, 2014
pbuf.h Fix headers + strings for code copied from aprsc Apr 19, 2015
ssl.c Collected material from Aprsc to start implementing SSL client mode Feb 1, 2014
ssl.h Collected material from Aprsc to start implementing SSL client mode Feb 1, 2014
telemetry.c Reorder telemetry formatters for better station bring-up Dec 19, 2016
test.c all sources processed with: indent -kr -ci8 -i8 Apr 16, 2008
timercmp.c Revised source file intro comment. Sep 21, 2014
timestamp.c * filter.c: Jan 1, 2011
ttyreader.c Revised source file intro comment. Sep 21, 2014
valgrind.c Revised source file intro comment. Sep 21, 2014

README

		APRX    v2.9

A multitalented APRS i-gate / digipeater

   Config file (-f option) default is:  /etc/aprx.conf
   Other runtime options are: -v,  -d,  -h/-?  (verbose, debug and help)

   - Rx-IGate functionality works correctly
   - Tx-IGate functionality works correctly

   - Can do APRS New-N and generic AX.25 node digipeater functionality
     with transmitters

   - Has same-channel Viscous Digipeater functionality to not digipeat
     at all, if during initial wait period the packet is heard again.

   - Has cross-interface Viscous Digipeater functionality to not to digipeat,
     if during the initial wait period the packet is heard on destination
     interface at least once, and at least once from other sources.

   - Can receive data from multiple receivers/modems on local machine
     serial ports, both classical and USB.

   - Can receive data from remote TCP stream connectable serial ports
     over the internet.

   - Understands on serial ports (local and remote TCP ones):
       - several KISS protocol variants, checksummed variants preferred
       - TNC2 debug style text (Rx-iGate receive only.)
       - D-STAR data side-channel "D-PRS"

   - Connects with one  callsign-ssid  pair to APRS-IS core for all
     received radio ports (the "mycall" parameter), but reports
     receiving radio port at each Rx-iGated packet

   - Knows that messages with following tokens in VIA fields of the
     path are not to be relayed into network:
              RFONLY, NOGATE, TCPIP, TCPXX

   - Knows that following source address prefixes are bogus and thus
     to be junked at Rx-iGate:
              WIDE, RELAY, TRACE, TCPIP, TCPXX, NOCALL, N0CALL
     (Actually these are string prefixes, so any WIDE*-* will block, etc.)

   - Has integrated D-PRS -> APRS/APRSIS Rx-iGate.
     Can even do D-PRS -> APRS RF conversion.
     This is experimental quality for "GPS" packets, the "GPS-A" is OK.

   - Does not require machine to have AX.25 protocol support internally!

   - On Linux machine with kernel internal AX.25 protocol support, does
     listen on internal AX.25 network in promiscuous form, and requires
     to be running as root to do that.   Does not fail to start in case
     the port fails to open (running as non-root.)

   - Built-in "erlang-monitor" actually counts bytes per time interval
     (1 min, 10 min, and 20 min)  on each receiving interface, including
     all that feed internal AX.25 network.

   - Telemetry reported erlang data is sent out every 20 minutes, and
     contains summarized data from 10 minute round-robin memory arrays.
     These are _not_ sent at exact 10 minutes of wall-clock, but exact
     20 minutes from previous telemetry reporting, and first one is sent
     20 minutes after program start.

   - Telemetry reported erlang data can be sent also over APRS radio
     port, but only for ports with valid AX.25 callsigns. See aprx-manual.pdf

   - The netbeacons are distributed timewise more evenly around the interval,
     and even the interval length is varied at random to statistically spread
     out traffic.  Number of netbeacons are unlimited, but their minimum
     transmit interval is 3 seconds making the amount of beacons sendable in
     20 minutes to be: 20*60/3 = 400.  All will be sent, but the cycle will
     just take longer.

   - Project homepage: http://thelifeofkenneth.com/aprx
   - Source code repository: https://github.com/PhirePhly/aprx/
   - A google-group for Aprx:   http://groups.google.com/group/aprx-software


by Matti Aarnio - OH2MQK - oh2mqk-at-sral-fi - 2007-2014
by Kenneth W. Finnegan - W6KWF - kennethfinnegan2007-at-gmail.com - 2014-