نام (NAME)

gpssnmp - کلاینت کمکی SNMP برای gpsd

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

gpssnmp [OPTIONS] [server[:port[:device]]]

gpssnmp -h

gpssnmp -g OID

gpssnmp -n OID

gpssnmp -p

gpssnmp -V

توضیحات (DESCRIPTION)

gpssnmp یک کلاینت gpsd است که به عنوان دستیار SNMP برای MRTG عمل می‌کند.

gpssnmp نیازی به مجوزهای ریشه ندارد، اما با دسترسی ریشه نیز بدون مشکل اجرا می‌شود.

gpssnmp می‌تواند به عنوان یک عامل (agent) برای snmpd در حالت pass یا pass_persist عمل کند. بنابراین می‌توان از آن برای گسترش snmpd با GPSD-MIB استفاده کرد. با توجه به ماهیت پروتکل SNMP، انتظار تأخیر (latency) مناسبی نداشته باشید. داده‌های حاصل از دوره‌های زمانی (epochs) مختلف ممکن است با یکدیگر ترکیب شوند.

نکته

این برنامه در نسخهٔ 3.24.1 جدید است و طی چند نگارش آینده دستخوش تغییر خواهد شد. آن را یک کار در حال پیشرفت (WIP) در نظر بگیرید.

گزینه‌ها (OPTIONS)

-?, -h, --help

چاپ خلاصه‌ای از گزینه‌ها و سپس خروج. همراه با «-D 1» برای مشاهدهٔ مقادیر معتبر OID استفاده شود. همراه با «-D 2» برای مشاهدهٔ مقادیر معتبر OID به همراه مقادیر مقیاس و توضیحات استفاده شود.

-g OID

دریافت OID مشخص‌شده.

-n OID

دریافت OID بعدی با شروع از OID داده‌شده.

-p, --persist

ورود به حالت pass_persist. این گزینه هنگام استفاده به عنوان یک عامل برای دیمن snmpd، عملکرد بهتری را فراهم می‌سازد. برای جزئیات بیشتر به صفحهٔ راهنمای snmpd.conf مراجعه کنید.

-V, --version

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

مثال‌ها (EXAMPLES)

برای دریافت تعداد ماهواره‌های دیده‌شده با استفاده از OID:

$ 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

برای دریافت تعداد ماهواره‌های دیده‌شده با استفاده از نام MIB:

$ gpssnmp -g skynSat.1
.1.3.6.1.4.1.59054.11.2.1.3.1
INTEGER
15

اتصال به snmpd (Connecting to snmpd)

gpssnmp می‌تواند به عنوان یک «اسکریپت عبوری» (pass-through script) با snmpd کار کند. برای فعال‌سازی این قابلیت بر روی یک snmpd در حال اجرا، این خطوط را به فایل snmpd.conf خود افزوده و سپس snmpd را بازراه‌اندازی کنید:

# 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

سپس می‌توانید تعداد ماهواره‌های در حال استفاده را بدین شیوه جویا شوید:

$ snmpget -c public -v 2c localhost skynSat.1
GPSD-MIB::skynSat.1 = INTEGER: 16

تخلیهٔ کامل شاخهٔ OID مربوط به «sky» بدین شیوه:

$ 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

تخلیهٔ کامل GPSD-MIB بدین شیوه:

$ snmpwalk -c public -v 2c localhost gpsd
GPSD-MIB::tpvLeapSeconds = INTEGER: 18
GPSD-MIB::tpvNumber = INTEGER: 1
GPSD-MIB::tpvIndex.1 = INTEGER: 1
[...]

gpssnmp از حالت pass_persist دیمن snmpd پشتیبانی می‌کند. برای آنکه snmpd از gpssnmp در این حالت استفاده کند، این خط را در فایل snmpd.conf خود قرار دهید:

pass_persist .1.3.6.1.4.1.59054  /usr/local/bin/gpssnmp --persist

وضعیت خروج (EXIT STATUS)

0

در صورت موفقیت.

1

در صورت بروز خطا.

همچنین ببینید (SEE ALSO)

cgps(1), gps(1), gpspipe(1), snmpget(1), snmpwalk(1), xgps(1)

snmpd.conf(5)

gpsd(8), snmpd(8)

منابع (RESOURCES)

وبگاه پروژه: https://gpsd.io

کپی‌رایت و تکثیر (COPYRIGHT)

SPDX-FileCopyrightText: The GPSD project
SPDX-FileType: DOCUMENTATION
SPDX-License-Identifier: BSD-2-clause