cl_snmp 命令

用途

向代理程序发出简单网络管理协议 (SNMP) 请求，并处理代理程序返回的 SNMP 响应。

语法

cl_snmp [-com] [-debug Level] [-host TargetHost] [-timeout TimeoutValue] [-retry RetryNumber] [-max MaxRepetitions] [-file ConfigurationFile] [-port PortNumber] [-verbose ] [-non NonRepeaters] 函数 [MIBvariable] [VariableType] [Value] [...]

描述

使用 cl_snmp 命令向代理程序发出 SNMP 请求，并处理代理程序返回的 SNMP 响应。 Virtual I/O ServerVirtual I/O Server cl_snmp 命令可用于 SNMPv1、SNMPv2c 和 SNMPv3 请求。

标志

标志名称 描述
-网 指定用于访问目标 SNMP 代理程序上所指定变量的共用名。 如果不指定共用名，那么缺省名为 public。 使用基于用户的安全模型时，不必指定共用名。
注: 社区名称区分大小写。
-debug 级别 指定运行时的调试级别。 缺省值为0。 调试级别越高，显示的消息数越大。 级别范围为 0 到 4。
-东道主 TargetHost 指定要向其发送请求的目标主机。 此目标可以是因特网协议地址、主机名或 clsnmp.conf 配置文件中的 winSNMP 名称。 如果未指定主机，那么缺省值为本地主机。
-超时 TimeoutValue 指定 cl_snmp 命令等待来自 SNMP 代理程序的回复的时间长度（以秒为单位）。 缺省值为3。
-重试 RetryNumber 指定如果超时要重新尝试命令的最大次数。 缺省值为 2。
-最大 MaxRepetitions 指定在第一个 -non number 后继作业后针对每个变量绑定对返回的字典序后继作业的数目。 此参数仅适用于 getbulk 请求。 如果功能请求不是 getbulk 请求，那么将忽略此参数。 例如，从后继作业 -non number+1 开始，针对每个变量绑定对返回后继作业的最大数目 (-max number)。 缺省值为 10。
-文件 ConfigurationFile 指定配置文件的完整路径和文件名。
-port PortNumber 指定侦听陷阱的端口号。 如果未指定端口号，那么 cl_snmp trap 功能将在熟知端口 162（cl_snmp 陷阱的缺省端口）上进行侦听。
-verbose 指定必须使用详细输出（例如，使用文本名称代替 MIB 对象标识）显示来自请求的输出。
-非 NonRepeaters 指定仅对其返回单个后继作业的变量绑定对（名称/值）的数目，从第一个变量绑定对开始。 此参数仅适用于 getbulk 请求。 如果功能请求不是 getbulk 请求，那么将忽略此参数。 缺省值为0。
函数 [MIBvariable] [VariableType] [值] [...]] 指定要执行的 SNMP 功能或操作，可以是下列其中一个功能：
  • 获取
  • getnext
  • getbulk
  • 设置
  • 行走
  • 陷阱
  • findname
MIBVariable
使用以下内容指定管理信息库 (MIB) 对象：其对象描述符（文本名称）、ASN.1 表示法的对象标识或这二者的组合。 与 walk 功能配合使用时，此变量为 MIB 对象前缀。 前缀可以是完整的对象标识的前导部分。 与 findname 命令配合使用时，此对象标识使用 ASN.1 表示法。
值
指定要由 SET 功能设置的值。 如果值中需要空格，请将值括在引号中。 要将变量设置为同时也是类型的值，您必须指定类型。
VariableType
指定要设置的值的类型。 要完成 SNMP SET 请求，那么必须知道 SMI_type。 如果未指定类型，那么 cl_snmp 命令将首先搜索 /etc/mib.defs 文件，然后搜索经过编译的 MIB 以确定类型。 如果未找到变量，那么返回错误。 如果指定了 VariableType，那么 VariableType 将优先于可以在 MIB 中分配的任何类型。 VariableType 和 value 必须兼容。 例如，如果指定类型 number 并指定值 foo，那么由于 foo 不是数字，因此将返回错误。 VariableType 不区分大小写。 有效变量类型为: (bitstring ， counter ， counter32， counter64， display or displaystring ，标尺， gauge32， integer ， integer32， ipaddress ， nsapaddress ， null ， objectidentifier 或 OID ， octetstring ，不透明，op暂定， timeticks ， uinteger)

请求类型

请求类型名称 描述
findname 发送搜索请求，以获取所指定 MIBVariable 输入的文本名称（其内部 ASN.1 值与输入 ASN.1 值最匹配）。 搜索功能将首先检查 /etc/mib.defs 文件，并且如果找不到匹配的文本名称，那么将继续搜索经过编译的管理信息库 (MIB)。 每个 cl_snmp findname 调用仅允许一个 MIBVariable 。
获取 向 SNMP 代理程序发送请求以获取特定的 MIB 变量。 然后，cl_snmp 命令将等待响应或超时。
getbulk 获取 MIB 树中由对象标识 (OID) 或 MIB 变量名称指定的变量的值。 单个 getbulk 与一系列 getnext 命令执行相同功能，但 cl_snmp 命令与 SNMP 代理程序之间的数据交换较少。
getnext 向 SNMP 代理程序发送请求，以获取按词典排序的跟在指定的 MIBVariable 后的 MIB 变量。 然后，cl_snmp 命令将等待响应或超时。
设置 向 SNMP 代理程序发送请求以设置特定 MIBVariable。 然后，cl_snmp 命令将等待响应或超时。
陷阱 侦听 SNMP 陷阱，并在出现这些陷阱时显示陷阱信息。 使用缺省的熟知端口 162 或 -port 选项中指定的端口号。 cl_snmp trap 功能继续侦听陷阱，直到停止或取消进程。
行走 针对指定的前缀发出 getnext 请求，然后在存在与指定的前缀匹配的变量时，继续发出 getnext 请求。 前缀可以是完整的对象标识的前导部分。

退出状态

请参阅 Virtual I/O Server 命令的退出状态。

示例

要发出 SNMP 请求，请运行以下命令：
cl_snmp -host hostname get sysName.0

相关信息

snmp_info 命令和 snmp_trap 命令。