C# Класс SnmpSharpNet.UTarget

USM security SNMP version 3 target class.
Наследование: ITarget
Показать файл Открыть проект

Защищенные свойства (Protected)

Свойство Тип Описание
_address IpAddress
_authenticationProtocol AuthenticationDigests
_authenticationSecret MutableByte
_contextEngineId OctetString
_contextName OctetString
_engineBoots Integer32
_engineId OctetString
_engineTime Integer32
_engineTimeStamp System.DateTime
_maxMessageSize Integer32
_port int
_privacyProtocol PrivacyProtocols
_privacySecret MutableByte
_reportable bool
_retry int
_securityName OctetString
_timeout int
_version SnmpVersion

Открытые методы

Метод Описание
GetCurrentEngineTime ( ) : int

Calculates and returns current agents engine time. ValidateEngineTime is called prior to calculation to make sure current engine time is timely enough to use. EngineTime is calculated as last received engine time + difference in seconds between the time stamp saved when last time value was received and current time (using the internal GMT clock).

PreparePacketForTransmission ( SnmpPacket packet ) : bool

Prepare packet for transmission by filling target specific information in the packet.

Reset ( ) : void

Reset the class. Initialize all member values to class defaults.

UTarget ( ) : System

Constructor

UpdateDiscoveryValues ( SnmpPacket packet ) : void

Update class values with SNMP version 3 discovery values from the supplied SnmpV3Packet class. Values updated are EngineId, EngineTime and EngineBoots.

UpdateTimeStamp ( ) : void

Updates engine time timestamp. This value is used to determine if agents engine time stored in this class is valid. Timestamp is saved as DateTime class by default initialized to DateTime.MinValue. Timestamp value is stored in GMT to make it portable (if it is saved on one computer and loaded on another that uses a different time zone).

Valid ( ) : bool

Checks validity of the class.

ValidateEngineTime ( ) : bool

Validate agents engine time. Valid engine time value is time that has been initialized to a value other then default (DateTime.MinValue is default set in the constructor) and that has been updated in the last 10 times the SNMP v3 timely window (150 seconds). In other words, valid time is any time value in the last 1500 seconds (or 25 minutes).

ValidateReceivedPacket ( SnmpPacket packet ) : bool

Validate received reply

Приватные методы

Метод Описание
EngineTimeStamp ( ) : System.DateTime

Get engine time stamp value (last time engine boots and time values were retrieved from the SNMP agent).

Описание методов

GetCurrentEngineTime() публичный Метод

Calculates and returns current agents engine time. ValidateEngineTime is called prior to calculation to make sure current engine time is timely enough to use. EngineTime is calculated as last received engine time + difference in seconds between the time stamp saved when last time value was received and current time (using the internal GMT clock).
public GetCurrentEngineTime ( ) : int
Результат int

PreparePacketForTransmission() публичный Метод

Prepare packet for transmission by filling target specific information in the packet.
public PreparePacketForTransmission ( SnmpPacket packet ) : bool
packet SnmpPacket SNMP packet class for the required version
Результат bool

Reset() публичный Метод

Reset the class. Initialize all member values to class defaults.
public Reset ( ) : void
Результат void

UTarget() публичный Метод

Constructor
public UTarget ( ) : System
Результат System

UpdateDiscoveryValues() публичный Метод

Update class values with SNMP version 3 discovery values from the supplied SnmpV3Packet class. Values updated are EngineId, EngineTime and EngineBoots.
Thrown when SNMP packet class other then version 3 /// is passed as parameter
public UpdateDiscoveryValues ( SnmpPacket packet ) : void
packet SnmpPacket class cast as
Результат void

UpdateTimeStamp() публичный Метод

Updates engine time timestamp. This value is used to determine if agents engine time stored in this class is valid. Timestamp is saved as DateTime class by default initialized to DateTime.MinValue. Timestamp value is stored in GMT to make it portable (if it is saved on one computer and loaded on another that uses a different time zone).
public UpdateTimeStamp ( ) : void
Результат void

Valid() публичный Метод

