基于WinSNMP的网络管理程序设计----原理与实践(第三章)

类别:VC语言 点击:0 评论:0 推荐:

 

第三章 Snmp在Windows下的实现----WinSNMP编程原理

 

在Windows下实现SNMP协议的编程,可以采用Winsock接口,在161,162端口通过udp传送信息。在Windows 2000中,Microsoft已经封装了SNMP协议的实现,提供了一套可供在Windows下开发基于SNMP的网络管理程序的接口,这就是WinSNMP API。

3.1  什么是WinSNMP

WinSNMP的目的是为在Windows下开发基于SNMP的网络管程序提供解决方案。它为SNMP网管开发者提供了必须遵循的开放式单一接口规范,它定义了过程调用、数据类型、数据结构和相关的语法。
图3.1显示了一个网络管理站(NMS)和网络管理代理(Agent)之间端到端的SNMP连接中WinSNMP所处的层次。这是一个WinSNMP的参考模型。


 

图3.1WinSNMP参考模型


总的来说,WinSNMP以函数的形式封装了SNMP协议的各部分(在VC++6.0开发环境中体现为wsnmp32.dll、wsnmp32.lib和winsnmp.h),且针对SNMP是使用UDP的特点而设置了消息重传、超时机制等。

3.2  一些基本概念

在WinSNMP编程中,我们需要考虑的基本概念主要有以下几点:
 SNMP支持层次
 Entity/Context转换模式
 本地数据库
 会话
 异步模式
 内存管理
下面我们将分别对它们作介绍。

3.2.1  SNMP支持层次(Levels of SNMP Support)
WinSNMP支持四个层次的SNMP操作:
 Level 0 = 只有消息编码/解码
 Level 1 = Level 0 + 与SNMPv1代理的通信
 Level 2 = Level 1 + 与SNMPv2代理的通信
 Level 3 = Level 2 + 与其它SNMPv2管理站的通信
因为SNMP协议支持SNMPv1与SNMPv2的共存,所以WinSNMP实现能提供对两个版本协议的支持。
SnmpStartup函数能返回当前WinSNMP实现所能提供的最大支持层次。

3.2.2  Entity/Context转换模式(Entity/Context Translation Modes)
WinSNMP应用程序能够让WinSNMP实现把entity和context参数按不同的方式解释:
(1)按字面解释为SNMPv1代理的地址和共同体(community)字符串。
(2)解释为SNMPv2的party和context标识符(context IDs)。
(3)通过查询本地数据库将其转换为各自的SNMPv1或SNMPv2元素。
三种Entity/Context转换模式如下:
SNMPAPI_TRANSLATED = 通过本地数据库查询转换
SNMPAPI_UNTRANSLATED_V1 = 转换为地址和共同体(community)字符串
SNMPAPI_UNTRANSLATED_V2 = SNMPv2的party和context IDs.
我们可以通过SnmpStartup函数获得当前默认的entity/context转换模式,SnmpSetTranslatedMode函数可以用来设置entity/context转换模式。
当在系统中采用SNMPv1协议时,我们可以将其设置为SNMPAPI_UNTRANSLATED_V1,具体实现如下:
HSNMP_ENTITY hAgent;
HSNMP_CONTEXT hView;
LPCSTR entityName = “202.120.86.71”;
smiOCTETS contextName;
contextName.ptr = “public”;
contextName.len = lstrlen (contextName.ptr);
hAgent = SnmpStrToEntity (hSomeSessin, entityName);
hView = SnmpStrToContext (hSomeSession, const &contextName);
通过这样的设置,我们就可以在161端口通过UDP访问IP地址“202.120.86.71”上的SNMP代理了。

3.2.3  本地数据库(Local Database)
本地数据库主要存储重传模式(RetransmitMode)、重试次数(Retry)、超时(timeout)、转换模式(TranslateMode)等值。我们可以对其中的数据进行读(get)、写(set)操作。

