---------------------------------------------------------------------------
Copyright (c) 1998 Microsoft Corporation
Module Name: WSnmpUtil.exe
File : ReadMe.txt
Description: This sample demonstrates the usage of WinSNMP Manager APIs
through the development of a SNMP Manager Application.
It supports the GET, GETNEXT, and SET operations of SNMP
Version 1, and the GETBULK operation of SNMP Version 2.
The extension operation WALK and SUBTREE are implemented
using the GETNEXT operation.
----------------------------------------------------------------------------
---------------------
Supported Platforms:
---------------------
Windows 2000 or later.
---------------------
Building this sample:
---------------------
To build the sample application, you need Windows 2000 Beta 2
Platform SDK or later to obtain the correct headers and libs
NMAKE
----------------------------------
Examples of using WSnmpUtil.exe:
----------------------------------
Listening for Trap
==================
Start wsnmputil to listen for traps sending to your machine by
C:\>wsnmputil trap
WSnmpUtil: listening for traps...
Stop and start your SNMP service which is configured to send trap
to the localhost as one of the trap destinations by
C:\net stop snmp
C:\net start snmp
You will then see the traps received by wsnmputil similar to the following:
C:\>wsnmputil trap
WSnmpUtil: listening for traps...
Agent : 127.0.0.1
OID :1.3.6.1.2.1.1.3.0
OID string: system.sysUpTime.0
TIMETICKS: 0
OID :1.3.6.1.6.3.1.1.4.1.0
OID string: .iso.org.dod.internet.6.3.1.1.4.1.0
OBJECT IDENTIFIER - .1.3.6.1.6.3.1.1.5.1
ColdStart
OID :1.3.6.1.6.3.1.1.4.3.0
OID string: .iso.org.dod.internet.6.3.1.1.4.3.0
OBJECT IDENTIFIER - .1.3.6.1.4.1.311.1.1.3.1.2
Enterprise specific oid from v1 trap
Get operation
=============
*Get the value of toasterManufacturer on toaster agent
C:\>wsnmputil -v1 get toaster public 1.3.6.1.4.1.12.2.1.0
OID :1.3.6.1.4.1.12.2.1.0
.iso.org.dod.internet.private.enterprises.12.2.1.0
OCTET STRING - Microsoft Corporation
GetNext operation
=================
*Get the lexicographic successor of toasterManufacturer on toaster agent
C:\>wsnmputil -v1 getnext toaster public 1.3.6.1.4.1.12.2.1.0
OID :1.3.6.1.4.1.12.2.2.0
.iso.org.dod.internet.private.enterprises.12.2.2.0
OCTET STRING - Example SNMP Extension Agent for Windows/NT (TOASTER-MIB).
Subtree operation
=================
*Get the subtree of the toaster mib on toaster agent
C:\>wsnmputil -v1 subtree toaster public 1.3.6.1.4.1.12.2
OID :1.3.6.1.4.1.12.2.1.0
.iso.org.dod.internet.private.enterprises.12.2.1.0
OCTET STRING - Microsoft Corporation
OID :1.3.6.1.4.1.12.2.2.0
.iso.org.dod.internet.private.enterprises.12.2.2.0
OCTET STRING - Example SNMP Extension Agent for Windows/NT (TOASTER-MIB).
OID :1.3.6.1.4.1.12.2.3.0
.iso.org.dod.internet.private.enterprises.12.2.3.0
INTEGER: 1
OID :1.3.6.1.4.1.12.2.4.0
.iso.org.dod.internet.private.enterprises.12.2.4.0
INTEGER: 2
OID :1.3.6.1.4.1.12.2.5.0
.iso.org.dod.internet.private.enterprises.12.2.5.0
INTEGER: 3
Set operation
=============
*Set toasterToastType on toaster agent to 2
C:\>wsnmputil -v1 get toaster public 1.3.6.1.4.1.12.2.5.0
OID :1.3.6.1.4.1.12.2.5.0
.iso.org.dod.internet.private.enterprises.12.2.5.0
INTEGER: 3
C:\>wsnmputil -v1 set toaster public 1.3.6.1.4.1.12.2.5.0 2
Succeeded in setting the OID value ..
C:\>wsnmputil -v1 get toaster public 1.3.6.1.4.1.12.2.5.0
OID :1.3.6.1.4.1.12.2.5.0
.iso.org.dod.internet.private.enterprises.12.2.5.0
INTEGER: 2
GetBulk operation
=================
*Get the lexicographic successor of sysObjectID and 2 lexicographic successors
of ipNetToMediaPhysAddress and ipNetToMediaType in 1 getbulk request on toaster agent:
C:\>wsnmputil -v2 getbulk toaster public 1 2 1.3.6.1.2.1.1.2.0 1.3.6.1.2.1.4.22.1.2 1.3.6.1.2.1.4.22.1.4
OID :1.3.6.1.2.1.1.3.0
system.sysUpTime.0
TIMETICKS: 8504211
OID :1.3.6.1.2.1.4.22.1.2.6.157.54.176.1
ip.ipNetToMediaTable.ipNetToMediaEntry.ipNetToMediaPhysAddress.6.157.54.176.1
OCTET STRING - <0x00><0x10><0x54><0x42><0xc0><0x88>
OID :1.3.6.1.2.1.4.22.1.4.6.157.54.176.1
ip.ipNetToMediaTable.ipNetToMediaEntry.ipNetToMediaType.6.157.54.176.1
INTEGER: 3
OID :1.3.6.1.2.1.4.22.1.2.6.157.54.178.219
ip.ipNetToMediaTable.ipNetToMediaEntry.ipNetToMediaPhysAddress.6.157.54.178.219
OCTET STRING - <0x00><0xc0><0x4f><0xad><0x89><0x5e>
OID :1.3.6.1.2.1.4.22.1.4.6.157.54.178.219
ip.ipNetToMediaTable.ipNetToMediaEntry.ipNetToMediaType.6.157.54.178.219
INTEGER: 3
Walk operation
==============
*Walk all mibs on agent toaster starting from toasterToastType
C:\>wsnmputil -v1 walk frankli0 public 1.3.6.1.4.1.12.2.5.0
OID :1.3.6.1.4.1.77.1.1.1.0
.iso.org.dod.internet.private.enterprises.lanmanager.lanmgr-2.common.comVersionMaj.0
OCTET STRING - 4
OID :1.3.6.1.4.1.77.1.1.2.0
.iso.org.dod.internet.private.enterprises.lanmanager.lanmgr-2.common.comVersionMin.0
OCTET STRING - 0
OID :1.3.6.1.4.1.77.1.1.3.0
.iso.org.dod.internet.private.enterprises.lanmanager.lanmgr-2.common.comType.0
OCTET STRING - <0x03><0x00><0x00><0x00>
OID :1.3.6.1.4.1.77.1.1.4.0
.iso.org.dod.internet.private.enterprises.lanmanager.lanmgr-2.common.comStatStart.0
INTEGER: 894297856
.
.
.
