man/network
man · Ağ

$ snmptest

Bölüm 1 · Ağ

SNMP istekleri kullanarak bir ağ varlığıyla iletişim kurar

Sözdizimi

       snmptest [GENEL SEÇENEKLER] ARACI

Açıklama

snmptest, bir ağ varlığı üzerindeki bilgileri izleyebilen ve yönetebilen esnek bir SNMP uygulamasıdır.

Program çağrıldıktan sonra, bir komut satırı yorumlayıcısı komutları kabul etmeye başlar. Bu yorumlayıcı, kullanıcının hedef aracılara farklı türlerde SNMP istekleri göndermesini sağlar.

ARACI (AGENT), verilen nesneleri izlemek üzere donatılmış bir hedef SNMP aracısını tanımlar. En basit haliyle ARACI tanımı, bir ana bilgisayar adı (hostname) veya bir IPv4 adresinden oluşur. Bu durumda komut, verilen hedef ana bilgisayarın 161 numaralı bağlantı noktasına (port) UDP/IPv4 kullanarak aracı ile iletişim kurmaya çalışacaktır. ARACI için olası biçimlerin tam listesi için snmpcmd(1) sayfasına bakın.

snmptest çağrıldıktan sonra, komut satırı yorumlayıcısı şu istemi görüntüler:

Variable:

Bu noktada, her satıra bir tane olmak üzere bir veya daha fazla değişken adı girebilirsiniz. Boş bir satır, parametre girişini sonlandırır ve isteği (girilen değişkenleri) tek bir paket halinde uzak varlığa gönderir. Her değişken adı variables(5) içinde belirtilen biçimde verilir. Örneğin:

snmptest -c public -v 1 zeus Variable: system.sysDescr.0 Variable:

istek ve yanıt paketleri hakkında bazı bilgilerin yanı sıra şu bilgileri de döndürecektir:

requestid 0x5992478A errstat 0x0 errindex 0x0 system.sysDescr.0 = STRING: "Unix 4.3BSD"

errstatus değeri, çağrı için hata durumu kodunu gösterir. errstat için olası değerler snmp.h başlık dosyasında yer alır. errindex değeri, verilen hataya sahip olan değişkeni tanımlar. İndeks değerleri, "Variable:" isteminde girilen tüm değişkenlere atanır. İlk değere 1 indeksi atanır.

Başlangıçta, program varsayılan olarak bir GET istek paketi gönderir. İstek türü, "Variable:" isteminde aşağıdaki komutlardan biri yazılarak değiştirilebilir:

$G - bir GET isteği gönderir $N - bir GETNEXT isteği gönderir $S - bir SET isteği gönderir $B - bir GETBULK isteği gönderir Not: GETBULK, SNMPv1'de mevcut değildir $I - bir Inform isteği gönderir $T - bir SNMPv2 Trap isteği gönderir

"Variable:" isteminde girilebilecek diğer değerler şunlardır:

$D - gönderilen ve alınan her paketin dökümünün (dump) yapılıp yapılmayacağını değiştirir (açıp kapatır) $QP - daha hızlı ve daha az ayrıntılı bir çıktı biçimini açıp kapatır $Q - Programdan çıkar

İstek Türleri:

GET İsteği:

"GET isteği" modundayken ($G veya varsayılan), kullanıcı "Variable:" isteminde bir OID girebilir. Kullanıcı, her istem için bir tane olmak üzere birden fazla OID girebilir. GET isteğini göndermek için kullanıcı boş bir satır girer.

GETNEXT İsteği:

"GETNEXT isteği" modu ($N), yukarıda açıklanan "GET isteği" moduna benzer.

SET İsteği:

"SET isteği" modundayken ($S), her değişken için istem tarafından daha fazla bilgi istenir. İstem:

Type [i|s|x|d|n|o|t|a]:

değişkenin türünün girilmesini ister. Ayarlamak istediğiniz değerin türüne bağlı olarak aşağıdakilerden birini yazabilirsiniz:

i - integer (tamsayı) u - unsigned integer (işaretsiz tamsayı) s - ASCII formatında octet string (sekizli dize) x - boşluklarla ayrılmış onaltılık (hex) baytlar halinde octet string d - boşluklarla ayrılmış ondalık (decimal) baytlar halinde octet string a - noktalı IP gösteriminde IP adresi o - nesne tanımlayıcı (object identifier / OID) n - null (boş) t - timeticks (zaman birimi)

Bu noktada bir değer istenecektir:

Value:

Eğer bu bir tamsayı (integer) değer ise, sadece tamsayıyı (ondalık tabanda) yazın. Eğer bir ondalık dize (decimal string) ise, dizenin her bir baytı için bir tane olacak şekilde boşlukla ayrılmış ondalık sayıları girin. Paketi göndermek için değişken adı isteminde tekrar boş bir satır girin.

