Current release: 5.9.4

skip to page content

About
Download
Tutorials
Documentation
Wiki
Support
Development

·	Projects
·	Release Schedule
·	Helping Out
·	Git
·	Release Policy
·	API

Related Info/SW

Archive Search: Users Coders Announce Bugs Patches SVN (named "CVS")

Require all words?

Site Search:

         

---

agent_trap.h File Reference

Go to the source code of this file.

Data Structures
struct	agent_add_trap_args
Functions
void	send_easy_trap (int, int)
void	send_trap_pdu (struct snmp_pdu *)
void	send_v2trap (struct variable_list *)
void	send_trap_vars (int, int, struct variable_list *)
void	send_enterprise_trap_vars (int trap, int specific, oid *enterprise, int enterprise_length, struct variable_list *vars)
void	snmpd_parse_config_authtrap (const char *, char *)
void	snmpd_parse_config_trapsink (const char *, char *)
void	snmpd_parse_config_trap2sink (const char *, char *)
void	snmpd_parse_config_informsink (const char *, char *)
void	snmpd_parse_config_trapsess (const char *, char *)
void	snmpd_free_trapsinks (void)
void	snmpd_parse_config_trapcommunity (const char *, char *)
void	snmpd_free_trapcommunity (void)
void	send_trap_to_sess (struct snmp_session *sess, struct snmp_pdu *template_pdu)
int	create_trap_session (char *, u_short, char *, int, int)
int	add_trap_session (struct snmp_session *, int, int, int)
int	remove_trap_session (struct snmp_session *)

---

Function Documentation

int add_trap_session (  struct snmp_session *    ss, int    pdutype, int    confirm, int    version )

Definition at line 129 of file agent_trap.c. Referenced by create_trap_session(), and snmpd_parse_config_trapsess(). { if (snmp_callback_available(SNMP_CALLBACK_APPLICATION, SNMPD_CALLBACK_REGISTER_NOTIFICATIONS) == SNMPERR_SUCCESS) { /* something else wants to handle notification registrations */ struct agent_add_trap_args args; DEBUGMSGTL(("add_trap_session","adding callback trap sink\n")); args.ss = ss; args.confirm = confirm; snmp_call_callbacks(SNMP_CALLBACK_APPLICATION, SNMPD_CALLBACK_REGISTER_NOTIFICATIONS, (void *) &args); } else { /* no other support exists, handle it ourselves. */ struct trap_sink *new_sink; DEBUGMSGTL(("add_trap_session","adding internal trap sink\n")); new_sink = (struct trap_sink *) malloc (sizeof (*new_sink)); if ( new_sink == NULL ) return 0; new_sink->sesp = ss; new_sink->pdutype = pdutype; new_sink->version = version; new_sink->next = sinks; sinks = new_sink; } return 1; }

int create_trap_session (  char *    sink, u_short    sinkport, char *    com, int    version, int    pdutype )

Definition at line 178 of file agent_trap.c. { struct snmp_session session, *sesp; memset (&session, 0, sizeof (struct snmp_session)); session.peername = sink; session.version = version; if (com) { session.community = (u_char *)com; session.community_len = strlen (com); } session.remote_port = sinkport; sesp = snmp_open (&session); if (sesp) { return( add_trap_session( sesp, pdutype, (pdutype==SNMP_MSG_INFORM), version )); } /* diagnose snmp_open errors with the input struct snmp_session pointer */ snmp_sess_perror("snmpd: create_trap_session", &session); return 0; }

int remove_trap_session (  struct snmp_session *    ss )

Definition at line 160 of file agent_trap.c. { struct trap_sink *sp = sinks, *prev = 0; while (sp) { if (sp->sesp == ss) { if (prev) { prev->next = sp->next; } else { sinks = sp->next; } free_trap_session(sp); return 1; } prev = sp; sp = sp->next; } return 0; }

void send_easy_trap (  int    trap, int    specific )

Definition at line 528 of file agent_trap.c. Referenced by handle_snmp_packet(), and main(). { send_trap_vars( trap, specific, NULL ); }

void send_enterprise_trap_vars (  int    trap, int    specific, oid *    enterprise, int    enterprise_length, struct variable_list *    vars )

