1GPS2UDP(1)                    GPSD Documentation                    GPS2UDP(1)
2
3
4

NAME

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

SYNOPSIS

9       gps2udp [-h] [-n] [-j] [-a] [-u hostname:udpport] [-c count] [-d 1|2]
10               [-v] [server [:port [:device]]]
11

DESCRIPTION

13       gps2udp is a tool to connect to gpsd and output the received sentences
14       to one or many UDP host:port destinations. This makes the program
15       useful for feeding AIS information from gpsd to aishub, marinetraffic,
16       shipfinder,...
17
18       gps2udp does not require root privileges, and can be run concurrently
19       with other tools connecting to the local gpsd without causing problems.
20
21       The output will consist of one or both of NMEA (-n option) or JSON (-j
22       option) gpsd sentences. The output is sent to one or many destinations
23       host through a UDP network socket (-u host:port options) .
24
25       Optionally a server, TCP/IP port number and remote device can be given.
26       If omitted, gps2udp connects to localhost on the default port (2947)
27       and watches all devices opened by gpsd.
28
29       gps2udp may be run as a daemon (-b option).
30
31       gps2udp is designed to run smoothly in background; it reconnects
32       automatically to gpsd whenever it is restarted. For debugging
33       purporses, there is an option to exit gracefully after a given count of
34       packets (-c option).
35

OPTIONS

37       -h makes gps2udp print a usage message and exit.
38
39       -n causes NMEA sentences to be output.
40
41       -j causes JSON sentences to be output.
42
43       -u host:port UDP destination for output sentenses (up to five
44       destinations).
45
46       -a output only AIS messages.
47
48       -b causes gps2udp to run as a daemon.
49
50       -c [count] causes [count] sentences to be output.  gps2udp will then
51       exit gracefully.
52
53       -d 1 prints sent packet on stdout.
54
55       -d 2 prints unsent packet on stdout.
56
57       -v prints the version, then exits.
58

EXAMPLE

60       With a running gpsd accessible on the network
61
62       gps2udp -d 1 -n -u data.aishub.net:2222 will collect data from
63       localhost:gpsd display them on stdout and send a copy to test aishub in
64       NMEA format.
65
66       gps2udp -a -n -b -u data.aishub.net:2222 -u 5.9.207.224:5321 -u
67       109.200.19.151:4001 fridu.net:2947 will collect data from a remote gpsd
68       located on fridu.net host, will filter AIS messages and send them to 3
69       destination (aishub, marinetraffic, shipfinder) in NMEA format, command
70       is running in background mode
71

SEE ALSO

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

AUTHOR

77       Fulup Ar Foll <fulup@sinagot.net>.
78
79
80
81The GPSD Project                 01 Marc 2013                       GPS2UDP(1)
Impressum