include/snmp.h

   1 /**
   2  * @file snmp.h
   3  * @copy 2012 MinGW.org project
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9  * and/or sell copies of the Software, and to permit persons to whom the
  10  * Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice (including the next
  13  * paragraph) shall be included in all copies or substantial portions of the
  14  * Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  22  * DEALINGS IN THE SOFTWARE.
  23  */
  24 #ifndef _SNMP_H
  25 #define _SNMP_H
  26 #pragma GCC system_header
  27
  28 #include <windows.h>
  29 #include <pshpack4.h>
  30
  31 #ifndef WINSNMPAPI
  32 #define WINSNMPAPI WINAPI
  33 #endif
  34
  35 #ifdef __cplusplus
  36 extern "C" {
  37 #endif
  38
  39 #define DEFAULT_SNMP_PORT_UDP   161
  40 #define DEFAULT_SNMP_PORT_IPX   36879
  41 #define DEFAULT_SNMPTRAP_PORT_UDP       162
  42 #define DEFAULT_SNMPTRAP_PORT_IPX       36880
  43 #ifndef _SNMP_ASN_DEFINED
  44 #define _SNMP_ASN_DEFINED
  45 #define ASN_UNIVERSAL   0x00
  46 #define ASN_PRIMITIVE   0x00
  47 #define ASN_CONSTRUCTOR 0x20
  48 #define ASN_APPLICATION 0x40
  49 #define ASN_CONTEXT     0x80
  50 #define ASN_PRIVATE     0xC0
  51 #define SNMP_PDU_GET    (ASN_CONTEXT | ASN_CONSTRUCTOR | 0)
  52 #define SNMP_PDU_GETNEXT        (ASN_CONTEXT | ASN_CONSTRUCTOR | 1)
  53 #define SNMP_PDU_RESPONSE       (ASN_CONTEXT | ASN_CONSTRUCTOR | 2)
  54 #define SNMP_PDU_SET    (ASN_CONTEXT | ASN_CONSTRUCTOR | 3)
  55 #define SNMP_PDU_GETBULK        (ASN_CONTEXT | ASN_CONSTRUCTOR | 4)
  56 #define SNMP_PDU_V1TRAP (ASN_CONTEXT | ASN_CONSTRUCTOR | 4)
  57 #define SNMP_PDU_INFORM (ASN_CONTEXT | ASN_CONSTRUCTOR | 6)
  58 #define SNMP_PDU_TRAP   (ASN_CONTEXT | ASN_CONSTRUCTOR | 7)
  59 #define SNMP_PDU_REPORT (ASN_CONTEXT | ASN_CONSTRUCTOR | 8)
  60 #endif /* _SNMP_ASN_DEFINED */
  61 #define ASN_INTEGER     (ASN_UNIVERSAL | ASN_PRIMITIVE | 2)
  62 #define ASN_BITS        (ASN_UNIVERSAL | ASN_PRIMITIVE | 3)
  63 #define ASN_OCTETSTRING (ASN_UNIVERSAL | ASN_PRIMITIVE | 4)
  64 #define ASN_NULL        (ASN_UNIVERSAL | ASN_PRIMITIVE | 5)
  65 #define ASN_OBJECTIDENTIFIER    (ASN_UNIVERSAL | ASN_PRIMITIVE | 6)
  66 #define ASN_INTEGER32   ASN_INTEGER
  67 #define ASN_SEQUENCE    (ASN_UNIVERSAL | ASN_CONSTRUCTOR | 0x10)
  68 #define ASN_SEQUENCEOF  ASN_SEQUENCE
  69 #define ASN_IPADDRESS   (ASN_APPLICATION | ASN_PRIMITIVE | 0x00)
  70 #define ASN_COUNTER32   (ASN_APPLICATION | ASN_PRIMITIVE | 0x01)
  71 #define ASN_GAUGE32     (ASN_APPLICATION | ASN_PRIMITIVE | 0x02)
  72 #define ASN_TIMETICKS   (ASN_APPLICATION | ASN_PRIMITIVE | 0x03)
  73 #define ASN_OPAQUE      (ASN_APPLICATION | ASN_PRIMITIVE | 0x04)
  74 #define ASN_COUNTER64   (ASN_APPLICATION | ASN_PRIMITIVE | 0x06)
  75 #define ASN_UNSIGNED32  (ASN_APPLICATION | ASN_PRIMITIVE | 0x07)
  76 #define SNMP_EXCEPTION_NOSUCHOBJECT     (ASN_CONTEXT | ASN_PRIMITIVE | 0x00)
  77 #define SNMP_EXCEPTION_NOSUCHINSTANCE   (ASN_CONTEXT | ASN_PRIMITIVE | 0x01)
  78 #define SNMP_EXCEPTION_ENDOFMIBVIEW     (ASN_CONTEXT | ASN_PRIMITIVE | 0x02)
  79 #define SNMP_EXTENSION_GET      SNMP_PDU_GET
  80 #define SNMP_EXTENSION_GET_NEXT SNMP_PDU_GETNEXT
  81 #define SNMP_EXTENSION_GET_BULK SNMP_PDU_GETBULK
  82 #define SNMP_EXTENSION_SET_TEST (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x0)
  83 #define SNMP_EXTENSION_SET_COMMIT       SNMP_PDU_SET
  84 #define SNMP_EXTENSION_SET_UNDO (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x1)
  85 #define SNMP_EXTENSION_SET_CLEANUP      (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x2)
  86 #define SNMP_ERRORSTATUS_NOERROR        0
  87 #define SNMP_ERRORSTATUS_TOOBIG 1
  88 #define SNMP_ERRORSTATUS_NOSUCHNAME     2
  89 #define SNMP_ERRORSTATUS_BADVALUE       3
  90 #define SNMP_ERRORSTATUS_READONLY       4
  91 #define SNMP_ERRORSTATUS_GENERR 5
  92 #define SNMP_ERRORSTATUS_NOACCESS       6
  93 #define SNMP_ERRORSTATUS_WRONGTYPE      7
  94 #define SNMP_ERRORSTATUS_WRONGLENGTH    8
  95 #define SNMP_ERRORSTATUS_WRONGENCODING  9
  96 #define SNMP_ERRORSTATUS_WRONGVALUE     10
  97 #define SNMP_ERRORSTATUS_NOCREATION     11
  98 #define SNMP_ERRORSTATUS_INCONSISTENTVALUE      12
  99 #define SNMP_ERRORSTATUS_RESOURCEUNAVAILABLE    13
 100 #define SNMP_ERRORSTATUS_COMMITFAILED   14
 101 #define SNMP_ERRORSTATUS_UNDOFAILED     15
 102 #define SNMP_ERRORSTATUS_AUTHORIZATIONERROR     16
 103 #define SNMP_ERRORSTATUS_NOTWRITABLE    17
 104 #define SNMP_ERRORSTATUS_INCONSISTENTNAME       18
 105 #define SNMP_GENERICTRAP_COLDSTART      0
 106 #define SNMP_GENERICTRAP_WARMSTART      1
 107 #define SNMP_GENERICTRAP_LINKDOWN       2
 108 #define SNMP_GENERICTRAP_LINKUP 3
 109 #define SNMP_GENERICTRAP_AUTHFAILURE    4
 110 #define SNMP_GENERICTRAP_EGPNEIGHLOSS   5
 111 #define SNMP_GENERICTRAP_ENTERSPECIFIC  6
 112 #define SNMP_ACCESS_NONE        0
 113 #define SNMP_ACCESS_NOTIFY      1
 114 #define SNMP_ACCESS_READ_ONLY   2
 115 #define SNMP_ACCESS_READ_WRITE  3
 116 #define SNMP_ACCESS_READ_CREATE 4
 117 #define SNMPAPI_ERROR   FALSE
 118 #define SNMPAPI_NOERROR TRUE
 119 #define SNMP_LOG_SILENT 0
 120 #define SNMP_LOG_FATAL  1
 121 #define SNMP_LOG_ERROR  2
 122 #define SNMP_LOG_WARNING        3
 123 #define SNMP_LOG_TRACE  4
 124 #define SNMP_LOG_VERBOSE        5
 125 #define SNMP_OUTPUT_TO_CONSOLE  1
 126 #define SNMP_OUTPUT_TO_LOGFILE  2
 127 #define SNMP_OUTPUT_TO_EVENTLOG 4
 128 #define SNMP_OUTPUT_TO_DEBUGGER 8
 129 #define SNMP_MAX_OID_LEN        128
 130 #define SNMP_MEM_ALLOC_ERROR    1
 131 #define SNMP_BERAPI_INVALID_LENGTH      10
 132 #define SNMP_BERAPI_INVALID_TAG 11
 133 #define SNMP_BERAPI_OVERFLOW    12
 134 #define SNMP_BERAPI_SHORT_BUFFER        13
 135 #define SNMP_BERAPI_INVALID_OBJELEM     14
 136 #define SNMP_PDUAPI_UNRECOGNIZED_PDU    20
 137 #define SNMP_PDUAPI_INVALID_ES  21
 138 #define SNMP_PDUAPI_INVALID_GT  22
 139 #define SNMP_AUTHAPI_INVALID_VERSION    30
 140 #define SNMP_AUTHAPI_INVALID_MSG_TYPE   31
 141 #define SNMP_AUTHAPI_TRIV_AUTH_FAILED   32
 142
 143 #ifndef RC_INVOKED
 144
 145 typedef INT SNMPAPI;
 146 typedef LONG AsnInteger32;
 147 typedef ULONG AsnUnsigned32;
 148 typedef ULARGE_INTEGER AsnCounter64;
 149 typedef AsnUnsigned32 AsnCounter32;
 150 typedef AsnUnsigned32 AsnGauge32;
 151 typedef AsnUnsigned32 AsnTimeticks;
 152 typedef struct {
 153         BYTE *stream;
 154         UINT length;
 155         BOOL dynamic;
 156 } AsnOctetString, AsnBits, AsnSequence, AsnImplicitSequence, AsnIPAddress, AsnNetworkAddress, AsnDisplayString, AsnOpaque;
 157 typedef struct {
 158         UINT idLength;
 159         UINT *ids;
 160 } AsnObjectIdentifier, AsnObjectName;
 161 typedef struct {
 162         BYTE asnType;
 163         union {
 164                 AsnInteger32 number;
 165                 AsnUnsigned32 unsigned32;
 166                 AsnCounter64 counter64;
 167                 AsnOctetString string;
 168                 AsnBits bits;
 169                 AsnObjectIdentifier object;
 170                 AsnSequence sequence;
 171                 AsnIPAddress address;
 172                 AsnCounter32 counter;
 173                 AsnGauge32 gauge;
 174                 AsnTimeticks ticks;
 175                 AsnOpaque arbitrary;
 176         } asnValue;
 177 } AsnAny, AsnObjectSyntax;
 178 typedef struct {
 179         AsnObjectName name;
 180         AsnObjectSyntax value;
 181 } SnmpVarBind;
 182 typedef struct {
 183         SnmpVarBind *list;
 184         UINT len;
 185 } SnmpVarBindList;
 186
 187 VOID WINSNMPAPI SnmpExtensionClose(void);
 188 BOOL WINSNMPAPI SnmpExtensionInit(DWORD,HANDLE*,AsnObjectIdentifier*);
 189 BOOL WINSNMPAPI SnmpExtensionInitEx(AsnObjectIdentifier*);
 190 BOOL WINSNMPAPI SnmpExtensionMonitor(LPVOID);
 191 BOOL WINSNMPAPI SnmpExtensionQuery(BYTE,SnmpVarBindList*,AsnInteger32*,AsnInteger32*);
 192 BOOL WINSNMPAPI SnmpExtensionQueryEx(DWORD,DWORD,SnmpVarBindList*,AsnOctetString*,AsnInteger32*,AsnInteger32*);
 193 BOOL WINSNMPAPI SnmpExtensionTrap(AsnObjectIdentifier*,AsnInteger32*,AsnInteger32*,AsnTimeticks*,SnmpVarBindList*);
 194 DWORD WINSNMPAPI SnmpSvcGetUptime(void);
 195 VOID WINSNMPAPI SnmpSvcSetLogLevel(INT);
 196 VOID WINSNMPAPI SnmpSvcSetLogType(INT);
 197 SNMPAPI WINSNMPAPI SnmpUtilAsnAnyCpy(AsnAny*,AsnAny*);
 198 VOID WINSNMPAPI SnmpUtilAsnAnyFree(AsnAny*);
 199 VOID WINSNMPAPI SnmpUtilDbgPrint(INT,LPSTR,...);
 200 LPSTR WINSNMPAPI SnmpUtilIdsToA(UINT*,UINT);
 201 LPVOID WINSNMPAPI SnmpUtilMemAlloc(UINT);
 202 VOID WINSNMPAPI SnmpUtilMemFree(LPVOID);
 203 LPVOID WINSNMPAPI SnmpUtilMemReAlloc(LPVOID,UINT);
 204 SNMPAPI WINSNMPAPI SnmpUtilOctetsCmp(AsnOctetString*,AsnOctetString*);
 205 SNMPAPI WINSNMPAPI SnmpUtilOctetsCpy(AsnOctetString*,AsnOctetString*);
 206 VOID WINSNMPAPI SnmpUtilOctetsFree(AsnOctetString*);
 207 SNMPAPI WINSNMPAPI SnmpUtilOctetsNCmp(AsnOctetString*,AsnOctetString*,UINT);
 208 SNMPAPI WINSNMPAPI SnmpUtilOidAppend(AsnObjectIdentifier*,AsnObjectIdentifier*);
 209 SNMPAPI WINSNMPAPI SnmpUtilOidCmp(AsnObjectIdentifier*,AsnObjectIdentifier*);
 210 SNMPAPI WINSNMPAPI SnmpUtilOidCpy(AsnObjectIdentifier*,AsnObjectIdentifier*);
 211 VOID WINSNMPAPI SnmpUtilOidFree(AsnObjectIdentifier*);
 212 SNMPAPI WINSNMPAPI SnmpUtilOidNCmp(AsnObjectIdentifier*,AsnObjectIdentifier*,UINT);
 213 LPSTR WINSNMPAPI SnmpUtilOidToA(AsnObjectIdentifier*);
 214 VOID WINSNMPAPI SnmpUtilPrintAsnAny(AsnAny*);
 215 VOID WINSNMPAPI SnmpUtilPrintOid(AsnObjectIdentifier*);
 216 SNMPAPI WINSNMPAPI SnmpUtilVarBindCpy(  SnmpVarBind*,SnmpVarBind*);
 217 SNMPAPI WINSNMPAPI SnmpUtilVarBindListCpy(SnmpVarBindList*,SnmpVarBindList*);
 218 VOID WINSNMPAPI SnmpUtilVarBindFree(SnmpVarBind*);
 219 VOID WINSNMPAPI SnmpUtilVarBindListFree(SnmpVarBindList*);
 220
 221 #ifndef SNMPSTRICT
 222 #define SNMP_malloc SnmpUtilMemAlloc
 223 #define SNMP_free SnmpUtilMemFree
 224 #define SNMP_realloc SnmpUtilMemReAlloc
 225 #define SNMP_DBG_malloc SnmpUtilMemAlloc
 226 #define SNMP_DBG_free SnmpUtilMemFree
 227 #define SNMP_DBG_realloc SnmpUtilMemReAlloc
 228 #define SNMP_oidappend SnmpUtilOidAppend
 229 #define SNMP_oidcmp SnmpUtilOidCmp
 230 #define SNMP_oidcpy SnmpUtilOidCpy
 231 #define SNMP_oidfree SnmpUtilOidFree
 232 #define SNMP_oidncmp SnmpUtilOidNCmp
 233 #define SNMP_printany SnmpUtilPrintAsnAny
 234 #define SNMP_CopyVarBind SnmpUtilVarBindCpy
 235 #define SNMP_CopyVarBindList SnmpUtilVarBindListCpy
 236 #define SNMP_FreeVarBind SnmpUtilVarBindFree
 237 #define SNMP_FreeVarBindList SnmpUtilVarBindListFree
 238 #define ASN_RFC1155_IPADDRESS ASN_IPADDRESS
 239 #define ASN_RFC1155_COUNTER ASN_COUNTER32
 240 #define ASN_RFC1155_GAUGE ASN_GAUGE32
 241 #define ASN_RFC1155_TIMETICKS ASN_TIMETICKS
 242 #define ASN_RFC1155_OPAQUE ASN_OPAQUE
 243 #define ASN_RFC1213_DISPSTRING ASN_OCTETSTRING
 244 #define ASN_RFC1157_GETREQUEST SNMP_PDU_GET
 245 #define ASN_RFC1157_GETNEXTREQUEST SNMP_PDU_GETNEXT
 246 #define ASN_RFC1157_GETRESPONSE SNMP_PDU_RESPONSE
 247 #define ASN_RFC1157_SETREQUEST SNMP_PDU_SET
 248 #define ASN_RFC1157_TRAP SNMP_PDU_V1TRAP
 249 #define ASN_CONTEXTSPECIFIC ASN_CONTEXT
 250 #define ASN_PRIMATIVE ASN_PRIMITIVE
 251 #define RFC1157VarBindList SnmpVarBindList
 252 #define RFC1157VarBind SnmpVarBind
 253 #define AsnInteger AsnInteger32
 254 #define AsnCounter AsnCounter32
 255 #define AsnGauge AsnGauge32
 256 #endif /* SNMPSTRICT */
 257
 258 #endif /* RC_INVOKED */
 259
 260 #ifdef __cplusplus
 261 }
 262 #endif
 263 #include <poppack.h>
 264 #endif