NAME

       gps2udp - feed the take from gpsd to one or more aggregation sites

SYNOPSIS

       gps2udp [--ais] [--count COUNT] [--daemonize] [--debug LVL] [--help] [--json] [--nmea] [--tpv]
               [--udp HOST:PORT] [-a] [-c COUNT] [-d LVL] [-h] [-j] [-n] [-t] [-u HOST:PORT] [-V] [-V] [server
               [:port [:device]]]

DESCRIPTION

       gps2udp is a tool to connect to gpsd and output the received sentences to one or many UDP host:port
       destinations. This makes the program useful for feeding AIS information from gpsd to aishub,
       marinetraffic, shipfinder,...

       gps2udp does not require root privileges, and can be run concurrently with other tools connecting to the
       local gpsd without causing problems.

       The output will consist of one or both of NMEA (-n option) or JSON (-j option) gpsd sentences. The output
       is sent to one or many destinations host through a UDP network socket (-u HOST:PORT options) .

       Optionally a server, TCP/IP port number and remote device can be given. If omitted, gps2udp connects to
       localhost on the default port (2947) and watches all devices opened by gpsd.

       gps2udp may be run as a daemon (-b option).

       gps2udp is designed to run smoothly in background; it reconnects automatically to gpsd whenever it is
       restarted. For debugging purporses, there is an option to exit gracefully after a given count of packets
       (-c option).

OPTIONS

       -?, -h, --help
           -Print a usage message and exit.

       -a, --ais
           Send only AIS messages.

       -b, --daemon
           Causes gps2udp to run as a daemon.

       -c COUNT, --count COUNT
           Exit after COUNT sentences are sent.

       -d LVL, --debug LVL
           Set debug level to LVL. LVL = 0 prints nothing. LVL =1 prints sent packet on stdout. LVL =2 prints
           ignored packets.

       -j, --json
           Causes JSON sentences to be output.

       -n, --nmea
           Causes NMEA sentences to be output.

       -t, --tpv
           Only output TPV sentences. Implies --json.

       -u HOST:PORT, --udp HOST:PORT
           UDP destination for output sentenses (up to five destinations).

       -v, -V, --version
           Prints the program version, then exit. -v is deprecated December 2020.

EXAMPLE

       With a running gpsd accessible on the network

       gps2udp -d 1 -n -u data.aishub.net:2222 will collect data from localhost:gpsd display them on stdout and
       send a copy to test aishub in NMEA format.

       gps2udp -a -n -b -u data.aishub.net:2222 -u 5.9.207.224:5321 -u 109.200.19.151:4001 fridu.net:2947 will
       collect data from a remote gpsd located on fridu.net host, will filter AIS messages and send them to 3
       destination (aishub, marinetraffic, shipfinder) in NMEA format, command is running in background mode

SEE ALSO

       gpsd(8), gps(1), libgps(3), libgpsmm(3), gpsprof(1), gpsfake(1), gpsctl(1), gpscat(1).  gpsmon(1).

AUTHOR

       Fulup Ar Foll <fulup@sinagot.net>.

The GPSD Project                                 6 December 2020                                      GPS2UDP(1)