3.2.4  会话(session)
会话是用来管理WinSNMP应用程序和WinSNMP实现之间的连接,由SnmpCreateSession(推荐)或SnmpOpen函数创建。会话是资源管理的最小单位,也是WinSNMP应用程序和WinSNMP实现之间通信管理的最小单位。一个良好的WinSNMP应用程序应该使用会话结构逻辑地管理它的操作,并将实现中的资源需求控制在最小。
调用SnmpCreateSession或SnmpOpen函数创建一个会话时,会返回一个“session id”,这是一个句柄(handle)变量,WinSNMP用它来管理自己的资源。应用程序最终应调用SnmpClose函数将会话释放。

3.2.5  异步模式(Asynchronous Model)
当代编程模式的一个很大特点就是消息驱动。WinSNMP采用了异步消息驱动模式,主要基于两个原因:
(1) 异步消息驱动模式非常适合于面向对象理论、SNMP分布式管理模型以及Windows编程、运行环境。
(2) SNMP再管理站和代理之间传送数据没有什么特别的传输机制,它基本上是基于数据报的,没有在远程实体之间建立实际通道(虚电路)。这样的事实使得WinSNMP非常适合采用异步模式。
现代的消息驱动程序必须响应各种重要事件,有些则完全依赖于异步关系。事实上,WinSNMP API中几乎所有函数都有异步成分,有些则是完全异步的。有三个非常重要的异步函数:
 SnmpSendMsg  (发送数据)
 SnmpRecvMsg  (接收数据)
 SnmpRegister (注册接受trap消息)
WinSNMP的整个编程模式就是基于异步的,我们将在后面做详细介绍。

3.2.6  内存管理(Memory Management)
在Windows编程中,内存管理一向是一个令人头疼的问题。在这里,我们将对WinSNMP的内存管理做一个较为详尽的描述。
WinSNMP包括三种不同的内存“对象”:
 句柄式资源 (HANDLE’d Resources)
 C风格(以NULL结尾)的字符串
 WinSNMP API结构类型

3.2.6.1  句柄式资源 (HANDLE’d Resources)
有五种句柄式资源的变量:
 Sessions
 Entities
 Contexts
 Protocol Data Units (PDUs)
 VarBindLists (VBLs)
所有句柄对象都表示为“HSNMP_<object_tag>”的形式,它为WinSNMP实现(以DLL方式)所拥有。

3.2.6.2  C风格字符串 (C-Stytle Strings)
C风格的字符串主要用来为通用的字符串表示与Entity和对象标识符(OID)对象之间的转换提供便利。WinSNMP中使用C风格字符串的函数有:SnmpStrToEntity、SnmpEntityToStr、SnmpStrToOid、SnmpOidToStr。
C风格字符串的内存分配、管理和释放完全由应用程序负责。因此我们还需要传递“size”参数给使用它的函数。

3.2.6.3  描述符 (Descriptors)
WinSNMP中有三种结构类型:
 smiOCTETS
 smiOID
 smiVALUE
前两种类型的定义如下:
typedef struct {
     smiUINT32 len;  /*unsigned long integer 类型,表示ptr中的字节数*/
     smiLPBYTE ptr;  /*指向包含octet string的字节数组的far指针*/
} smiOCTETS;

typedef struct {
smiUINT32   len;  /**unsigned long integer 类型,表示ptr中无符号长整形的个数*/
     smiLPUINT32 ptr;   /*指向由OID各个标识符组成的无符号长整形数祖的far指针*/
} smiOID;

