'\" t
.\"     Title: cgps
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD Version 3.27.5
.\"  Language: English
.\"
.TH "CGPS" "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)"
cgps \- کلاینت پایانه مبتنی بر curses برای gpsd
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcgps\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBcgps\fP \-h
.sp
\fBcgps\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBcgps\fP یک کلاینت \fBgpsd\fP مبتنی بر ncurses است. این برنامه قادر است روی یک پایانه سریال یا شبیه‌ساز پایانه اجرا شود. عملکرد آن شبیه به \fBxgps\fP(1) است، اما فاقد نمایش نگاره‌ای ماهواره‌ها بوده و به X یا سایر سیستم‌های پنجره‌بندی نیازی ندارد.
.sp
دستور \fBcgps\fP به دسترسی‌های ریشه (root) نیازی ندارد؛ هرچند با کاربر ریشه نیز بدون مشکل اجرا می‌شود. با این حال، اجرا از طریق sudo باعث از دست رفتن کارکردها خواهد شد.
.sp
هیچ‌یک از برآوردهای خطای ارائه‌شده توسط \fBgpsd\fP و نمایش‌داده‌شده توسط \fBcgps\fP نباید فراتر از سطح «کیفیت نسبی» در نظر گرفته شوند. سازندگان گیرنده‌های GNSS معمولاً مبنای برآوردهای خود را مستندسازی نمی‌کنند. آن‌هایی هم که برآوردهایشان را مستند می‌کنند، در تعریف و مفهوم آن‌ها ناهماهنگ و متناقض هستند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
چاپ خلاصه‌ای از گزینه‌ها و سپس خروج.
.RE
.sp
\fB\-D LVL\fP, \fB\-\-debug LVL\fP
.RS 4
تنظیم سطح اشکال‌زدایی؛ این گزینه عمدتاً برای استفاده توسعه‌دهندگان GPSD است. پیام‌های مختلف پیشرفت را در خروجی خطای استاندارد فعال می‌کند.
.RE
.sp
\fB\-i\fP, \fB\-\-imu\fP
.RS 4
نمایش IMU به جای داده‌های موقعیت (fix) و ماهواره.
.RE
.sp
\fB\-l FMT\fP, \fB\-\-llfmt FMT\fP
.RS 4
تنظیم قالب گزارش‌های عرض و طول جغرافیایی. مقدار \*(Aqd\*(Aq درجات اعشاری را تولید می‌کند که حالت پیش‌فرض است. مقدار \*(Aqm\*(Aq درجات و دقایق اعشاری را تولید می‌کند. مقدار \*(Aqs\*(Aq درجات، دقایق و ثانیه‌های اعشاری را ارائه می‌دهد.
.RE
.sp
\fB\-m\fP, \fB\-\-magtrack\fP
.RS 4
نمایش مسیرها به‌صورت مغناطیسی، نه واقعی.
.RE
.sp
\fB\-m\fP, \fB\-\-magtrack\fP
.RS 4
نمایش مسیر مغناطیسی شما (در برابر مسیر واقعی‌تان). این مقدار محاسبه‌شده است و نه اندازه‌گیری‌شده. انحراف مغناطیسی همواره می‌تواند مستعد خطاهای بزرگ باشد، اما معمولاً خطای آن کمتر از دو درجه است.
.RE
.sp
\fB\-s\fP, \fB\-\-silent\fP
.RS 4
جلوگیری از نمایش داده‌های خام دریافتی از دیمن توسط \fBcgps\fP. این نمایش را می‌توان با کلید s نیز تغییر وضعیت داد.
.RE
.sp
\fB\-u UNITS\fP, \fB\-\-units UNITS\fP
.RS 4
تنظیم واحدهای سیستم برای نمایش؛ پس از این کلیدواژه، از \*(Aqi\*(Aq یا \*(Aqimperial\*(Aq برای واحدهای آمریکایی (فوت بین‌المللی برای ارتفاع و برآورد خطا، مایل بر ساعت برای سرعت)، از \*(Aqn\*(Aq یا \*(Aqnautical\*(Aq برای واحدهای دریایی (فوت در ارتفاع و برآورد خطا، گره دریایی برای سرعت) و از \*(Aqm\*(Aq یا \*(Aqmetric\*(Aq برای واحدهای متریک (متر برای ارتفاع و برآورد خطا، کیلومتر بر ساعت برای سرعت) استفاده کنید.
.sp
نکته: واحد USA Survey Foot پشتیبانی نمی‌شود.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ نسخه بسته و خروج.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی \fBgpsd\fP که روی localhost با درگاه پیش‌فرض GPSD یعنی ۲۹۴۷ اجرا می‌شود، دریافت می‌کنند. با استفاده از آرگومان اختیاری برای هر کلاینت می‌توان این رفتار را بازنویسی کرد: \fB[server[:port[:device]]]\fP
.sp
برای توضیحات بیشتر و مثال‌ها، بخش \fBARGUMENTS\fP را در صفحه راهنمای \fBgps\fP(1) مشاهده کنید.
.SH "دستورها (COMMANDS)"
.sp
دستور \fBcgps\fP با ارسال سیگنال SIGHUP یا SIGINT متوقف می‌شود؛ با توجه به تنظیمات پیش‌فرض پایانه، این کار هنگام فشردن کلیدهای Ctrl\-C صورت می‌گیرد.
.sp
دستور \fBcgps\fP در حین اجرا چند دستور تک‌حرفی را می‌پذیرد:
.sp
\fBc\fP
.RS 4
پاک کردن پنجره پایینی.
.RE
.sp
\fBd\fP
.RS 4
نمایش طول/عرض جغرافیایی در قالب‌های dd.dddddddd و dd mm.mmmmmm و dd mm ss.ssss.
.RE
.sp
\fBh\fP
.RS 4
نمایش پنجره راهنما.
.RE
.sp
\fBi\fP
.RS 4
استفاده از واحدهای امپریال (imperial).
.RE
.sp
\fBm\fP
.RS 4
استفاده از واحدهای متریک (metric).
.RE
.sp
\fBn\fP
.RS 4
استفاده از واحدهای دریایی (nautical).
.RE
.sp
\fBq\fP
.RS 4
پاک کردن صفحه و خروج.
.RE
.sp
\fBs\fP
.RS 4
تغییر وضعیت نمایش داده‌های خام JSON در پنجره پایینی.
.RE
.sp
\fBt\fP
.RS 4
تغییر وضعیت مسیر بین واقعی (true) و مغناطیسی (magnetic).
.RE
.SH "محیط (ENVIRONMENT)"
.sp
چنانچه هیچ سیستم واحدی در خط فرمان مشخص نشده باشد، متغیر محیطی \fBGPSD_UNITS\fP بررسی می‌شود. این متغیر می‌تواند مقادیر \*(Aqi\*(Aq، \*(Aqimperial\*(Aq، \*(Aqm\*(Aq، \*(Aqmetric\*(Aq یا \*(Aqn\*(Aq، \*(Aqnautical\*(Aq را داشته باشد.
.sp
اگر هیچ سیستم واحدی در خط فرمان یا در GPSD_UNITS مشخص نشده باشد، ابتدا LC_MEASUREMENT و سپس LANG بررسی می‌شوند. چنانچه این مقدار برابر با \*(AqC\*(Aq، \*(AqPOSIX\*(Aq باشد یا با \*(Aqen_US\*(Aq آغاز شود، سیستم واحدها روی imperial تنظیم می‌شود. در صورتی که هیچ سیستمی انتخاب نشده باشد، مقدار پیش‌فرض metric خواهد بود.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.sp
\fB2\fP
.RS 4
خطا: پایانه بسیار کوچک است.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgegps\fP(1)، \fBgpsctl\fP(1)، \fBgps\fP(1)، gpsprof*(1)، \fBgpsfake\fP(1)،
\fBgpscat\fP(1)، \fBgpspipe\fP(1)، \fBxgps\fP(1)، \fBxgpsspeed\fP(1)
.sp
\fBlibgps\fP(3)، \fBlibgpsmm\fP(3)
.sp
\fBgpsd\fP(8)
.SH "منابع (RESOURCES)"
.sp
\fBتارنمای پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
این پرونده دارای حق نشر ۲۰۱۳ متعلق به پروژه GPSD است
.br
SPDX\-License\-Identifier: BSD\-2\-clause