Sella NMS v1.0.0 (02/XX/05) - http://www.digitalgenesis.com

Configuration:

   There are several options available to aid developers in debugging Sella NMS.
   These options can be used in any combination, the developer chooses.

   0. Trace-options

      Trace-options can be used to provide additional information from a
      running module to aid in troubleshooting configuration problems or
      internal issues.

      See the trace-options section of the manual for detailed information:

        http://www.digitalgenesis.com/software/sella_nms/manual

   1. Debug Mode

      Debug mode enables debugging features within Sella NMS and supporting
      libraries. This mode will enable debugging symbols and disable
      optimization (-O0) for gcc. Additionally, assert() calls will trigger
      and any '#ifdef DEBUG' will be compiled in.

      This mode can be enabled with:

         ./configure --enable-debug

   2. Arena Memory

      The STL's arena (pool) memory system can be disabled, which aids in
      tracking down memory leaks. This prevents false positives when using a
      a memory debugging tool such as Valgrind. This may cause a noticable
      slowdown in the running speed of Sella NMS.

      This mode can be enabled with:

         ./configure --disable-arena-memory

      NOTE: If you are compiling with gcc 3.2.2 or newer, this feature will
            not work. To disable the arena memory sytem set the env variable
            GLIBCPP_FORCE_NEW before starting Sella NMS.

   3. STLport's 'Safe STL' Mode

      Safe STL mode is available if you are compiling with STLPort. It enables
      checks for iterators, bounds checking and memory corruption. This may
      cause a noticable slowdown in the running speed of Sella NMS.

      This mode can be enabled with:

         ./configure --with-stlp=<path_to_stlport> --enable-safe-stl

      NOTE: STL Port 4.6.2 with gcc 2.95.3 works well. We've had limited success
            using STL Port working with gcc 3.x.




/* WARNING: Information below this point is very out of date, and support has been disabled. */




   X. ccmalloc Support (http://www.inf.ethz.ch/personal/biere/projects/ccmalloc/)

      CAUTION: ccmalloc isn't thread safe, so it sometimes tends to causes the
               program to crash.

      NOTE: You must have a ccmalloc installed on your system prior to using this
            feature. Tested with ccmalloc v0.3.9.

      ccmalloc support can be compiled into Sella NMS by using the following
      configure parameter:

	      ./configure --with-ccmalloc

      Normally its best to enable both debug and ccmalloc support. Without doing
      this, you will get invalid results since the STL uses an arena/pool memory
      system.

         ./configure --enable-debug --with-ccmalloc

      To utilize ccmalloc after compiling it in, you must modify your .ccmalloc
      file which is located within sella_nms/src/daemon. Then just run as normal.

   X. dmalloc Support (http://www.dmalloc.com)

      CAUTION: You must have a threaded version of dmalloc installed on your
               system prior to using this feature. Tested with dmalloc v4.8.1.

      dmalloc support can be compiled into Sella NMS by using the following
      configure parameter:

	      ./configure --with-dmalloc

      Normally its best to enable both debug and dmalloc support. Without doing
      this, you will get invalid results since the STL uses an arena/pool memory
      system.

         ./configure --enable-debug --with-dmalloc

      To utilize dmalloc after compiling it in, plug-ins must be preloaded and
      the DMALLOC_OPTIONS environment variable must be used to specify features.

      The example below assumes you are running bash as your shell:

	       DMALLOC_OPTIONS="debug=0x4e40503,inter=100,log=/tmp/dmalloc.log" \
          LD_PRELOAD="../modules/configuration/flatfile/libflatfile.so.0 \
                      ../modules/storage/mysql/libmysql.so.0 \
                      ../modules/monitor/libmonitor.so.0 \
                      ../modules/monitor/icmp/libicmp.so.0" \
          ./sella_nms --foreground -c ../../etc/sella_nms.conf \
                      -m ../modules/configuration/flatfile/libflatfile.so.0

   X. mpatrol Support (http://www.cbmamiga.demon.co.uk/mpatrol)

      CAUTION: You must have a threaded version of mpatrol installed on your
               system prior to using this feature. Tested with mpatrol v1.4.8.

      mpatrol support can be compiled into Sella NMS by using the following
      configure parameter:

	      ./configure --with-mpatrol

      Normally its best to enable both debug and mpatrol support. Without doing
      this, you will get invalid results since the STL uses an arena/pool memory
      system.

         ./configure --enable-debug --with-mpatrol

      To utilize mpatrol after compiling it in, plug-ins must be preloaded and
      the MPATROL_OPTIONS environment variable must be used to specify features.

      The example below assumes you are running bash as your shell:

	       MPATROL_OPTIONS="PROF USEDEBUG LEAKTABLE SHOWUNFREED" \
          LD_PRELOAD="../modules/configuration/flatfile/libflatfile.so.0 \
                      ../modules/storage/mysql/libmysql.so.0 \
                      ../modules/monitor/libmonitor.so.0 \
                      ../modules/monitor/icmp/libicmp.so.0" \
          ./sella_nms -foreground -c ../../etc/sella_nms.conf \
                      -m ../modules/configuration/flatfile/libflatfile.so.0

Fini
