Özet

       snmptrapd [SEÇENEKLER] [DİNLEME ADRESLERİ]

Açıklama

snmptrapd, SNMP TRAP ve INFORM mesajlarını alan ve günlüğe kaydeden bir SNMP uygulamasıdır.

Not: Varsayılan olarak tüm IPv4 arayüzlerinde UDP portu 162 dinlenir. 162 ayrıcalıklı bir port olduğundan, snmptrapd'nin genellikle root olarak çalıştırılması gerekir.

Seçenekler

-a: authenticationFailure trap'lerini yoksay.
-A: Günlük dosyasının üzerine yazmak (kırpmak) yerine sonuna ekle.

Bunun, uygulanması gereken herhangi bir -Lf seçeneğinden önce gelmesi gerektiğini unutmayın.

-c DOSYA DOSYA'yı bir yapılandırma dosyası (veya virgülle ayrılmış bir yapılandırma dosyaları listesi) olarak oku.

-C: İsteğe bağlı olarak -c seçeneği ile belirtilen dosya dışındaki hiçbir yapılandırma dosyasını okuma.
-d: Gönderilen ve alınan SNMP paketlerinin dökümünü (onaltılık/hexadecimal formatta) çıkar.

-D[BELİRTEÇ[,...]] Belirtilen BELİRTEÇ(ler) için hata ayıklama çıktısını etkinleştir. Son derece ayrıntılı çıktı için ALL seçeneğini deneyin.

-f: Çağıran kabuktan (shell) fork() yapma.

-F BİÇİM Standart çıktıya günlüğe kaydederken, BİÇİM dizgesindeki biçimi kullanın. Daha fazla ayrıntı için aşağıdaki BİÇİM ÖZELLİKLERİ bölümüne bakın.

-h, --help Kısa bir kullanım mesajı görüntüle ve ardından çık.

-H: Trap arka plan programı (daemon) tarafından anlaşılan yapılandırma dosyası yönergelerinin bir listesini görüntüle ve ardından çık.

-I [-]İLKLENDİRME_LİSTESİ snmptrapd başladığında hangi modüllerin ilklendirilmesi (veya ilklendirilmemesi) gerektiğini belirtir. Virgülle ayrılmış İLKLENDİRME_LİSTESİ'nin önünde bir '-' varsa, bu başlatılmaması gereken modüllerin listesidir. Aksi takdirde, bu yalnızca başlatılması gereken modüllerin listesidir.

Derlenmiş modüllerin bir listesini almak için, snmptrapd'yi -Dmib_init -H argümanlarıyla çalıştırın (hata ayıklama desteğinin derlendiği varsayılırsa).

-L[efos] Günlük çıktısının nereye yönlendirileceğini belirtir (standart hata veya çıktı, bir dosyaya veya syslog aracılığıyla). Ayrıntılar için snmpcmd(1) içindeki GÜNLÜKLEME SEÇENEKLERİ bölümüne bakın.

-m MİB_LİSTESİ Bu uygulama için yüklenecek MIB modüllerinin iki nokta üst üste ile ayrılmış bir listesini belirtir. Bu, MIBS çevre değişkenini geçersiz kılar. Ayrıntılar için snmpcmd(1) kılavuzuna bakın.

-M DİZİN_LİSTESİ MIB'lerin aranacağı dizinlerin iki nokta üst üste ile ayrılmış bir listesini belirtir. Bu, MIBDIRS çevre değişkenini geçersiz kılar. Ayrıntılar için snmpcmd(1) kılavuzuna bakın.

-n: Gelen paketlerin kaynak adreslerini ana bilgisayar adlarına (hostname) dönüştürmeye çalışmama.

-p DOSYA Trap arka plan programının işlem kimliğini (PID) DOSYA içine kaydet.

-O [abeEfnqQsStTuUvxX] MIB nesnelerinin ve diğer çıktıların nasıl görüntüleneceğini belirtir. Ayrıntılar için snmpcmd(1) kılavuz sayfasındaki ÇIKTI SEÇENEKLERİ bölümüne bakın.

-t: Trap'leri syslog'a kaydetme. Bu, syslog'a günlüğe kaydetmeyi devre dışı bırakır. Bu seçenek, snmptrapd uygulamasının yalnızca traphandle kancalarını (hooks) çalıştırmasını ve herhangi bir konuma trap kaydetmemesini istiyorsanız kullanışlıdır.

-v, --version Trap arka plan programının sürüm bilgisini yazdır ve ardından çık.

-x ADRES Varsayılan "/var/agentx/master" adresi yerine, belirtilen adresteki AgentX ana aracısına (master agent) bağlan. Bu tür adreslerin biçiminin ayrıntıları için snmpd(8) kılavuzuna bakın.

--name="değer" snmptrapd.conf dosyasında desteklenen herhangi bir belirtecin ("ad") belirtilmesine izin verir ve değerini "değer" olarak ayarlar. snmptrapd.conf dosyasındaki karşılık gelen belirteci geçersiz kılar. Belirteçlerin tam listesi için snmptrapd.conf(5) kılavuzuna bakın.

Biçim Özellikleri

snmptrapd, biçim dizgelerini (format strings) printf(3) işlevine benzer şekilde yorumlar. Aşağıdaki biçimlendirme dizilerini anlar:

%% harfi harfine bir %