smiVALUE稍微复杂一点,它的定义如下:
typedef struct {    /* smiVALUE portion of VarBind */
 smiUINT32 syntax;  /* Insert SNMP_SYNTAX_<type> */
 union {
 smiINT  sNumber; /* SNMP_SYNTAX_INT
          SNMP_SYNTAX_INT32 */
 smiUINT32 uNumber; /* SNMP_SYNTAX_UINT32
                                SNMP_SYNTAX_CNTR32                                   SNMP_SYNTAX_GAUGE32                                   SNMP_SYNTAX_TIMETICKS */
 smiCNTR64 hNumber; /* SNMP_SYNTAX_CNTR64 */
 smiOCTETS string;  /* SNMP_SYNTAX_OCTETS
        SNMP_SYNTAX_BITS
        SNMP_SYNTAX_OPAQUE
        SNMP_SYNTAX_IPADDR
        SNMP_SYNTAX_NSAPADDR */
 smiOID  oid;  /* SNMP_SYNTAX_OID */
 smiBYTE empty;  /* SNMP_SYNTAX_NULL
        SNMP_SYNTAX_NOSUCHOBJECT
        SNMP_SYNTAX_NOSUCHINSTANCE
        SNMP_SYNTAX_ENDOFMIBVIEW */
         }  value;  /* union */
 }  smiVALUE;

当一个应用程序得到一个smiVALUE变量时,首先必须检查它的“syntax”成员,已决定怎样取到它的第二个成员。
当“syntax”成员变量显示“value”值是一个smiOCTETS或smiOID对象时,我们就应该考虑内存管理,约定如下:
(1)  当其作为输入参数时,应用程序负责为变长对象分配内存;
(2)  当其作为输出参数时,由WinSNMP实现(表现为DLL)为变长对象分配
内存。 

3.2.6.4  内存的释放
WinSNMP应用程序必须负责释放所有通过调用WinSNMP API函数所分配的资源,主要有以下三类函数:
 SnmpFree<xxx>: 释放Entity、Context、Pdu、Vbl、Descriptor
 SnmpClose    : 关闭会话
 SnmpCleanup  : 必须在程序结束之前调用,释放所有资源
应用程序推荐使用上述的顺序来释放所有的WinSNMP资源。

3.3  WinSNMP基本编程模式

WinSNMP API按照SNMP协议封装了各种操作,包括PDU、VarBindList以及协议操作的各项函数。我们可以按照SNMP协议的描述,调用WinSNMP相关函数,完成一次完整的SNMP。我们下面将以笔者完整的系统(采用SNMPv1协议)为例,具体描述WinSNMP的一般编程模式。我们分发送请求消息与接受响应消息两部分来实现。

3.3.1  WinSNMP发送请求消息
WinSNMP发送请求消息的过程可以分为四个部分,主要有:WinSNMP的初始化、PDUs的创建、发送信息以及资源的释放。

3.3.1.1  WinSNMP的初始化
(1) 调用SnmpStartup函数启动WinSNMP。
(2) 调用SnmpCreateSession函数创建一个会话session。
(3) 调用SnmpSetRetransmitMode函数设置重传模式。
(4) 调用SnmpSetRetry函数设置重传次数。
(5) 调用SnmpSetTimeout函数设置超时时间。
其中第3、4、5步都是对本地数据库的操作,完成了对WinSNMP相关参数的设置。

3.3.1.2  创建协议数据单元(PDUs)
在创建PDU之前,我们必须先创建变量绑定表(varbindlists)。
(1) 调用SnmpStrToOid函数创建读取对象的OID,例如,我们创建MIB变量ipInReceives(一个实例的OID为1.3.6.1.2.1.4.3.0),我们可以采用下面的代码:
LPCSTR name="1.3.6.1.2.1.4.3.0";
smiOID Oid;
SnmpStrToOid(name,&Oid);

(2) 调用SnmpCreateVbl函数创建变量绑定表。
HSNMP_VBL m_hvbl=SnmpCreateVbl(session,&Oid,NULL);/*NULL表示该OID的值为空*/
(3) 调用SnmpSetVb函数往变量绑定表中添加变量绑定,我们需先创
建一个OID,命名为Oid。
SnmpSetVb(m_hvbl,0,&Oid,NULL);/*0表示往变量绑定表中添加变量绑定,非0值表示修改此位置的变量绑定*/
创建好了变量绑定表后,我们调用SnmpCreatePdu函数创建协议数据单元,在这个函数中,我们必须设定error_index、error_status、request_id参数,它们都与协议中相应的量对应。
HSNMP_PDU m_hpdu=SnmpCreatePdu(session,SNMP_PDU_GET,
NULL,NULL,NULL,m_hvbl);

