'\" t
.\"     Title: gpxlogger
.\"    Author: Amaury Jacquot, Petter Reinholdtsen, Chris Kuethe
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: English
.\"
.TH "GPXLOGGER" "1" "2025-11-04" "GPSD, Version 3.27.5" "GPSD Documentation"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
gpxlogger \- ابزاری برای اتصال به gpsd و تولید فایل GPX
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgpxlogger\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBgpxlogger\fP \-h
.sp
\fBgpxlogger\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBgpslogger\fP موقعیت‌های تثبیت‌شده (fixes) را از \fBgpsd\fP جمع‌آوری کرده و آن‌ها را در قالب GPX (یک نمایه XML برای ثبت مسیر یا track logging) در خروجی استاندارد ثبت می‌کند. این برنامه نیازی به اجرا به عنوان ریشه (root) ندارد، اما می‌تواند با دسترسی ریشه نیز اجرا شود.
.sp
خروجی ممکن است از چندین مسیر تشکیل شده باشد. اگر برای بازه زمانی مشخص‌شده توسط گزینه \fB\-i\fP یا \fB\-\-interval\fP (با مقدار پیش‌فرض ۵ ثانیه) هیچ موقعیت تثبیت‌شده‌ای ثبت نشود، یک مسیر جدید ایجاد می‌شود.
.sp
برنامه \fBgpxlogger\fP می‌تواند از هر یک از روش‌های برون‌بری (export) که \fBgpsd\fP پشتیبانی می‌کند استفاده نماید. برای مشاهده فهرستی از این روش‌ها، از گزینه \fB\-l\fP یا \fB\-\-exports\fP استفاده کنید. برای تحمیل یک روش خاص، گزینه \fB\-e\fP یا \fB\-\-export\fP را به همراه یکی از نام‌های متد خاتمه‌یافته به دو نقطه از جدول \fB\-l\fP یا \fB\-\-exports\fP وارد کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
چاپ خلاصه‌ای از گزینه‌ها و سپس خروج.
.RE
.sp
\fB\-d\fP, \fB\-\-daemonize\fP
.RS 4
اجرا به صورت یک دیمن در پس‌زمینه. این گزینه به گزینه \fB\-f, \-\-output\fP نیاز دارد که خروجی را به یک فایل لاگ مشخص هدایت می‌کند.
.RE
.sp
\fB\-D LVL\fP, \fB\-\-debug LVL\fP
.RS 4
تنظیم سطح اشکال‌زدایی؛ این گزینه عمدتاً برای عیب‌یابی کاربرد دارد و پیام‌های پیشرفت مختلف را در خطای استاندارد فعال می‌کند.
.RE
.sp
\fB\-e METHOD\fP, \fB\-\-export METHOD\fP
.RS 4
اگر پشتیبانی از D\-Bus روی میزبان موجود باشد، GPSD برای استفاده از آن پیکربندی شده باشد، و \fB\-e dbus\fP یا \fB\-\-export dbus\fP مشخص گردد، این برنامه از طریق org.gpsd.fix به اعلان‌های همگانی DBUS از \fBgpsd\fP گوش فرا می‌دهد.
.sp
با \fB\-e sockets\fP، یا اگر روش پیش‌فرض سوکت‌ها باشد، می‌توانید مشخصات [server[:port[:device]]] را به عنوان آرگومان ارائه دهید. برای جزئیات بیشتر به بخش \fBARGUMENTS\fP در ادامه مراجعه کنید.
.sp
با \fB\-e shm, \-\-export shm\fP این برنامه با استفاده از حافظه اشتراکی به \fBgpsd\fP محلی گوش فرا خواهد داد.
.RE
.sp
\fB\-f OUTFILE\fP, \fB\-\-output OUTFILE\fP
.RS 4
ارسال لاگ GPX به فایل OUTFILE به‌جای خروجی استاندارد (stdout). می‌توانید از مشخصه‌های strftime(3) در OUTFILE استفاده کنید.
.RE
.sp
\fB\-F INFILE\fP, \fB\-\-filein INFILE\fP
.RS 4
خواندن JSON مربوط به \fBgpsd\fP از فایل INFILE به‌جای دریافت آن از یک دیمن \fBgpsd\fP.
.RE
.sp
\fB\-g\fP, \fB\-\-garmin\fP
.RS 4
فعال‌سازی افزونه‌های Garmin برای قالب GPX. این کار اجازه می‌دهد مقدار عمق (depth) نیز در خروجی GPX ثبت شود. با نقشه‌های گوگل (Google Maps) سازگار نیست.
.RE
.sp
\fB\-i SECONDS\fP, \fB\-\-interval SECONDS\fP
.RS 4
اگر برای بازه‌ای به مدت SECONDS ثانیه هیچ موقعیت تثبیت‌شده‌ای ثبت نشود، یک مسیر جدید ایجاد می‌شود. مقدار پیش‌فرض ۵ ثانیه است.
.RE
.sp
\fB\-l\fP, \fB\-\-exports\fP
.RS 4
فهرست کردن تمام گزینه‌های ممکن برای \fB\-e, \-\-export\fP.
.RE
.sp
\fB\-m MINMOVE\fP, \fB\-\-minmove MINMOVE\fP
.RS 4
تعیین حداقل فاصله جابه‌جایی بر حسب متر (می‌تواند شامل بخش اعشاری باشد). حرکات کمتر از این مقدار ثبت نخواهند شد.
.RE
.sp
\fB\-r\fP, \fB\-\-reconnect\fP
.RS 4
تلاش مجدد در صورتی که GPSd موقعیت تثبیت‌شده را از دست بدهد. بدون \fB\-r\fP، در چنین شرایطی \fBgpxlogger\fP خارج خواهد شد.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ نسخه بسته و خروج.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی \fBgpsd\fP که روی localhost با استفاده از پورت پیش‌فرض GPSD یعنی 2947 اجرا می‌شود جمع‌آوری می‌کنند. آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را بازنویسی کند: \fB[server[:port[:device]]]\fP
.sp
برای توضیحات بیشتر و مثال‌ها، به بخش \fBARGUMENTS\fP در صفحه راهنمای \fBgps\fP(1) مراجعه کنید.
.SH "وضعیت خروج (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته
.ps -1
.br
.sp
برنامه gpxlogger پیام‌های خطا را به لاگ سیستم ارسال می‌کند، نه به stderr.
.sp .5v
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
برای اجرا به صورت دیمن و ارسال لاگ gpx به یک فایل با نام حاوی برچسب تاریخ:
.sp
$ gpxlogger \-d \-f "out\-%c.gpx"
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgps\fP(1)
.sp
\fBstrftime\fP(3)
.sp
\fBgpsd\fP(8)
.SH "منابع (RESOURCES)"
.sp
\fBتارنمای پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق امتیاز این فایل متعلق است به GPSD project (سال 2013)
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسندگان (AUTHORS)"
.sp
Amaury Jacquot
.sp
Petter Reinholdtsen
.sp
Chris Kuethe