%a PDU'nun agent-addr alanının içeriği (yalnızca v1 TRAP'leri için)

%A varsa PDU'nun agent-addr alanının içeriğine karşılık gelen ana bilgisayar adı, aksi takdirde PDU'nun agent-addr alanının içeriği (yalnızca v1 TRAP'leri için).

%b PDU kaynak adresi (Not: Bu adresin mutlaka bir IPv4 adresi olması gerekmez)

%B varsa PDU kaynak ana bilgisayar adı, aksi takdirde PDU kaynak adresi (yukarıdaki nota bakın)

%h yerel sistemdeki geçerli saat

%H sysUpTime.0 değişken bağlamasındaki (varbind) saat alanı

%j yerel sistemdeki geçerli dakika

%J sysUpTime.0 değişken bağlamasındaki (varbind) dakika alanı

%k yerel sistemdeki geçerli saniye

%K sysUpTime.0 değişken bağlamasındaki (varbind) saniye alanı

%l yerel sistemdeki geçerli ayın günü

%L sysUpTime.0 değişken bağlamasındaki (varbind) ayın günü alanı

%m yerel sistemdeki geçerli (sayısal) ay

%M sysUpTime.0 değişken bağlamasındaki (varbind) sayısal ay alanı

%N kuruluş (enterprise) dizgesi

%q trap alt türü (sayısal, ondalık tabanda)

%P PDU'dan alınan güvenlik bilgileri (v1/v2c için topluluk adı [community name], v3 için kullanıcı ve bağlam [user and context])

%t işletim sistemi başlangıcından (epoch) itibaren geçen saniye cinsinden ondalık sayı (time(2) tarafından döndürüldüğü gibi)

%T sysUpTime.0 değişken bağlamasının (varbind) saniye cinsinden değeri

%v bildirim yükünden (notification payload) alınan değişken bağlamalarının (variable-bindings) listesi. Bunlar bir sekme (tab) karakteriyle veya alternatif biçim talep edilirse bir virgül ve bir boşlukla ayrılır. Ayrıca bkz. %V

%V değişken bağlama (variable-bindings) ayırıcısını belirtir. Bu, bir sonraki % karakterine kadar bir karakter dizisi alır (dizgeye bir % gömmek için % kullanın)

%w trap türü (sayısal, ondalık tabanda)

%W trap açıklaması

%y yerel sistemdeki geçerli yıl

%Y sysUpTime.0 değişken bağlamasındaki (varbind) yıl alanı

Bu değerlere ek olarak, tıpkı printf(3) işlevinde olduğu gibi isteğe bağlı bir alan genişliği ile hassasiyeti ve bir bayrak (flag) değeri de belirtilebilir. Aşağıdaki bayraklar desteklenmektedir:

sola yasla

0 öncü sıfırları kullan

alternatif biçim kullan

"Alternatif biçim kullan" bayrağı, çeşitli biçim dizgesi dizilerinin davranışını değiştirir:

Zaman bilgisi (yerel saat dilimi yerine) GMT temel alınarak görüntülenecektir

Değişken bağlamaları (sekme ile ayrılmış liste yerine) virgülle ayrılmış bir liste olacaktır

Sistem çalışma süresi (simple integer/basit bir tam sayı olmak yerine) insanlar için anlamlı bir biçime dönüştürülecektir

Örnekler: "14:03 TRAP3.1 from humpty.ucd.edu" gibi bir mesaj almak için şuna benzer bir şey kullanabilirsiniz:

snmptrapd -P -F "%02.2h:%02.2j TRAP%w.%q from %A\n"

Aynı şeyi yerel saat yerine GMT olarak istiyorsanız şunu kullanın:

snmptrapd -P -F "%#02.2h:%#02.2j TRAP%w.%q from %A\n"

Dinleme Adresleri

Varsayılan olarak snmptrapd, tüm IPv4 arayüzlerinde UDP portu 162 üzerinden gelen SNMP TRAP ve INFORM paketlerini dinler. Ancak, snmptrapd'ye argüman olarak bir veya daha fazla dinleme adresi belirterek bu davranışı değiştirmek mümkündür. Dinleme adreslerinin biçimi hakkında daha fazla bilgi için snmpd(8) kılavuz sayfasına bakın.

Notification-Log-Mib Desteği

net-snmp 5.0 itibarıyla, snmptrapd uygulaması NOTIFICATION-LOG-MIB desteği sunmaktadır. Bunu, ana (master) snmpd aracısına bir AgentX alt aracı (subagent) bağlantısı açarak ve bildirim günlüğü tablolarını kaydederek yapar. snmpd uygulaması önce başlatıldığı sürece, snmptrapd kendisini ona bağlayacaktır ve böylece nlmLogTable ile nlmLogVariableTable aracılığıyla kaydedilen son bildirimleri görüntüleyebilmeniz gerekir. Bu desteği kapatmak için snmptrapd.conf dosyasına ve "doNotRetainNotificationLogs" belirtecine bakın. MIB'in kendisi hakkında daha fazla ayrıntı için NOTIFICATION-LOG-MIB belgesine bakın.

GENİŞLETİLEBİLİRLİK VE YAPILANDIRMA Bkz. snmptrapd.conf(5) kılavuz sayfası.

Ayrıca Bkz.

snmpcmd(1), snmpd(8), printf(3), snmptrapd.conf(5), syslog(8), variables(5)