3.3.1.3  发送信息
我们首先调用SnmpStrToContext和SnmpStrToEntity函数创建共同体(community)字符串和代理entity,具体实现见3.2.2。
然后,我们调用SnmpSendMsg函数发送信息。
SnmpSendMsg(session,NULL,hAgent,hView,m_hpdu);

3.3.1.4  资源的释放
最后,我们应该释放所有分配的资源。

3.3.2  WinSNMP接受响应消息
还记得前面的SnmpCreateSession函数吗?它可以说是WinSNMP异步消息驱动模式的一个关键,让我们先来看看它的函数原型:
HSNMP_SESSION SnmpCreateSession(
  HWND hWnd,                    // handle to the notification window
  UINT wMsg,                    // window notification message number
  SNMPAPI_CALLBACK fCallback,   // notification callback function
  LPVOID lpClientData           // pointer to callback function data
);
它提供了两种方式的异步消息驱动,我们可以让WinSNMP在有响应消息到达时发送一个消息给系统,也可以让它自动调用一个函数。笔者采用了第一种方式,实现如下:
session=SnmpCreateSession(m_hWnd,wMsg,NULL,NULL);
我们可以给消息wMsg创建一个消息处理函数,在这个函数里处理消息的接收、信息的提取与处理等事务。
下面我们将具体描述WinSNMP接受响应消息的步骤。
(1) 调用SnmpRecvMsg函数接收数据
(2) 调用SnmpGetPduData函数从PDU中析取出数据,
(3) 调用SnmpCountVbl获得变量绑定列表中变量绑定的个数
(4) 调用SnmpGetVb函数取得PDU变量绑定表中每个变量绑定的OID及其对应的值,可以指明该变量绑定在变量绑定表中的位置。参考实现如下:
int nCount=SnmpCountVbl(varbindlist);
for(int index=1;i<=nCount;i++)
  SnmpGetVb(varbindlist,index,&Oid,value[i]);
其中,index指定了变量绑定的位置,value[i]表示接收到的OID变量的值,是smiLPVALUE类型的,Oid表示接收到的变量绑定的OID。
对于value[i],我们可以参考3.2.6.3节,按照它的syntax成员,用select case语句,分别转换为字符串或整数类型。
(5) 调用SnmpOidToStr函数将Oid转换为字符串。并将接收到的Oid与发送数据包的各OID做比较,已决定各自值的归属。引用一段代码
if(strcmp(m_sOid[i],m_initOid[1])==0)
  m_sDesr= str[i];
 else if (strcmp(m_sOid[i],m_initOid[2])==0)
  m_sSysOid=str[i];
 else if (strcmp(m_sOid[i],m_initOid[3])==0)
  m_sSysTime=str[i];
 else if (strcmp(m_sOid[i],m_initOid[4])==0)
  m_sName=str[i];
 else if (strcmp(m_sOid[i],m_initOid[5])==0)
  {m_sIpin=str[i];
  m_nIpin=nIpin;}
 else if(strcmp(m_sOid[i],m_initOid[6])==0)
  m_sIpout=str[i];
当我们比较发送的OID与接收到的OID时,我们就知道了这个str[i]是属于哪个OID的值,应当放在哪里显示,以m_s开头的变量都代表了不同的label,这样,相应的值就在相应的字符串中显示。

通过这样的步骤,我们就完成了一个简单的SNMP网络管理程序的设计。但是,在具体的应用中,我们应该考虑更多的问题,如内存管理、错误处理等问题,还有很多问题需要我们在系统开发的过程中去发现、解决。下面,我将描述几个我在系统开发中遇到的问题,有的已经解决,有的还在探索中,希望能为同仁提供参考。

