Provided by: gpsd-clients_2.30-1ubuntu3_i386 bug

NAME

       xgps, xgpsspeed, cgps - test clients for gpsd

SYNOPSIS

       xgps [X-options] [-h] [-v] [-speedunits {mph | kph | knots}]
            [-altunits {feet | meters}] [-l [d | m | s]] [server [:port
            [:device]]]

       xgpsspeed [-rv] [X-options] [-h] [-v] [-nc X-color]
                 [-speedunits {mph | kph | knots}] [server [:port [:device]]]

       cgps [-h] [-v] [-speedunits {mph | kph | knots}]
            [-altunits {feet | meters}] [-l [d | m | s]] [server [:port
            [:device]]]

DESCRIPTION

   xgps
       xgps is a simple test client for gpsd with an X interface. It  displays
       current  GPS  position/time/velocity  information  and  (for GPSes that
       support the feature) the locations of accessible satellites.

       xgps accepts an -h option as for gpsd, or  a  -v  option  to  dump  the
       package version and exit.

       An  optional  argument  may  specify  a  server  to  get  data  from; a
       colon-separated suffix is taken as a port number. If there is a  second
       colon-separated  suffix, that is taken as a device name to be handed to
       the daemon in an F= command.

       The -speedunits option can be used to set the speed units for  display;
       follow  the  keyword  with  knots  for nautical miles per hour, kph for
       kilometres per hour, or mph for miles per hour. The  default  is  miles
       per hour. This option can also be set as the X resource ’speedunits’.

       The -altunits option can be used to set the altitude units for display;
       follow the keyword with ’meters’ or ’feet’. The default is  feet.  This
       option can also be set as the X resource ’altunits’.

       The  -l  option  sets the format of latitude and longitude reports. The
       value ’d’ produces decimal degrees and is the default.  The  value  ’m’
       produces  degrees  and decimal minutes. The value ’s’ produces degrees,
       minutes, and decimal seconds.

       There is a known bug in xgps; it assumes the default font  size  is  no
       more  than  18  pixels.  If  this  is  not the case, the satellite data
       display will show fewer than 12 satellites.

   xgpsspeed
       xgpsspeed is a speedometer that uses position information from the GPS.
       It  accepts  an  -h  option  and  optional argument as for gps, or a -v
       option to dump the package version and exit. Additionally,  it  accepts
       -rv (reverse video) and -nc (needle color) options.

       The  -speedunits option can be used to set the speed units for display;
       follow the keyword with knots for nautical  miles  per  hour,  kph  for
       kilometres  per  hour,  or mph for miles per hour. The default is miles
       per hour. This option can also be set as the X resource ’speedunits’.

   cgps
       cgps is a client resembling xgps, but without the  pictorial  satellite
       display and able to run on a serial terminal or terminal emulator.

       Rather  than use X resources to detemine which units to use, cgps looks
       at variables in its environment. Here are the variables and  values  it
       checks:

                  GPSD_UNITS one of:
                            imperial   = miles/feet
                            nautical   = knots/feet
                            metric     = km/meters
                  LC_MEASUREMENT            en_US      = miles/feet
                            C          = miles/feet
                            POSIX      = miles/feet
                            [other]    = km/meters
                  LANG            en_US      = miles/feet
                            C          = miles/feet
                            POSIX      = miles/feet
                            [other]    = km/meters

       cgps  terminates  when  you  send  it a SIGHUP or SIGINT; given default
       terminal settings this will happen when you type Ctl-C at it.  It  will
       also terminate on ’q’

SEE ALSO

        gpsd(8), libgps(3), libgpsd(3), gpsprof(1), gpsfake(1).

AUTHORS

       Remco  Treffcorn,  Derrick Brashear, Russ Nelson, Eric S. Raymond. This
       manual page by Eric S. Raymond <esr@thyrsus.com>. There  is  a  project
       page, with xgps screenshots, here: http://gpsd.berlios.de/.

                                                                       XGPS(1)