293 lines
5.0 KiB
HTML
293 lines
5.0 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of GEOCLUE CONFIGURATION</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>GEOCLUE CONFIGURATION</H1>
|
|
Section: File Formats (5)<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
geoclue.conf
|
|
-
|
|
geoclue configuration parameters
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>/etc/geoclue/geoclue.conf</B>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
|
|
The geoclue geoclue.conf configuration file specifies parameters that
|
|
control the operation of geoclue.
|
|
<P>
|
|
|
|
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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>AGENT CONFIGURATION OPTIONS</H2>
|
|
|
|
<B></B><I>[agent]</I>
|
|
|
|
is used to begin the agent configuration.
|
|
<DL COMPACT>
|
|
<DT id="1"><B>whitelist<DD>
|
|
<BR>
|
|
|
|
Whitelist of desktop IDs (without .desktop part) of all agents we recognise,
|
|
separated by a ';'.
|
|
<DT id="2"><DD>
|
|
whitelist=geoclue-demo-agent;gnome-shell;io.elementary.desktop.agent-geoclue2</B>
|
|
|
|
<BR>
|
|
|
|
<DT id="3"><B>[network-nmea]<DD>
|
|
<BR>
|
|
|
|
Network NMEA source configuration options
|
|
<DT id="4"><DD>
|
|
enable=true </B>
|
|
|
|
<BR>
|
|
|
|
Fetch location from NMEA sources on local network?
|
|
<BR>
|
|
|
|
<DT id="5"><B>[3G]<DD>
|
|
<BR>
|
|
|
|
3G source configuration options
|
|
<DT id="6"><DD>
|
|
enable=true </B>
|
|
|
|
<BR>
|
|
|
|
Enable 3G source
|
|
<BR>
|
|
|
|
<DT id="7"><B>[cdma]<DD>
|
|
<BR>
|
|
|
|
CDMA source configuration options
|
|
<DT id="8"><DD>
|
|
enable=true </B>
|
|
|
|
<BR>
|
|
|
|
Enable CDMA source
|
|
<BR>
|
|
|
|
<DT id="9"><B>[modem-gps]<DD>
|
|
<BR>
|
|
|
|
Modem GPS source configuration options
|
|
<DT id="10"><DD>
|
|
enable=true </B>
|
|
|
|
<BR>
|
|
|
|
Enable Modem-GPS source
|
|
<BR>
|
|
|
|
<DT id="11"><B>[wifi]<DD>
|
|
<BR>
|
|
|
|
WiFi source configuration options
|
|
<DT id="12"><DD>
|
|
enable=true </B>
|
|
|
|
<BR>
|
|
|
|
Enable WiFi source
|
|
<DT id="13"><DD>
|
|
<B>url=</B><I><A HREF="https://location.services.mozilla.com/v1/geolocate?key=geoclue">https://location.services.mozilla.com/v1/geolocate?key=geoclue</A></I>
|
|
|
|
<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.
|
|
<DT id="14"><DD>
|
|
<B>submit-data=false</B>
|
|
|
|
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.
|
|
<DT id="15"><DD>
|
|
<B>submission-url=</B><I><A HREF="https://location.services.mozilla.com/v1/submit?key=geoclue">https://location.services.mozilla.com/v1/submit?key=geoclue</A></I>
|
|
|
|
<BR>
|
|
|
|
URL to submission API of Mozilla Location Service
|
|
<DT id="16"><DD>
|
|
<B>submission-nick=geoclue</B>
|
|
|
|
<BR>
|
|
|
|
A nickname to submit network data with. A nickname must be 2-32 characters long.
|
|
<BR>
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>APPLICATION CONFIGURATION OPTIONS</H2>
|
|
|
|
Having an entry here for an application with
|
|
<B>allowed=true</B>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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.
|
|
<DL COMPACT>
|
|
<DT id="17">Format:<DD>
|
|
<DL COMPACT><DT id="18"><DD>
|
|
<B>[random-app]</B>
|
|
|
|
<BR>
|
|
|
|
Desktop ID of application without .desktop part
|
|
<P>
|
|
|
|
<B>allowed=true|false</B>
|
|
|
|
<BR>
|
|
|
|
Allowed access to location information?
|
|
<P>
|
|
|
|
<B>system=true|false</B>
|
|
|
|
<BR>
|
|
|
|
Is application a system component?
|
|
<P>
|
|
|
|
<B>users=</B>
|
|
|
|
<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.
|
|
</DL>
|
|
|
|
<DT id="19">Examples:<DD>
|
|
<DL COMPACT><DT id="20"><DD>
|
|
<B>[gnome-datetime-panel]</B>
|
|
|
|
<BR>
|
|
|
|
allowed=true
|
|
<BR>
|
|
|
|
system=true
|
|
<BR>
|
|
|
|
users=
|
|
<P>
|
|
|
|
<B>[gnome-color-panel]</B>
|
|
|
|
<BR>
|
|
|
|
allowed=true
|
|
<BR>
|
|
|
|
system=true
|
|
<BR>
|
|
|
|
users=
|
|
<P>
|
|
|
|
<B>[org.gnome.Shell]</B>
|
|
|
|
<BR>
|
|
|
|
allowed=true
|
|
<BR>
|
|
|
|
system=true
|
|
<BR>
|
|
|
|
users=
|
|
<P>
|
|
|
|
<B>[io.elementary.desktop.agent-geoclue2]</B>
|
|
|
|
<BR>
|
|
|
|
allowed=true
|
|
<BR>
|
|
|
|
system=true
|
|
<BR>
|
|
|
|
users=
|
|
<P>
|
|
|
|
<B>[epiphany]</B>
|
|
|
|
<BR>
|
|
|
|
allowed=true
|
|
<BR>
|
|
|
|
system=false
|
|
<BR>
|
|
|
|
users=
|
|
<P>
|
|
|
|
<B>[firefox]</B>
|
|
|
|
<BR>
|
|
|
|
allowed=true
|
|
<BR>
|
|
|
|
system=false
|
|
<BR>
|
|
|
|
users=
|
|
<BR>
|
|
|
|
</DL>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
|
|
<PRE>
|
|
Sachin Chand
|
|
|
|
</PRE>
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="21"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="22"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="23"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="24"><A HREF="#lbAE">AGENT CONFIGURATION OPTIONS</A><DD>
|
|
<DT id="25"><A HREF="#lbAF">APPLICATION CONFIGURATION OPTIONS</A><DD>
|
|
<DT id="26"><A HREF="#lbAG">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:03 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|