3.4  几个问题

3.4.1 读IP地址
前面讲到,IpAddress是SMIv1的一个应用数据类型,表示IP地址,它的定义为:
IpAddress::=[APPLICATION 0] IMPLICIT OCTET STRING(SIZE(4))
当我们读取一个表示IP地址的OID时,我们应该分别读出IpAddress四个字节的值,再将它们处理成我们平时见到的IP地址的形式。代码如下:
case SNMP_SYNTAX_IPADDR:
strIp.Format("%d",*m_value[i]->value.string.ptr);
  strIp+=".";
  strTemp.Format("%d",*(m_value[i]->value.string.ptr+1));
  strIp+=strTemp;
  strIp+=".";
  strTemp.Format("%d",*(m_value[i]->value.string.ptr+2));
  strIp+=strTemp;
  strIp+=".";
  strTemp.Format("%d",*(m_value[i]->value.string.ptr+3));
  strIp+=strTemp;

3.4.2  GETNEXT操作的实现
GETNEXT是SNMP中用来读取表格变量的一个操作。在WinSNMP中,我们可以通过SnmpCreatePdu(session,SNMP_PDU_GETNEXT,NULL,NULL,NULL,m_hvbl)来创建一个GETNEXT操作的PDU。
关键的问题是我们如何对这个表格作遍历。(1).如何判断表格的结束;(2).在接收到响应消息时如何处理。
我们下面将以笔者系统为例,说明这些问题。我们将获得本机的路由表的一部分。先构造一个函数,代码如下:
void CSnmpManagerDlg::Next(LPTSTR Oid)
{
 CString str(Oid);
 if(!strcmp(str.Left(20),"1.3.6.1.2.1.4.21.1.7"))
 {
  file://处理接收到的数据
  pSnmp.CreateVbl(Oid,NULL);
  pSnmp.CreatePdu(SNMP_PDU_GETNEXT,NULL,NULL,NULL);
  pSnmp.Send("127.0.0.1","public");
 }
 else
 {
  m_bNext=FALSE;
  file://送去显示
 }
}
我们把接收到的OID的前20位与路由next hop MIB变量("1.3.6.1.2.1.4.21.1.7")作比较,假如不等,就说明这一列已经结束。把数据送去显示或进一步处理。
我们可以为这一操作创建一个新的会话(session),或继续使用前面GET操作的会话。创建一个新的会话时,我们为这个会话指定一个消息处理函数,并在这个函数中,处理接收到的数据,以及调用Next(LPTSTR Oid)函数继续发送GETNEXT操作。
假如继续使用以前的会话,我们要依靠标志m_bNext,判断m_bNext的真假以决定是否继续发GETNEXT数据包。
void CSnmpManagerDlg::OnRecv()
{ file://接收、处理消息
if(m_bNext==TRUE)
  Next(m_sOid);
}
这样,我们就完成了对表格中一列的遍历。同样,我们可以完成对整个表格的遍历,我们只需strcmp(str.Left(18),"1.3.6.1.2.1.4.21.1"),就可以获得整个表格的结束。再在Next(LPTSTR Oid)函数中用switch-case语句按各个MIB变量的值分类,就可以得到整个表格。

3.4.3  对表格变量的SET操作
在整个系统的开发中,我们曾经对SysName变量进行SET操作。证明是可行的。但当我们SET一个表格变量时,报告变量绑定(VB)错误,类型为bad value。可能有两个原因。
(1). 代理进程(Agent)不支持对这些表格变量的SET操作。(具体见RFC1212)
(2). 当SET一个表格变量时,我们应该对表格中的所有变量都赋值,并封装成一个PDU发出去。因为当我们用route add添加路由表时,必须指定所有的参数。并且,表格变量只允许添加与删除两种操作。

本文地址:http://com.8s8s.com/it/it3019.htm