GETBULK İsteği:

"GETBULK isteği" modu ($B), "SET isteği" moduna benzer. Ancak GETBULK, SNMPv1'de mevcut değildir.

Inform İsteği:

"Inform isteği" modu ($I), "SET isteği" moduna benzer. Ancak bu istek türü SNMPv1'de mevcut değildir. Ayrıca snmptest komutunda belirtilen aracı (agent), hedef snmptrapd aracısına karşılık gelmelidir.

SNMPv2 Trap İsteği:

"SNMPv2 Trap İsteği" modu ($T), "SET isteği" moduna benzer. Ancak bu istek türü SNMPv1'de mevcut değildir. Ayrıca snmptest komutunda belirtilen aracı (agent), hedef snmptrapd aracısına karşılık gelmelidir.

Seçenekler

snmptest, snmpcmd(1) kılavuz sayfasında açıklanan genel seçenekleri alır.

Örnekler

       Aşağıda, iki OID için bir GET isteği gönderilmesine dair bir örnek yer almaktadır:

       % snmptest -v 2c -c public testhost:9999

       Variable: system.sysDescr.0
       Variable: system.sysContact.0
       Variable:
       Received Get Response from 128.2.56.220
       requestid 0x7D9FCD63 errstat 0x0 errindex 0x0
       SNMPv2-MIB::sysDescr.0 = STRING: SunOS testhost 5.9 Generic_112233-02 sun4u
       SNMPv2-MIB::sysContact.0 = STRING: x1111

       Aşağıda, bir GETNEXT isteği gönderilmesine dair bir örnek yer almaktadır:

       Variable: SNMPv2-MIB::sysORUpTime
       Variable:
       Received Get Response from 128.2.56.220
       requestid 0x7D9FCD64 errstat 0x0 errindex 0x0
       SNMPv2-MIB::sysORUpTime.1 = Timeticks: (6) 0:00:00.06
       Variable:

       Aşağıda, bir SET isteği gönderilmesine dair bir örnek yer almaktadır:

       Variable: $S
       Request type is Set Request
       Variable: system.sysLocation.0
       Type [i|u|s|x|d|n|o|t|a]: s
       Value: building 17
       Variable:
       Received Get Response from 128.2.56.220
       requestid 0x7D9FCD65 errstat 0x0 errindex 0x0
       SNMPv2-MIB::sysLocation.0 = STRING: building A
       Variable:

       Aşağıda, bir GETBULK isteği gönderilmesine dair bir örnek yer almaktadır:

       Variable: $B
       Request type is Bulk Request
       Enter a blank line to terminate the list of non-repeaters
       and to begin the repeating variables
       Variable:
       Now input the repeating variables
       Variable: system.sysContact.0
       Variable: system.sysLocation.0
       Variable:
       What repeat count? 2
       Received Get Response from 128.2.56.220
       requestid 0x2EA7942A errstat 0x0 errindex 0x0
       SNMPv2-MIB::sysName.0 = STRING: testhost
       SNMPv2-MIB::sysORLastChange.0 = Timeticks: (58) 0:00:00.58
       SNMPv2-MIB::sysLocation.0 = STRING: bldg A
       SNMPv2-MIB::sysORID.1 = OID: IF-MIB::ifMIB
       Variable:

       Aşağıda, bir Inform isteği gönderilmesine dair bir örnek yer almaktadır:

       snmptest -v 2c -c public snmptrapd_host
       Variable: $I
       Request type is Inform Request
       (Are you sending to the right port?)
       Variable: system.sysContact.0
       Type [i|u|sIx|d|n|o|t|a]: s
       Value: x12345
       Variable:
       Inform Acknowledged
       Variable:

       snmptrapd_host şunları gösterecektir:

       snmptrapd_host [<ip address>]: Trap SNMPv2-MIB::sysContact.0 = STRING: x12345

       Aşağıda, bir SNMPv2 Trap isteği gönderilmesine dair bir örnek yer almaktadır:

       snmptest -v 2c -c public snmptrapd_host
       Variable: $T
       Request type is SNMPv2 Trap Request
       (Are you sending to the right port?)
       Variable: system.sysLocation.0
       Type [i|u|s|x|d|n|o|t|a]: s
       Value: building a
       Variable:

       snmptrapd_host şunları gösterecektir:

       snmptrapd_host [<ip address>]: Trap SNMPv2-MIB::sys.0 = STRING:
       building a

Ayrıca Bakınız

snmpcmd(1), snmpget(1), snmpset(1), variables(5)