### WhatRoute Help

## Preferences

WhatRoute offers two preference panes in its Preferences window.

General provides settings that affect the application behaviour in all its windows.
Trace and Ping provides settings for the Trace and Ping commands as well as configuration of the geolocation engine.
Map Settings provides settings map specific properties and also allows setting of flow colours.

The descriptions I have provided in this document are brief. Many of the settings are self explanatory but if you need further explanation, please contact bryan@bryanc.co.nz

### General

Check for Updates
Get notified when a new release of WhatRoute is available for download and installation.

Launch at Login
Start WhatRoute automatically when logging in to your computer.

Show WhatRoute in menu bar
Add a menubar display of current input and output network bandworth. Alternatively, just display the WhatRoute icon.
The drop down menu allows control of the interface being monitored.

Resume monitor(s) when window(s) open
The Flow Monitor and Bandwidth Monitor windows will immediately begin recording data when opened.

Fetch External IP
If you are behind a NAT firewall/gateway, your LAN address is not exposed to the internet. It is translated to and address (usually) supplied by your ISP. WhatRoute will send a small request to a known internet site to determine this address, which is then feed into the geolocation engine to determine your location for presentation on the map.

LAN Discovery
Ping all IP addresses in the active interface subnet when the Local Network window first opens.

Check Bogons
A bogon is an IP address that cannot be routed on the internet. These addresses cannot have a specific location as they may be used in many private network setups. If this option is checked any bogon addresses are not submitted to the geolocation engine.

DNS timeout
The Domain Name service (DNS) converts numeric IP addresses to familiar names and also performs the reverse function when required. If a response from the DNS is not received within the timeout period, WhatRoute will abandon the request.
To reduce the amount of network traffic involved in querying the DNS, WhatRoute caches results for 5 minutes. This cache can be cleared (forcing a new lookup if requested) by clicking the Flush DNS Cache button.

### Trace and Ping

Geo Location
To convert IP addresses to locations on the map, WhatRoute consults data supplied by Maxmind (http://maxmind.com). This data may either be downloaded to your computer or alternatively, a network server can be queried to resolve locations.

You can choose to only update the data on demand, or to have it automatically updated on a weekly or monthly basis.

The Refresh button can be used to force an update of locally held data.

Network masks can be used to coalesce the results for individual IP addresses into geographic regions.

More detailed views of a location may be provided by the mapping services.
See WhatRoute Map Viewer for details of the internal detailed map viewer.

Use Location Services uses Apple location software to determine the location of your machine, overriding the location provided by IP address queries to the MaxMind geolocation engine.
See Location Services for details of how WhatRoute uses these services.

Traceroute
These settings provide parameters to the Trace function.

Offset to timing results modifies the way in which results are displayed in the output pane of the Trace window. If this offset is enabled the results of the traceroute will start on a new line, indented by the specified offset. This is useful if you wish to constrain the data to fit within say an 80 character wide window.

Ping and Network Scan
These settings provide parameters to the ping engine built in to WhatRoute.

### Map Settings

Show Routes display Traceroute paths on the map.

Show Flows display Flow paths on the map.

Line width adjust the width of paths on the map.

b/w scaling make paths thicker (or thinner) depending on the bandwidth consumed.

Accuracy regions show a circle with radius of the Maxmind data accuracy. The slider will adjust the transparency of the circle.

Colours define the colours used by the Map and also by the Flow Usage treemap.

Copyright © 2016 - 2017 B.R. Christianson (bryan@whatroute.net)