Definition at line 283 of file agent_trap.c. Referenced by send_trap_vars(). { struct variable_list uptime_var, snmptrap_var, enterprise_var; struct variable_list *v2_vars, *last_var=NULL; struct snmp_pdu *template_pdu; struct timeval now; long uptime; in_addr_t *pdu_in_addr_t; struct trap_sink *sink; oid temp_oid[MAX_OID_LEN]; /* * Initialise SNMPv2 required variables */ gettimeofday(&now, NULL); uptime = calculate_time_diff(&now, &starttime); memset (&uptime_var, 0, sizeof (struct variable_list)); snmp_set_var_objid( &uptime_var, sysuptime_oid, OID_LENGTH(sysuptime_oid)); snmp_set_var_value( &uptime_var, (u_char *)&uptime, sizeof(uptime) ); uptime_var.type = ASN_TIMETICKS; uptime_var.next_variable = &snmptrap_var; memset (&snmptrap_var, 0, sizeof (struct variable_list)); snmp_set_var_objid( &snmptrap_var, snmptrap_oid, OID_LENGTH(snmptrap_oid)); /* value set later .... */ snmptrap_var.type = ASN_OBJECT_ID; if ( vars ) snmptrap_var.next_variable = vars; else snmptrap_var.next_variable = &enterprise_var; /* find end of provided varbind list, ready to append the enterprise info if necessary */ last_var = vars; while ( last_var && last_var->next_variable ) last_var = last_var->next_variable; memset (&enterprise_var, 0, sizeof (struct variable_list)); snmp_set_var_objid( &enterprise_var, snmptrapenterprise_oid, OID_LENGTH(snmptrapenterprise_oid)); snmp_set_var_value( &enterprise_var, (u_char *)enterprise, enterprise_length*sizeof(oid)); enterprise_var.type = ASN_OBJECT_ID; enterprise_var.next_variable = NULL; v2_vars = &uptime_var; /* * Create a template PDU, ready for sending */ template_pdu = snmp_pdu_create( SNMP_MSG_TRAP ); if ( template_pdu == NULL ) { /* Free memory if value stored dynamically */ snmp_set_var_value( &enterprise_var, NULL, 0); return; } template_pdu->trap_type = trap; template_pdu->specific_type = specific; if ( snmp_clone_mem((void **)&template_pdu->enterprise, enterprise, enterprise_length*sizeof(oid))) { snmp_free_pdu( template_pdu ); snmp_set_var_value( &enterprise_var, NULL, 0); return; } template_pdu->enterprise_length = enterprise_length; template_pdu->flags |= UCD_MSG_FLAG_FORCE_PDU_COPY; pdu_in_addr_t = (in_addr_t *)template_pdu->agent_addr; *pdu_in_addr_t = get_myaddr(); template_pdu->time = uptime; /* * Now use the parameters to determine * which v2 variables are needed, * and what values they should take. */ switch ( trap ) { case -1: /* * SNMPv2 only * Check to see whether the variables provided * are sufficient for SNMPv2 notifications */ if (vars && snmp_oid_compare(vars->name, vars->name_length, sysuptime_oid, OID_LENGTH(sysuptime_oid)) == 0 ) v2_vars = vars; else if (vars && snmp_oid_compare(vars->name, vars->name_length, snmptrap_oid, OID_LENGTH(snmptrap_oid)) == 0 ) uptime_var.next_variable = vars; else { /* Hmmm... we don't seem to have a value - oops! */ snmptrap_var.next_variable = vars; } last_var = NULL; /* Don't need enterprise info */ convert_v2_to_v1( vars, template_pdu ); break; /* "Standard" SNMPv1 traps */ case SNMP_TRAP_COLDSTART: snmp_set_var_value( &snmptrap_var, (u_char *)cold_start_oid, sizeof(cold_start_oid)); break; case SNMP_TRAP_WARMSTART: snmp_set_var_value( &snmptrap_var, (u_char *)warm_start_oid, sizeof(warm_start_oid)); break; case SNMP_TRAP_LINKDOWN: snmp_set_var_value( &snmptrap_var, (u_char *)link_down_oid, sizeof(link_down_oid)); break; case SNMP_TRAP_LINKUP: snmp_set_var_value( &snmptrap_var, (u_char *)link_up_oid, sizeof(link_up_oid)); break; case SNMP_TRAP_AUTHFAIL: if (snmp_enableauthentraps == SNMP_AUTHENTICATED_TRAPS_DISABLED) { snmp_free_pdu(template_pdu); snmp_set_var_value( &enterprise_var, NULL, 0); return; } snmp_set_var_value( &snmptrap_var, (u_char *)auth_fail_oid, sizeof(auth_fail_oid)); break; case SNMP_TRAP_EGPNEIGHBORLOSS: snmp_set_var_value( &snmptrap_var, (u_char *)egp_xxx_oid, sizeof(egp_xxx_oid)); break; case SNMP_TRAP_ENTERPRISESPECIFIC: memcpy( temp_oid, (char *)enterprise, (enterprise_length)*sizeof(oid)); temp_oid[ enterprise_length ] = 0; temp_oid[ enterprise_length+1 ] = specific; snmp_set_var_value( &snmptrap_var, (u_char *)temp_oid, (enterprise_length+2)*sizeof(oid)); snmptrap_var.next_variable = vars; last_var = NULL; /* Don't need version info */ break; } /* * Now loop through the list of trap sinks, * sending an appropriately formatted PDU to each */ for ( sink = sinks ; sink ; sink=sink->next ) { if ( sink->version == SNMP_VERSION_1 && trap == -1 ) continue; /* Skip v1 sinks for v2 only traps */ template_pdu->command = sink->pdutype; if ( sink->version != SNMP_VERSION_1 ) { template_pdu->variables = v2_vars; if ( last_var ) last_var->next_variable = &enterprise_var; } else template_pdu->variables = vars; send_trap_to_sess(sink->sesp, template_pdu); if ( sink->version != SNMP_VERSION_1 && last_var ) last_var->next_variable = NULL; } /* send stuff to registered callbacks */ /* v2 traps/informs */ template_pdu->variables = v2_vars; if ( last_var ) last_var->next_variable = &enterprise_var; snmp_call_callbacks(SNMP_CALLBACK_APPLICATION, SNMPD_CALLBACK_SEND_TRAP2, template_pdu); if ( last_var ) last_var->next_variable = NULL; /* v1 traps */ template_pdu->command = SNMP_MSG_TRAP; template_pdu->variables = vars; snmp_call_callbacks(SNMP_CALLBACK_APPLICATION, SNMPD_CALLBACK_SEND_TRAP1, template_pdu); /* Free memory if values stored dynamically */ snmp_set_var_value( &enterprise_var, NULL, 0); snmp_set_var_value( &snmptrap_var, NULL, 0); /* Ensure we don't free anything we shouldn't */ if ( last_var ) last_var->next_variable = NULL; template_pdu->variables = NULL; snmp_free_pdu( template_pdu ); }

