Provided by: kismet_2008-05-R1-4.3build1_amd64 bug

NAME

       gpsmap - Wireless sniffing and monitoring

SYNOPSIS

       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]
       [-Z draw-power-zoom]
       [-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]

DESCRIPTION

       gpsmap reads GPS and Network XML datafiles and plots networks on downloaded vector maps or
       satellite photos or user-supplied images.

USAGE

       -h, --help
              Display usage

       -v, --verbose
              Verbose output

       -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

       -i, --invert-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

       -I, --invert-typefilter
              Process only MACs and types  specified in the filter list

       -z, --threads NUM
              Spawn NUM threads for power interpolation calculations

       -N, --pure-avg-center
              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

       -D, --keep-gif
              Keep downloaded GIF file

       -V, --version
              Version of GPSMap

USAGE (IMAGE OPTIONS)

       -c, --coords LAT,LON
              Force map center to LAT,LON instead of automatically calculated location

       -s, --scale SCALE
              Force map scale of SCALE instead of automatically calculated scale

       -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).  Default: 0

       -G, --no-greyscale
              Don't convert map to greyscale

       --color-saturation PERCENTAGE
              Set  background  map  image  color  saturation.  0 is greyscale, 100 is full normal
              colors.

       --map-intensity [-]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.

       -M, --metric
              Download map with metric measurements (if possible)

       -O, --offset XOFF,YOFF
              Offset map by XOFF,YOFF pixels.

USAGE (DRAWING OPTIONS)

       -t, --draw-track
              Draw travel track

       -Y, --draw-track-width WIDTH
              Travel track width.  Default: 3

       -b, --draw-bounds
              Draw network bounding box

       -K, --draw-bounds-opacity OPACITY
              Opacity to draw bounding boxes with.  Default: 10

       -r, --draw-range
              Draw estimated range circles

       -R, --draw-range-opacity OPACITY
              Opacity to draw range circles with.  Default: 70

       --feather-range
              Feather the range circles out into transparency

       -u, --draw-hull
              Draw convex hull for each network

       -U, --draw-hull-opacity OPACITY
              Opacity to draw convex hull with.  Default: 70

       -a, --draw-scatter
              Draw scatter plot of data points

       -A, --draw-scatter-opacity OPACITY
              Scatter plot opacity Default: 100

       --feather-scatter
              Feather the edges of scatterplot circles.  VERY SLOW.

       -B, --draw-scatter-size SIZE
              Draw scatter at radius size.  Default: 2

       -Z, --draw-power-zoom
              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

       -p, --draw-power
              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

       -e, --draw-center
              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, location, manuf.

       -L, --draw-label-orient ORIENT
              Label orientation (0 upper left, 8 lower right) Default: 7

       -k, --draw-legend
              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) Default: 'ptbrhscl'.

DRAWING METHODS

   TRACK DRAWING
       Draws a blue track along the traveled path, based on the track data saved by Kismet.

   BOUNDING RECTANGLE
       Draws the bounding rectangle around the extreme points of each network.

   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.

   CONVEX HULL
       Convex  hull  of all sample points for each network.  This will display the exact detected
       range of the networks.

   SCATTER PLOT
       Draws a dot for every detected packet point.

   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.

   NETWORK CENTER
       Simply draw a dot in the averaged center of each network

   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.

   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.

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.

SEE ALSO

       kismet(1)

AUTHOR

       Mike Kershaw

                                          March 14, 2004                                gpsmap(1)