data/geoclue.5.in


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171

.TH "GEOCLUE CONFIGURATION" 5 
.SH NAME
geoclue.conf
\-
geoclue configuration parameters
.SH SYNOPSIS
.B @sysconfdir@/geoclue/geoclue.conf
.SH DESCRIPTION
.ad
.fi
The geoclue geoclue.conf configuration file specifies parameters that
control the operation of geoclue.
.PP
All configurations settings below are mandatory and the defaults are
what you see before you edit them in geoclue.conf. If you want to keep the default
values around, copy and comment out the appropriate line(s) before
changing them.
.SH AGENT CONFIGURATION OPTIONS
.B \fI[agent]
is used to begin the agent configuration.
.IP \fBwhitelist 
.br
Whitelist of desktop IDs (without .desktop part) of all agents we recognise,
separated by a ';'.
.IP 
.B whitelist=geoclue-demo-agent;gnome-shell;io.elementary.desktop.agent-geoclue2
.br
.IP \fB[network-nmea]
.br
Network NMEA source configuration options
.IP
.B \fBenable=true 
.br
Fetch location from NMEA sources on local network?
.br
.IP \fB[3G]
.br
3G source configuration options
.IP
.B \fBenable=true 
.br
Enable 3G source
.br
.IP \fB[cdma]
.br
CDMA source configuration options
.IP
.B \fBenable=true 
.br
Enable CDMA source
.br
.IP \fB[modem-gps]
.br
Modem GPS source configuration options
.IP
.B \fBenable=true 
.br
Enable Modem-GPS source
.br
.IP \fB[wifi]
.br
WiFi source configuration options
.IP
.B \fBenable=true 
.br
Enable WiFi source
.IP
.B url=\fIhttps://location.services.mozilla.com/v1/geolocate?key=geoclue
.br
URL to the wifi geolocation service. The key can currenty be anything, just
needs to be present but that is likely going to change in future.
.IP
.B submit-data=false
Submit data to Mozilla Location Service
.br
If set to true, geoclue will automatically submit network data to Mozilla
each time it gets a GPS lock.
.IP
.B submission-url=\fIhttps://location.services.mozilla.com/v1/submit?key=geoclue
.br
URL to submission API of Mozilla Location Service
.IP
.B submission-nick=geoclue
.br
A nickname to submit network data with. A nickname must be 2-32 characters long.
.br
.SH APPLICATION CONFIGURATION OPTIONS
Having an entry here for an application with 
.B allowed=true
means that geoclue will not ask agent to authorize the application. This is to
ensure that applications with built-in authorization mechanism (e.g web
browsers) do not have to be bound to agents.
.PP
If your application is denied access to location information and your
operating system doesn't provide any mechanism to change that, it is
likely a bug in your operation system (or geoclue). The solution is to
report the issue with all details, rather than adding your application
to this list.
.IP Format:
.RS
.B [random-app]
.br
Desktop ID of application without .desktop part
.PP
.B allowed=true|false
.br
Allowed access to location information?
.PP
.B system=true|false
.br
Is application a system component?
.PP
.B users=
.br
List of UIDs of all users for which this application is allowed location
info access, separate by ';'. Keep it empty for allowing it for all users.
.RE
.IP Examples:
.RS
.B [gnome-datetime-panel]
.br
allowed=true
.br
system=true
.br
users=
.PP
.B [gnome-color-panel]
.br
allowed=true
.br
system=true
.br
users=
.PP
.B [org.gnome.Shell]
.br
allowed=true
.br
system=true
.br
users=
.PP
.B [io.elementary.desktop.agent-geoclue2]
.br
allowed=true
.br
system=true
.br
users=
.PP
.B [epiphany]
.br
allowed=true
.br
system=false
.br
users=
.PP
.B [firefox]
.br
allowed=true
.br
system=false
.br
users=
.br
.SH AUTHOR
.na
.nf
Sachin Chand