void send_trap_pdu (  struct snmp_pdu *    pdu )

Definition at line 540 of file agent_trap.c. { send_trap_vars( -1, -1, pdu->variables ); }

void send_trap_to_sess (  struct snmp_session *    sess, struct snmp_pdu *    template_pdu )

Definition at line 489 of file agent_trap.c. Referenced by send_enterprise_trap_vars(). { struct snmp_pdu *pdu; if (!sess || !template_pdu) return; DEBUGMSGTL(("send_trap_to_sess","sending trap type=%d, version=%d\n", template_pdu->command, sess->version)); if (sess->version == SNMP_VERSION_1 && (template_pdu->command == SNMP_MSG_TRAP2 || template_pdu->command == SNMP_MSG_INFORM)) return; /* Skip v1 sinks for v2 only traps */ template_pdu->version = sess->version; pdu = snmp_clone_pdu( template_pdu ); pdu->sessid = sess->sessid; /* AgentX only ? */ if ( snmp_send( sess, pdu) == 0 ) { snmp_sess_perror ("snmpd: send_trap", sess); snmp_free_pdu( pdu ); } else { snmp_increment_statistic(STAT_SNMPOUTTRAPS); snmp_increment_statistic(STAT_SNMPOUTPKTS); } }

void send_trap_vars (  int    trap, int    specific, struct variable_list *    vars )

Definition at line 516 of file agent_trap.c. Referenced by send_easy_trap(), send_trap_pdu(), and send_v2trap(). { if ( trap == SNMP_TRAP_ENTERPRISESPECIFIC ) send_enterprise_trap_vars( trap, specific, objid_enterprisetrap, OID_LENGTH(objid_enterprisetrap), vars ); else send_enterprise_trap_vars( trap, specific, version_id, OID_LENGTH(version_id), vars ); }

void send_v2trap (  struct variable_list *    vars )

Definition at line 534 of file agent_trap.c. { send_trap_vars( -1, -1, vars ); }

void snmpd_free_trapcommunity (  void    )

Definition at line 718 of file agent_trap.c. { if (snmp_trapcommunity) { free(snmp_trapcommunity); snmp_trapcommunity = NULL; } }

void snmpd_free_trapsinks (  void    )

Definition at line 225 of file agent_trap.c. { struct trap_sink *sp = sinks; while (sp) { sinks = sinks->next; free_trap_session(sp); sp = sinks; } }

void snmpd_parse_config_authtrap (  const char *    token, char *    cptr )

Definition at line 553 of file agent_trap.c. { int i; i = atoi(cptr); if ( i == 0 ) { if ( !strcmp( cptr, "enable" )) i = SNMP_AUTHENTICATED_TRAPS_ENABLED; else if ( !strcmp( cptr, "disable" )) i = SNMP_AUTHENTICATED_TRAPS_DISABLED; } if (i < 1 || i > 2) config_perror("authtrapenable must be 1 or 2"); else snmp_enableauthentraps = i; }

