GPS Manager User Manual -- Installation

|  |  | Installation

## Installation

In Unix and Linux systems access to the serial port is restricted. This means that either there is a program to lock the port with super-user privileges, or the permissions of the port are changed to give read/write access to a group of users or to all users. The latter is dangerous in that it creates security problems. In any case super-user privileges are needed to install the software or to give access to the serial port group.

### Debian and Slackware packages

The installation is done as with other such packages and there is no need for configuration. Users of GPSMan must belong to the group that owns the serial port to be used (normally `dialout`).

The program is launched by calling `gpsman` that may have as single argument the path to the serial port device.

### Other Unix and Linux systems

After unpacking the files, using `tar xzvf gpsman-5.4.2.tgz`, the GPSMan main file, `gpsman.tcl`, should be edited for configuration (see below) and put where it can be executed. The other GPSMan files should go into the directory whose path is given in the beginning of `gpsman.tcl`.

The package includes a file `gpsman.sh` in the `util` directory that is a shell script to call `gpsman.tcl` with no need to give the serial port as argument. This file should be edited for configuration and placed where its can be executed.

A directory `aux` is created that contains the source of utilities to lock and set the serial port. These utilities, that need the `liblockdev` library, must be run with super-user privileges. One is `gpsman` that tries to lock the serial port and calls the Tcl/Tk program `gpsman.tcl` passing the path of the serial port to it as an argument. The other one is `gpsman-config` that sets the path of the serial port to be used. This path is stored in the file `/etc/gpsman`.

### Other systems

After unpacking the `gpsman-5.4.2.zip` archive the GPSMan main file, `gpsman.tcl`, should be edited for configuration (see below) and put where it can be executed. The other GPSMan files should go into the directory whose path is given in the beginning of `gpsman.tcl`.

|  |  | Installation