Provided by: kismet_2008-05-R1-4build1_i386
gpsmap - Wireless sniffing and monitoring
gpsmap [-hviNIDVGMtbruapek] [-g config-file] [-o output-file]
[-f filter-list] [-F filter-type-list] [-z numthreads] [-S mapsource] [-c coords] [-s scale]
[-m usermap] [-d mapsize] [-n netcolors] [-O offset] [color-saturation] [map-intensity] [-R range-opacity] [feather-range] [-K bounds-opacity]
[-U hull-opacity] [-A scatter-opacity] [-B scatter-size] [feather-scatter]
[-P power-opacity] [-Q power-res] [-q power-colors] [-E center-opacity]
[-H center-size] [-l label-list] [-L label-orientation]
[-K legend-opacity] [-F feature-order]
GPSFile1 [GpsFile2 ... GpsFileN]
gpsmap reads GPS and Network XML datafiles and plots networks on
downloaded vector maps or satellite photos or user-supplied images.
-g, --config-file FILE
Use alternate config file FILE
-o, --output FILE
Image output file
-f, --filter LIST
Comma separated list of MACs to filter
Process only MACs specified in the filter list
-F, --typefilter LIST
Comma separated list of network types
(ap,adhoc,probe,turbocell,data,unknown) to filter
Process only MACs and types specified in the filter list
-z, --threads NUM
Spawn NUM threads for power interpolation calculations
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.
-S, --map-source 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
Keep downloaded GIF file
Version of GPSMap
USAGE (IMAGE OPTIONS)
-c, --coords LAT,LON
Force map center to LAT,LON instead of automatically calculated
-s, --scale SCALE
Force map scale of SCALE instead of automatically calculated
-m, --user-map MAP
Use custom map file instead of downloading one. If center and
scale are specified in the map title they will be used.
-d, --map-size X,Y
Download map at XSIZE,YSIZE. Default: 1280x1024
-n, --network-colors COLORS
Color networks by COLORS (0 = Random rotation; 1 = Color based
on WEP and factory default; 2 = Color based on network channel).
Don’t convert map to greyscale
Set background map image color saturation. 0 is greyscale, 100
is full normal colors.
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.
Download map with metric measurements (if possible)
-O, --offset XOFF,YOFF
Offset map by XOFF,YOFF pixels.
USAGE (DRAWING OPTIONS)
Draw travel track
-Y, --draw-track-width WIDTH
Travel track width. Default: 3
Draw network bounding box
-K, --draw-bounds-opacity OPACITY
Opacity to draw bounding boxes with. Default: 10
Draw estimated range circles
-R, --draw-range-opacity OPACITY
Opacity to draw range circles with. Default: 70
Feather the range circles out into transparency
Draw convex hull for each network
-U, --draw-hull-opacity OPACITY
Opacity to draw convex hull with. Default: 70
Draw scatter plot of data points
-A, --draw-scatter-opacity OPACITY
Scatter plot opacity Default: 100
Feather the edges of scatterplot circles. VERY SLOW.
-B, --draw-scatter-size SIZE
Draw scatter at radius size. Default: 2
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
Draw interpolated network power
-P, --draw-power-opacity OPACITY
Interpolated power opacity. Default: 70
-Q, --draw-power-res RES
Interpolated power resolution. Default: 5
-q, --draw-power-colors 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
Draw dot at center of network range
-E, --draw-center-opacity OPACITY
Center dot opacity. Default: 100
-H, --draw-center-size SIZE
Center dot at radius size. Default: 2
-l, --draw-labels LIST
Draw network label types, comma-seperated list. Labels are
drawn in the order given. Valid labels are bssid, ssid, info,
-L, --draw-label-orient ORIENT
Label orientation (0 upper left, 8 lower right) Default: 7
Draw map legend
-K, --draw-legend-opacity OPACITY
Legend opacity [Default: 90]
-F, --feature-order 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)
Draws a blue track along the traveled path, based on the track data
saved by Kismet.
Draws the bounding rectangle around the extreme points of each network.
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.
Convex hull of all sample points for each network. This will display
the exact detected range of the networks.
Draws a dot for every detected packet point.
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.
Simply draw a dot in the averaged center of each network
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.
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
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.
March 14, 2004 gpsmap(1)