نام (NAME)

gpxlogger - ابزاری برای اتصال به gpsd و تولید فایل GPX

خلاصه دستور (SYNOPSIS)

gpxlogger [OPTIONS] [server[:port[:device]]]

gpxlogger -h

gpxlogger -V

توضیحات (DESCRIPTION)

برنامه gpslogger موقعیت‌های تثبیت‌شده (fixes) را از gpsd جمع‌آوری کرده و آن‌ها را در قالب GPX (یک نمایه XML برای ثبت مسیر یا track logging) در خروجی استاندارد ثبت می‌کند. این برنامه نیازی به اجرا به عنوان ریشه (root) ندارد، اما می‌تواند با دسترسی ریشه نیز اجرا شود.

خروجی ممکن است از چندین مسیر تشکیل شده باشد. اگر برای بازه زمانی مشخص‌شده توسط گزینه -i یا --interval (با مقدار پیش‌فرض ۵ ثانیه) هیچ موقعیت تثبیت‌شده‌ای ثبت نشود، یک مسیر جدید ایجاد می‌شود.

برنامه gpxlogger می‌تواند از هر یک از روش‌های برون‌بری (export) که gpsd پشتیبانی می‌کند استفاده نماید. برای مشاهده فهرستی از این روش‌ها، از گزینه -l یا --exports استفاده کنید. برای تحمیل یک روش خاص، گزینه -e یا --export را به همراه یکی از نام‌های متد خاتمه‌یافته به دو نقطه از جدول -l یا --exports وارد کنید.

گزینه‌ها (OPTIONS)

-?, -h, --help

چاپ خلاصه‌ای از گزینه‌ها و سپس خروج.

-d, --daemonize

اجرا به صورت یک دیمن در پس‌زمینه. این گزینه به گزینه -f, --output نیاز دارد که خروجی را به یک فایل لاگ مشخص هدایت می‌کند.

-D LVL, --debug LVL

تنظیم سطح اشکال‌زدایی؛ این گزینه عمدتاً برای عیب‌یابی کاربرد دارد و پیام‌های پیشرفت مختلف را در خطای استاندارد فعال می‌کند.

-e METHOD, --export METHOD

اگر پشتیبانی از D-Bus روی میزبان موجود باشد، GPSD برای استفاده از آن پیکربندی شده باشد، و -e dbus یا --export dbus مشخص گردد، این برنامه از طریق org.gpsd.fix به اعلان‌های همگانی DBUS از gpsd گوش فرا می‌دهد.

با -e sockets، یا اگر روش پیش‌فرض سوکت‌ها باشد، می‌توانید مشخصات [server[:port[:device]]] را به عنوان آرگومان ارائه دهید. برای جزئیات بیشتر به بخش ARGUMENTS در ادامه مراجعه کنید.

با -e shm, --export shm این برنامه با استفاده از حافظه اشتراکی به gpsd محلی گوش فرا خواهد داد.

-f OUTFILE, --output OUTFILE

ارسال لاگ GPX به فایل OUTFILE به‌جای خروجی استاندارد (stdout). می‌توانید از مشخصه‌های strftime(3) در OUTFILE استفاده کنید.

-F INFILE, --filein INFILE

خواندن JSON مربوط به gpsd از فایل INFILE به‌جای دریافت آن از یک دیمن gpsd.

-g, --garmin

فعال‌سازی افزونه‌های Garmin برای قالب GPX. این کار اجازه می‌دهد مقدار عمق (depth) نیز در خروجی GPX ثبت شود. با نقشه‌های گوگل (Google Maps) سازگار نیست.

-i SECONDS, --interval SECONDS

اگر برای بازه‌ای به مدت SECONDS ثانیه هیچ موقعیت تثبیت‌شده‌ای ثبت نشود، یک مسیر جدید ایجاد می‌شود. مقدار پیش‌فرض ۵ ثانیه است.

-l, --exports

فهرست کردن تمام گزینه‌های ممکن برای -e, --export.

-m MINMOVE, --minmove MINMOVE

تعیین حداقل فاصله جابه‌جایی بر حسب متر (می‌تواند شامل بخش اعشاری باشد). حرکات کمتر از این مقدار ثبت نخواهند شد.

-r, --reconnect

تلاش مجدد در صورتی که GPSd موقعیت تثبیت‌شده را از دست بدهد. بدون -r، در چنین شرایطی gpxlogger خارج خواهد شد.

-V, --version

چاپ نسخه بسته و خروج.

آرگومان‌ها (ARGUMENTS)

به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی gpsd که روی localhost با استفاده از پورت پیش‌فرض GPSD یعنی 2947 اجرا می‌شود جمع‌آوری می‌کنند. آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را بازنویسی کند: [server[:port[:device]]]

برای توضیحات بیشتر و مثال‌ها، به بخش ARGUMENTS در صفحه راهنمای gps(1) مراجعه کنید.