4 * Citadel "system dependent" stuff.
5 * See copyright.txt for copyright information.
7 * Here's where we (hopefully) have most parts of the Citadel server that
8 * would need to be altered to run the server in a non-POSIX environment.
10 * If we ever port to a different platform and either have multiple
11 * variants of this file or simply load it up with #ifdefs.
22 #include <sys/types.h>
25 #include <sys/socket.h>
27 #include <sys/syslog.h>
29 #if TIME_WITH_SYS_TIME
30 # include <sys/time.h>
34 # include <sys/time.h>
41 #include <sys/resource.h>
42 #include <netinet/in.h>
43 #include <netinet/tcp.h>
44 #include <arpa/inet.h>
55 #include <libcitadel.h>
58 #include "sysdep_decls.h"
59 #include "citserver.h"
63 #include "housekeeping.h"
64 #include "modules/crypto/serv_crypto.h" /* Needed for init_ssl, client_write_ssl, client_read_ssl, destruct_ssl */
67 #ifdef HAVE_SYS_SELECT_H
68 #include <sys/select.h>
75 #include "ctdl_module.h"
77 #ifdef DEBUG_MEMORY_LEAKS
85 struct igheap *igheap = NULL;
89 pthread_mutex_t Critters[MAX_SEMAPHORES]; /* Things needing locking */
90 pthread_key_t MyConKey; /* TSD key for MyContext() */
92 int verbosity = DEFAULT_VERBOSITY; /* Logging level */
94 struct CitContext masterCC;
95 time_t last_purge = 0; /* Last dead session purge */
96 static int num_threads = 0; /* Current number of threads */
97 static int num_workers = 0; /* Current number of worker threads */
98 int num_sessions = 0; /* Current number of sessions */
100 int syslog_facility = LOG_DAEMON;
101 int enable_syslog = 0;
105 * Create an interface to lprintf that follows the coding convention.
106 * This is here until such time as we have replaced all calls to lprintf with CtdlLogPrintf
109 void CtdlLogPrintf(enum LogLevel loglevel, const char *format, ...)
112 va_start(arg_ptr, format);
113 vlprintf(loglevel, format, arg_ptr);
119 * lprintf() ... Write logging information
121 void lprintf(enum LogLevel loglevel, const char *format, ...) {
123 va_start(arg_ptr, format);
124 vlprintf(loglevel, format, arg_ptr);
128 void vlprintf(enum LogLevel loglevel, const char *format, va_list arg_ptr)
130 char buf[SIZ], buf2[SIZ];
133 vsyslog((syslog_facility | loglevel), format, arg_ptr);
136 /* stderr output code */
137 if (enable_syslog || running_as_daemon) return;
139 /* if we run in forground and syslog is disabled, log to terminal */
140 if (loglevel <= verbosity) {
145 gettimeofday(&tv, NULL);
146 /* Promote to time_t; types differ on some OSes (like darwin) */
147 unixtime = tv.tv_sec;
148 localtime_r(&unixtime, &tim);
149 if (CC->cs_pid != 0) {
151 "%04d/%02d/%02d %2d:%02d:%02d.%06ld [%3d] ",
152 tim.tm_year + 1900, tim.tm_mon + 1,
153 tim.tm_mday, tim.tm_hour, tim.tm_min,
154 tim.tm_sec, (long)tv.tv_usec,
158 "%04d/%02d/%02d %2d:%02d:%02d.%06ld ",
159 tim.tm_year + 1900, tim.tm_mon + 1,
160 tim.tm_mday, tim.tm_hour, tim.tm_min,
161 tim.tm_sec, (long)tv.tv_usec);
163 vsprintf(buf2, format, arg_ptr);
165 fprintf(stderr, "%s%s", buf, buf2);
173 * Signal handler to shut down the server.
176 volatile int exit_signal = 0;
177 volatile int shutdown_and_halt = 0;
178 volatile int restart_server = 0;
179 volatile int running_as_daemon = 0;
181 static RETSIGTYPE signal_cleanup(int signum) {
182 CtdlLogPrintf(CTDL_DEBUG, "Caught signal %d; shutting down.\n", signum);
183 exit_signal = signum;
189 void InitialiseSemaphores(void)
193 /* Set up a bunch of semaphores to be used for critical sections */
194 for (i=0; i<MAX_SEMAPHORES; ++i) {
195 pthread_mutex_init(&Critters[i], NULL);
202 * Some initialization stuff...
204 void init_sysdep(void) {
207 /* Avoid vulnerabilities related to FD_SETSIZE if we can. */
211 getrlimit(RLIMIT_NOFILE, &rl);
212 rl.rlim_cur = FD_SETSIZE;
213 rl.rlim_max = FD_SETSIZE;
214 setrlimit(RLIMIT_NOFILE, &rl);
218 /* If we've got OpenSSL, we're going to use it. */
224 * Set up a place to put thread-specific data.
225 * We only need a single pointer per thread - it points to the
226 * CitContext structure (in the ContextList linked list) of the
227 * session to which the calling thread is currently bound.
229 if (pthread_key_create(&MyConKey, NULL) != 0) {
230 CtdlLogPrintf(CTDL_CRIT, "Can't create TSD key: %s\n",
235 * The action for unexpected signals and exceptions should be to
236 * call signal_cleanup() to gracefully shut down the server.
239 sigaddset(&set, SIGINT);
240 sigaddset(&set, SIGQUIT);
241 sigaddset(&set, SIGHUP);
242 sigaddset(&set, SIGTERM);
243 // sigaddset(&set, SIGSEGV); commented out because
244 // sigaddset(&set, SIGILL); we want core dumps
245 // sigaddset(&set, SIGBUS);
246 sigprocmask(SIG_UNBLOCK, &set, NULL);
248 signal(SIGINT, signal_cleanup);
249 signal(SIGQUIT, signal_cleanup);
250 signal(SIGHUP, signal_cleanup);
251 signal(SIGTERM, signal_cleanup);
252 // signal(SIGSEGV, signal_cleanup); commented out because
253 // signal(SIGILL, signal_cleanup); we want core dumps
254 // signal(SIGBUS, signal_cleanup);
257 * Do not shut down the server on broken pipe signals, otherwise the
258 * whole Citadel service would come down whenever a single client
261 signal(SIGPIPE, SIG_IGN);
266 * Obtain a semaphore lock to begin a critical section.
268 void begin_critical_section(int which_one)
270 /* CtdlLogPrintf(CTDL_DEBUG, "begin_critical_section(%d)\n", which_one); */
272 /* For all types of critical sections except those listed here,
273 * ensure nobody ever tries to do a critical section within a
274 * transaction; this could lead to deadlock.
276 if ( (which_one != S_FLOORCACHE)
277 #ifdef DEBUG_MEMORY_LEAKS
278 && (which_one != S_DEBUGMEMLEAKS)
280 && (which_one != S_RPLIST)
284 pthread_mutex_lock(&Critters[which_one]);
288 * Release a semaphore lock to end a critical section.
290 void end_critical_section(int which_one)
292 pthread_mutex_unlock(&Critters[which_one]);
298 * This is a generic function to set up a master socket for listening on
299 * a TCP port. The server shuts down if the bind fails.
302 int ig_tcp_server(char *ip_addr, int port_number, int queue_len, char **errormessage)
304 struct sockaddr_in sin;
306 int actual_queue_len;
308 actual_queue_len = queue_len;
309 if (actual_queue_len < 5) actual_queue_len = 5;
311 memset(&sin, 0, sizeof(sin));
312 sin.sin_family = AF_INET;
313 sin.sin_port = htons((u_short)port_number);
314 if (ip_addr == NULL) {
315 sin.sin_addr.s_addr = INADDR_ANY;
318 sin.sin_addr.s_addr = inet_addr(ip_addr);
321 if (sin.sin_addr.s_addr == !INADDR_ANY) {
322 sin.sin_addr.s_addr = INADDR_ANY;
325 s = socket(PF_INET, SOCK_STREAM, IPPROTO_TCP);
328 *errormessage = (char*) malloc(SIZ + 1);
329 snprintf(*errormessage, SIZ,
330 "citserver: Can't create a socket: %s",
332 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
337 setsockopt(s, SOL_SOCKET, SO_REUSEADDR, &i, sizeof(i));
339 if (bind(s, (struct sockaddr *)&sin, sizeof(sin)) < 0) {
340 *errormessage = (char*) malloc(SIZ + 1);
341 snprintf(*errormessage, SIZ,
342 "citserver: Can't bind: %s",
344 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
349 /* set to nonblock - we need this for some obscure situations */
350 if (fcntl(s, F_SETFL, O_NONBLOCK) < 0) {
351 *errormessage = (char*) malloc(SIZ + 1);
352 snprintf(*errormessage, SIZ,
353 "citserver: Can't set socket to non-blocking: %s",
355 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
360 if (listen(s, actual_queue_len) < 0) {
361 *errormessage = (char*) malloc(SIZ + 1);
362 snprintf(*errormessage, SIZ,
363 "citserver: Can't listen: %s",
365 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
376 * Create a Unix domain socket and listen on it
378 int ig_uds_server(char *sockpath, int queue_len, char **errormessage)
380 struct sockaddr_un addr;
383 int actual_queue_len;
385 actual_queue_len = queue_len;
386 if (actual_queue_len < 5) actual_queue_len = 5;
388 i = unlink(sockpath);
389 if (i != 0) if (errno != ENOENT) {
390 *errormessage = (char*) malloc(SIZ + 1);
391 snprintf(*errormessage, SIZ, "citserver: can't unlink %s: %s",
392 sockpath, strerror(errno));
393 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
397 memset(&addr, 0, sizeof(addr));
398 addr.sun_family = AF_UNIX;
399 safestrncpy(addr.sun_path, sockpath, sizeof addr.sun_path);
401 s = socket(AF_UNIX, SOCK_STREAM, 0);
403 *errormessage = (char*) malloc(SIZ + 1);
404 snprintf(*errormessage, SIZ,
405 "citserver: Can't create a socket: %s",
407 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
411 if (bind(s, (struct sockaddr *)&addr, sizeof(addr)) < 0) {
412 *errormessage = (char*) malloc(SIZ + 1);
413 snprintf(*errormessage, SIZ,
414 "citserver: Can't bind: %s",
416 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
420 /* set to nonblock - we need this for some obscure situations */
421 if (fcntl(s, F_SETFL, O_NONBLOCK) < 0) {
422 *errormessage = (char*) malloc(SIZ + 1);
423 snprintf(*errormessage, SIZ,
424 "citserver: Can't set socket to non-blocking: %s",
426 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
431 if (listen(s, actual_queue_len) < 0) {
432 *errormessage = (char*) malloc(SIZ + 1);
433 snprintf(*errormessage, SIZ,
434 "citserver: Can't listen: %s",
436 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
440 chmod(sockpath, S_ISGID|S_IRUSR|S_IWUSR|S_IXUSR|S_IRGRP|S_IWGRP|S_IXGRP|S_IROTH|S_IWOTH|S_IXOTH);
447 * Return a pointer to the CitContext structure bound to the thread which
448 * called this function. If there's no such binding (for example, if it's
449 * called by the housekeeper thread) then a generic 'master' CC is returned.
451 * This function is used *VERY* frequently and must be kept small.
453 struct CitContext *MyContext(void) {
455 register struct CitContext *c;
457 return ((c = (struct CitContext *) pthread_getspecific(MyConKey),
458 c == NULL) ? &masterCC : c
464 * Initialize a new context and place it in the list. The session number
465 * used to be the PID (which is why it's called cs_pid), but that was when we
466 * had one process per session. Now we just assign them sequentially, starting
467 * at 1 (don't change it to 0 because masterCC uses 0).
469 struct CitContext *CreateNewContext(void) {
470 struct CitContext *me;
471 static int next_pid = 0;
473 me = (struct CitContext *) malloc(sizeof(struct CitContext));
475 CtdlLogPrintf(CTDL_ALERT, "citserver: can't allocate memory!!\n");
478 memset(me, 0, sizeof(struct CitContext));
480 /* The new context will be created already in the CON_EXECUTING state
481 * in order to prevent another thread from grabbing it while it's
484 me->state = CON_EXECUTING;
487 * Generate a unique session number and insert this context into
490 begin_critical_section(S_SESSION_TABLE);
491 me->cs_pid = ++next_pid;
493 me->next = ContextList;
495 if (me->next != NULL) {
499 end_critical_section(S_SESSION_TABLE);
505 * The following functions implement output buffering. If the kernel supplies
506 * native TCP buffering (Linux & *BSD), use that; otherwise, emulate it with
507 * user-space buffering.
511 # define HAVE_TCP_BUFFERING
514 # define HAVE_TCP_BUFFERING
515 # define TCP_CORK TCP_NOPUSH
517 #endif /* TCP_CORK */
518 #endif /* HAVE_DARWIN */
520 #ifdef HAVE_TCP_BUFFERING
521 static unsigned on = 1, off = 0;
522 void buffer_output(void) {
523 struct CitContext *ctx = MyContext();
524 setsockopt(ctx->client_socket, IPPROTO_TCP, TCP_CORK, &on, 4);
528 void unbuffer_output(void) {
529 struct CitContext *ctx = MyContext();
530 setsockopt(ctx->client_socket, IPPROTO_TCP, TCP_CORK, &off, 4);
534 void flush_output(void) {
535 struct CitContext *ctx = MyContext();
536 setsockopt(ctx->client_socket, IPPROTO_TCP, TCP_CORK, &off, 4);
537 setsockopt(ctx->client_socket, IPPROTO_TCP, TCP_CORK, &on, 4);
541 /* Stub functions for Darwin/OS X where TCP buffering isn't liked at all */
542 void buffer_output(void) {
545 void unbuffer_output(void) {
548 void flush_output(void) {
551 void buffer_output(void) {
552 if (CC->buffering == 0) {
555 CC->output_buffer = malloc(SIZ);
559 void flush_output(void) {
560 if (CC->buffering == 1) {
561 client_write(CC->output_buffer, CC->buffer_len);
566 void unbuffer_output(void) {
567 if (CC->buffering == 1) {
569 /* We don't call flush_output because we can't. */
570 client_write(CC->output_buffer, CC->buffer_len);
572 free(CC->output_buffer);
573 CC->output_buffer = NULL;
576 #endif /* HAVE_DARWIN */
577 #endif /* HAVE_TCP_BUFFERING */
582 * client_write() ... Send binary data to the client.
584 void client_write(char *buf, int nbytes)
586 int bytes_written = 0;
588 #ifndef HAVE_TCP_BUFFERING
589 int old_buffer_len = 0;
594 if (Ctx->redirect_buffer != NULL) {
595 if ((Ctx->redirect_len + nbytes + 2) >= Ctx->redirect_alloc) {
596 Ctx->redirect_alloc = (Ctx->redirect_alloc * 2) + nbytes;
597 Ctx->redirect_buffer = realloc(Ctx->redirect_buffer,
598 Ctx->redirect_alloc);
600 memcpy(&Ctx->redirect_buffer[Ctx->redirect_len], buf, nbytes);
601 Ctx->redirect_len += nbytes;
602 Ctx->redirect_buffer[Ctx->redirect_len] = 0;
606 #ifndef HAVE_TCP_BUFFERING
607 /* If we're buffering for later, do that now. */
608 if (Ctx->buffering) {
609 old_buffer_len = Ctx->buffer_len;
610 Ctx->buffer_len += nbytes;
611 Ctx->output_buffer = realloc(Ctx->output_buffer, Ctx->buffer_len);
612 memcpy(&Ctx->output_buffer[old_buffer_len], buf, nbytes);
617 /* Ok, at this point we're not buffering. Go ahead and write. */
620 if (Ctx->redirect_ssl) {
621 client_write_ssl(buf, nbytes);
626 while (bytes_written < nbytes) {
627 retval = write(Ctx->client_socket, &buf[bytes_written],
628 nbytes - bytes_written);
630 CtdlLogPrintf(CTDL_ERR,
631 "client_write(%d bytes) failed: %s (%d)\n",
632 nbytes - bytes_written,
633 strerror(errno), errno);
635 // CtdlLogPrintf(CTDL_DEBUG, "Tried to send: %s", &buf[bytes_written]);
639 bytes_written = bytes_written + retval;
645 * cprintf() ... Send formatted printable data to the client. It is
646 * implemented in terms of client_write() but remains in
647 * sysdep.c in case we port to somewhere without va_args...
649 void cprintf(const char *format, ...) {
653 va_start(arg_ptr, format);
654 if (vsnprintf(buf, sizeof buf, format, arg_ptr) == -1)
655 buf[sizeof buf - 2] = '\n';
656 client_write(buf, strlen(buf));
662 * Read data from the client socket.
664 * 1 Requested number of bytes has been read.
665 * 0 Request timed out.
666 * -1 The socket is broken.
667 * If the socket breaks, the session will be terminated.
669 int client_read_to(char *buf, int bytes, int timeout)
678 if (CC->redirect_ssl) {
679 return (client_read_ssl(buf, bytes, timeout));
683 fd = CC->client_socket;
690 retval = select( (fd)+1,
691 &rfds, NULL, NULL, &tv);
693 if (FD_ISSET(fd, &rfds) == 0) {
697 rlen = read(fd, &buf[len], bytes-len);
699 /* The socket has been disconnected! */
709 * Read data from the client socket with default timeout.
710 * (This is implemented in terms of client_read_to() and could be
711 * justifiably moved out of sysdep.c)
713 INLINE int client_read(char *buf, int bytes)
715 return(client_read_to(buf, bytes, config.c_sleeping));
720 * client_getln() ... Get a LF-terminated line of text from the client.
721 * (This is implemented in terms of client_read() and could be
722 * justifiably moved out of sysdep.c)
724 int client_getln(char *buf, int bufsize)
728 /* Read one character at a time.
731 retval = client_read(&buf[i], 1);
732 if (retval != 1 || buf[i] == '\n' || i == (bufsize-1))
736 /* If we got a long line, discard characters until the newline.
738 if (i == (bufsize-1))
739 while (buf[i] != '\n' && retval == 1)
740 retval = client_read(&buf[i], 1);
742 /* Strip the trailing LF, and the trailing CR if present.
746 && ( (buf[i - 1]==13)
747 || ( buf[i - 1]==10)) ) {
751 if (retval < 0) safestrncpy(&buf[i], "000", bufsize - i);
757 * Cleanup any contexts that are left lying around
759 void context_cleanup(void)
761 struct CitContext *ptr = NULL;
762 struct CitContext *rem = NULL;
765 * Clean up the contexts.
766 * There are no threads so no critical_section stuff is needed.
770 /* Remove the session from the active list */
774 lprintf(CTDL_DEBUG, "Purging session %d\n", ptr->cs_pid);
784 * The system-dependent part of master_cleanup() - close the master socket.
786 void sysdep_master_cleanup(void) {
787 struct ServiceFunctionHook *serviceptr;
790 * close all protocol master sockets
792 for (serviceptr = ServiceHookTable; serviceptr != NULL;
793 serviceptr = serviceptr->next ) {
795 if (serviceptr->tcp_port > 0)
796 CtdlLogPrintf(CTDL_INFO, "Closing listener on port %d\n",
797 serviceptr->tcp_port);
799 if (serviceptr->sockpath != NULL)
800 CtdlLogPrintf(CTDL_INFO, "Closing listener on '%s'\n",
801 serviceptr->sockpath);
803 close(serviceptr->msock);
805 /* If it's a Unix domain socket, remove the file. */
806 if (serviceptr->sockpath != NULL) {
807 unlink(serviceptr->sockpath);
816 CtdlDestroyProtoHooks();
817 CtdlDestroyDeleteHooks();
818 CtdlDestroyXmsgHooks();
819 CtdlDestroyNetprocHooks();
820 CtdlDestroyUserHooks();
821 CtdlDestroyMessageHook();
822 CtdlDestroyCleanupHooks();
823 CtdlDestroyFixedOutputHooks();
824 CtdlDestroySessionHooks();
825 CtdlDestroyServiceHook();
826 #ifdef HAVE_BACKTRACE
834 * Terminate another session.
835 * (This could justifiably be moved out of sysdep.c because it
836 * no longer does anything that is system-dependent.)
838 void kill_session(int session_to_kill) {
839 struct CitContext *ptr;
841 begin_critical_section(S_SESSION_TABLE);
842 for (ptr = ContextList; ptr != NULL; ptr = ptr->next) {
843 if (ptr->cs_pid == session_to_kill) {
847 end_critical_section(S_SESSION_TABLE);
851 void graceful_shutdown(int signum) {
852 kill(current_child, signum);
853 unlink(file_pid_file);
859 * Start running as a daemon.
861 void start_daemon(int unused) {
869 /* Close stdin/stdout/stderr and replace them with /dev/null.
870 * We don't just call close() because we don't want these fd's
871 * to be reused for other files.
880 signal(SIGHUP, SIG_IGN);
881 signal(SIGINT, SIG_IGN);
882 signal(SIGQUIT, SIG_IGN);
886 freopen("/dev/null", "r", stdin);
887 freopen("/dev/null", "w", stdout);
888 freopen("/dev/null", "w", stderr);
891 current_child = fork();
893 signal(SIGTERM, graceful_shutdown);
895 if (current_child < 0) {
900 else if (current_child == 0) {
901 return; /* continue starting citadel. */
905 fp = fopen(file_pid_file, "w");
908 * NB.. The pid file contains the pid of the actual server.
909 * This is not the pid of the watcher process
911 fprintf(fp, ""F_PID_T"\n", current_child);
914 waitpid(current_child, &status, 0);
919 /* Did the main process exit with an actual exit code? */
920 if (WIFEXITED(status)) {
922 /* Exit code 0 means the watcher should exit */
923 if (WEXITSTATUS(status) == 0) {
927 /* Exit code 101-109 means the watcher should exit */
928 else if ( (WEXITSTATUS(status) >= 101) && (WEXITSTATUS(status) <= 109) ) {
932 /* Any other exit code means we should restart. */
938 /* Any other type of termination (signals, etc.) should also restart. */
943 } while (do_restart);
945 unlink(file_pid_file);
946 exit(WEXITSTATUS(status));
952 * Generic routine to convert a login name to a full name (gecos)
953 * Returns nonzero if a conversion took place
955 int convert_login(char NameToConvert[]) {
959 pw = getpwnam(NameToConvert);
964 strcpy(NameToConvert, pw->pw_gecos);
965 for (a=0; a<strlen(NameToConvert); ++a) {
966 if (NameToConvert[a] == ',') NameToConvert[a] = 0;
975 * New thread interface.
976 * To create a thread you must call one of the create thread functions.
977 * You must pass it the address of (a pointer to a CtdlThreadNode initialised to NULL) like this
978 * struct CtdlThreadNode *node = NULL;
980 * If the thread is created *node will point to the thread control structure for the created thread.
981 * If the thread creation fails *node remains NULL
982 * Do not free the memory pointed to by *node, it doesn't belong to you.
983 * If your thread function returns it will be started again without creating a new thread.
984 * If your thread function wants to exit it should call CtdlThreadExit(ret_code);
985 * This new interface duplicates much of the eCrash stuff. We should go for closer integration since that would
986 * remove the need for the calls to eCrashRegisterThread and friends
990 struct CtdlThreadNode *CtdlThreadList = NULL;
993 * Condition variable and Mutex for thread garbage collection
995 /*static pthread_mutex_t thread_gc_mutex = PTHREAD_MUTEX_INITIALIZER;
996 static pthread_cond_t thread_gc_cond = PTHREAD_COND_INITIALIZER;
998 static pthread_t GC_thread;
999 static char *CtdlThreadStates[CTDL_THREAD_LAST_STATE];
1000 double CtdlThreadLoadAvg = 0;
1001 double CtdlThreadWorkerAvg = 0;
1003 * Pinched the following bits regarding signals from Kannel.org
1007 * Change this thread's signal mask to block user-visible signals
1008 * (HUP, TERM, QUIT, INT), and store the old signal mask in
1010 * Return 0 for success, or -1 if an error occurred.
1014 * This does not work in Darwin alias MacOS X alias Mach kernel,
1015 * however. So we define a dummy function doing nothing.
1017 #if defined(DARWIN_OLD)
1018 static int pthread_sigmask();
1021 static int ctdl_thread_internal_block_signals(sigset_t *old_set_storage)
1024 sigset_t block_signals;
1026 ret = sigemptyset(&block_signals);
1028 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC. Couldn't initialize signal set\n");
1031 ret = sigaddset(&block_signals, SIGHUP);
1032 ret |= sigaddset(&block_signals, SIGTERM);
1033 ret |= sigaddset(&block_signals, SIGQUIT);
1034 ret |= sigaddset(&block_signals, SIGINT);
1036 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC. Couldn't add signal to signal set.\n");
1039 ret = pthread_sigmask(SIG_BLOCK, &block_signals, old_set_storage);
1041 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC. Couldn't disable signals for thread creation\n");
1047 static void ctdl_thread_internal_restore_signals(sigset_t *old_set)
1051 ret = pthread_sigmask(SIG_SETMASK, old_set, NULL);
1053 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC. Couldn't restore signal set.\n");
1058 void ctdl_thread_internal_cleanup(void)
1062 for (i=0; i<CTDL_THREAD_LAST_STATE; i++)
1064 free (CtdlThreadStates[i]);
1068 void ctdl_thread_internal_init(void)
1070 struct CtdlThreadNode *this_thread;
1073 GC_thread = pthread_self();
1074 CtdlThreadStates[CTDL_THREAD_INVALID] = strdup ("Invalid Thread");
1075 CtdlThreadStates[CTDL_THREAD_VALID] = strdup("Valid Thread");
1076 CtdlThreadStates[CTDL_THREAD_CREATE] = strdup("Thread being Created");
1077 CtdlThreadStates[CTDL_THREAD_CANCELLED] = strdup("Thread Cancelled");
1078 CtdlThreadStates[CTDL_THREAD_EXITED] = strdup("Thread Exited");
1079 CtdlThreadStates[CTDL_THREAD_STOPPING] = strdup("Thread Stopping");
1080 CtdlThreadStates[CTDL_THREAD_STOP_REQ] = strdup("Thread Stop Requested");
1081 CtdlThreadStates[CTDL_THREAD_SLEEPING] = strdup("Thread Sleeping");
1082 CtdlThreadStates[CTDL_THREAD_RUNNING] = strdup("Thread Running");
1083 CtdlThreadStates[CTDL_THREAD_BLOCKED] = strdup("Thread Blocked");
1085 /* Get ourself a thread entry */
1086 this_thread = malloc(sizeof(struct CtdlThreadNode));
1087 if (this_thread == NULL) {
1088 CtdlLogPrintf(CTDL_EMERG, "Thread system, can't allocate CtdlThreadNode, exiting\n");
1091 // Ensuring this is zero'd means we make sure the thread doesn't start doing its thing until we are ready.
1092 memset (this_thread, 0, sizeof(struct CtdlThreadNode));
1094 /* We are garbage collector so create us as running */
1095 this_thread->state = CTDL_THREAD_RUNNING;
1097 if ((ret = pthread_attr_init(&this_thread->attr))) {
1098 CtdlLogPrintf(CTDL_EMERG, "Thread system, pthread_attr_init: %s\n", strerror(ret));
1103 this_thread->name = strdup("Garbage Collection Thread");
1105 pthread_mutex_init (&(this_thread->ThreadMutex), NULL);
1106 pthread_cond_init (&(this_thread->ThreadCond), NULL);
1108 this_thread->tid = GC_thread;
1110 num_threads++; // Increase the count of threads in the system.
1112 this_thread->next = CtdlThreadList;
1113 CtdlThreadList = this_thread;
1114 if (this_thread->next)
1115 this_thread->next->prev = this_thread;
1116 /* Set up start times */
1117 gettimeofday(&this_thread->start_time, NULL); /* Time this thread started */
1118 memcpy(&this_thread->last_state_change, &this_thread->start_time, sizeof (struct timeval)); /* Changed state so mark it. */
1123 * A function to update a threads load averages
1125 void ctdl_thread_internal_update_avgs(struct CtdlThreadNode *this_thread)
1127 struct timeval now, result;
1128 double last_duration;
1130 pthread_mutex_lock(&this_thread->ThreadMutex); /* To prevent race condition of a sleeping thread */
1131 gettimeofday(&now, NULL);
1132 timersub(&now, &(this_thread->last_state_change), &result);
1133 // result now has a timeval for the time we spent in the last state since we last updated
1134 last_duration = (double)result.tv_sec + ((double)result.tv_usec / (double) 1000000);
1135 if (this_thread->state == CTDL_THREAD_SLEEPING)
1136 this_thread->avg_sleeping += last_duration;
1137 if (this_thread->state == CTDL_THREAD_RUNNING)
1138 this_thread->avg_running += last_duration;
1139 if (this_thread->state == CTDL_THREAD_BLOCKED)
1140 this_thread->avg_blocked += last_duration;
1141 memcpy (&this_thread->last_state_change, &now, sizeof (struct timeval));
1142 pthread_mutex_unlock(&this_thread->ThreadMutex);
1146 * A function to chenge the state of a thread
1148 void ctdl_thread_internal_change_state (struct CtdlThreadNode *this_thread, enum CtdlThreadState new_state)
1151 * Wether we change state or not we need update the load values
1153 ctdl_thread_internal_update_avgs(this_thread);
1154 pthread_mutex_lock(&this_thread->ThreadMutex); /* To prevent race condition of a sleeping thread */
1155 if ((new_state == CTDL_THREAD_STOP_REQ) && (this_thread->state > CTDL_THREAD_STOP_REQ))
1156 this_thread->state = new_state;
1157 if (((new_state == CTDL_THREAD_SLEEPING) || (new_state == CTDL_THREAD_BLOCKED)) && (this_thread->state == CTDL_THREAD_RUNNING))
1158 this_thread->state = new_state;
1159 if ((new_state == CTDL_THREAD_RUNNING) && ((this_thread->state == CTDL_THREAD_SLEEPING) || (this_thread->state == CTDL_THREAD_BLOCKED)))
1160 this_thread->state = new_state;
1161 pthread_mutex_unlock(&this_thread->ThreadMutex);
1166 * A function to tell all threads to exit
1168 void CtdlThreadStopAll(void)
1170 struct CtdlThreadNode *this_thread;
1172 begin_critical_section(S_THREAD_LIST);
1173 this_thread = CtdlThreadList;
1176 if (this_thread->thread_func) // Don't tell garbage collector to stop
1178 ctdl_thread_internal_change_state (this_thread, CTDL_THREAD_STOP_REQ);
1179 pthread_cond_signal(&this_thread->ThreadCond);
1180 CtdlLogPrintf(CTDL_DEBUG, "Thread system stopping thread \"%s\" (%ld).\n", this_thread->name, this_thread->tid);
1182 this_thread = this_thread->next;
1184 end_critical_section(S_THREAD_LIST);
1189 * A function to signal that we need to do garbage collection on the thread list
1191 void CtdlThreadGC(void)
1193 struct CtdlThreadNode *this_thread;
1195 CtdlLogPrintf(CTDL_DEBUG, "Thread system signalling garbage collection.\n");
1197 begin_critical_section(S_THREAD_LIST);
1198 this_thread = CtdlThreadList;
1201 if (!this_thread->thread_func)
1202 pthread_cond_signal(&this_thread->ThreadCond);
1204 this_thread = this_thread->next;
1206 end_critical_section(S_THREAD_LIST);
1211 * A function to return the number of threads running in the system
1213 int CtdlThreadGetCount(void)
1219 * A function to find the thread structure for this thread
1221 struct CtdlThreadNode *CtdlThreadSelf(void)
1224 struct CtdlThreadNode *this_thread;
1226 self_tid = pthread_self();
1228 begin_critical_section(S_THREAD_LIST);
1229 this_thread = CtdlThreadList;
1232 if (pthread_equal(self_tid, this_thread->tid))
1234 end_critical_section(S_THREAD_LIST);
1237 this_thread = this_thread->next;
1239 end_critical_section(S_THREAD_LIST);
1247 * A function to rename a thread
1248 * Returns a char * and the caller owns the memory and should free it
1250 char *CtdlThreadName(struct CtdlThreadNode *thread, char *name)
1252 struct CtdlThreadNode *this_thread;
1256 this_thread = CtdlThreadSelf();
1258 this_thread = thread;
1261 CtdlLogPrintf(CTDL_WARNING, "Thread system WARNING. Attempt to CtdlThreadRename() a non thread.\n");
1264 begin_critical_section(S_THREAD_LIST);
1265 old_name = this_thread->name;
1267 this_thread->name = strdup (name);
1269 old_name = strdup(old_name);
1270 end_critical_section (S_THREAD_LIST);
1276 * A function to force a thread to exit
1278 void CtdlThreadCancel(struct CtdlThreadNode *thread)
1280 struct CtdlThreadNode *this_thread;
1283 this_thread = CtdlThreadSelf();
1285 this_thread = thread;
1288 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC. Attempt to CtdlThreadCancel() a non thread.\n");
1289 CtdlThreadStopAll();
1293 if (!this_thread->thread_func)
1295 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC. Attempt to CtdlThreadCancel() the garbage collector.\n");
1296 CtdlThreadStopAll();
1300 begin_critical_section(S_THREAD_LIST);
1301 ctdl_thread_internal_change_state (this_thread, CTDL_THREAD_CANCELLED);
1302 pthread_cancel(this_thread->tid);
1303 end_critical_section (S_THREAD_LIST);
1309 * A function for a thread to check if it has been asked to stop
1311 int CtdlThreadCheckStop(void)
1313 struct CtdlThreadNode *this_thread;
1315 this_thread = CtdlThreadSelf();
1318 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC, CtdlThreadCheckStop() called by a non thread.\n");
1319 CtdlThreadStopAll();
1322 if(this_thread->state == CTDL_THREAD_STOP_REQ)
1324 this_thread->state = CTDL_THREAD_STOPPING;
1327 else if(this_thread->state < CTDL_THREAD_STOP_REQ)
1335 * A function to ask a thread to exit
1336 * The thread must call CtdlThreadCheckStop() periodically to determine if it should exit
1338 void CtdlThreadStop(struct CtdlThreadNode *thread)
1340 struct CtdlThreadNode *this_thread;
1343 this_thread = CtdlThreadSelf();
1345 this_thread = thread;
1348 if (!(this_thread->thread_func))
1349 return; // Don't stop garbage collector
1351 begin_critical_section (S_THREAD_LIST);
1352 ctdl_thread_internal_change_state (this_thread, CTDL_THREAD_STOP_REQ);
1353 pthread_cond_signal(&this_thread->ThreadCond);
1354 end_critical_section(S_THREAD_LIST);
1358 * So we now have a sleep command that works with threads but it is in seconds
1360 void CtdlThreadSleep(int secs)
1362 struct timespec wake_time;
1363 struct timeval time_now;
1364 struct CtdlThreadNode *self;
1367 self = CtdlThreadSelf();
1370 CtdlLogPrintf(CTDL_WARNING, "CtdlThreadSleep() called by something that is not a thread. Should we die?\n");
1374 begin_critical_section(S_THREAD_LIST);
1375 ctdl_thread_internal_change_state (self, CTDL_THREAD_SLEEPING);
1376 pthread_mutex_lock(&self->ThreadMutex); /* Prevent something asking us to awaken before we've gone to sleep */
1377 end_critical_section(S_THREAD_LIST);
1379 memset (&wake_time, 0, sizeof(struct timespec));
1380 gettimeofday(&time_now, NULL);
1381 wake_time.tv_sec = time_now.tv_sec + secs;
1382 wake_time.tv_nsec = time_now.tv_usec * 10;
1383 pthread_cond_timedwait(&self->ThreadCond, &self->ThreadMutex, &wake_time);
1384 begin_critical_section(S_THREAD_LIST);
1385 pthread_mutex_unlock(&self->ThreadMutex);
1386 ctdl_thread_internal_change_state (self, CTDL_THREAD_RUNNING);
1387 end_critical_section(S_THREAD_LIST);
1392 * Routine to clean up our thread function on exit
1394 static void ctdl_internal_thread_cleanup(void *arg)
1396 struct CtdlThreadNode *this_thread;
1397 this_thread = CtdlThreadSelf();
1399 * In here we were called by the current thread because it is exiting
1400 * NB. WE ARE THE CURRENT THREAD
1402 CtdlLogPrintf(CTDL_NOTICE, "Thread \"%s\" (%ld) exited.\n", this_thread->name, this_thread->tid);
1403 begin_critical_section(S_THREAD_LIST);
1404 #ifdef HAVE_BACKTRACE
1405 eCrash_UnregisterThread();
1407 this_thread->state = CTDL_THREAD_EXITED; // needs to be last thing else house keeping will unlink us too early
1408 end_critical_section(S_THREAD_LIST);
1413 * A quick function to show the load averages
1415 void ctdl_thread_internal_calc_loadavg(void)
1417 struct CtdlThreadNode *that_thread;
1418 double load_avg, worker_avg;
1421 begin_critical_section(S_THREAD_LIST);
1422 that_thread = CtdlThreadList;
1427 /* Update load averages */
1428 ctdl_thread_internal_update_avgs(that_thread);
1429 pthread_mutex_lock(&that_thread->ThreadMutex);
1430 that_thread->load_avg = that_thread->avg_sleeping + that_thread->avg_running + that_thread->avg_blocked;
1431 that_thread->load_avg = that_thread->avg_running / that_thread->load_avg * 100;
1432 that_thread->avg_sleeping /= 2;
1433 that_thread->avg_running /= 2;
1434 that_thread->avg_blocked /= 2;
1435 load_avg += that_thread->load_avg;
1436 if (that_thread->flags & CTDLTHREAD_WORKER)
1438 worker_avg += that_thread->load_avg;
1441 #ifdef WITH_THREADLOG
1442 CtdlLogPrintf(CTDL_DEBUG, "CtdlThread, \"%s\" (%ld) \"%s\" %f %f %f %f.\n",
1445 CtdlThreadStates[that_thread->state],
1446 that_thread->avg_sleeping,
1447 that_thread->avg_running,
1448 that_thread->avg_blocked,
1449 that_thread->load_avg);
1451 pthread_mutex_unlock(&that_thread->ThreadMutex);
1452 that_thread = that_thread->next;
1454 CtdlThreadLoadAvg = load_avg/num_threads;
1455 CtdlThreadWorkerAvg = worker_avg/workers;
1456 #ifdef WITH_THREADLOG
1457 CtdlLogPrintf(CTDL_INFO, "System load average %f, workers averag %f\n", CtdlThreadLoadAvg, CtdlThreadWorkerAvg);
1459 end_critical_section(S_THREAD_LIST);
1464 * Garbage collection routine.
1465 * Gets called by main() in a loop to clean up the thread list periodically.
1467 void ctdl_internal_thread_gc (void)
1469 struct CtdlThreadNode *this_thread, *that_thread;
1472 /* Handle exiting of garbage collector thread */
1473 if(num_threads == 1)
1474 CtdlThreadList->state = CTDL_THREAD_EXITED;
1476 #ifdef WITH_THREADLOG
1477 CtdlLogPrintf(CTDL_DEBUG, "Thread system running garbage collection.\n");
1480 * Woke up to do garbage collection
1482 begin_critical_section(S_THREAD_LIST);
1483 this_thread = CtdlThreadList;
1486 that_thread = this_thread;
1487 this_thread = this_thread->next;
1489 /* Do we need to clean up this thread? */
1490 if (that_thread->state != CTDL_THREAD_EXITED)
1492 if(that_thread->flags & CTDLTHREAD_WORKER)
1493 workers++; /* Sanity check on number of worker threads */
1497 if (pthread_equal(that_thread->tid, pthread_self()) && that_thread->thread_func)
1498 { /* Sanity check */
1499 end_critical_section(S_THREAD_LIST);
1500 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC, a thread is trying to clean up after itself.\n");
1501 CtdlThreadStopAll();
1505 if (num_threads <= 0)
1506 { /* Sanity check */
1507 end_critical_section (S_THREAD_LIST);
1508 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC, num_threads <= 0 and trying to do Garbage Collection.\n");
1509 CtdlThreadStopAll();
1513 /* If we are unlinking the list head then the next becomes the list head */
1514 if (that_thread == CtdlThreadList)
1515 CtdlThreadList = that_thread->next;
1516 if(that_thread->prev)
1517 that_thread->prev->next = that_thread->next;
1518 if(that_thread->next)
1519 that_thread->next->prev = that_thread->next;
1521 if(that_thread->flags & CTDLTHREAD_WORKER)
1522 num_workers--; /* This is a wroker thread so reduce the count. */
1525 * Join on the thread to do clean up and prevent memory leaks
1526 * Also makes sure the thread has cleaned up after itself before we remove it from the list
1527 * If that thread has no function it must be the garbage collector
1529 if (that_thread->thread_func)
1530 pthread_join (that_thread->tid, NULL);
1533 * Now we own that thread entry
1535 CtdlLogPrintf(CTDL_INFO, "Garbage Collection for thread \"%s\" (%ld).\n", that_thread->name, that_thread->tid);
1536 if(that_thread->name)
1537 free(that_thread->name);
1538 pthread_mutex_destroy(&that_thread->ThreadMutex);
1539 pthread_cond_destroy(&that_thread->ThreadCond);
1540 pthread_attr_destroy(&that_thread->attr);
1544 /* Sanity check number of worker threads */
1545 if (workers != num_workers)
1547 end_critical_section(S_THREAD_LIST);
1548 CtdlLogPrintf(CTDL_EMERG, "Thread system PANIC, discrepancy in number of worker threads. Counted %d, should be %d.\n", workers, num_workers);
1551 end_critical_section(S_THREAD_LIST);
1558 * Runtime function for a Citadel Thread.
1559 * This initialises the threads environment and then calls the user supplied thread function
1560 * Note that this is the REAL thread function and wraps the users thread function.
1562 static void *ctdl_internal_thread_func (void *arg)
1564 struct CtdlThreadNode *this_thread;
1567 /* lock and unlock the thread list.
1568 * This causes this thread to wait until all its creation stuff has finished before it
1569 * can continue its execution.
1571 begin_critical_section(S_THREAD_LIST);
1572 // Get our thread data structure
1573 this_thread = (struct CtdlThreadNode *) arg;
1574 this_thread->state = CTDL_THREAD_RUNNING;
1575 this_thread->pid = getpid();
1576 gettimeofday(&this_thread->start_time, NULL); /* Time this thread started */
1577 memcpy(&this_thread->last_state_change, &this_thread->start_time, sizeof (struct timeval)); /* Changed state so mark it. */
1578 end_critical_section(S_THREAD_LIST);
1580 // Tell the world we are here
1581 CtdlLogPrintf(CTDL_NOTICE, "Created a new thread \"%s\" (%ld). \n", this_thread->name, this_thread->tid);
1583 // Register the cleanup function to take care of when we exit.
1584 pthread_cleanup_push(ctdl_internal_thread_cleanup, NULL);
1588 * run the thread to do the work
1590 ret = (this_thread->thread_func)(this_thread->user_args);
1593 * Our thread is exiting either because it wanted to end or because the server is stopping
1594 * We need to clean up
1596 pthread_cleanup_pop(1); // Execute our cleanup routine and remove it
1604 * Internal function to create a thread.
1605 * Must be called from within a S_THREAD_LIST critical section
1607 struct CtdlThreadNode *ctdl_internal_create_thread(char *name, long flags, void *(*thread_func) (void *arg), void *args)
1610 struct CtdlThreadNode *this_thread;
1612 sigset_t old_signal_set;
1614 if (num_threads >= 32767)
1616 CtdlLogPrintf(CTDL_EMERG, "Thread system. Thread list full.\n");
1620 this_thread = malloc(sizeof(struct CtdlThreadNode));
1621 if (this_thread == NULL) {
1622 CtdlLogPrintf(CTDL_EMERG, "Thread system, can't allocate CtdlThreadNode, exiting\n");
1625 // Ensuring this is zero'd means we make sure the thread doesn't start doing its thing until we are ready.
1626 memset (this_thread, 0, sizeof(struct CtdlThreadNode));
1628 this_thread->state = CTDL_THREAD_CREATE;
1630 if ((ret = pthread_attr_init(&this_thread->attr))) {
1631 CtdlLogPrintf(CTDL_EMERG, "Thread system, pthread_attr_init: %s\n", strerror(ret));
1636 /* Our per-thread stacks need to be bigger than the default size,
1637 * otherwise the MIME parser crashes on FreeBSD, and the IMAP service
1638 * crashes on 64-bit Linux.
1640 if (flags & CTDLTHREAD_BIGSTACK)
1642 CtdlLogPrintf(CTDL_INFO, "Thread system. Creating BIG STACK thread.\n");
1643 if ((ret = pthread_attr_setstacksize(&this_thread->attr, THREADSTACKSIZE))) {
1644 CtdlLogPrintf(CTDL_EMERG, "Thread system, pthread_attr_setstacksize: %s\n",
1646 pthread_attr_destroy(&this_thread->attr);
1653 * If we got here we are going to create the thread so we must initilise the structure
1654 * first because most implimentations of threading can't create it in a stopped state
1655 * and it might want to do things with its structure that aren't initialised otherwise.
1659 this_thread->name = strdup(name);
1663 this_thread->name = strdup("Un-named Thread");
1666 this_thread->flags = flags;
1667 this_thread->thread_func = thread_func;
1668 this_thread->user_args = args;
1669 pthread_mutex_init (&(this_thread->ThreadMutex), NULL);
1670 pthread_cond_init (&(this_thread->ThreadCond), NULL);
1673 * We want to make sure that only the main thread handles signals,
1674 * so that each signal is handled exactly once. To do this, we
1675 * make sure that each new thread has all the signals that we
1676 * handle blocked. To avoid race conditions, we block them in
1677 * the spawning thread first, then create the new thread (which
1678 * inherits the settings), and then restore the old settings in
1679 * the spawning thread. This means that there is a brief period
1680 * when no signals will be processed, but during that time they
1681 * should be queued by the operating system.
1683 if (pthread_equal(GC_thread, pthread_self()))
1684 sigtrick = ctdl_thread_internal_block_signals(&old_signal_set) == 0;
1687 * We pass this_thread into the thread as its args so that it can find out information
1688 * about itself and it has a bit of storage space for itself, not to mention that the REAL
1689 * thread function needs to finish off the setup of the structure
1691 if ((ret = pthread_create(&this_thread->tid, &this_thread->attr, ctdl_internal_thread_func, this_thread) != 0))
1694 CtdlLogPrintf(CTDL_ALERT, "Thread system, Can't create thread: %s\n",
1696 if (this_thread->name)
1697 free (this_thread->name);
1698 pthread_mutex_destroy(&(this_thread->ThreadMutex));
1699 pthread_cond_destroy(&(this_thread->ThreadCond));
1700 pthread_attr_destroy(&this_thread->attr);
1703 ctdl_thread_internal_restore_signals(&old_signal_set);
1708 ctdl_thread_internal_restore_signals(&old_signal_set);
1710 num_threads++; // Increase the count of threads in the system.
1711 if(this_thread->flags & CTDLTHREAD_WORKER)
1714 this_thread->next = CtdlThreadList;
1715 CtdlThreadList = this_thread;
1716 if (this_thread->next)
1717 this_thread->next->prev = this_thread;
1718 // Register for tracing
1719 #ifdef HAVE_BACKTRACE
1720 eCrash_RegisterThread(this_thread->name, 0);
1726 * Wrapper function to create a thread
1727 * ensures the critical section and other protections are in place.
1728 * char *name = name to give to thread, if NULL, use generic name
1729 * int flags = flags to determine type of thread and standard facilities
1731 struct CtdlThreadNode *CtdlThreadCreate(char *name, long flags, void *(*thread_func) (void *arg), void *args)
1733 struct CtdlThreadNode *ret = NULL;
1735 begin_critical_section(S_THREAD_LIST);
1736 ret = ctdl_internal_create_thread(name, flags, thread_func, args);
1737 end_critical_section(S_THREAD_LIST);
1744 * A warapper function for select so we can show a thread as blocked
1746 int CtdlThreadSelect(int n, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, const struct timeval *timeout)
1748 struct CtdlThreadNode *self;
1751 self = CtdlThreadSelf();
1752 ctdl_thread_internal_change_state(self, CTDL_THREAD_BLOCKED);
1753 ret = select(n, readfds, writefds, exceptfds, timeout);
1754 ctdl_thread_internal_change_state(self, CTDL_THREAD_RUNNING);
1759 * Purge all sessions which have the 'kill_me' flag set.
1760 * This function has code to prevent it from running more than once every
1761 * few seconds, because running it after every single unbind would waste a lot
1762 * of CPU time and keep the context list locked too much. To force it to run
1763 * anyway, set "force" to nonzero.
1766 * After that's done, we raise the size of the worker thread pool
1767 * if such an action is appropriate.
1769 void dead_session_purge(int force) {
1770 struct CitContext *ptr, *ptr2; /* general-purpose utility pointer */
1771 struct CitContext *rem = NULL; /* list of sessions to be destroyed */
1773 CtdlThreadPushName("dead_session_purge");
1776 if ( (time(NULL) - last_purge) < 5 ) {
1777 CtdlThreadPopName();
1778 return; /* Too soon, go away */
1783 begin_critical_section(S_SESSION_TABLE);
1789 if ( (ptr2->state == CON_IDLE) && (ptr2->kill_me) ) {
1790 /* Remove the session from the active list */
1792 ptr2->prev->next = ptr2->next;
1795 ContextList = ptr2->next;
1798 ptr2->next->prev = ptr2->prev;
1803 /* And put it on our to-be-destroyed list */
1809 end_critical_section(S_SESSION_TABLE);
1811 /* Now that we no longer have the session list locked, we can take
1812 * our time and destroy any sessions on the to-be-killed list, which
1813 * is allocated privately on this thread's stack.
1815 while (rem != NULL) {
1816 CtdlLogPrintf(CTDL_DEBUG, "Purging session %d\n", rem->cs_pid);
1823 /* Raise the size of the worker thread pool if necessary. */
1824 begin_critical_section(S_THREAD_LIST);
1825 if ( (num_sessions > num_workers)
1826 && (num_workers < config.c_max_workers) ) {
1827 ctdl_internal_create_thread("Worker Thread", CTDLTHREAD_BIGSTACK + CTDLTHREAD_WORKER, worker_thread, NULL);
1829 end_critical_section(S_THREAD_LIST);
1830 // FIXME: reduce the number of worker threads too
1832 CtdlThreadPopName();
1841 * masterCC is the context we use when not attached to a session. This
1842 * function initializes it.
1844 void InitializeMasterCC(void) {
1845 memset(&masterCC, 0, sizeof(struct CitContext));
1846 masterCC.internal_pgm = 1;
1847 masterCC.cs_pid = 0;
1856 * Bind a thread to a context. (It's inline merely to speed things up.)
1858 INLINE void become_session(struct CitContext *which_con) {
1859 pthread_setspecific(MyConKey, (void *)which_con );
1865 * This loop just keeps going and going and going...
1867 void *worker_thread(void *arg) {
1870 struct CitContext *ptr;
1871 struct CitContext *bind_me = NULL;
1874 struct CitContext *con= NULL; /* Temporary context pointer */
1875 struct ServiceFunctionHook *serviceptr;
1876 int ssock; /* Descriptor for client socket */
1878 int force_purge = 0;
1883 while (!CtdlThreadCheckStop()) {
1885 /* make doubly sure we're not holding any stale db handles
1886 * which might cause a deadlock.
1888 cdb_check_handles();
1889 do_select: force_purge = 0;
1890 bind_me = NULL; /* Which session shall we handle? */
1892 /* Initialize the fdset. */
1896 begin_critical_section(S_SESSION_TABLE);
1897 for (ptr = ContextList; ptr != NULL; ptr = ptr->next) {
1898 if (ptr->state == CON_IDLE) {
1899 FD_SET(ptr->client_socket, &readfds);
1900 if (ptr->client_socket > highest)
1901 highest = ptr->client_socket;
1903 if ((bind_me == NULL) && (ptr->state == CON_READY)) {
1905 ptr->state = CON_EXECUTING;
1908 end_critical_section(S_SESSION_TABLE);
1914 /* If we got this far, it means that there are no sessions
1915 * which a previous thread marked for attention, so we go
1916 * ahead and get ready to select().
1919 /* First, add the various master sockets to the fdset. */
1920 for (serviceptr = ServiceHookTable; serviceptr != NULL;
1921 serviceptr = serviceptr->next ) {
1922 m = serviceptr->msock;
1923 FD_SET(m, &readfds);
1929 if (!CtdlThreadCheckStop()) {
1930 tv.tv_sec = 1; /* wake up every second if no input */
1932 retval = CtdlThreadSelect(highest + 1, &readfds, NULL, NULL, &tv);
1933 // retval = select(highest + 1, &readfds, NULL, NULL, &tv);
1936 if (CtdlThreadCheckStop()) return(NULL);
1938 /* Now figure out who made this select() unblock.
1939 * First, check for an error or exit condition.
1942 if (errno == EBADF) {
1943 CtdlLogPrintf(CTDL_NOTICE, "select() failed: (%s)\n",
1947 if (errno != EINTR) {
1948 CtdlLogPrintf(CTDL_EMERG, "Exiting (%s)\n", strerror(errno));
1949 CtdlThreadStopAll();
1950 } else if (!CtdlThreadCheckStop()) {
1951 CtdlLogPrintf(CTDL_DEBUG, "Un handled select failure.\n");
1955 else if(retval == 0) {
1958 /* Next, check to see if it's a new client connecting
1959 * on a master socket.
1961 else for (serviceptr = ServiceHookTable; serviceptr != NULL;
1962 serviceptr = serviceptr->next ) {
1964 if (FD_ISSET(serviceptr->msock, &readfds)) {
1965 ssock = accept(serviceptr->msock, NULL, 0);
1967 CtdlLogPrintf(CTDL_DEBUG,
1968 "New client socket %d\n",
1971 /* The master socket is non-blocking but the client
1972 * sockets need to be blocking, otherwise certain
1973 * operations barf on FreeBSD. Not a fatal error.
1975 if (fcntl(ssock, F_SETFL, 0) < 0) {
1976 CtdlLogPrintf(CTDL_EMERG,
1977 "citserver: Can't set socket to blocking: %s\n",
1981 /* New context will be created already
1982 * set up in the CON_EXECUTING state.
1984 con = CreateNewContext();
1986 /* Assign our new socket number to it. */
1987 con->client_socket = ssock;
1988 con->h_command_function =
1989 serviceptr->h_command_function;
1990 con->h_async_function =
1991 serviceptr->h_async_function;
1993 serviceptr->ServiceName;
1995 /* Determine whether it's a local socket */
1996 if (serviceptr->sockpath != NULL)
1997 con->is_local_socket = 1;
1999 /* Set the SO_REUSEADDR socket option */
2001 setsockopt(ssock, SOL_SOCKET,
2005 become_session(con);
2007 serviceptr->h_greeting_function();
2008 become_session(NULL);
2009 con->state = CON_IDLE;
2015 /* It must be a client socket. Find a context that has data
2016 * waiting on its socket *and* is in the CON_IDLE state. Any
2017 * active sockets other than our chosen one are marked as
2018 * CON_READY so the next thread that comes around can just bind
2019 * to one without having to select() again.
2021 begin_critical_section(S_SESSION_TABLE);
2022 for (ptr = ContextList; ptr != NULL; ptr = ptr->next) {
2023 if ( (FD_ISSET(ptr->client_socket, &readfds))
2024 && (ptr->state != CON_EXECUTING) ) {
2025 ptr->input_waiting = 1;
2027 bind_me = ptr; /* I choose you! */
2028 bind_me->state = CON_EXECUTING;
2031 ptr->state = CON_READY;
2035 end_critical_section(S_SESSION_TABLE);
2038 /* We're bound to a session */
2039 if (bind_me != NULL) {
2040 become_session(bind_me);
2042 /* If the client has sent a command, execute it. */
2043 if (CC->input_waiting) {
2044 CC->h_command_function();
2045 CC->input_waiting = 0;
2048 /* If there are asynchronous messages waiting and the
2049 * client supports it, do those now */
2050 if ((CC->is_async) && (CC->async_waiting)
2051 && (CC->h_async_function != NULL)) {
2052 CC->h_async_function();
2053 CC->async_waiting = 0;
2056 force_purge = CC->kill_me;
2057 become_session(NULL);
2058 bind_me->state = CON_IDLE;
2061 dead_session_purge(force_purge);
2063 check_sched_shutdown();
2065 /* If control reaches this point, the server is shutting down */
2074 * Translate text facility name to syslog.h defined value.
2076 int SyslogFacility(char *name)
2085 { LOG_KERN, "kern" },
2086 { LOG_USER, "user" },
2087 { LOG_MAIL, "mail" },
2088 { LOG_DAEMON, "daemon" },
2089 { LOG_AUTH, "auth" },
2090 { LOG_SYSLOG, "syslog" },
2092 { LOG_NEWS, "news" },
2093 { LOG_UUCP, "uucp" },
2094 { LOG_LOCAL0, "local0" },
2095 { LOG_LOCAL1, "local1" },
2096 { LOG_LOCAL2, "local2" },
2097 { LOG_LOCAL3, "local3" },
2098 { LOG_LOCAL4, "local4" },
2099 { LOG_LOCAL5, "local5" },
2100 { LOG_LOCAL6, "local6" },
2101 { LOG_LOCAL7, "local7" },
2104 for(i = 0; facTbl[i].name != NULL; i++) {
2105 if(!strcasecmp(name, facTbl[i].name))
2106 return facTbl[i].facility;
2113 /********** MEM CHEQQER ***********/
2115 #ifdef DEBUG_MEMORY_LEAKS
2122 void *tracked_malloc(size_t size, char *file, int line) {
2123 struct igheap *thisheap;
2126 block = malloc(size);
2127 if (block == NULL) return(block);
2129 thisheap = malloc(sizeof(struct igheap));
2130 if (thisheap == NULL) {
2135 thisheap->block = block;
2136 strcpy(thisheap->file, file);
2137 thisheap->line = line;
2139 begin_critical_section(S_DEBUGMEMLEAKS);
2140 thisheap->next = igheap;
2142 end_critical_section(S_DEBUGMEMLEAKS);
2148 void *tracked_realloc(void *ptr, size_t size, char *file, int line) {
2149 struct igheap *thisheap;
2152 block = realloc(ptr, size);
2153 if (block == NULL) return(block);
2155 thisheap = malloc(sizeof(struct igheap));
2156 if (thisheap == NULL) {
2161 thisheap->block = block;
2162 strcpy(thisheap->file, file);
2163 thisheap->line = line;
2165 begin_critical_section(S_DEBUGMEMLEAKS);
2166 thisheap->next = igheap;
2168 end_critical_section(S_DEBUGMEMLEAKS);
2175 void tracked_free(void *ptr) {
2176 struct igheap *thisheap;
2177 struct igheap *trash;
2181 if (igheap == NULL) return;
2182 begin_critical_section(S_DEBUGMEMLEAKS);
2183 for (thisheap = igheap; thisheap != NULL; thisheap = thisheap->next) {
2184 if (thisheap->next != NULL) {
2185 if (thisheap->next->block == ptr) {
2186 trash = thisheap->next;
2187 thisheap->next = thisheap->next->next;
2192 if (igheap->block == ptr) {
2194 igheap = igheap->next;
2197 end_critical_section(S_DEBUGMEMLEAKS);
2200 char *tracked_strdup(const char *s, char *file, int line) {
2203 if (s == NULL) return(NULL);
2204 ptr = tracked_malloc(strlen(s) + 1, file, line);
2205 if (ptr == NULL) return(NULL);
2206 strncpy(ptr, s, strlen(s));
2210 void dump_heap(void) {
2211 struct igheap *thisheap;
2213 for (thisheap = igheap; thisheap != NULL; thisheap = thisheap->next) {
2214 CtdlLogPrintf(CTDL_CRIT, "UNFREED: %30s : %d\n",
2215 thisheap->file, thisheap->line);
2219 #endif /* DEBUG_MEMORY_LEAKS */