Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
58 lines (39 sloc) 1.56 KB
========================================================================
Coding style, some useful global MACROS and functions descriptions
========================================================================
--------
MACROS
--------
USER_MSG
+ *every* output should be achieved thru the macro USER_MSG(x, ...)
in this way when the inteface will be coded, it is sufficient
to change this macro to redirect user messages to the right place.
DEBUG_MSG
+ to print a debug message use the macro DEBUG_MSG(x, ...)
to enable the debug you should use ./configure --enable-debug
ERROR_MSG
+ the macro ERROR_MSG(x, ...) print the file:function:line, errno,
strerror and a the user message x.
useful on unexpected behaviours.
ON_ERROR
+ the macro ON_ERROR(x, y, f, ...) expands to :
if (x == y)
ERROR_MSG(f, ...)
useful to check null pointer as follow:
foo = malloc(10);
ON_ERROR(foo, NULL, "cant allocate memory");
FATAL_MSG
+ print the message and execute an exit(1)
-------
API
-------
+ THREADS
the file lmap_threads.c provides all the necessary functions to create and
destroy new thread. other files should be not aware of the pthread.h include
file.
the thread list is intended to have a list of active thread that the user can
kill or create thru the user interface. obviously some thread can't be killed
such as the capturer, the euristic and the user interface. all the active
probing thread are stored in the list and can be killed at any time.
/* EOF */
vim:ts=3:expandtab