/*
 *  snmp.h      Simple Network Management Protocol (SNMP) functions
 *
 * =========================================================================
 *
 *                          Open Watcom Project
 *
 * Copyright (c) 2004-2026 The Open Watcom Contributors. All Rights Reserved.
 *
 *    This file is automatically generated. Do not edit directly.
 *
 * =========================================================================
 */

#ifndef _INC_SNMP
#define _INC_SNMP

#ifndef _ENABLE_AUTODEPEND
 #pragma read_only_file
#endif

#include <windows.h>

#ifdef __cplusplus
extern "C" {
#endif

/* SNMP calling convention */
#define SNMP_FUNC_TYPE  WINAPI

/* ASN primitive data types */
typedef LONG            AsnInteger32;
typedef ULONG           AsnUnsigned32;
typedef ULARGE_INTEGER  AsnCounter64;
typedef AsnUnsigned32   AsnCounter32;
typedef AsnUnsigned32   AsnGauge32;
typedef AsnUnsigned32   AsnTimeticks;
#ifndef SNMPSTRICT
    #define AsnInteger  AsnInteger32
    #define AsnCounter  AsnCounter32
    #define AsnGauge    AsnGauge32
#endif

/* SNMP return code data type */
#define SNMPAPI INT

/* ASN base types */
#ifndef _INC_WINSNMP
    #define ASN_UNIVERSAL       0x00
    #define ASN_APPLICATION     0x40
    #define ASN_CONTEXT         0x80
    #define ASN_PRIVATE         0xC0
    #define ASN_PRIMITIVE       0x00
    #define ASN_CONSTRUCTOR     0x20
#endif
#ifndef SNMPSTRICT
    #define ASN_CONTEXTSPECIFIC ASN_CONTEXT
    #define ASN_PRIMATIVE       ASN_PRIMITIVE
#endif

/* SNMP PDU types */
#ifndef _INC_WINSNMP
    #define SNMP_PDU_GET                (ASN_CONTEXT | ASN_CONSTRUCTOR | 0x00)
    #define SNMP_PDU_GETNEXT            (ASN_CONTEXT | ASN_CONSTRUCTOR | 0x01)
    #define SNMP_PDU_RESPONSE           (ASN_CONTEXT | ASN_CONSTRUCTOR | 0x02)
    #define SNMP_PDU_SET                (ASN_CONTEXT | ASN_CONSTRUCTOR | 0x03)
    #define SNMP_PDU_V1TRAP             (ASN_CONTEXT | ASN_CONSTRUCTOR | 0x04)
    #define SNMP_PDU_GETBULK            (ASN_CONTEXT | ASN_CONSTRUCTOR | 0x05)
    #define SNMP_PDU_INFORM             (ASN_CONTEXT | ASN_CONSTRUCTOR | 0x06)
    #define SNMP_PDU_TRAP               (ASN_CONTEXT | ASN_CONSTRUCTOR | 0x07)
#endif
#ifndef SNMPSTRICT
    #define ASN_RFC1157_GETREQUEST      SNMP_PDU_GET
    #define ASN_RFC1157_GETNEXTREQUEST  SNMP_PDU_GETNEXT
    #define ASN_RFC1157_GETRESPONSE     SNMP_PDU_RESPONSE
    #define ASN_RFC1157_SETREQUEST      SNMP_PDU_SET
    #define ASN_RFC1157_TRAP            SNMP_PDU_V1TRAP
#endif

/* ASN simple syntax types */
#define ASN_INTEGER                 (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x02)
#define ASN_BITS                    (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x03)
#define ASN_OCTETSTRING             (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x04)
#define ASN_NULL                    (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x05)
#define ASN_OBJECTIDENTIFIER        (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x06)
#define ASN_INTEGER32               ASN_INTEGER
#ifndef SNMPSTRICT
    #define ASN_RFC1213_DISPSTRING  ASN_OCTETSTRING
#endif

/* ASN constructor syntax types */
#define ASN_SEQUENCE    (ASN_UNIVERSAL | ASN_CONSTRUCTOR | 0x10)
#define ASN_SEQUENCEOF  ASN_SEQUENCE

/* ASN application syntax types */
#define ASN_IPADDRESS               (ASN_APPLICATION | ASN_PRIMITIVE | 0x00)
#define ASN_COUNTER32               (ASN_APPLICATION | ASN_PRIMITIVE | 0x01)
#define ASN_GAUGE32                 (ASN_APPLICATION | ASN_PRIMITIVE | 0x02)
#define ASN_TIMETICKS               (ASN_APPLICATION | ASN_PRIMITIVE | 0x03)
#define ASN_OPAQUE                  (ASN_APPLICATION | ASN_PRIMITIVE | 0x04)
#define ASN_COUNTER64               (ASN_APPLICATION | ASN_PRIMITIVE | 0x06)
#define ASN_UINTEGER32              (ASN_APPLICATION | ASN_PRIMITIVE | 0x07)
#define ASN_RFC2578_UNSIGNED32      ASN_GAUGE32
#ifndef SNMPSTRICT
    #define ASN_RFC1155_IPADDRESS   ASN_IPADDRESS
    #define ASN_RFC1155_COUNTER     ASN_COUNTER32
    #define ASN_RFC1155_GAUGE       ASN_GAUGE32
    #define ASN_RFC1155_TIMETICKS   ASN_TIMETICKS
    #define ASN_RFC1155_OPAQUE      ASN_OPAQUE
    #define ASN_UNSIGNED32          ASN_UINTEGER32
#endif

/* SNMP exception types */
#define SNMP_EXCEPTION_NOSUCHOBJECT     (ASN_CONTEXT | ASN_PRIMITIVE | 0x00)
#define SNMP_EXCEPTION_NOSUCHINSTANCE   (ASN_CONTEXT | ASN_PRIMITIVE | 0x01)
#define SNMP_EXCEPTION_ENDOFMIBVIEW     (ASN_CONTEXT | ASN_PRIMITIVE | 0x02)

/* SNMP extension types */
#define SNMP_EXTENSION_GET          SNMP_PDU_GET
#define SNMP_EXTENSION_GET_NEXT     SNMP_PDU_GETNEXT
#define SNMP_EXTENSION_GET_BULK     SNMP_PDU_GETBULK
#define SNMP_EXTENSION_SET_TEST     (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x00)
#define SNMP_EXTENSION_SET_COMMIT   SNMP_PDU_SET
#define SNMP_EXTENSION_SET_UNDO     (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x01)
#define SNMP_EXTENSION_SET_CLEANUP  (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x02)

/* SNMP error codes */
#define SNMP_ERRORSTATUS_NOERROR                0
#define SNMP_ERRORSTATUS_TOOBIG                 1
#define SNMP_ERRORSTATUS_NOSUCHNAME             2
#define SNMP_ERRORSTATUS_BADVALUE               3
#define SNMP_ERRORSTATUS_READONLY               4
#define SNMP_ERRORSTATUS_GENERR                 5
#define SNMP_ERRORSTATUS_NOACCESS               6
#define SNMP_ERRORSTATUS_WRONGTYPE              7
#define SNMP_ERRORSTATUS_WRONGLENGTH            8
#define SNMP_ERRORSTATUS_WRONGENCODING          9
#define SNMP_ERRORSTATUS_WRONGVALUE             10
#define SNMP_ERRORSTATUS_NOCREATION             11
#define SNMP_ERRORSTATUS_INCONSISTENTVALUE      12
#define SNMP_ERRORSTATUS_RESOURCEUNAVAILABLE    13
#define SNMP_ERRORSTATUS_COMMITFAILED           14
#define SNMP_ERRORSTATUS_UNDOFAILED             15
#define SNMP_ERRORSTATUS_AUTHORIZATIONERROR     16
#define SNMP_ERRORSTATUS_NOTWRITABLE            17
#define SNMP_ERRORSTATUS_INCONSISTENTNAME       18

/* SNMP generic trap types */
#define SNMP_GENERICTRAP_COLDSTART      0
#define SNMP_GENERICTRAP_WARMSTART      1
#define SNMP_GENERICTRAP_LINKDOWN       2
#define SNMP_GENERICTRAP_LINKUP         3
#define SNMP_GENERICTRAP_AUTHFAILURE    4
#define SNMP_GENERICTRAP_EGPNEIGHLOSS   5
#define SNMP_GENERICTRAP_ENTERSPECIFIC  6

/* SNMP access types */
#define SNMP_ACCESS_NONE        0
#define SNMP_ACCESS_NOTIFY      1
#define SNMP_ACCESS_READ_ONLY   2
#define SNMP_ACCESS_READ_WRITE  3
#define SNMP_ACCESS_READ_CREATE 4

/* SNMP return codes */
#define SNMPAPI_NOERROR TRUE
#define SNMPAPI_ERROR   FALSE

/* SNMP log levels */
#define SNMP_LOG_SILENT     0x00000000
#define SNMP_LOG_FATAL      0x00000001
#define SNMP_LOG_ERROR      0x00000002
#define SNMP_LOG_WARNING    0x00000003
#define SNMP_LOG_TRACE      0x00000004
#define SNMP_LOG_VERBOSE    0x00000005

/* SNMP log types */
#define SNMP_OUTPUT_TO_CONSOLE  0x00000001
#define SNMP_OUTPUT_TO_LOGFILE  0x00000002
#define SNMP_OUTPUT_TO_EVENTLOG 0x00000004
#define SNMP_OUTPUT_TO_DEBUGGER 0x00000008

/* SNMP macros */
#define DEFINE_SIZEOF( x )  (sizeof( x ) / sizeof( (x)[0] ))
#define DEFINE_OID( x )     { DEFINE_SIZEOF( x ), (x) }
#define DEFINE_NULLOID()    { 0, NULL }
#define DEFINE_NULLOCTETS() { NULL, 0, FALSE }

/* SNMP default values */
#define DEFAULT_SNMP_PORT_UDP       161
#define DEFAULT_SNMP_PORT_IPX       36879
#define DEFAULT_SNMPTRAP_PORT_UDP   162
#define DEFAULT_SNMPTRAP_PORT_IPX   36880

/* SNMP maximum object identifier length */
#define SNMP_MAX_OID_LEN    128

/* SNMP API error codes */
#define SNMP_MEM_ALLOC_ERROR            1
#define SNMP_BERAPI_INVALID_LENGTH      10
#define SNMP_BERAPI_INVALID_TAG         11
#define SNMP_BERAPI_OVERFLOW            12
#define SNMP_BERAPI_SHORT_BUFFER        13
#define SNMP_BERAPI_INVALID_OBJELEM     14
#define SNMP_PDUAPI_UNRECOGNIZED_PDU    20
#define SNMP_PDUAPI_INVALID_ES          21
#define SNMP_PDUAPI_INVALID_GT          22
#define SNMP_AUTHAPI_INVALID_VERSION    30
#define SNMP_AUTHAPI_INVALID_MSG_TYPE   31
#define SNMP_AUTHAPI_TRIV_AUTH_FAILED   32

/* The following structures get 4-byte packing. */
#pragma pack( __push, 4 )

/* ASN octet string */
typedef struct {
    BYTE    *stream;
    UINT    length;
    BOOL    dynamic;
} AsnOctetString;
typedef AsnOctetString  AsnBits;
typedef AsnOctetString  AsnSequence;
typedef AsnOctetString  AsnImplicitSequence;
typedef AsnOctetString  AsnIPAddress;
typedef AsnOctetString  AsnNetworkAddress;
typedef AsnOctetString  AsnDisplayString;
typedef AsnOctetString  AsnOpaque;

/* ASN object identifier */
typedef struct {
    UINT    idLength;
    UINT    *ids;
} AsnObjectIdentifier;
typedef AsnObjectIdentifier AsnObjectName;

/* ASN type and value */
typedef struct {
    BYTE    asnType;
    union {
        AsnInteger32        number;
        AsnUnsigned32       unsigned32;
        AsnCounter64        counter64;
        AsnOctetString      string;
        AsnBits             bits;
        AsnObjectIdentifier object;
        AsnSequence         sequence;
        AsnIPAddress        address;
        AsnCounter32        counter;
        AsnGauge32          gauge;
        AsnTimeticks        ticks;
        AsnOpaque           arbitrary;
    } asnValue;
} AsnAny;
typedef AsnAny  AsnObjectSyntax;

/* SNMP variable bind */
typedef struct {
    AsnObjectName   name;
    AsnObjectSyntax value;
} SnmpVarBind;
#ifndef SNMPSTRICT
    #define RFC1157VarBind  SnmpVarBind
#endif

/* SNMP variable bind list */
typedef struct {
    SnmpVarBind *list;
    UINT        len;
} SnmpVarBindList;
#ifndef SNMPSTRICT
    #define RFC1157VarBindList  SnmpVarBindList
#endif

/* Revert to default packing. */
#pragma pack( __pop )

/* SNMP extension callbacks */
typedef VOID (SNMP_FUNC_TYPE *PFNSNMPEXTENSIONCLOSE)();
typedef BOOL (SNMP_FUNC_TYPE *PFNSNMPEXTENSIONINIT)( DWORD, HANDLE *, AsnObjectIdentifier * );
typedef BOOL (SNMP_FUNC_TYPE *PFNSNMPEXTENSIONINITEX)( AsnObjectIdentifier * );
typedef BOOL (SNMP_FUNC_TYPE *PFNSNMPEXTENSIONMONITOR)( LPVOID );
typedef BOOL (SNMP_FUNC_TYPE *PFNSNMPEXTENSIONQUERY)( BYTE, SnmpVarBindList *, AsnInteger32 *, AsnInteger32 * );
typedef BOOL (SNMP_FUNC_TYPE *PFNSNMPEXTENSIONQUERYEX)( UINT, UINT, SnmpVarBindList *, AsnOctetString *, AsnInteger32 *, AsnInteger32 * );
typedef BOOL (SNMP_FUNC_TYPE *PFNSNMPEXTENSIONTRAP)( AsnObjectIdentifier *, AsnInteger32 *, AsnInteger32 *, AsnTimeticks *, SnmpVarBindList * );

/* Functions exported by SNMP extensions */
VOID SNMP_FUNC_TYPE SnmpExtensionClose();
BOOL SNMP_FUNC_TYPE SnmpExtensionInit( DWORD, HANDLE *, AsnObjectIdentifier * );
BOOL SNMP_FUNC_TYPE SnmpExtensionInitEx( AsnObjectIdentifier * );
BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor( LPVOID );
BOOL SNMP_FUNC_TYPE SnmpExtensionQuery( BYTE, SnmpVarBindList *, AsnInteger32 *, AsnInteger32 * );
BOOL SNMP_FUNC_TYPE SnmpExtensionQueryEx( UINT, UINT, SnmpVarBindList *, AsnOctetString *, AsnInteger32 *, AsnInteger32 * );
BOOL SNMP_FUNC_TYPE SnmpExtensionTrap( AsnObjectIdentifier *, AsnInteger32 *, AsnInteger32 *, AsnTimeticks *, SnmpVarBindList * );

/* Functions in SNMPAPI.DLL */
DWORD SNMP_FUNC_TYPE    SnmpSvcGetUptime();
VOID SNMP_FUNC_TYPE     SnmpSvcSetLogLevel( INT );
VOID SNMP_FUNC_TYPE     SnmpSvcSetLogType( INT );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilAsnAnyCpy( AsnAny *, AsnAny * );
VOID SNMP_FUNC_TYPE     SnmpUtilAsnAnyFree( AsnAny * );
VOID SNMP_FUNC_TYPE     SnmpUtilDbgPrint( INT, LPSTR, ... );
LPSTR SNMP_FUNC_TYPE    SnmpUtilIdsToA( UINT *, UINT );
LPVOID SNMP_FUNC_TYPE   SnmpUtilMemAlloc( UINT );
VOID SNMP_FUNC_TYPE     SnmpUtilMemFree( LPVOID );
LPVOID SNMP_FUNC_TYPE   SnmpUtilMemReAlloc( LPVOID, UINT );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilOctetsCmp( AsnOctetString *, AsnOctetString * );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilOctetsNCmp( AsnOctetString *, AsnOctetString *, UINT );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilOctetsCpy( AsnOctetString *, AsnOctetString * );
VOID SNMP_FUNC_TYPE     SnmpUtilOctetsFree( AsnOctetString * );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilOidAppend( AsnObjectIdentifier *, AsnObjectIdentifier * );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilOidCmp( AsnObjectIdentifier *, AsnObjectIdentifier * );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilOidCpy( AsnObjectIdentifier *, AsnObjectIdentifier * );
VOID SNMP_FUNC_TYPE     SnmpUtilOidFree( AsnObjectIdentifier * );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilOidNCmp( AsnObjectIdentifier *, AsnObjectIdentifier *, UINT );
LPSTR SNMP_FUNC_TYPE    SnmpUtilOidToA( AsnObjectIdentifier * );
VOID SNMP_FUNC_TYPE     SnmpUtilPrintAsnAny( AsnAny * );
VOID SNMP_FUNC_TYPE     SnmpUtilPrintOid( AsnObjectIdentifier * );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilVarBindCpy( SnmpVarBind *, SnmpVarBind * );
VOID SNMP_FUNC_TYPE     SnmpUtilVarBindFree( SnmpVarBind * );
SNMPAPI SNMP_FUNC_TYPE  SnmpUtilVarBindListCpy( SnmpVarBindList *, SnmpVarBindList * );
VOID SNMP_FUNC_TYPE     SnmpUtilVarBindListFree( SnmpVarBindList * );

/* Old names for compatibility */
#ifndef SNMPSTRICT
    #define SNMP_oidcpy             SnmpUtilOidCpy
    #define SNMP_oidappend          SnmpUtilOidAppend
    #define SNMP_oidncmp            SnmpUtilOidNCmp
    #define SNMP_oidcmp             SnmpUtilOidCmp
    #define SNMP_oidfree            SnmpUtilOidFree
    #define SNMP_CopyVarBindList    SnmpUtilVarBindListCpy
    #define SNMP_FreeVarBindList    SnmpUtilVarBindListFree
    #define SNMP_CopyVarBind        SnmpUtilVarBindCpy
    #define SNMP_FreeVarBind        SnmpUtilVarBindFree
    #define SNMP_printany           SnmpUtilPrintAsnAny
    #define SNMP_free               SnmpUtilMemFree
    #define SNMP_malloc             SnmpUtilMemAlloc
    #define SNMP_realloc            SnmpUtilMemReAlloc
    #define SNMP_DBG_free           SnmpUtilMemFree
    #define SNMP_DBG_malloc         SnmpUtilMemAlloc
    #define SNMP_DBG_realloc        SnmpUtilMemReAlloc
#endif

#ifdef __cplusplus
} /* extern "C" */
#endif

#endif /* _INC_SNMP */
