File: README

package info (click to toggle)
gpsd 3.27-1.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 44,056 kB
  • sloc: ansic: 74,438; python: 16,521; sh: 890; cpp: 848; php: 225; makefile: 197; perl: 111; javascript: 26; xml: 11
file content (117 lines) | stat: -rw-r--r-- 3,470 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
= Developer Tools
:date: 13 January 2021
:description: Developer tools for gpsd developers
:keywords: GPSD, GPS, developer
:robots: index,follow
:title: Developer Tools
:toc:

This is a list of developer tools included in the source repository
but not necessarily shipped in the tarball or binary distributions If you're
viewing it with Emacs, you can try doing Ctl-C Ctl-t browse through
the outline headers.  Ctl-C Ctl-a will unfold them again.

== ais.py

AIS packet decoder in Python.  Useful as a check on the C code.
Also, if you have AISHub privileges (see <http://www.aishub.net/>), 
a command like
 
      nc data.aishub.net 4006 | devtools/ais.py -c -v -t RANGE >AIS.LOG 2>&1"

is a handy way to capture filtered AIS samples; RANGE can be a comma-separated
list of AIS types. 

== aidvmtable

Generate an asciidoc table of the six-bit encoding used in AIVDM packets.

== cycle_analyzer

Finds end-of-cycle sentences from GPS output logs.

== dchroot-exec

Very simple wrapper around the DSA version of dchroot
on the Debian porter boxes. dchroot only accepts one command
as argument, nothing else. This wrapper creates a temporary script
which will be executed then.

== do-build

Very simple wrapper around scons clean, build, and check, saving
output in a file named with "git describe".

== easyinverse.pl

Generate random pairirs of mutually inverse covariance matrices 
suitable for testing a matrix-inversion algorithm.

== editcomment

Give this a commit-ID specification.  It will edit the associated comment.
Usual caveats apply; the edited one and all commits after will change IDs,
and pushing them to a repo with the old commits will wreak havoc.
Note also that this cavalierly overwrites refs/original.

== fakeserver

Analogue of gpsfake. Impersonates a gpsd, spewing specified data to
clients connecting to localhost:2947

== fakecompare

Compare the results from running gpsfake on a logfile between this
machine and a remote one.  Especially useful when remote and local
have different word lengths.

== gpsd-debian-regressions.sh

Retrieves the latest build logs from Debian's buildds and extracts a
list of failed regression tests, sorted by architecture.

== identify_failing_build_options.py

Run from the top level to try to identify any combinations of build
options that don't compile.  To run cd to the root of the repo and
run "devtools/identify_failing_build_options.py" it will generate
failed_build_configs.txt for any that failed to compile.

== logextract

Extract pure NMEA from an emailed gpsd error log. The output can be fed 
to gpsfake.

== regress-builder

This script runs an exhaustive test on combinations of compilation options, 
looking for ones that break the build.

== regressdiff

Walk through a pair of text files looking for where they begin to differ.
May be useful for comparing logs when regression tests break.

== reindent

Try to reindent the code in a uniform style.

== sizes

Test-build interesting versions of the daemon and display their sizes.

== striplog

Strip leading comment lines from NMEA sentence logs.  gpsfake can do
this itself now, so this script has a lot of dust on it. 

== tablegen.py

Generate most of the code required to support a message type from
AIVDM message layout tables.  Also, redo their bit offsets to be
conformant with field lengths.

== test_json_validity.py

Test a file full of lines containing GPSD-JSON reports to verify that each
line is in fact well-formed JSON.