.\" Text automatically generated by txt2man-1.4.5
.TH gpsmap 1 "March 14, 2004" "" ""
.SH NAME
\fBgpsmap \fP- Wireless sniffing and monitoring
\fB
.SH SYNOPSIS
.nf
.fam C
\fBgpsmap\fP [\fB-hviNIDVGMtbruapek\fP] [\fB-g\fP \fIconfig-file\fP] [\fB-o\fP \fIoutput-file\fP]
[\fB-f\fP \fIfilter-list\fP] [\fB-F\fP \fIfilter-type-list\fP] [\fB-z\fP \fInumthreads\fP] [\fB-S\fP \fImapsource\fP] [\fB-c\fP \fIcoords\fP] [\fB-s\fP \fIscale\fP]
[\fB-m\fP \fIusermap\fP] [\fB-d\fP \fImapsize\fP] [\fB-n\fP \fInetcolors\fP] [\fB-O\fP \fIoffset\fP] [\fIcolor-saturation\fP] [\fImap-intensity\fP] [\fB-R\fP \fIrange-opacity\fP] [\fIfeather-range\fP] [\fB-K\fP \fIbounds-opacity\fP]
[\fB-U\fP \fIhull-opacity\fP] [\fB-A\fP \fIscatter-opacity\fP] [\fB-B\fP \fIscatter-size\fP] [\fBfeather-scatter\fP]
[\fB-Z\fP \fIdraw-power-zoom\fI] 
[\fB-P\fP \fIpower-opacity\fP] [\fB-Q\fP \fIpower-res\fP] [\fB-q\fP \fIpower-colors\fP] [\fB-E\fP \fIcenter-opacity\fP]
[\fB-H\fP \fIcenter-size\fP] [\fB-l\fP \fIlabel-list\fP] [\fB-L\fP \fIlabel-orientation\fP]
[\fB-K\fP \fIlegend-opacity\fP] [\fB-F\fP \fIfeature-order\fP]
.PP
\fIGPSFile1\fP [\fIGpsFile2\fP \.\.\. \fIGpsFileN\fP]
.fam T
.fi
.SH DESCRIPTION
\fBgpsmap\fP reads GPS and Network XML datafiles and plots networks on downloaded 
vector maps or satellite photos or user-supplied images.
.SH USAGE
.TP
.B
\fB-h\fP, \fB--help\fP
Display usage
.TP
.B
\fB-v\fP, \fB--verbose\fP
Verbose output
.TP
.B
\fB-g\fP, --\fBconfig-file\fP FILE
Use alternate config file FILE
.TP
.B
\fB-o\fP, \fB--output\fP FILE
Image output file
.TP
.B
\fB-f\fP, \fB--filter\fP LIST
Comma separated list of MACs to filter
.TP
.B
\fB-i\fP, \fB--invert-filter\fP
Process only MACs specified in the filter list
.TP
.B
\fB-F\fP, \fB--typefilter\fP LIST
Comma separated list of network types (ap,adhoc,probe,turbocell,data,unknown) to filter
.TP
.B
\fB-I\fP, \fB--invert-typefilter\fP
Process only MACs and types  specified in the filter list
.TP
.B
\fB-z\fP, \fB--threads\fP NUM
Spawn NUM threads for power interpolation calculations
.TP
.B
\fB-N\fP, \fB--pure-avg-center\fP
Use old pure-average center to guess the center of a network by averaging all of the
sample points, instead of the new code which tries to find the most relevant cluster of
sample points.
.TP
.B
\fB-S\fP, \fB--map-source\fP SOURCE
Source to download maps from (-1 = Null; 0 = Mapblast; 1 = MapPoint(broken); 2 = Terraserver; 3 = Tiger Census; 4 = Earthamap; 5 = Terraserver Topographic).  Default: 4
.TP
.B
\fB-D\fP, \fB--keep-gif\fP
Keep downloaded GIF file
.TP
.B
\fB-V\fP, \fB--version\fP
Version of GPSMap
.SH USAGE (IMAGE OPTIONS)
.TP
.B
\fB-c\fP, --\fBcoords\fP LAT,LON
Force map center to LAT,LON instead of automatically calculated location
.TP
.B
\fB-s\fP, --\fBscale\fP SCALE
Force map \fIscale\fP of SCALE instead of automatically calculated \fIscale\fP
.TP
.B
\fB-m\fP, \fB--user-map\fP MAP
Use custom map file instead of downloading one.  If center and \fIscale\fP are specified in the map title they will be used.
.TP
.B
\fB-d\fP, \fB--map-size\fP X,Y
Download map at XSIZE,YSIZE.  Default: 1280x1024
.TP
.B
\fB-n\fP, \fB--network-colors\fP COLORS
Color networks by COLORS (0 = Random rotation; 1 = Color based on WEP and factory default; 2 = Color based on network channel).  Default: 0
.TP
.B
\fB-G\fP, \fB--no-greyscale\fP
Don't convert map to greyscale
.TP
.B
\fB--color-saturation\fP PERCENTAGE
Set background map image color saturation.  0 is greyscale, 100 is full normal colors.
.TP
.B
\fB--map-intensity\fP [-]PERCENTAGE
Set background map intensity.  Negative percentages cause the map to be layered over a black background, while 
positive percentages cause the map to be layered over a white background.
.TP
.B
\fB-M\fP, \fB--metric\fP
Download map with metric measurements (if possible)
.TP
.B
\fB-O\fP, --\fBoffset\fP XOFF,YOFF
Offset map by XOFF,YOFF pixels.
.SH USAGE (DRAWING OPTIONS)
.TP
.B
\fB-t\fP, \fB--draw-track\fP
Draw travel track
.TP
.B
\fB-Y\fP, \fB--draw-track-width\fP WIDTH
Travel track width.  Default: 3
.TP
.B
\fB-b\fP, \fB--draw-bounds\fP
Draw network bounding box
.TP
.B
\fB-K\fP, \fB--draw-bounds-opacity\fP OPACITY
Opacity to draw bounding boxes with.  Default: 10
.TP
.B
\fB-r\fP, \fB--draw-range\fP
Draw estimated range circles
.TP
.B
\fB-R\fP, \fB--draw\fP-\fBrange-opacity\fP OPACITY
Opacity to draw range circles with.  Default: 70
.TP
.B
\fB--feather-range\fP
Feather the range circles out into transparency
.TP
.B
\fB-u\fP, \fB--draw-hull\fP
Draw convex hull for each network
.TP
.B
\fB-U\fP, \fB--draw\fP-\fBhull-opacity\fP OPACITY
Opacity to draw convex hull with.  Default: 70
.TP
.B
\fB-a\fP, \fB--draw-scatter\fP
Draw scatter plot of data points
.TP
.B
\fB-A\fP, \fB--draw\fP-\fBscatter-opacity\fP OPACITY
Scatter plot opacity Default: 100
.TP
.B
\fB--feather-scatter\fP
Feather the edges of scatterplot circles.  VERY SLOW.
.TP
.B
\fB-B\fP, \fB--draw\fP-\fBscatter-size\fP SIZE
Draw scatter at radius size.  Default: 2
.TP
.B
\fB-Z\fP, \fB--draw-power-zoom\fP
Power based scatter plot range for scaling colors [Default: 0]
0 determines upper limit based on max observed for network
1-255 is user defined upper limit
.TP
.B
\fB-p\fP, \fB--draw-power\fP
Draw interpolated network power
.TP
.B
\fB-P\fP, \fB--draw\fP-\fBpower-opacity\fP OPACITY
Interpolated power opacity.  Default: 70
.TP
.B
\fB-Q\fP, \fB--draw\fP-\fBpower-res\fP RES
Interpolated power resolution.  Default: 5
.TP
.B
\fB-q\fP, \fB--draw\fP-\fBpower-colors\fP COLORS
Interpolated power color set. (0 is a ramp though RGB colorspace; 1 is the origional color set; 2 is weathermap radar style).  Default: 0
.TP
.B
\fB-e\fP, \fB--draw-center\fP
Draw dot at center of network range
.TP
.B
\fB-E\fP, \fB--draw\fP-\fBcenter-opacity\fP OPACITY
Center dot opacity. Default: 100
.TP
.B
\fB-H\fP, \fB--draw\fP-\fBcenter-size\fP SIZE
Center dot at radius size. Default: 2
.TP
.B
\fB-l\fP, \fB--draw-labels\fP LIST
Draw network label types, comma-seperated list.  Labels are drawn in the order given.
Valid labels are bssid, ssid, info, location, manuf.
.TP
.B
\fB-L\fP, \fB--draw-label-orient\fP ORIENT
Label orientation (0 upper left, 8 lower right) Default: 7
.TP
.B
\fB-k\fP, \fB--draw-legend\fP
Draw map legend
.TP
.B
\fB-K\fP, \fB--draw\fP-\fBlegend-opacity\fP OPACITY
Legend opacity [Default: 90]
.TP
.B
\fB-F\fP, --\fBfeature-order\fP ORDER
String representing the order map features are drawn. (p: interpolated power; t: tracks; b: bounds; r: range circles; h: convex hulls; s: scatter plot; c: center dot; l: labels) Default: 'ptbrhscl'.
.SH DRAWING METHODS
.SS        TRACK DRAWING
Draws a blue track along the traveled path, based on the track data saved by Kismet.
.SS        BOUNDING RECTANGLE
Draws the bounding rectangle around the extreme points of each network.
.SS        RANGE CIRCLE
Estimates the range of a network based on the average center and the distance 
to the closest extreme corner.
Not exact, but often useful for estimating the  
range of the network.
.SS        CONVEX HULL
Convex hull of all sample points for each network.
This will display the exact 
detected range of the networks.
.SS        SCATTER PLOT
Draws a dot for every detected packet point.
.SS        POWER INTERPOLATION
By far the most CPU intensive, power interpolation forms a grid over the image 
and attempts to interpolate the power for points that aren't directly sampled. 
For this graph to be a reasonable representation of reality, samples around 
the entire area, preferably forming a grid or mesh, should be taken.  
.SS        NETWORK CENTER
Simply draw a dot in the averaged center of each network
.SS        LABELS
Labels are drawn in the order requested in the list.
Labels are drawn based on the center of the network and the label orientation.
There is some logic to attempt to prevent label overlap, but on extremely crowded
maps it will be unavoidable.
.SS        LEGEND
Draws a legend on the bottom of the map with the coordinates, scale, total sampled
networks, networks visible on the current plot, and dynamic information based on the
plots selected and the network color methods requested.
.SH BUGS
While not technically a bug, source 1 (MapPoint) are nonfunctional. 
The vendors have changed their serivice in such a way that it is impossible to download 
the map images from them.  GPSMap still supports these sources, but ONLY for predownloaded 
images that may have been kept previously.  Attempts to use these sources when a user map
is not available will fail.
.SH SEE ALSO
\fBkismet\fP(1)
.SH AUTHOR
Mike Kershaw