1GEOCLUE CONFIGURATION(5)      File Formats Manual     GEOCLUE CONFIGURATION(5)
2
3
4

NAME

6       geoclue.conf - geoclue configuration parameters
7

SYNOPSIS

9       /etc/geoclue/geoclue.conf
10

DESCRIPTION

12       The  geoclue  geoclue.conf configuration file specifies parameters that
13       control the operation of geoclue.
14
15       All configurations settings below are mandatory and  the  defaults  are
16       what  you see before you edit them in geoclue.conf. If you want to keep
17       the default values around, copy and comment out the appropriate line(s)
18       before changing them.
19

AGENT CONFIGURATION OPTIONS

21       [agent] is used to begin the agent configuration.
22
23       whitelist
24              Whitelist  of  desktop IDs (without .desktop part) of all agents
25              we recognise, separated by a ';'.
26
27              whitelist=geoclue-demo-agent;gnome-shell;io.elementary.desk‐
28              top.agent-geoclue2
29
30       [network-nmea]
31              Network NMEA source configuration options
32
33              enable=true
34              Fetch location from NMEA sources on local network?
35
36       [3G]
37              3G source configuration options
38
39              enable=true
40              Enable 3G source
41
42       [cdma]
43              CDMA source configuration options
44
45              enable=true
46              Enable CDMA source
47
48       [modem-gps]
49              Modem GPS source configuration options
50
51              enable=true
52              Enable Modem-GPS source
53
54       [wifi]
55              WiFi source configuration options
56
57              enable=true
58              Enable WiFi source
59
60              url=https://location.services.mozilla.com/v1/geolocate?key=geo‐
61              clue
62              URL to the wifi geolocation service. The  key  can  currenty  be
63              anything,  just  needs to be present but that is likely going to
64              change in future.
65
66              submit-data=false Submit data to Mozilla Location Service
67              If set to true, geoclue will automatically submit  network  data
68              to Mozilla each time it gets a GPS lock.
69
70              submission-url=https://location.services.mozilla.com/v1/sub‐
71              mit?key=geoclue
72              URL to submission API of Mozilla Location Service
73
74              submission-nick=geoclue
75              A nickname to submit network data with. A nickname must be  2-32
76              characters long.
77

APPLICATION CONFIGURATION OPTIONS

79       Having  an  entry  here for an application with allowed=true means that
80       geoclue will not ask agent to authorize the  application.  This  is  to
81       ensure that applications with built-in authorization mechanism (e.g web
82       browsers) do not have to be bound to agents.
83
84       If your application is denied access to location information  and  your
85       operating  system  doesn't  provide any mechanism to change that, it is
86       likely a bug in your operation system (or geoclue). The solution is  to
87       report  the issue with all details, rather than adding your application
88       to this list.
89
90       Format:
91              [random-app]
92              Desktop ID of application without .desktop part
93
94              allowed=true|false
95              Allowed access to location information?
96
97              system=true|false
98              Is application a system component?
99
100              users=
101              List of UIDs of all users for which this application is  allowed
102              location  info access, separate by ';'. Keep it empty for allow‐
103              ing it for all users.
104
105       Examples:
106              [gnome-datetime-panel]
107              allowed=true
108              system=true
109              users=
110
111              [gnome-color-panel]
112              allowed=true
113              system=true
114              users=
115
116              [org.gnome.Shell]
117              allowed=true
118              system=true
119              users=
120
121              [io.elementary.desktop.agent-geoclue2]
122              allowed=true
123              system=true
124              users=
125
126              [epiphany]
127              allowed=true
128              system=false
129              users=
130
131              [firefox]
132              allowed=true
133              system=false
134              users=
135

AUTHOR

137       Sachin Chand
138
139
140
141                                                      GEOCLUE CONFIGURATION(5)