1
ubuntu-location-service(1) -- A location service aggregating position/velocity/heading updates and exporting them over dbus.
2
============================================================================================================================
5
`ubuntu-location-service` `--bus` <bus> `--provider` <provider> [`--provider` <provider>] [provider specific options] [logging options]
8
A location service aggregating position/velocity/heading updates and exporting them over dbus.
11
These options control which bus the service is exposed upon and which providers are instantiated:
14
Specify the bus that the service should be exposed upon, valid values are "session" or "system".
16
* `--provider`=<provider>:
17
Specify the provider that should be instantiated and configured for this service instance.
18
Valid values are: geoclue::Provider, gps::Provider and skyhook::Provider.
20
These options control the behavior of the geoclue provider:
22
* `--geoclue::Provider::name`=<name>:
23
The name of the provider on the bus.
25
* `--geoclue::Provider::path`=<path>:
26
The object path of the provider on the bus.
28
These options control the behavior of the Skyhook provider:
30
* `--skyhook::Provider::username`=<username>:
31
Username for authenicating with the Skyhook service.
33
* `--skyhook::Provider::realm`=<realm>:
34
Realm for authenticating with the Skyhook service.
36
* `--skyhook::Provider::period`=<period>:
37
Delay between updates in [ms].
39
These options control the logging behavior of the service:
41
* `--logtostderr`=<boolean, default: false>:
42
Log messages to stderr instead of logfiles, defaults to false.
44
* `--stderrthreshold`=<threshold, default: 2>:
45
Copy log messages at or above this level to stderr in addition to logfiles. The numbers of severity levels INFO, WARNING, ERROR, and FATAL are 0, 1, 2, and 3, respectively. Defa
47
* `--minloglevel`=<level, default: 0>:
48
Log messages at or above this level. Again, the numbers of severity levels INFO, WARNING, ERROR, and FATAL are 0, 1, 2, and 3, respectively.
50
* `--log_dir`=<path, default: "">:
51
If specified, logfiles are written into this directory instead of the default logging directory.
53
* `--v`=<level, default: 0>:
54
Show all VLOG(m) messages for m less or equal the value of this flag.
58
Starting the service with a gps and a skyhook provider, exposing it on the system bus:
59
$ /usr/bin/ubuntu-location-service/examples/service
61
--provider gps::Provider
62
--provider skyhook::Provider
63
--skyhook::Provider::username=a_registered_user_name
64
--skyhook::Provider::realm=a_registered_realm
66
A slightly more verbose instance:
67
$ /usr/bin/ubuntu-location-service/examples/service
69
--provider gps::Provider
70
--provider skyhook::Provider
71
--skyhook::Provider::username=a_registered_user_name
72
--skyhook::Provider::realm=a_registered_realm
78
Ubuntu Location Service is Copyright (C) 2013 Canonical Ltd.