'\" t
.\"     Title: gpssnmp
.\"    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 "GPSSNMP" "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)"
gpssnmp \- کلاینت کمکی SNMP برای gpsd
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgpssnmp\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBgpssnmp\fP \-h
.sp
\fBgpssnmp\fP \-g OID
.sp
\fBgpssnmp\fP \-n OID
.sp
\fBgpssnmp\fP \-p
.sp
\fBgpssnmp\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
\fBgpssnmp\fP یک کلاینت \fBgpsd\fP است که به عنوان دستیار SNMP برای \fBMRTG\fP عمل می‌کند.
.sp
\fBgpssnmp\fP نیازی به مجوزهای ریشه ندارد، اما با دسترسی ریشه نیز بدون مشکل اجرا می‌شود.
.sp
\fBgpssnmp\fP می‌تواند به عنوان یک عامل (agent) برای \fBsnmpd\fP در حالت \fIpass\fP یا \fIpass_persist\fP عمل کند. بنابراین می‌توان از آن برای گسترش \fBsnmpd\fP با \fBGPSD\-MIB\fP استفاده کرد. با توجه به ماهیت پروتکل \fBSNMP\fP، انتظار تأخیر (latency) مناسبی نداشته باشید. داده‌های حاصل از دوره‌های زمانی (epochs) مختلف ممکن است با یکدیگر ترکیب شوند.
.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
این برنامه در نسخهٔ 3.24.1 جدید است و طی چند نگارش آینده دستخوش تغییر خواهد شد. آن را یک کار در حال پیشرفت (WIP) در نظر بگیرید.
.sp .5v
.RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
چاپ خلاصه‌ای از گزینه‌ها و سپس خروج.
همراه با «\-D 1» برای مشاهدهٔ مقادیر معتبر OID استفاده شود.
همراه با «\-D 2» برای مشاهدهٔ مقادیر معتبر OID به همراه مقادیر مقیاس و توضیحات استفاده شود.
.RE
.sp
\fB\-g OID\fP
.RS 4
دریافت OID مشخص‌شده.
.RE
.sp
\fB\-n OID\fP
.RS 4
دریافت OID بعدی با شروع از OID داده‌شده.
.RE
.sp
\fB\-p\fP, \fB\-\-persist\fP
.RS 4
ورود به حالت \fIpass_persist\fP. این گزینه هنگام استفاده به عنوان یک عامل برای دیمن \fBsnmpd\fP، عملکرد بهتری را فراهم می‌سازد. برای جزئیات بیشتر به صفحهٔ راهنمای snmpd.conf مراجعه کنید.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ نسخهٔ بسته و خروج.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
برای دریافت تعداد ماهواره‌های دیده‌شده با استفاده از OID:
.sp
.if n .RS 4
.nf
.fam C
   $ gpssnmp \-g .1.3.6.1.4.1.59054.11.2.1.3.1
   .1.3.6.1.4.1.59054.11.2.1.3.1
   INTEGER
   15
.fam
.fi
.if n .RE
.sp
برای دریافت تعداد ماهواره‌های دیده‌شده با استفاده از نام MIB:
.sp
.if n .RS 4
.nf
.fam C
   $ gpssnmp \-g skynSat.1
   .1.3.6.1.4.1.59054.11.2.1.3.1
   INTEGER
   15
.fam
.fi
.if n .RE
.SS "اتصال به snmpd (Connecting to snmpd)"
.sp
\fBgpssnmp\fP می‌تواند به عنوان یک «اسکریپت عبوری» (pass\-through script) با \fBsnmpd\fP کار کند. برای فعال‌سازی این قابلیت بر روی یک snmpd در حال اجرا، این خطوط را به فایل \fBsnmpd.conf\fP خود افزوده و سپس \fBsnmpd\fP را بازراه‌اندازی کنید:
.sp
.if n .RS 4
.nf
.fam C
# be sure SNMPv2 community "public" can access all MIBs:
rocommunity public\&  localhost

# configure pass\-through of GPSD\-MIB to gpssnmp
pass .1.3.6.1.4.1.59054\&  /usr/local/bin/gpssnmp
.fam
.fi
.if n .RE
.sp
سپس می‌توانید تعداد ماهواره‌های در حال استفاده را بدین شیوه جویا شوید:
.sp
.if n .RS 4
.nf
.fam C
$ snmpget \-c public \-v 2c localhost skynSat.1
GPSD\-MIB::skynSat.1 = INTEGER: 16
.fam
.fi
.if n .RE
.sp
تخلیهٔ کامل شاخهٔ OID مربوط به «sky» بدین شیوه:
.sp
.if n .RS 4
.nf
.fam C
$ snmpwalk \-c public \-v 2c localhost GPSD\-MIB::sky
GPSD\-MIB::skynSat.1 = INTEGER: 17
GPSD\-MIB::skyuSat.1 = INTEGER: 8
GPSD\-MIB::skySNRavg.1 = INTEGER: 2000
.fam
.fi
.if n .RE
.sp
تخلیهٔ کامل GPSD\-MIB بدین شیوه:
.sp
.if n .RS 4
.nf
.fam C
$ snmpwalk \-c public \-v 2c localhost gpsd
GPSD\-MIB::tpvLeapSeconds = INTEGER: 18
GPSD\-MIB::tpvNumber = INTEGER: 1
GPSD\-MIB::tpvIndex.1 = INTEGER: 1
[...]
.fam
.fi
.if n .RE
.sp
\fBgpssnmp\fP از حالت \fIpass_persist\fP دیمن snmpd پشتیبانی می‌کند. برای آنکه \fBsnmpd\fP از \fBgpssnmp\fP در این حالت استفاده کند، این خط را در فایل \fIsnmpd.conf\fP خود قرار دهید:
.sp
.if n .RS 4
.nf
.fam C
pass_persist .1.3.6.1.4.1.59054\&  /usr/local/bin/gpssnmp \-\-persist
.fam
.fi
.if n .RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcgps\fP(1), \fBgps\fP(1), \fBgpspipe\fP(1), \fBsnmpget\fP(1), \fBsnmpwalk\fP(1), \fBxgps\fP(1)
.sp
\fBsnmpd.conf\fP(5)
.sp
\fBgpsd\fP(8), \fBsnmpd\fP(8)
.SH "منابع (RESOURCES)"
.sp
\fBوبگاه پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
SPDX\-FileCopyrightText: The GPSD project
.br
SPDX\-FileType: DOCUMENTATION
.br
SPDX\-License\-Identifier: BSD\-2\-clause