1gpsmap(1) gpsmap(1)
2
6 gpsmap - Wireless sniffing and monitoring
7
9 gpsmap [-hviNIDVGMtbruapek] [-g config-file] [-o output-file]
10 [-f filter-list] [-F filter-type-list] [-z numthreads] [-S mapsource] [-c coords] [-s scale]
11 [-m usermap] [-d mapsize] [-n netcolors] [-O offset] [color-saturation] [map-intensity] [-R range-opacity] [feather-range] [-K bounds-opacity]
12 [-U hull-opacity] [-A scatter-opacity] [-B scatter-size] [feather-scatter]
13 [-Z draw-power-zoom]
14 [-P power-opacity] [-Q power-res] [-q power-colors] [-E center-opacity]
15 [-H center-size] [-l label-list] [-L label-orientation]
16 [-K legend-opacity] [-F feature-order]
17 GPSFile1 [GpsFile2 ... GpsFileN]
19
21 gpsmap reads GPS and Network XML datafiles and plots networks on down‐
22 loaded vector maps or satellite photos or user-supplied images.
23
25 -h, --help
26 Display usage
27 -v, --verbose
29 Verbose output
30 -g, --config-file FILE
32 Use alternate config file FILE
33 -o, --output FILE
35 Image output file
36 -f, --filter LIST
38 Comma separated list of MACs to filter
39 -i, --invert-filter
41 Process only MACs specified in the filter list
42 -F, --typefilter LIST
44 Comma separated list of network types (ap,adhoc,probe,turbo‐
45 cell,data,unknown) to filter
46 -I, --invert-typefilter
48 Process only MACs and types specified in the filter list
49 -z, --threads NUM
51 Spawn NUM threads for power interpolation calculations
52 -N, --pure-avg-center
54 Use old pure-average center to guess the center of a network by
55 averaging all of the sample points, instead of the new code
56 which tries to find the most relevant cluster of sample points.
57 -S, --map-source SOURCE
59 Source to download maps from (-1 = Null; 0 = Mapblast; 1 = Map‐
60 Point(broken); 2 = Terraserver; 3 = Tiger Census; 4 = Earthamap;
61 5 = Terraserver Topographic). Default: 4
62 -D, --keep-gif
64 Keep downloaded GIF file
65 -V, --version
67 Version of GPSMap
68
70 -c, --coords LAT,LON
71 Force map center to LAT,LON instead of automatically calculated
72 location
73 -s, --scale SCALE
75 Force map scale of SCALE instead of automatically calculated
76 scale
77 -m, --user-map MAP
79 Use custom map file instead of downloading one. If center and
80 scale are specified in the map title they will be used.
81 -d, --map-size X,Y
83 Download map at XSIZE,YSIZE. Default: 1280x1024
84 -n, --network-colors COLORS
86 Color networks by COLORS (0 = Random rotation; 1 = Color based
87 on WEP and factory default; 2 = Color based on network channel).
88 Default: 0
89 -G, --no-greyscale
91 Don't convert map to greyscale
92 --color-saturation PERCENTAGE
94 Set background map image color saturation. 0 is greyscale, 100
95 is full normal colors.
96 --map-intensity [-]PERCENTAGE
98 Set background map intensity. Negative percentages cause the
99 map to be layered over a black background, while positive per‐
100 centages cause the map to be layered over a white background.
101 -M, --metric
103 Download map with metric measurements (if possible)
104 -O, --offset XOFF,YOFF
106 Offset map by XOFF,YOFF pixels.
107
109 -t, --draw-track
110 Draw travel track
111 -Y, --draw-track-width WIDTH
113 Travel track width. Default: 3
114 -b, --draw-bounds
116 Draw network bounding box
117 -K, --draw-bounds-opacity OPACITY
119 Opacity to draw bounding boxes with. Default: 10
120 -r, --draw-range
122 Draw estimated range circles
123 -R, --draw-range-opacity OPACITY
125 Opacity to draw range circles with. Default: 70
126 --feather-range
128 Feather the range circles out into transparency
129 -u, --draw-hull
131 Draw convex hull for each network
132 -U, --draw-hull-opacity OPACITY
134 Opacity to draw convex hull with. Default: 70
135 -a, --draw-scatter
137 Draw scatter plot of data points
138 -A, --draw-scatter-opacity OPACITY
140 Scatter plot opacity Default: 100
141 --feather-scatter
143 Feather the edges of scatterplot circles. VERY SLOW.
144 -B, --draw-scatter-size SIZE
146 Draw scatter at radius size. Default: 2
147 -Z, --draw-power-zoom
149 Power based scatter plot range for scaling colors [Default: 0] 0
150 determines upper limit based on max observed for network 1-255
151 is user defined upper limit
152 -p, --draw-power
154 Draw interpolated network power
155 -P, --draw-power-opacity OPACITY
157 Interpolated power opacity. Default: 70
158 -Q, --draw-power-res RES
160 Interpolated power resolution. Default: 5
161 -q, --draw-power-colors COLORS
163 Interpolated power color set. (0 is a ramp though RGB col‐
164 orspace; 1 is the origional color set; 2 is weathermap radar
165 style). Default: 0
166 -e, --draw-center
168 Draw dot at center of network range
169 -E, --draw-center-opacity OPACITY
171 Center dot opacity. Default: 100
172 -H, --draw-center-size SIZE
174 Center dot at radius size. Default: 2
175 -l, --draw-labels LIST
177 Draw network label types, comma-seperated list. Labels are
178 drawn in the order given. Valid labels are bssid, ssid, info,
179 location, manuf.
180 -L, --draw-label-orient ORIENT
182 Label orientation (0 upper left, 8 lower right) Default: 7
183 -k, --draw-legend
185 Draw map legend
186 -K, --draw-legend-opacity OPACITY
188 Legend opacity [Default: 90]
189 -F, --feature-order ORDER
191 String representing the order map features are drawn. (p: inter‐
192 polated power; t: tracks; b: bounds; r: range circles; h: convex
193 hulls; s: scatter plot; c: center dot; l: labels) Default:
194 'ptbrhscl'.
195
197 TRACK DRAWING
198 Draws a blue track along the traveled path, based on the track data
199 saved by Kismet.
200 BOUNDING RECTANGLE
202 Draws the bounding rectangle around the extreme points of each network.
203 RANGE CIRCLE
205 Estimates the range of a network based on the average center and the
206 distance to the closest extreme corner. Not exact, but often useful
207 for estimating the range of the network.
208 CONVEX HULL
210 Convex hull of all sample points for each network. This will display
211 the exact detected range of the networks.
212 SCATTER PLOT
214 Draws a dot for every detected packet point.
215 POWER INTERPOLATION
217 By far the most CPU intensive, power interpolation forms a grid over
218 the image and attempts to interpolate the power for points that aren't
219 directly sampled. For this graph to be a reasonable representation of
220 reality, samples around the entire area, preferably forming a grid or
221 mesh, should be taken.
222 NETWORK CENTER
224 Simply draw a dot in the averaged center of each network
225 LABELS
227 Labels are drawn in the order requested in the list. Labels are drawn
228 based on the center of the network and the label orientation. There is
229 some logic to attempt to prevent label overlap, but on extremely
230 crowded maps it will be unavoidable.
231 LEGEND
233 Draws a legend on the bottom of the map with the coordinates, scale,
234 total sampled networks, networks visible on the current plot, and
235 dynamic information based on the plots selected and the network color
236 methods requested.
237
239 While not technically a bug, source 1 (MapPoint) are nonfunctional.
240 The vendors have changed their serivice in such a way that it is impos‐
241 sible to download the map images from them. GPSMap still supports
242 these sources, but ONLY for predownloaded images that may have been
243 kept previously. Attempts to use these sources when a user map is not
244 available will fail.
245
247 kismet(1)
248
250 Mike Kershaw
251 March 14, 2004 gpsmap(1)