'\" t
.\"     Title: gps2udp
.\"    Author: Fulup Ar Foll
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD Version 3.27.5
.\"  Language: Persian
.\"
.TH "GPS2UDP" "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)"
gps2udp \- ارسال داده‌های دریافتی از gpsd به یک یا چند پایگاه تجمیع داده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgps2udp\fP [\fIگزینه‌ها\fP] [server[:port[:device]]]
.sp
\fBgps2udp\fP \-h
.sp
\fBgps2udp\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
\fBgps2udp\fP ابزاری برای اتصال به \fBgpsd\fP و ارسال جملات دریافتی به یک یا چند مقصد UDP با فرمت میزبان:درگاه (host:port) است. این ویژگی باعث می‌شود که این برنامه برای ارسال اطلاعات AIS از \fBgpsd\fP به پایگاه‌هایی مانند aishub، marinetraffic، shipfinder و... بسیار مفید باشد.
.sp
\fBgps2udp\fP برای اجرا نیازی به مجوزهای کاربر ارشد (root) ندارد، اما می‌تواند با این کاربر نیز اجرا شود. همچنین این ابزار می‌تواند بدون ایجاد هیچ مشکلی، به‌طور هم‌زمان با سایر ابزارهایی که به \fBgpsd\fP محلی متصل هستند اجرا شود.
.sp
خروجی شامل یک یا هر دو نوع جملات NMEA (گزینه \fB\-n\fP) یا JSON (گزینه \fB\-j\fP) از \fBgpsd\fP خواهد بود. خروجی از طریق یک سوکت شبکه UDP به یک یا چند میزبان مقصد (گزینه \fB\-u HOST:PORT\fP) فرستاده می‌شود.
.sp
به‌صورت اختیاری می‌توان یک کارساز (سرور)، شماره درگاه TCP/IP و دستگاه دوردست را مشخص کرد. در صورت عدم تعیین، \fBgps2udp\fP به localhost روی درگاه پیش‌فرض (2947) متصل می‌شود و تمامی دستگاه‌های بازشده توسط \fBgpsd\fP را نظارت می‌کند.
.sp
\fBgps2udp\fP می‌تواند به‌صورت یک دیمن (گزینه \fB\-b\fP) اجرا شود.
.sp
\fBgps2udp\fP به‌گونه‌ای طراحی شده است که به‌خوبی در پس‌زمینه اجرا شود؛ در صورت راه‌اندازی مجدد \fBgpsd\fP، این ابزار به‌طور خودکار دوباره به آن متصل می‌شود. برای مقاصد اشکال‌زدایی، گزینه‌ای برای خروج تمیز پس از ارسال تعداد مشخصی بسته در نظر گرفته شده است (گزینه \fB\-c\fP).
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
چاپ پیام راهنمای نحوه استفاده و خروج.
.RE
.sp
\fB\-a\fP, \fB\-\-ais\fP
.RS 4
فقط ارسال پیام‌های AIS.
.RE
.sp
\fB\-b\fP, \fB\-\-daemon\fP
.RS 4
اجرای \fBgps2udp\fP به‌صورت یک دیمن (در پس‌زمینه).
.RE
.sp
\fB\-c COUNT\fP, \fB\-\-count COUNT\fP
.RS 4
خروج پس از ارسال COUNT جمله.
.RE
.sp
\fB\-d LVL\fP, \fB\-\-debug LVL\fP
.RS 4
تنظیم سطح اشکال‌زدایی روی LVL. مقدار LVL = 0 چیزی چاپ نمی‌کند. مقدار LVL = 1 بسته‌های ارسالی را در خروجی استاندارد چاپ می‌کند. مقدار LVL = 2 بسته‌های نادیده‌گرفته‌شده را چاپ می‌کند.
.RE
.sp
\fB\-j\fP, \fB\-\-json\fP
.RS 4
باعث خروجی داده شدن جملات JSON می‌شود.
.RE
.sp
\fB\-n\fP, \fB\-\-nmea\fP
.RS 4
باعث خروجی داده شدن جملات NMEA می‌شود.
.RE
.sp
\fB\-t\fP, \fB\-\-tpv\fP
.RS 4
تنها خروجی دادن جملات TPV. به طور ضمنی شامل \-\-json نیز می‌شود.
.RE
.sp
\fB\-u HOST:PORT\fP, \fB\-\-udp HOST:PORT\fP
.RS 4
مقصد UDP برای جملات خروجی (تا حداکثر پنج مقصد).
.RE
.sp
\fB\-v\fP, \fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ نسخه برنامه و خروج. گزینه \-v از دسامبر ۲۰۲۰ منسوخ شده است.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی \fBgpsd\fP که روی localhost اجرا می‌شود و با استفاده از درگاه پیش‌فرض GPSD یعنی 2947 جمع‌آوری می‌کنند. با آرگومان اختیاری کلاینت می‌توان این رفتار را بازنویسی کرد: \fB[server[:port[:device]]]\fP
.sp
برای توضیحات بیشتر و مشاهده مثال‌ها، به بخش \fBARGUMENTS\fP در صفحه راهنمای \fBgps\fP(1) مراجعه کنید.
.SH "مثال‌ها (EXAMPLES)"
.sp
با وجود یک \fBgpsd\fP در حال اجرا و قابل دسترسی روی شبکه، دستور زیر داده‌ها را از localhost:gpsd جمع‌آوری کرده، آن‌ها را در خروجی استاندارد (stdout) نمایش می‌دهد و رونوشتی از آن را در قالب NMEA برای آزمایش به aishub ارسال می‌کند:
.sp
.if n .RS 4
.nf
.fam C
gps2udp \-d 1 \-n \-u data.aishub.net:2222
.fam
.fi
.if n .RE
.sp
دستور زیر داده‌ها را از یک \fBgpsd\fP دوردست مستقر بر روی میزبان fridu.net جمع‌آوری کرده، پیام‌های AIS را فیلتر می‌کند و آن‌ها را در قالب NMEA به ۳ مقصد (aishub، marinetraffic و shipfinder) می‌فرستد، در حالی که در حالت پس‌زمینه اجرا می‌شود:
.sp
.if n .RS 4
.nf
.fam C
gps2udp \-a \-n \-b \-u data.aishub.net:2222 \-u 5.9.207.224:5321 \(rs
   \-u 109.200.19.151:4001 fridu.net:2947
.fam
.fi
.if n .RE
.SH "مقادیر بازگشتی (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgps\fP(1)
.SH "منابع (RESOURCES)"
.sp
\fBوبگاه پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر این پرونده در سال ۲۰۱۳ متعلق به پروژه GPSD است.
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسنده (AUTHOR)"
.sp
Fulup Ar Foll