[insert project logo here (125x200px max)] Navigator Home Downloads Documentation Research News Forums Project Summary CVS repository Mailinglists Help Announcement Developer Please report any errors or ommissions you find to our `Help' mailinglist, or post a message in the Forums. Copyright and Licensing Information Snap is (c) Jonathan T. Moore, 1999-2002 and licensed under the GNU General Public License (GPL). All other parts of Splash are (c) Willem de Bruijn, 2002-2003 and licensed under the BSD Open Source License. All sourcecode is made publicly available. Acknowledgement Splash and the Splash website are hosted by SourceForge.net

Splash - Documentation SNMP Plus a Lightweight API for SNAP Handling             snap_svc/snap_svc_test.c Go to the documentation of this file. /* snap service library */ /* (c) Willem de Bruijn, 2002, 2003 */ /* Licensed under the BSD License */ /* snap_svc_test library sourcefile */ #include <string.h> #include "d_printf.h" #include "snap_svc.h" #include "snap_svc_test.h" /* HOWTO create a new library this file can guide as an example on how to implement your libraries (1) BUILDING and COMPILING you can copy the snap_svc_TEMPLATE.h and snap_svc_TEMPLATE.c files and edit those. Just rename all instances of TEMPLATE and add your code each library must include snap_svc.h and link to snap_svc.o each library should at least contain the following functions: void snap_external_svclib_init(); void snap_external_svclib_done(); void snap_external_svclib_getnextfunc(char**, snapsvc_func_proto*, int*, int*); please view the examples below to understand how you should implement thense any other functions can be created as you please... ... there is only one restriction: Although your functions need not use any arguments it is IMPERATIVE that you add a single useless argument to empty argument lists, i.e. you are not allowed to create functions that take no arguments. This follows from the typedef we use to pass functions declared in snap_svc.h (2) MAKE and MAKE INSTALL adding your library to the base package is fairly simple. in Makefile.am : add a new entry to lib_LTLIBRARIES = [previous entries ...] libsnap_svc_[yourlibname].la and add two new lines : libsnap_svc_[yourlibname]_la_SOURCES = [your source and header files ] libsnap_svc_[yourlibname]_la_LDFLAGS = -version-info 1:0:0 [your library includes] and optionally add header files that should be installed to include_HEADERS = [previous entries ...] [your entries ...] when finished alteringn this file run : aclocal && autoconf && autoheader && automake -a --foreign ofcourse, these tools must be installed on your system to work. then do a : make && make uninstall && make install and finally run: ldconfig DONE! good luck, Willem */ /* library handling functions */ void snap_external_svclib_init(){ d_printf(50,"snap_svc_test : initialized\n"); } void snap_external_svclib_done(){ d_printf(50,"snap_svc_test : closed\n"); } /* there is where functions inside the library should be listed for registration */ void snap_external_svclib_getnextfunc(char** snapsvc_name, snapsvc_func_proto* snapsvc_func, int* snapsvc_args, int* snapsvc_rets){ switch (svc_fun_counter){ case 0 : (*snapsvc_name) = strdup ("testsimple"); (*snapsvc_func) = (snapsvc_func_proto) &snap_external_svclib_testfunc; (*snapsvc_args) = 0; (*snapsvc_rets) = SVC_SNMP_TYPE_NULL; break; case 1 : (*snapsvc_name) = strdup ("testint"); (*snapsvc_func) = (snapsvc_func_proto) &snap_external_svclib_testintfunc; (*snapsvc_args) = 1; (*snapsvc_rets) = SVC_SNMP_TYPE_NULL; break; case 2 : (*snapsvc_name) = strdup ("teststr"); (*snapsvc_func) = (snapsvc_func_proto) &snap_external_svclib_teststrfunc; (*snapsvc_args) = 1; (*snapsvc_rets) = SVC_SNMP_TYPE_NULL; break; /* unknown handler -> return NULL as end-of-list symbol */ default : (*snapsvc_name) = NULL; (*snapsvc_func) = NULL; (*snapsvc_args) = 0; (*snapsvc_rets) = 0; } svc_fun_counter ++; } /* ADD SERVICES BELOW */ /* declarations of snap service handlers */ /* test function : print a message to stderr */ int snap_external_svclib_testfunc(void* useless){ fprintf (stderr,"snap_svc_snmp : succesfully called the testfunction\n"); return 0; } /* test function : print a message containing an int */ int snap_external_svclib_testintfunc(int useless){ if (useless) fprintf (stderr,"snap_svc_snmp : succesfully called the test INT function with argument %d\n", useless); else fprintf (stderr,"snap_svc_snmp : succesfully called the test INT function with argument NULL\n"); return 0; } /* test function : print a message containing a string */ int snap_external_svclib_teststrfunc(char* useless){ if (useless) fprintf (stderr,"snap_svc_snmp : succesfully called the test STR function with argument %s\n",useless); else fprintf (stderr,"snap_svc_snmp : succesfully called the test STR function with argument NULL\n"); return 0; }