Ubuntu Manpage: gpsman - a (graphical) manager of GPS data

NAME

       gpsman - a (graphical) manager of GPS data

SYNOPSIS

       gpsman [-dev [usb=]DEVICE]
       gpsman [OPTIONS] COMMAND [COMMAND_ARGS]

DESCRIPTION

       gpsman  GPS  Manager  (GPSMan)  is  a  graphical manager of GPS data that makes possible the preparation,
       inspection and edition of GPS data in a friendly environment. GPSMan supports communication and real-time
       logging with Garmin, Lowrance and Magellan receivers and accepts real-time logging  information  in  NMEA
       0183 from any GPS receiver.

       To  comunicate  with  the  GPS  port  the  user  must  have  been  granted read/write permissions for the
       corresponding device.

       For use in graphical mode GPSMan is normally invoked in the first form above, where the  usb=  prefix  to
       the  device  path  enforces  the  use  of  the  Garmin  USB protocol. The use in this mode is not further
       described here, a full description being given in  the  User  Manual  available  along  with  the  GPSMan
       distribution.

       GPSMan  can  also be used in command line mode (with no graphical interface except with the readand start
       travel commands), in which case it must be invoked in the second form above. The sections  below  address
       this mode.

EXIT STATUS

       In  non-graphical  mode GPSMan exits with either a 0 if COMMAND was successfully executed, or a 1 if not.
       Some commands will write information to the standard output  channel.  Error  messages  can  possibly  be
       written to the standard error channel, but most of the errors will not be explained. In case of doubt the
       graphical mode should be used to see if there are problems with files or the receiver.

OPTIONS

       Apart from the -dev option all other options are only for use in non-graphical mode.

       -dev DEVICE gives the device path.

       -log creates a log file of the low-level communication
              under the name logfile in the GPSMan user directory.

       -rec Garmin | Lowrance | Magellan
              changes  the  brand of the receiver (NOTE: at present will only work with Garmin); this option can
              be useful to override the options in the  preferences  file;  cannot  be  used  with  the  readput
              command, nor with the -prefs option, and cannot occur after the -prot option.

       -prefs PREFSFILE
              gives  the path for an alternative preferences file (read after the user preferences file); cannot
              be used with the -rec option.

       -prot PROTOCOL
              selects the protocol to be used for connecting to the  receiver;  cannot  occur  before  the  -rec
              option; the show protocols command can be used to find out which protocols are available.

       Options not related with COMMAND will be silently ignored.

NAME=VALUE ARGUMENTS

       Some  commands  accept  parameters  in  the  form  NAME=VALUE. The term PARAM when used here referring to
       arguments of a command has always this meaning. Care should be taken if the value part is a  string  with
       spaces  (or  other  characters with special meaning for the shell or system command interpreter) in which
       case quotes or some other form of quoting should be used.

GPSMAN COMMAND SUMMARY

       There is no room in a manual page to describe in detail the available commands. The following list  gives
       a synopsis for all of them and the User Manual should be consulted for more information.

       is available exits with 0.

       is connected
              exits with 0 if a connection check with the receiver succeeds.

       show WHAT writes help information to the standard output; WHAT is one of: datums, formats (data file
       formats), help, projections, protocols, symbols (waypoint symbols), transfs (coordinates
       transformations).

       haslib LIBRARY checks availability of a library

       getwrite INTYPES FORMAT [OUTTYPES] [OUTPARAMS] PATH transfers data from the receiver to a file.

       readput FORMAT [INPARAMS] [INTYPES] PATH [OUTTYPES] transfers data from a file to the receiver.

       getrtimelog PATH [INTERVAL] gets the real-time log from the receiver and saves it to a file.

       getfix PATH [TIMEOUT] gets the current fix data from the receiver and saves it to a file.

       getalmanac PATH gets the current almanac data from the receiver and saves it to a file.

       read IN-FORMAT [PARAMS] [TYPES] PATH reads a data file and launches the graphical interface (in GPSMan
       scripts the behaviour is different; see the exec command in the User Manual).

       start travel [INTERVAL] launches the graphical interface and starts real-time logging, animation and
       travelling.

       translate FORMAT [INPARAMS] [INTYPES] PATH [HOWPARAMS] FORMAT [OUTPARAMS] [OUTTYPES] PATH translates from
       a file format to another.

       project LATD LONGD DATUM PROJECTION [PARAMS] writes to the standard output the projection of a point.

       georef IMGPATH TRANSF LATD LONGD LATD LONGD [LATD LONGD] DATUM X Y X Y [X Y] PROJECTION [PARAMS] writes
       to the standard output a map information file.

       geopicts FORMAT [INPARAMS] INTYPE PATH [PROCPARAMS] [FORMAT] [OUTPARAMS] PATH PICTPATHS geo-references
       files either based on their time-stamps and a given track, or by using the sequence of waypoints in a
       group.

       source PATH executes a Tcl/Tk script.

       exec PATH executes a GPSMan script.

AUTHORS

       This  manual  page  was written by Miguel Filgueiras <migfilg_AT_t-online.de> using a previous version by
       Rogerio Reis <rvr_AT_debian.org>.

       GPSMan: developed and maintained by Miguel Filgueiras, with contributions by Brian Baulch, Rogerio  Reis,
       Andreas  Lange,  Alessandro  Palmas,  Niki  Hammler, Martin Ostermann, Valere Robin, David Wolfskill, Rob
       Buitenhuis, Frank Kujawski, Tri Agus Prayitno, Matt Martin, Stefan Heinen,  Heiko  Thede,  Sabine  Broda,
       Alberto  Morales,  Martin  Buck,  David  Kaplan,  Jean H. Theoret, Paul Scorer, Nigel Orr, David Gardner,
       Nikolai Kosyakoff, Benoit Steiner, Sandor Laky, Alexander B. Preobrazhenskiy, Rudolf Martin.

REPORTING BUGS

       Report bugs to <migfilg_AT_t-online.de>.

COPYRIGHT

       Copyright   (C)   1998-2013   by   Miguel   Filgueiras   <migfilg_AT_t-online.de>   and   Rogerio    Reis
       <rvr_AT_debian.org>

       This is free software distributed under the GNU General Public License; a copy of this license is part of
       the distribution.

       The  two  GPSMan  logos  used  by  gpsman  ara under Copyright (C) 1998-2013 by Miguel Filgueiras and are
       distributed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License. To  view  a
       copy of this license, visit
        http://creativecommons.org/licenses/by-nc-nd/3.0/.

       All  other  images  used  by  gpsman  ara  under  Copyright  (C)  1998-2013  by Miguel Filgueiras and are
       distributed under a Creative Commons Attribution-ShareAlike 3.0 Unported License. To view a copy of  this
       license, visit http://creativecommons.org/licenses/by-sa/3.0/.

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

NAME=VALUE ARGUMENTS

GPSMAN COMMAND SUMMARY

AUTHORS

REPORTING BUGS

COPYRIGHT

SEE ALSO