void snmpd_parse_config_informsink (  const char *    word, char *    cptr )

Definition at line 627 of file agent_trap.c. { char tmpbuf[1024]; char *sp, *cp, *pp = NULL; u_short sinkport; if (!snmp_trapcommunity) snmp_trapcommunity = strdup("public"); sp = strtok(cptr, " \t\n"); cp = strtok(NULL, " \t\n"); if (cp) pp = strtok(NULL, " \t\n"); if (cp && pp) { sinkport = atoi(pp); if ((sinkport < 1) || (sinkport > 0xffff)) { config_perror("trapsink port out of range"); sinkport = SNMP_TRAP_PORT; } } else { sinkport = SNMP_TRAP_PORT; } if (create_v2_inform_session(sp, sinkport, cp ? cp : snmp_trapcommunity) == 0) { sprintf(tmpbuf,"cannot create informsink: %s", cptr); config_perror(tmpbuf); } }

void snmpd_parse_config_trap2sink (  const char *    word, char *    cptr )

Definition at line 600 of file agent_trap.c. { char tmpbuf[1024]; char *sp, *cp, *pp = NULL; u_short sinkport; if (!snmp_trapcommunity) snmp_trapcommunity = strdup("public"); sp = strtok(cptr, " \t\n"); cp = strtok(NULL, " \t\n"); if (cp) pp = strtok(NULL, " \t\n"); if (cp && pp) { sinkport = atoi(pp); if ((sinkport < 1) || (sinkport > 0xffff)) { config_perror("trapsink port out of range"); sinkport = SNMP_TRAP_PORT; } } else { sinkport = SNMP_TRAP_PORT; } if (create_v2_trap_session(sp, sinkport, cp ? cp : snmp_trapcommunity) == 0) { sprintf(tmpbuf,"cannot create trap2sink: %s", cptr); config_perror(tmpbuf); } }

void snmpd_parse_config_trapcommunity (  const char *    word, char *    cptr )

Definition at line 711 of file agent_trap.c. { if (snmp_trapcommunity) free(snmp_trapcommunity); snmp_trapcommunity = (char *)malloc (strlen(cptr)+1); copy_nword(cptr, snmp_trapcommunity, strlen(cptr)+1); }

void snmpd_parse_config_trapsess (  const char *    word, char *    cptr )

Definition at line 678 of file agent_trap.c. { char *argv[MAX_ARGS]; int argn, arg; struct snmp_session session, *ss; /* inform or trap? default to trap */ traptype = SNMP_MSG_TRAP2; /* create the argv[] like array */ argv[0] = strdup("snmpd-trapsess"); /* bogus entry for getopt() */ for(argn = 1; cptr && argn < MAX_ARGS; argn++) { argv[argn] = strdup(cptr); /* more than enough room */ } arg = snmp_parse_args(argn, argv, &session, "C:", trapOptProc); do { free(argv[--argn]); } while (argn > 0); ss = snmp_open (&session); if (!ss) { config_perror("snmpd: failed to parse this line"); snmp_sess_perror("snmpd: snmpd_parse_config_trapsess()", &session); return; } if (ss->version == SNMP_VERSION_1) { add_trap_session(ss, SNMP_MSG_TRAP, 0, SNMP_VERSION_1); } else { add_trap_session( ss, traptype, (traptype==SNMP_MSG_INFORM), ss->version ); } }

void snmpd_parse_config_trapsink (  const char *    token, char *    cptr )

Definition at line 571 of file agent_trap.c. { char tmpbuf[1024]; char *sp, *cp, *pp = NULL; u_short sinkport; if (!snmp_trapcommunity) snmp_trapcommunity = strdup("public"); sp = strtok(cptr, " \t\n"); cp = strtok(NULL, " \t\n"); if (cp) pp = strtok(NULL, " \t\n"); if (cp && pp) { sinkport = atoi(pp); if ((sinkport < 1) || (sinkport > 0xffff)) { config_perror("trapsink port out of range"); sinkport = SNMP_TRAP_PORT; } } else { sinkport = SNMP_TRAP_PORT; } if (create_v1_trap_session(sp, sinkport, cp ? cp : snmp_trapcommunity) == 0) { sprintf(tmpbuf,"cannot create trapsink: %s", cptr); config_perror(tmpbuf); } }

---

[an error occurred while processing this directive] [an error occurred while processing this directive]

---

Last modified: Wednesday, 01-Aug-2018 04:41:28 UTC
For questions regarding web content and site functionality, please write to the net-snmp-users mail list.