/***************************************************************************** * * HELLOWORLD.C - Example of a simple NEB module * * Copyright (c) 2003-2005 Ethan Galstad (http://www.nagios.org) * * Last Modified: 08-02-2005 * * Description: * * This is an example of a very basic module. It does nothing useful other * than logging some messages to the main Nagios log file when it is initialized * (loaded), when it is closed (unloaded), and when aggregated status updates * occur. I would not call that too useful, but hopefully it will serve as a * very basic example of how to write a NEB module... * * Instructions: * * Compile with the following command: * * gcc -shared -o helloworld.o helloworld.c * *****************************************************************************/ /* include (minimum required) event broker header files */ #include "../include/nebmodules.h" #include "../include/nebcallbacks.h" /* include other event broker header files that we need for our work */ #include "../include/nebstructs.h" #include "../include/broker.h" /* include some Nagios stuff as well */ #include "../include/config.h" #include "../include/common.h" #include "../include/nagios.h" /* specify event broker API version (required) */ NEB_API_VERSION(CURRENT_NEB_API_VERSION); void *helloworld_module_handle=NULL; void helloworld_reminder_message(char *); int helloworld_handle_data(int,void *); /* this function gets called when the module is loaded by the event broker */ int nebmodule_init(int flags, char *args, nebmodule *handle){ char temp_buffer[1024]; time_t current_time; unsigned long interval; /* save our handle */ helloworld_module_handle=handle; /* log module info to the Nagios log file */ write_to_all_logs("helloworld: Copyright (c) 2003-2005 Ethan Galstad (nagios@nagios.org)",NSLOG_INFO_MESSAGE); /* log a message to the Nagios log file */ snprintf(temp_buffer,sizeof(temp_buffer)-1,"helloworld: Hello world!\n"); temp_buffer[sizeof(temp_buffer)-1]='\x0'; write_to_all_logs(temp_buffer,NSLOG_INFO_MESSAGE); /* log a reminder message every 15 minutes (how's that for annoying? :-)) */ time(¤t_time); interval=900; schedule_new_event(EVENT_USER_FUNCTION,TRUE,current_time+interval,TRUE,interval,NULL,TRUE,helloworld_reminder_message,"How about you?"); /* register to be notified of certain events... */ neb_register_callback(NEBCALLBACK_AGGREGATED_STATUS_DATA,helloworld_module_handle,0,helloworld_handle_data); return 0; } /* this function gets called when the module is unloaded by the event broker */ int nebmodule_deinit(int flags, int reason){ char temp_buffer[1024]; /* deregister for all events we previously registered for... */ neb_deregister_callback(NEBCALLBACK_AGGREGATED_STATUS_DATA,helloworld_handle_data); /* log a message to the Nagios log file */ snprintf(temp_buffer,sizeof(temp_buffer)-1,"helloworld: Goodbye world!\n"); temp_buffer[sizeof(temp_buffer)-1]='\x0'; write_to_all_logs(temp_buffer,NSLOG_INFO_MESSAGE); return 0; } /* gets called every X minutes by an event in the scheduling queue */ void helloworld_reminder_message(char *message){ char temp_buffer[1024]; /* log a message to the Nagios log file */ snprintf(temp_buffer,sizeof(temp_buffer)-1,"helloworld: I'm still here! %s",message); temp_buffer[sizeof(temp_buffer)-1]='\x0'; write_to_all_logs(temp_buffer,NSLOG_INFO_MESSAGE); return; } /* handle data from Nagios daemon */ int helloworld_handle_data(int event_type, void *data){ nebstruct_aggregated_status_data *agsdata=NULL; char temp_buffer[1024]; /* what type of event/data do we have? */ switch(event_type){ case NEBCALLBACK_AGGREGATED_STATUS_DATA: /* an aggregated status data dump just started or ended... */ if((agsdata=(nebstruct_aggregated_status_data *)data)){ /* log a message to the Nagios log file */ snprintf(temp_buffer,sizeof(temp_buffer)-1,"helloworld: An aggregated status update just %s.",(agsdata->type==NEBTYPE_AGGREGATEDSTATUS_STARTDUMP)?"started":"finished"); temp_buffer[sizeof(temp_buffer)-1]='\x0'; write_to_all_logs(temp_buffer,NSLOG_INFO_MESSAGE); } break; default: break; } return 0; }