.\"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 "GPSFAKE" 1 "" "" ""
.SH NAME
gpsfake \- test harness for gpsd, simulating a GPS
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 8
\fBgpsfake\fR [\-h] [\-b] [\-c\ \fIinterval\fR] [\-i] [\-D\ \fIdebuglevel\fR] [\-l] [\-m\ \fImonitor\fR] [\-o\ \fIoptions\fR] [\-p] [\-s\ \fIspeed\fR] [\fIlogfile\fR]
.ad
.hy

.SH "DESCRIPTION"

.PP
gpsfake is a test harness for gpsd and its clients\&. It opens a pty (pseudo\-TTY), launches a gpsd instance that thinks the slave side of the pty is its GPS device, and repeatedly feeds the contents of a test logfile through the master side to the GPS\&.

.PP
gpsfake does not require root privileges, and can be run concurrently with a production gpsd instance without causing problems\&.

.PP
The logfile may be of NMEA, SiRF\-II packets, or Zodiac packets\&. Leading lines beginning with # will be treated as comments and ignored\&.

.PP
The gpsd instance is run in foreground\&. The thread sending fake GPS data to the daemon is run in background\&.

.SH "OPTIONS"

.PP
The \-b option enables a twirling\-baton progress indicator on standard error\&. At termination, it reports elaped time\&.

.PP
The \-c option sets the delay between sentences in seconds\&. Fractional values of seconds are legal\&.

.PP
The \-l option makes the program dump a line or packet number just before each sentence is fed to the daemon\&. If the sentence is textual (e\&.g\&. NMEA, the text is dumped as well)\&.

.PP
The \-i option is for single\-stepping through logfiles\&. It dumps the line or packet number (and the sentence if the protocol is textual) followed by "? "\&. Only when the user keys Enter is the line actually fed to gpsd\&.

.PP
The \-m option specifies a monitor program inside which the daemon should be run\&. This option is intended to be used with \fBvalgrind\fR(1), \fBgdb\fR(1) and similar programs\&.

.PP
The \-o option specifies options to pass to the daemon\&. Passing "\-n" is often useful\&. The \-D option passes a \-D option to the daemon: thus \-D 4 is shorthand for \-o "\-D 4"\&.

.PP
The \-p option dumps the NMEA and GPSD notifications generated by the log to standard output\&. The logfile is interpreted once only\&. (This option is intended to facilitate regression testing\&.)

.PP
The \-s option sets the baud rate for the slave tty\&. The default is 4800\&.

.PP
The \-h option makes gpsfake print a usage message and exit\&.

.PP
The argument must be the name of a file containing the data to be cycled at the device\&. gpsfake will print a notification each time it cycles\&.

.SH "CUSTOM TESTS"

.PP
gpsfake is a trivial wrapper around a Python module, also named gpsfake, that can be used to fully script sessions involving a gpsd instance, any number of client sessions, and any number of fake GPSes feeding the daemon instance with data from specified sentence logs\&.

.PP
Source and embedded documentation for this module is shipped with the gpsd development tools\&. You can use it to torture\-test either gpsd itself or any gpsd\-aware client application\&.

.SH "SEE ALSO"

.PP
 \fBgpsd\fR(8), \fBxgps\fR(1), \fBlibgps\fR(3), \fBlibgpsd\fR(3), \fBgpsprof\fR(1), \fBgnuplot\fR(1)\&.

.SH "AUTHOR"

.PP
Eric S\&. Raymond <esr@thyrsus\&.com>\&. There is a project page for gpsd  here: \fIhttp://gpsd.berlios.de/\fR\&.