Checks validity of the class.
public Valid ( ) : bool
Результат bool

ValidateEngineTime() публичный Метод

Validate agents engine time. Valid engine time value is time that has been initialized to a value other then default (DateTime.MinValue is default set in the constructor) and that has been updated in the last 10 times the SNMP v3 timely window (150 seconds). In other words, valid time is any time value in the last 1500 seconds (or 25 minutes).
public ValidateEngineTime ( ) : bool
Результат bool

ValidateReceivedPacket() публичный Метод

Validate received reply
Thrown on following errors with ErrorCode: /// * ErrorCode = 0: SecureAgentParameters was updated after request was made but before reply was received (this is not allowed) /// * SnmpException.InvalidAuthoritativeEngineId: engine id in the reply does not match request /// * SnmpException.InvalidSecurityName: security name mismatch between request and reply packets /// * SnmpException.ReportOnNoReports: report packet received when we had reportable set to false in the request /// * SnmpException.UnsupportedNoAuthPriv: noAuthPriv is not supported /// Thrown when configured privacy passwords in this class and in the packet class do not match Thrown when configured authentication passwords in this class and in the packet class do not match
public ValidateReceivedPacket ( SnmpPacket packet ) : bool
packet SnmpPacket Received SNMP packet
Результат bool

Описание свойств

_address защищенное свойство

Target IP address
protected IpAddress,SnmpSharpNet _address
Результат IpAddress

_authenticationProtocol защищенное свойство

Authentication digest to use in authNoPriv and authPriv security combinations. For available authentication digests, see AuthenticationDigests enumeration.
protected AuthenticationDigests _authenticationProtocol
Результат AuthenticationDigests

_authenticationSecret защищенное свойство

Authentication secret (or authentication password)
protected MutableByte _authenticationSecret
Результат MutableByte

_contextEngineId защищенное свойство

Context engine id. By default, this value is set to authoritative engine id value unless specifically set to a different value here.
protected OctetString _contextEngineId
Результат OctetString

_contextName защищенное свойство

Context name. By default this value is a 0 length string (no context name). Set this value if you require it to be defined in ScopedPdu.
protected OctetString _contextName
Результат OctetString

_engineBoots защищенное свойство

Authoritative engine boots value
protected Integer32 _engineBoots
Результат Integer32

_engineId защищенное свойство

Authoritative engine id
protected OctetString _engineId
Результат OctetString

_engineTime защищенное свойство

Authoritative engine time value
protected Integer32 _engineTime
Результат Integer32

_engineTimeStamp защищенное свойство

Time stamp when authoritative engine time value was last refreshed with data from the agent. This value is used to calculate up to date authoritative agent time value without having to repeat discovery process every 150 seconds.
protected DateTime,System _engineTimeStamp
Результат System.DateTime

_maxMessageSize защищенное свойство

Maximum message size. This value is by default set to 64KB and then updated by the maximum message size value in the response from the agent. This value should be the smallest message size supported by both the agent and manager.
protected Integer32 _maxMessageSize
Результат Integer32

_port защищенное свойство

Target port number
protected int _port
Результат int

_privacyProtocol защищенное свойство

Privacy protocol to use. For available protocols, see PrivacyProtocols enumeration.
protected PrivacyProtocols _privacyProtocol
Результат PrivacyProtocols

_privacySecret защищенное свойство

Privacy secret (or privacy password)
protected MutableByte _privacySecret
Результат MutableByte

_reportable защищенное свойство

Reportable option flag. Set to true by default. This flag controls if reportable flag will be set in the packet. When this flag is set in the packet, agent will respond to invalid requests with Report packets. Without this flag being set, all invalid requests are silently dropped by the agent.
protected bool _reportable
Результат bool

_retry защищенное свойство

Target maximum retry count
protected int _retry
Результат int

_securityName защищенное свойство

Security name value, or user name.
protected OctetString _securityName
Результат OctetString

_timeout защищенное свойство

Target request timeout period in milliseconds
protected int _timeout
Результат int

_version защищенное свойство

Target SNMP version number
protected SnmpVersion _version
Результат SnmpVersion