开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Internet/网络编程 > SNMP编程 > 查看源码
snmp_secmod.h
资源名称：net-snmp-5.2.2.rar　[点击查看]
上传用户：wxp200602
上传日期：2007-10-30
资源大小：4028k
文件大小：5k
源码类别：

SNMP编程

开发平台：

Unix_Linux

snmp_secmod.h：源码内容
  1. #ifndef SNMPSECMOD_H
  2. #define SNMPSECMOD_H
  4. #ifdef __cplusplus
  5. extern          "C" {
  6. #endif
  8. #include <net-snmp/library/snmp_transport.h>
  10. struct snmp_secmod_def;
  12. /*
  13.  * parameter information passed to security model routines
  14.  */
  15. struct snmp_secmod_outgoing_params {
  16.     int             msgProcModel;
  17.     u_char         *globalData;
  18.     size_t          globalDataLen;
  19.     int             maxMsgSize;
  20.     int             secModel;
  21.     u_char         *secEngineID;
  22.     size_t          secEngineIDLen;
  23.     char           *secName;
  24.     size_t          secNameLen;
  25.     int             secLevel;
  26.     u_char         *scopedPdu;
  27.     size_t          scopedPduLen;
  28.     void           *secStateRef;
  29.     u_char         *secParams;
  30.     size_t         *secParamsLen;
  31.     u_char        **wholeMsg;
  32.     size_t         *wholeMsgLen;
  33.     size_t         *wholeMsgOffset;
  34.     netsnmp_pdu    *pdu;        /* IN - the pdu getting encoded            */
  35.     netsnmp_session *session;   /* IN - session sending the message        */
  36. };
  38. struct snmp_secmod_incoming_params {
  39.     int             msgProcModel;       /* IN */
  40.     size_t          maxMsgSize; /* IN     - Used to calc maxSizeResponse.  */
  42.     u_char         *secParams;  /* IN     - BER encoded securityParameters. */
  43.     int             secModel;   /* IN */
  44.     int             secLevel;   /* IN     - AuthNoPriv; authPriv etc.      */
  46.     u_char         *wholeMsg;   /* IN     - Original v3 message.           */
  47.     size_t          wholeMsgLen;        /* IN     - Msg length.                    */
  49.     u_char         *secEngineID;        /* OUT    - Pointer snmpEngineID.          */
  50.     size_t         *secEngineIDLen;     /* IN/OUT - Len available; len returned.   */
  51.     /*
  52.      * NOTE: Memory provided by caller.      
  53.      */
  55.     char           *secName;    /* OUT    - Pointer to securityName.       */
  56.     size_t         *secNameLen; /* IN/OUT - Len available; len returned.   */
  58.     u_char        **scopedPdu;  /* OUT    - Pointer to plaintext scopedPdu. */
  59.     size_t         *scopedPduLen;       /* IN/OUT - Len available; len returned.   */
  61.     size_t         *maxSizeResponse;    /* OUT    - Max size of Response PDU.      */
  62.     void          **secStateRef;        /* OUT    - Ref to security state.         */
  63.     netsnmp_session *sess;      /* IN     - session which got the message  */
  64.     netsnmp_pdu    *pdu;        /* IN     - the pdu getting parsed         */
  65.     u_char          msg_flags;  /* IN     - v3 Message flags.              */
  66. };
  69. /*
  70.  * function pointers:
  71.  */
  73. /*
  74.  * free's a given security module's data; called at unregistration time 
  75.  */
  76. typedef int     (SecmodSessionCallback) (netsnmp_session *);
  77. typedef int     (SecmodPduCallback) (netsnmp_pdu *);
  78. typedef int     (Secmod2PduCallback) (netsnmp_pdu *, netsnmp_pdu *);
  79. typedef int     (SecmodOutMsg) (struct snmp_secmod_outgoing_params *);
  80. typedef int     (SecmodInMsg) (struct snmp_secmod_incoming_params *);
  81. typedef void    (SecmodFreeState) (void *);
  82. typedef void    (SecmodHandleReport) (void *sessp,
  83.                                       netsnmp_transport *transport,
  84.                                       netsnmp_session *,
  85.                                       int result,
  86.                                       netsnmp_pdu *origpdu);
  88. /*
  89.  * definition of a security module
  90.  */
  92. /*
  93.  * all of these callback functions except the encoding and decoding
  94.  * routines are optional.  The rest of them are available if need.  
  95.  */
  96. struct snmp_secmod_def {
  97.     /*
  98.      * session maniplation functions 
  99.      */
  100.     SecmodSessionCallback *session_open;        /* called in snmp_sess_open()  */
  101.     SecmodSessionCallback *session_close;       /* called in snmp_sess_close() */
  103.     /*
  104.      * pdu manipulation routines 
  105.      */
  106.     SecmodPduCallback *pdu_free;        /* called in free_pdu() */
  107.     Secmod2PduCallback *pdu_clone;      /* called in snmp_clone_pdu() */
  108.     SecmodPduCallback *pdu_timeout;     /* called when request timesout */
  109.     SecmodFreeState *pdu_free_state_ref;        /* frees pdu->securityStateRef */
  111.     /*
  112.      * de/encoding routines: mandatory 
  113.      */
  114.     SecmodOutMsg   *encode_reverse;     /* encode packet back to front */
  115.     SecmodOutMsg   *encode_forward;     /* encode packet forward */
  116.     SecmodInMsg    *decode;     /* decode & validate incoming */
  118.    /*
  119.     * error and report handling
  120.     */
  121.    SecmodHandleReport *handle_report;
  122. };
  125. /*
  126.  * internal list
  127.  */
  128. struct snmp_secmod_list {
  129.     int             securityModel;
  130.     struct snmp_secmod_def *secDef;
  131.     struct snmp_secmod_list *next;
  132. };
  135. /*
  136.  * register a security service 
  137.  */
  138. int             register_sec_mod(int, const char *,
  139.                                  struct snmp_secmod_def *);
  140. /*
  141.  * find a security service definition 
  142.  */
  143. struct snmp_secmod_def *find_sec_mod(int);
  144. /*
  145.  * register a security service 
  146.  */
  147. int             unregister_sec_mod(int);        /* register a security service */
  148. void            init_secmod(void);
  150. /*
  151.  * clears the sec_mod list
  152.  */
  153. void            clear_sec_mod(void);
  155. #ifdef __cplusplus
  156. }
  157. #endif
  158. #endif                          /* SNMPSECMOD_H */