summaryrefslogtreecommitdiff
path: root/rtcmdecode.1
diff options
context:
space:
mode:
authorEric S. Raymond <esr@thyrsus.com>2005-07-20 16:04:52 +0000
committerEric S. Raymond <esr@thyrsus.com>2005-07-20 16:04:52 +0000
commitb5fa2f599470073d279ac70d346b709c62114a3e (patch)
treedf1bc77d9203d8736d12931c15a528e88941f94c /rtcmdecode.1
parentfc2548d0076011f1f175f93c5cb32e6179767593 (diff)
downloadgpsd-b5fa2f599470073d279ac70d346b709c62114a3e.tar.gz
Ugh. Manual pages have to be in the repo in order for xmlto not to be required.
Diffstat (limited to 'rtcmdecode.1')
-rw-r--r--rtcmdecode.169
1 files changed, 69 insertions, 0 deletions
diff --git a/rtcmdecode.1 b/rtcmdecode.1
new file mode 100644
index 00000000..667e26b0
--- /dev/null
+++ b/rtcmdecode.1
@@ -0,0 +1,69 @@
+.\"Generated by db2man.xsl. Don't modify this, modify the source.
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "RTCMDECODE" 1 "" "" ""
+.SH NAME
+rtcmdecode \- decode RTCM104 streams into a readable format
+.SH "SYNOPSIS"
+.ad l
+.hy 0
+.HP 11
+\fBrtcmdecode\fR [\-v\ \fIdebuglevel\fR]
+.ad
+.hy
+
+.SH "DESCRIPTION"
+
+.PP
+This tool is a decoder for RTCM\-104, an obscure and complicated serial protocol used for broadcasting pseudorange corrections from differential\-GPS reference stations\&. RTCM\-104 is expected on standard input; an equivalent, 100%\-information\-preserving text format is written to standard output\&.
+
+.PP
+You can use this tool with \fBnc\fR(1) to examine RTCM feeds from DGPSIP servers\&.
+
+.PP
+The decoder dump format is described in \fBrtcm\fR(5); these lines go to standard output\&. As well as data the decoder also prints decoder status messages to standard error, as necessary\&.
+
+.SH "OPTIONS"
+
+.PP
+The \-v option sets a verbosity level\&. It is mainly of interest to developers\&.
+
+.SH "SEE ALSO"
+
+.PP
+ \fBgpsd\fR(8), \fBxgps\fR(1), \fBlibgps\fR(3), \fBlibgpsd\fR(3), \fBgpsprof\fR(1), \fBgnuplot\fR(1), \fBgpsfake\fR(1), \fBrtcm\fR(5)\&.
+
+.SH "APPLICABLE STANDARDS"
+
+.PP
+The applicable standard is RTCM Recommended Standards for Differential NAVSTAR GPS Service RTCM Paper 194\-93/SC 104\-STD\&.
+
+.PP
+Ordering instructions are accessible from the website of the Radio Technical Commission for Maritime Services: \fIhttp://www.rtcm.org/\fR under "Publications"\&.
+
+.SH "BUGS"
+
+.PP
+This program will fail quietly, never achieving sync lock with the RTCM stream, on a non\-little\-endian machine\&. The decoder logic is sufficiently convoluted to confuse some compiler optimizers, notably in GCC 3\&.x at \-O2, into generating bad code\&.
+
+.SH "AUTHOR"
+
+.PP
+Eric S\&. Raymond <esr@thyrsus\&.com>\&. This is a somewhat hacked version of an RTCM decoder originally written by Wolfgang Rupprecht\&. There is a project page for gpsd here: \fIhttp://gpsd.berlios.de/\fR\&.
+