.TH "GEOCLUE CONFIGURATION" 5 "2025-05-01" "geoclue" "فایل‌های پیکربندی"
.SH "نام (NAME)"
geoclue \- پرونده پیکربندی دیمن اطلاعات جغرافیایی Geoclue
.SH "خلاصه (SYNOPSIS)"
پرونده اصلی پیکربندی:
.B /etc/geoclue/geoclue.conf
.br
پرونده‌های بازنویسی پارامترها:
.B /etc/geoclue/conf.d
.SH "توضیحات (DESCRIPTION)"
.ad
پرونده اصلی پیکربندی GeoClue با نام
.B 'geoclue.conf'
پارامترهایی را مشخص می‌کند که نحوه عملکرد
.B geoclue
را کنترل می‌کنند. می‌توان پارامترها را با قرار دادن پرونده‌های پیکربندی در دایرکتوری
.B conf.d
بازنویسی کرد؛ این پرونده‌ها به ترتیب الفبایی اعمال می‌شوند. بنابراین، پرونده پیکربندی
.B '90-config.conf'
پارامترهای مشخص‌شده در یک پرونده پیکربندی دیگر به نام
.B '50-config.conf'
در دایرکتوری
.B conf.d
را بازنویسی خواهد کرد.
.PP
تمامی تنظیمات پیکربندی زیر اجباری هستند و مقادیر پیش‌فرض همان مواردی است که قبل از ویرایش در
.B geoclue.conf
مشاهده می‌کنید. اگر می‌خواهید مقادیر پیش‌فرض را حفظ کنید، قبل از تغییر دادن خط(های) مربوطه، یک کپی از آن‌ها تهیه کرده و به صورت کامنت درآورید.
.PP
نبود کلید
.B 'enable'
برای یک منبع خاص در پرونده اصلی پیکربندی، باعث می‌شود آن منبع به صورت پیش‌فرض فعال باشد. افزودن تنظیم کلید
.B 'enable'
به هر پرونده پیکربندی دیگر می‌تواند این مقدار پیش‌فرض را بازنویسی کند.
.SH "گزینه‌های پیکربندی کارگزار (AGENT CONFIGURATION OPTIONS)"
.B \fI[agent]
برای شروع پیکربندی کارگزار (agent) استفاده می‌شود.
.IP \fBwhitelist
.br
فهرست مجاز شناسه رومیزی (بدون بخش ‎.desktop‎) تمامی کارگزارهای شناسایی‌شده، که با
.B ';'
از هم جدا شده‌اند.
.IP
.B whitelist=geoclue-demo-agent;gnome-shell;io.elementary.desktop.agent-geoclue2
.br
.SH "گزینه‌های پیکربندی منبع مکان (LOCATION SOURCE CONFIGURATION OPTIONS)"
.IP \fB[ip]
.br
گزینه‌های پیکربندی منبع IP
.IP
.B \fBenable=true
.br
فعال کردن منبع GeoIP
.br
.IP
.B \fBmethod=ichnaea
.br
روش (پشتانه) مورد استفاده برای مکان‌یابی IP. موارد پیاده‌سازی‌شده در حال حاضر عبارتند از:
.br
.BR '"ichnaea"' :
استفاده از API ایچنایا (Ichnaea) با URL مشخص‌شده از منبع wifi.
.br
.BR '"gmaps"' :
استفاده از مکان تعیین‌شده توسط Google Maps.
.br
.BR '"reallyfreegeoip"' :
سایت reallyfreegeoip.org. این API دقت را بازنمی‌گرداند، بنابراین از یک مقدار ثابت استفاده می‌شود. گزینه accuracy در زیر را ببینید.
.br
.IP
نیازی به تنظیم گزینه‌های زیر نیست، اما در صورت تمایل به لغو و بازنویسی مقادیر پیش‌فرض روش، می‌توان آن‌ها را مشخص کرد:
.br
.IP
.B \fBurl=https://example.com/v1/geolocate
.br
نشانی URL جایگزین برای سرویس GeoIP پیاده‌سازی‌شده با روش انتخاب‌شده.
.br
.IP
.B \fBaccuracy=30000.0
.br
بازنویسی دقت دریافت شده از سرور GeoIP (یا مقدار ثابت در روش) با این مقدار.
.br
.IP \fB[network-nmea]
.br
گزینه‌های پیکربندی منبع NMEA تحت شبکه
.IP
منابع NMEA تحت شبکه به طور خودکار با استفاده از avahi و دامنه
.B "_nmea-0183._tcp"
شناسایی می‌شوند. یک سرویس NMEA در شبکه شما می‌تواند با اجرای دستور زیر در avahi ثبت شود:
.IP
.EX
$ avahi-publish-service -H my.nmea.host "NMEA over TCP" _nmea-0183._tcp 50000
.EE
.IP
در اینجا
.B 'my.nmea.host'
و
.B '50000'
به ترتیب نام میزبان و درگاه (port) سرویس NMEA هستند.
.IP
.B \fBenable=true
.br
آیا مکان از منابع NMEA در شبکه محلی دریافت شود؟
.IP
.B \fBnmea-socket=/var/run/gps-share.sock
.br
استفاده از سوکت یونیکس به عنوان منبع داده NMEA.
در صورت عدم تنظیم، از سوکت یونیکس استفاده نخواهد شد.
.br
.IP \fB[3g]
.br
گزینه‌های پیکربندی منبع 3G
.IP
.B \fBenable=true
.br
فعال کردن منبع 3G. منبع 3G از نشانی URL سرویس مکان‌یابی جغرافیایی بی‌سیم که در بخش
.B "wifi"
تعریف شده است استفاده می‌کند.
.br
.IP \fB[cdma]
.br
گزینه‌های پیکربندی منبع CDMA
.IP
.B \fBenable=true
.br
فعال کردن منبع CDMA
.br
.IP \fB[modem-gps]
.br
گزینه‌های پیکربندی منبع Modem GPS
.IP
.B \fBenable=true
.br
فعال کردن منبع Modem-GPS
.br
.IP \fB[wifi]
.br
گزینه‌های پیکربندی منبع WiFi
.IP
.B \fBenable=true
.br
فعال کردن منبع WiFi
.IP
.B url=\fIhttps://example.com/v1/geolocate?key=YOUR_KEY
.br
نشانی URL سرویس مکان‌یابی جغرافیایی بی‌سیم سازگار با Ichnaea API
(https://ichnaea.readthedocs.io/en/latest/api/geolocate.html). در صورت عدم تنظیم، به نشانی URL تعیین‌شده در پیکربندی ساخت بازمی‌گردد. اگر هیچ نشانی URL در اینجا یا در پیکربندی ساخت تنظیم نشود، منابع wifi و 3g غیرفعال خواهند شد. یک کلید API می‌تواند با پارامتر
.B "key"
در URL تنظیم شود.
.IP
.B submit-data=false
.br
ارسال داده‌ها به یک سرویس مکان‌یابی جغرافیایی بی‌سیم.
.br
اگر برابر با true تنظیم شود، geoclue هر بار که اتصال و قفل GPS (GPS lock) دریافت کند، داده‌های شبکه را به طور خودکار به یک سرویس مکان‌یابی جغرافیایی بی‌سیم ارسال می‌کند. در حال حاضر، فقط منابع Modem-GPS یا Network NMEA به عنوان ارائه‌دهنده مکان جهت ارسال پشتیبانی می‌شوند (در هر زمان یکی از آن‌ها). اگر منبع Modem-GPS در بالا فعال باشد، ارائه‌دهنده انحصاری خواهد بود (صرف‌نظر از اینکه سیستم واقعاً به چنین مودمی مجهز باشد یا خیر)، در غیر این صورت منبع Network NMEA در نظر گرفته می‌شود.
.IP
.B submission-url=\fIhttps://example.com/v2/geosubmit?key=YOUR_KEY
.br
نشانی URL برای ارسال داده‌ها به یک سرویس مکان‌یابی جغرافیایی بی‌سیم با API سازگار با Ichnaea
(https://ichnaea.readthedocs.io/en/latest/api/geosubmit2.html).
.IP
.B submission-nick=geoclue
.br
یک نام مستعار برای ارسال داده‌های شبکه. هدر HTTP با عنوان
.B "X-Nickname"
را برای درخواست ارسال تنظیم می‌کند. اگر یک رشته خالی تنظیم شود، از ارسال حذف می‌شود. در غیر این صورت باید بین ۲ تا ۳۲ نویسه طول داشته باشد. مقدار پیش‌فرض
.B "geoclue"
است.
.br
.IP \fB[compass]
.br
گزینه‌های پیکربندی قطب‌نما (Compass)
.IP
.B \fBenable=true
.br
فعال کردن قطب‌نما
.br
.IP \fB[static-source]
.br
گزینه‌های پیکربندی منبع ایستا (Static source).
.br
این منبع مکان را از پرونده
.B "geolocation"
در
.B /etc
می‌خواند. برای ساختار این پرونده، بخش
.B "پرونده مکان ایستا (STATIC LOCATION FILE)"
در زیر را ببینید. در حالی که این پرونده در طول کارکرد geoclue به طور مداوم برای تغییرات پایش می‌شود و مکان ایستای گزارش‌شده مطابق با آن به‌روزرسانی می‌گردد، این منبع برای وارد کردن مکانی با تغییرات پویا به geoclue در نظر گرفته نشده است (لطفاً برای این منظور از منبع Network NMEA استفاده کنید).
.IP
.B \fBenable=true
.br
فعال کردن منبع ایستا.
.br
اگر از این منبع استفاده می‌کنید، احتمالاً باید سایر منابع مکان را در geoclue.conf غیرفعال کنید تا آن‌ها مکان ایستای پیکربندی‌شده را بازنویسی نکنند.
.br
.SH "گزینه‌های پیکربندی برنامه‌های کاربردی (APPLICATION CONFIGURATION OPTIONS)"
داشتن یک مدخل در اینجا برای یک برنامه کاربردی با
.B allowed=true
به این معنی است که geoclue برای اعتبارسنجی برنامه از کارگزار (agent) درخواستی نخواهد کرد. این امر برای اطمینان از این است که برنامه‌های کاربردی دارای سازوکار اعتبارسنجی داخلی (مانند مرورگرهای وب) نیازی به پیوند با کارگزارها نداشته باشند.
.PP
اگر دسترسی برنامه شما به اطلاعات مکان رد شد و سیستم‌عامل شما هیچ سازوکاری برای تغییر آن ارائه نمی‌دهد، احتمالاً این یک اشکال (bug) در سیستم‌عامل شما (یا در geoclue) است. راه‌حل این است که مشکل را با تمام جزئیات گزارش دهید، نه اینکه برنامه خود را به این فهرست اضافه کنید.
.IP "قالب (Format):"
.RS
.B [random-app]
.br
شناسه رومیزی (Desktop ID) برنامه کاربردی بدون بخش ‎.desktop‎
.PP
.B allowed=true|false
.br
آیا دسترسی به اطلاعات مکان مجاز است؟
.PP
.B system=true|false
.br
آیا برنامه یک مؤلفه سیستمی است؟
.PP
.B users=
.br
فهرست UID تمامی کاربرانی که این برنامه برای آن‌ها مجاز به دسترسی به اطلاعات مکان است، جداشده با ';'. برای مجاز بودن برای تمامی کاربران، آن را خالی بگذارید.
.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=
.RE
.SH "پرونده مکان ایستا (STATIC LOCATION FILE)"
.SS "قالب پایه (Basic format):"
پرونده مکان ایستا در
.B /etc
(استفاده‌شده توسط منبع ایستا) یک پرونده متنی متشکل از موارد زیر است:
.RS
.nr step 1 1
.IP \n[step]
عرض جغرافیایی یا Latitude (عدد اعشاری ممیز شناور؛ مقادیر مثبت نشان‌دهنده شمال و مقادیر منفی نشان‌دهنده جنوب هستند)
.IP \n+[step]
طول جغرافیایی یا Longitude (عدد اعشاری ممیز شناور؛ مقادیر مثبت نشان‌دهنده شرق و مقادیر منفی نشان‌دهنده غرب هستند)
.IP \n+[step]
ارتفاع یا Altitude (عدد اعشاری ممیز شناور؛ به متر)
.IP \n+[step]
شعاع دقت یا Accuracy radius (عدد اعشاری ممیز شناور؛ به متر)
.RE
.PP
این مقادیر باید با نویسه‌های خط جدید (newline) از هم جدا شوند.
.SS "اطلاعات تکمیلی قالب:"
.IP \[bu]
نویسه '\[sh]' آغازگر کامنت (توضیح) است که تا پایان خط جاری ادامه می‌یابد.
.IP \[bu]
فاصله‌های خالی ابتدایی و انتهایی در هر خط نادیده گرفته می‌شوند.
.IP \[bu]
خطوط خالی (یا خطوطی که فقط شامل فاصله‌های خالی یا کامنت هستند) نادیده گرفته می‌شوند.
.SS "مثال:"
.EX
# Example static location file for a machine inside Statue of Liberty torch

40.6893129   # latitude
-74.0445531  # longitude
96           # altitude
1.83         # accuracy radius (the diameter of the torch is 12 feet)
.EE
.SS "نکات (Notes):"
برای امنیت بیشتر، پرونده مکان ایستا می‌تواند طوری تنظیم شود که فقط توسط کاربر geoclue قابل خواندن باشد:
.EX
# chown geoclue /etc/geolocation
# chmod 600 /etc/geolocation
.EE
.SH "فهرست کلاینت‌ها (CLIENT LIST)"
ارسال سیگنال SIGUSR1 به یک فرایند در حال اجرای geoclue، فهرست فعلی کلاینت‌ها را در لاگ وقایع چاپ می‌کند.
.SH "نویسنده (AUTHOR)"
.na
.nf
Sachin Chand
.fi