Troubleshooting

pinpoint's help menu:

bash-3.2$ pinpoint -h
usage: pinpoint [-h] [--auto] [-v] [-f] [-l LOOKUP] [-k APIKEY] [-a ADDRESS]
                [-b] [-V]

This script will attempt to locate your mac.

optional arguments:
  -h, --help            show this help message and exit
  --auto                Used by the LaunchDaemon to find your mac in the
                        background.
  -v, --verbose         Increase verbosity level. Repeatable up to two times.
  -f, --force           Force the location lookup run disregarding last check
                        time.
  -l LOOKUP, --lookup LOOKUP
                        Override the configured lookup service.
  -k APIKEY, --apikey APIKEY
                        API key for the Google lookup service.
  -a ADDRESS, --address ADDRESS
                        Override the configured address lookup service.
  -b, --fallback        Fallback on other service if specified address/lookup
                        service fails
  -V, --version         Print script version

Verbose output

In most cases the warnings produced by this script in a normal run will provide enough information to determine what the issue is. However, if you are unsure why a lookup is failing the best way to get more information is with the verbose output option.

To see warnings and information statements use:

sudo /Library/Application\ Support/pinpoint/bin/pinpoint -v

To see a full output of warnings, information, and debug statements use:

sudo /Library/Application\ Support/pinpoint/bin/pinpoint -vv

Force Run

pinpoint has a built-in safety mechanism so location checks do not run too often. However for testing you will often want to override this check. The -f flag will force a lookup.

sudo /Library/Application\ Support/pinpoint/bin/pinpoint -f

Logging

pinpoint, as of v1.0.0, writes a high verbose log to a 'Logs' subdirectory inside of your CacheDir directory. The default file location is:

/Library/Application Support/pinpoint/Logs/pinpoint.log

This file will be automatically rotated so it does not grow larger than 5 MB in size.