aprsmon - monitor APRS AX.25 traffic for javAPRS



SYNOPSIS
       aprsmon  [-a]  [-m] [-r] [-k minutes] [-p port] [-t title]
       [-i infofile]



DESCRIPTION
       Aprsmon uses SOCK_PACKET facilities to provide  a  network
       monitor  of all AX.25 UI text traffic heard by the system.
       It is based on listen(1).

       This version either collects  (-m)  or  displays  standard
       AX.25 UI text frames in a format similar to that output by
       standard TNC's in "Monitor ON" mode and is intended to  be
       used  with  programs  like javAPRS which wish to see a TNC
       data stream over a TCP connection.

       Compressed position and telemetry reports as generated  by
       the  "APRS  Mic  Encoder"  are translated into the conven-
       tional uncompressed MIM format so that these stations  are
       visible in javAPRS.




OPTIONS
       -a        Allow  for  the monitoring of outgoing frames as
                 well as incoming ones.

       -r        Choose "raw"  mode  which  allows  non-printable
                 data through.

       -p port   Monitor only those frames received on a particu-
                 lar port, by default all AX.25 devices are moni-
                 tored.

       -m        "Master"  mode.   Retain  monitored data for the
                 number of minutes specified with the  -k  option
                 in a shared memory segment.

       -k minutes
                 Retain  monitored  packets  going back the given
                 number of minutes.  Default is 30.

       -t title  Sets the javAPRS title string.  Default is "Live
                 data from Linux."

       -i infofile
                 Infofile  is  the  path  to  the  file  that the
                 aprsmon master writes the shared memory  segment
                 and    semaphore    id's   into.    Default   is
                 "/var/ax25/aprsmon.info."



javAPRS CONFIGURATION

       aprsmon -a -m&

       Add  an  entry into /etc/services with the port number you
       want javAPRS to connect on.  For example:

       aprs      14579/tcp # APRS monitor on 145.79

       Add an entry into /etc/inetd.conf for this service:

       aprs stream tcp nowait root /usr/sbin/aprsmon aprsmon -a

       To test, simply "telnet  localhost  aprs".   To  use  with
       javAPRS, set, for example,

       <PARAM name = "dataFile1" value = "netc:14579:localhost">




FILES
       /etc/ax25/axports /var/ax25/aprsmon.info



SEE ALSO
       call(1),   listen(1),   beacon(1),  ax25(4),  axattach(8),
       http://www.bridge.net/~sdimse/javAPRS.html,
       http://www.tapr.org/sigs.html