citadel/sysdep.c

   1 /*
   2  * $Id$
   3  *
   4  * Citadel "system dependent" stuff.
   5  * See copyright.txt for copyright information.
   6  *
   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.
   9  *
  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.
  12  *
  13  */
  14
  15 #include "sysdep.h"
  16 #include <stdlib.h>
  17 #include <unistd.h>
  18 #include <stdio.h>
  19 #include <fcntl.h>
  20 #include <ctype.h>
  21 #include <signal.h>
  22 #include <sys/types.h>
  23 #include <sys/stat.h>
  24 #include <sys/wait.h>
  25 #include <sys/socket.h>
  26 #include <syslog.h>
  27 #include <sys/syslog.h>
  28
  29 #if TIME_WITH_SYS_TIME
  30 # include <sys/time.h>
  31 # include <time.h>
  32 #else
  33 # if HAVE_SYS_TIME_H
  34 #  include <sys/time.h>
  35 # else
  36 #  include <time.h>
  37 # endif
  38 #endif
  39
  40 #include <limits.h>
  41 #include <sys/resource.h>
  42 #include <netinet/in.h>
  43 #include <netinet/tcp.h>
  44 #include <arpa/inet.h>
  45 #include <netdb.h>
  46 #include <sys/un.h>
  47 #include <string.h>
  48 #include <pwd.h>
  49 #include <errno.h>
  50 #include <stdarg.h>
  51 #include <grp.h>
  52 #include <libcitadel.h>
  53 #include "citadel.h"
  54 #include "server.h"
  55 #include "sysdep_decls.h"
  56 #include "citserver.h"
  57 #include "support.h"
  58 #include "config.h"
  59 #include "database.h"
  60 #include "housekeeping.h"
  61 #include "modules/crypto/serv_crypto.h" /* Needed for init_ssl, client_write_ssl, client_read_ssl, destruct_ssl */
  62 #include "ecrash.h"
  63
  64 #ifdef HAVE_SYS_SELECT_H
  65 #include <sys/select.h>
  66 #endif
  67
  68 #ifndef HAVE_SNPRINTF
  69 #include "snprintf.h"
  70 #endif
  71
  72 #include "ctdl_module.h"
  73 #include "threads.h"
  74
  75 #ifdef DEBUG_MEMORY_LEAKS
  76 struct igheap {
  77         struct igheap *next;
  78         char file[32];
  79         int line;
  80         void *block;
  81 };
  82
  83 struct igheap *igheap = NULL;
  84 #endif
  85
  86
  87 citthread_key_t MyConKey;                               /* TSD key for MyContext() */
  88
  89 int verbosity = DEFAULT_VERBOSITY;              /* Logging level */
  90
  91 struct CitContext masterCC;
  92 time_t last_purge = 0;                          /* Last dead session purge */
  93 int num_sessions = 0;                           /* Current number of sessions */
  94
  95 int syslog_facility = LOG_DAEMON;
  96 int enable_syslog = 0;
  97
  98
  99 /*
 100  * Create an interface to lprintf that follows the coding convention.
 101  * This is here until such time as we have replaced all calls to lprintf with CtdlLogPrintf
 102  */
 103
 104 void CtdlLogPrintf(enum LogLevel loglevel, const char *format, ...)
 105 {
 106         va_list arg_ptr;
 107         va_start(arg_ptr, format);
 108         vlprintf(loglevel, format, arg_ptr);
 109         va_end(arg_ptr);
 110 }
 111
 112
 113 /*
 114  * lprintf()  ...   Write logging information
 115  */
 116 void lprintf(enum LogLevel loglevel, const char *format, ...) {
 117         va_list arg_ptr;
 118         va_start(arg_ptr, format);
 119         vlprintf(loglevel, format, arg_ptr);
 120         va_end(arg_ptr);
 121 }
 122
 123 void vlprintf(enum LogLevel loglevel, const char *format, va_list arg_ptr)
 124 {
 125         char buf[SIZ], buf2[SIZ];
 126
 127         if (enable_syslog) {
 128                 vsyslog((syslog_facility | loglevel), format, arg_ptr);
 129         }
 130
 131         /* stderr output code */
 132         if (enable_syslog || running_as_daemon) return;
 133
 134         /* if we run in forground and syslog is disabled, log to terminal */
 135         if (loglevel <= verbosity) {
 136                 struct timeval tv;
 137                 struct tm tim;
 138                 time_t unixtime;
 139
 140                 gettimeofday(&tv, NULL);
 141                 /* Promote to time_t; types differ on some OSes (like darwin) */
 142                 unixtime = tv.tv_sec;
 143                 localtime_r(&unixtime, &tim);
 144                 if (CC->cs_pid != 0) {
 145                         sprintf(buf,
 146                                 "%04d/%02d/%02d %2d:%02d:%02d.%06ld [%3d] ",
 147                                 tim.tm_year + 1900, tim.tm_mon + 1,
 148                                 tim.tm_mday, tim.tm_hour, tim.tm_min,
 149                                 tim.tm_sec, (long)tv.tv_usec,
 150                                 CC->cs_pid);
 151                 } else {
 152                         sprintf(buf,
 153                                 "%04d/%02d/%02d %2d:%02d:%02d.%06ld ",
 154                                 tim.tm_year + 1900, tim.tm_mon + 1,
 155                                 tim.tm_mday, tim.tm_hour, tim.tm_min,
 156                                 tim.tm_sec, (long)tv.tv_usec);
 157                 }
 158                 vsnprintf(buf2, SIZ, format, arg_ptr);
 159
 160                 fprintf(stderr, "%s%s", buf, buf2);
 161                 fflush(stderr);
 162         }
 163 }
 164
 165
 166
 167 /*
 168  * Signal handler to shut down the server.
 169  */
 170
 171 volatile int exit_signal = 0;
 172 volatile int shutdown_and_halt = 0;
 173 volatile int restart_server = 0;
 174 volatile int running_as_daemon = 0;
 175
 176 static RETSIGTYPE signal_cleanup(int signum) {
 177         CtdlLogPrintf(CTDL_DEBUG, "Caught signal %d; shutting down.\n", signum);
 178 #ifdef THREADS_USESIGNALS
 179         if (CT)
 180         {
 181                 CtdlLogPrintf(CTDL_DEBUG, "Thread \"%s\" caught signal %d.\n", CT->name, signum);
 182                 CT->signal = signum;
 183         }
 184         else
 185 #endif
 186                 exit_signal = signum;
 187 }
 188
 189
 190
 191 /*
 192  * Some initialization stuff...
 193  */
 194 void init_sysdep(void) {
 195         sigset_t set;
 196
 197         /* Avoid vulnerabilities related to FD_SETSIZE if we can. */
 198 #ifdef FD_SETSIZE
 199 #ifdef RLIMIT_NOFILE
 200         struct rlimit rl;
 201         getrlimit(RLIMIT_NOFILE, &rl);
 202         rl.rlim_cur = FD_SETSIZE;
 203         rl.rlim_max = FD_SETSIZE;
 204         setrlimit(RLIMIT_NOFILE, &rl);
 205 #endif
 206 #endif
 207
 208         /* If we've got OpenSSL, we're going to use it. */
 209 #ifdef HAVE_OPENSSL
 210         init_ssl();
 211 #endif
 212
 213         /*
 214          * Set up a place to put thread-specific data.
 215          * We only need a single pointer per thread - it points to the
 216          * CitContext structure (in the ContextList linked list) of the
 217          * session to which the calling thread is currently bound.
 218          */
 219         if (citthread_key_create(&MyConKey, NULL) != 0) {
 220                 CtdlLogPrintf(CTDL_CRIT, "Can't create TSD key: %s\n",
 221                         strerror(errno));
 222         }
 223
 224         /*
 225          * The action for unexpected signals and exceptions should be to
 226          * call signal_cleanup() to gracefully shut down the server.
 227          */
 228         sigemptyset(&set);
 229         sigaddset(&set, SIGINT);
 230         sigaddset(&set, SIGQUIT);
 231         sigaddset(&set, SIGHUP);
 232         sigaddset(&set, SIGTERM);
 233         // sigaddset(&set, SIGSEGV);    commented out because
 234         // sigaddset(&set, SIGILL);     we want core dumps
 235         // sigaddset(&set, SIGBUS);
 236         sigprocmask(SIG_UNBLOCK, &set, NULL);
 237
 238         signal(SIGINT, signal_cleanup);
 239         signal(SIGQUIT, signal_cleanup);
 240         signal(SIGHUP, signal_cleanup);
 241         signal(SIGTERM, signal_cleanup);
 242         // signal(SIGSEGV, signal_cleanup);     commented out because
 243         // signal(SIGILL, signal_cleanup);      we want core dumps
 244         // signal(SIGBUS, signal_cleanup);
 245
 246         /*
 247          * Do not shut down the server on broken pipe signals, otherwise the
 248          * whole Citadel service would come down whenever a single client
 249          * socket breaks.
 250          */
 251         signal(SIGPIPE, SIG_IGN);
 252 }
 253
 254
 255
 256
 257 /*
 258  * This is a generic function to set up a master socket for listening on
 259  * a TCP port.  The server shuts down if the bind fails.
 260  *
 261  */
 262 int ig_tcp_server(char *ip_addr, int port_number, int queue_len, char **errormessage)
 263 {
 264         struct sockaddr_in sin;
 265         int s, i;
 266         int actual_queue_len;
 267
 268         actual_queue_len = queue_len;
 269         if (actual_queue_len < 5) actual_queue_len = 5;
 270
 271         memset(&sin, 0, sizeof(sin));
 272         sin.sin_family = AF_INET;
 273         sin.sin_port = htons((u_short)port_number);
 274         if (ip_addr == NULL) {
 275                 sin.sin_addr.s_addr = INADDR_ANY;
 276         }
 277         else {
 278                 sin.sin_addr.s_addr = inet_addr(ip_addr);
 279         }
 280
 281         if (sin.sin_addr.s_addr == !INADDR_ANY) {
 282                 sin.sin_addr.s_addr = INADDR_ANY;
 283         }
 284
 285         s = socket(PF_INET, SOCK_STREAM, IPPROTO_TCP);
 286
 287         if (s < 0) {
 288                 *errormessage = (char*) malloc(SIZ + 1);
 289                 snprintf(*errormessage, SIZ,
 290                                  "citserver: Can't create a socket: %s",
 291                                  strerror(errno));
 292                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 293                 return(-1);
 294         }
 295
 296         i = 1;
 297         setsockopt(s, SOL_SOCKET, SO_REUSEADDR, &i, sizeof(i));
 298
 299         if (bind(s, (struct sockaddr *)&sin, sizeof(sin)) < 0) {
 300                 *errormessage = (char*) malloc(SIZ + 1);
 301                 snprintf(*errormessage, SIZ,
 302                                  "citserver: Can't bind: %s",
 303                                  strerror(errno));
 304                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 305                 close(s);
 306                 return(-1);
 307         }
 308
 309         /* set to nonblock - we need this for some obscure situations */
 310         if (fcntl(s, F_SETFL, O_NONBLOCK) < 0) {
 311                 *errormessage = (char*) malloc(SIZ + 1);
 312                 snprintf(*errormessage, SIZ,
 313                                  "citserver: Can't set socket to non-blocking: %s",
 314                                  strerror(errno));
 315                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 316                 close(s);
 317                 return(-1);
 318         }
 319
 320         if (listen(s, actual_queue_len) < 0) {
 321                 *errormessage = (char*) malloc(SIZ + 1);
 322                 snprintf(*errormessage, SIZ,
 323                                  "citserver: Can't listen: %s",
 324                                  strerror(errno));
 325                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 326                 close(s);
 327                 return(-1);
 328         }
 329
 330         return(s);
 331 }
 332
 333
 334
 335 /*
 336  * Create a Unix domain socket and listen on it
 337  */
 338 int ig_uds_server(char *sockpath, int queue_len, char **errormessage)
 339 {
 340         struct sockaddr_un addr;
 341         int s;
 342         int i;
 343         int actual_queue_len;
 344
 345         actual_queue_len = queue_len;
 346         if (actual_queue_len < 5) actual_queue_len = 5;
 347
 348         i = unlink(sockpath);
 349         if (i != 0) if (errno != ENOENT) {
 350                 *errormessage = (char*) malloc(SIZ + 1);
 351                 snprintf(*errormessage, SIZ, "citserver: can't unlink %s: %s",
 352                         sockpath, strerror(errno));
 353                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 354                 return(-1);
 355         }
 356
 357         memset(&addr, 0, sizeof(addr));
 358         addr.sun_family = AF_UNIX;
 359         safestrncpy(addr.sun_path, sockpath, sizeof addr.sun_path);
 360
 361         s = socket(AF_UNIX, SOCK_STREAM, 0);
 362         if (s < 0) {
 363                 *errormessage = (char*) malloc(SIZ + 1);
 364                 snprintf(*errormessage, SIZ,
 365                          "citserver: Can't create a socket: %s",
 366                          strerror(errno));
 367                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 368                 return(-1);
 369         }
 370
 371         if (bind(s, (struct sockaddr *)&addr, sizeof(addr)) < 0) {
 372                 *errormessage = (char*) malloc(SIZ + 1);
 373                 snprintf(*errormessage, SIZ,
 374                          "citserver: Can't bind: %s",
 375                          strerror(errno));
 376                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 377                 return(-1);
 378         }
 379
 380         /* set to nonblock - we need this for some obscure situations */
 381         if (fcntl(s, F_SETFL, O_NONBLOCK) < 0) {
 382                 *errormessage = (char*) malloc(SIZ + 1);
 383                 snprintf(*errormessage, SIZ,
 384                          "citserver: Can't set socket to non-blocking: %s",
 385                          strerror(errno));
 386                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 387                 close(s);
 388                 return(-1);
 389         }
 390
 391         if (listen(s, actual_queue_len) < 0) {
 392                 *errormessage = (char*) malloc(SIZ + 1);
 393                 snprintf(*errormessage, SIZ,
 394                          "citserver: Can't listen: %s",
 395                          strerror(errno));
 396                 CtdlLogPrintf(CTDL_EMERG, "%s\n", *errormessage);
 397                 return(-1);
 398         }
 399
 400         chmod(sockpath, S_ISGID|S_IRUSR|S_IWUSR|S_IXUSR|S_IRGRP|S_IWGRP|S_IXGRP|S_IROTH|S_IWOTH|S_IXOTH);
 401         return(s);
 402 }
 403
 404
 405
 406 /*
 407  * Return a pointer to the CitContext structure bound to the thread which
 408  * called this function.  If there's no such binding (for example, if it's
 409  * called by the housekeeper thread) then a generic 'master' CC is returned.
 410  *
 411  * This function is used *VERY* frequently and must be kept small.
 412  */
 413 struct CitContext *MyContext(void) {
 414
 415         register struct CitContext *c;
 416
 417         return ((c = (struct CitContext *) citthread_getspecific(MyConKey),
 418                 c == NULL) ? &masterCC : c
 419         );
 420 }
 421
 422
 423 /*
 424  * Initialize a new context and place it in the list.  The session number
 425  * used to be the PID (which is why it's called cs_pid), but that was when we
 426  * had one process per session.  Now we just assign them sequentially, starting
 427  * at 1 (don't change it to 0 because masterCC uses 0).
 428  */
 429 struct CitContext *CreateNewContext(void) {
 430         struct CitContext *me;
 431         static int next_pid = 0;
 432
 433         me = (struct CitContext *) malloc(sizeof(struct CitContext));
 434         if (me == NULL) {
 435                 CtdlLogPrintf(CTDL_ALERT, "citserver: can't allocate memory!!\n");
 436                 return NULL;
 437         }
 438         memset(me, 0, sizeof(struct CitContext));
 439
 440         /* The new context will be created already in the CON_EXECUTING state
 441          * in order to prevent another thread from grabbing it while it's
 442          * being set up.
 443          */
 444         me->state = CON_EXECUTING;
 445         /*
 446          * Generate a unique session number and insert this context into
 447          * the list.
 448          */
 449         begin_critical_section(S_SESSION_TABLE);
 450         me->cs_pid = ++next_pid;
 451         me->prev = NULL;
 452         me->next = ContextList;
 453         ContextList = me;
 454         if (me->next != NULL) {
 455                 me->next->prev = me;
 456         }
 457         ++num_sessions;
 458         end_critical_section(S_SESSION_TABLE);
 459         return (me);
 460 }
 461
 462
 463 /*
 464  * The following functions implement output buffering. If the kernel supplies
 465  * native TCP buffering (Linux & *BSD), use that; otherwise, emulate it with
 466  * user-space buffering.
 467  */
 468 #ifndef HAVE_DARWIN
 469 #ifdef TCP_CORK
 470 #       define HAVE_TCP_BUFFERING
 471 #else
 472 #       ifdef TCP_NOPUSH
 473 #               define HAVE_TCP_BUFFERING
 474 #               define TCP_CORK TCP_NOPUSH
 475 #       endif
 476 #endif /* TCP_CORK */
 477 #endif /* HAVE_DARWIN */
 478
 479 #ifdef HAVE_TCP_BUFFERING
 480 static unsigned on = 1, off = 0;
 481 void buffer_output(void) {
 482         struct CitContext *ctx = MyContext();
 483         setsockopt(ctx->client_socket, IPPROTO_TCP, TCP_CORK, &on, 4);
 484         ctx->buffering = 1;
 485 }
 486
 487 void unbuffer_output(void) {
 488         struct CitContext *ctx = MyContext();
 489         setsockopt(ctx->client_socket, IPPROTO_TCP, TCP_CORK, &off, 4);
 490         ctx->buffering = 0;
 491 }
 492
 493 void flush_output(void) {
 494         struct CitContext *ctx = MyContext();
 495         setsockopt(ctx->client_socket, IPPROTO_TCP, TCP_CORK, &off, 4);
 496         setsockopt(ctx->client_socket, IPPROTO_TCP, TCP_CORK, &on, 4);
 497 }
 498 #else
 499 #ifdef HAVE_DARWIN
 500 /* Stub functions for Darwin/OS X where TCP buffering isn't liked at all */
 501 void buffer_output(void) {
 502         CC->buffering = 0;
 503 }
 504 void unbuffer_output(void) {
 505         CC->buffering = 0;
 506 }
 507 void flush_output(void) {
 508 }
 509 #else
 510 void buffer_output(void) {
 511         if (CC->buffering == 0) {
 512                 CC->buffering = 1;
 513                 CC->buffer_len = 0;
 514                 CC->output_buffer = malloc(SIZ);
 515         }
 516 }
 517
 518 void flush_output(void) {
 519         if (CC->buffering == 1) {
 520                 client_write(CC->output_buffer, CC->buffer_len);
 521                 CC->buffer_len = 0;
 522         }
 523 }
 524
 525 void unbuffer_output(void) {
 526         if (CC->buffering == 1) {
 527                 CC->buffering = 0;
 528                 /* We don't call flush_output because we can't. */
 529                 client_write(CC->output_buffer, CC->buffer_len);
 530                 CC->buffer_len = 0;
 531                 free(CC->output_buffer);
 532                 CC->output_buffer = NULL;
 533         }
 534 }
 535 #endif /* HAVE_DARWIN */
 536 #endif /* HAVE_TCP_BUFFERING */
 537
 538
 539
 540 /*
 541  * client_write()   ...    Send binary data to the client.
 542  */
 543 void client_write(char *buf, int nbytes)
 544 {
 545         int bytes_written = 0;
 546         int retval;
 547 #ifndef HAVE_TCP_BUFFERING
 548         int old_buffer_len = 0;
 549 #endif
 550         t_context *Ctx;
 551
 552         Ctx = CC;
 553         if (Ctx->redirect_buffer != NULL) {
 554                 if ((Ctx->redirect_len + nbytes + 2) >= Ctx->redirect_alloc) {
 555                         Ctx->redirect_alloc = (Ctx->redirect_alloc * 2) + nbytes;
 556                         Ctx->redirect_buffer = realloc(Ctx->redirect_buffer,
 557                                                 Ctx->redirect_alloc);
 558                 }
 559                 memcpy(&Ctx->redirect_buffer[Ctx->redirect_len], buf, nbytes);
 560                 Ctx->redirect_len += nbytes;
 561                 Ctx->redirect_buffer[Ctx->redirect_len] = 0;
 562                 return;
 563         }
 564
 565 #ifndef HAVE_TCP_BUFFERING
 566         /* If we're buffering for later, do that now. */
 567         if (Ctx->buffering) {
 568                 old_buffer_len = Ctx->buffer_len;
 569                 Ctx->buffer_len += nbytes;
 570                 Ctx->output_buffer = realloc(Ctx->output_buffer, Ctx->buffer_len);
 571                 memcpy(&Ctx->output_buffer[old_buffer_len], buf, nbytes);
 572                 return;
 573         }
 574 #endif
 575
 576         /* Ok, at this point we're not buffering.  Go ahead and write. */
 577
 578 #ifdef HAVE_OPENSSL
 579         if (Ctx->redirect_ssl) {
 580                 client_write_ssl(buf, nbytes);
 581                 return;
 582         }
 583 #endif
 584
 585         while (bytes_written < nbytes) {
 586                 retval = write(Ctx->client_socket, &buf[bytes_written],
 587                         nbytes - bytes_written);
 588                 if (retval < 1) {
 589                         CtdlLogPrintf(CTDL_ERR,
 590                                 "client_write(%d bytes) failed: %s (%d)\n",
 591                                 nbytes - bytes_written,
 592                                 strerror(errno), errno);
 593                         cit_backtrace();
 594                         // CtdlLogPrintf(CTDL_DEBUG, "Tried to send: %s",  &buf[bytes_written]);
 595                         Ctx->kill_me = 1;
 596                         return;
 597                 }
 598                 bytes_written = bytes_written + retval;
 599         }
 600 }
 601
 602
 603 /*
 604  * cprintf()  ...   Send formatted printable data to the client.   It is
 605  *                implemented in terms of client_write() but remains in
 606  *                sysdep.c in case we port to somewhere without va_args...
 607  */
 608 void cprintf(const char *format, ...) {
 609         va_list arg_ptr;
 610         char buf[1024];
 611
 612         va_start(arg_ptr, format);
 613         if (vsnprintf(buf, sizeof buf, format, arg_ptr) == -1)
 614                 buf[sizeof buf - 2] = '\n';
 615         client_write(buf, strlen(buf));
 616         va_end(arg_ptr);
 617 }
 618
 619
 620 /*
 621  * Read data from the client socket.
 622  * Return values are:
 623  *      1       Requested number of bytes has been read.
 624  *      0       Request timed out.
 625  *      -1      The socket is broken.
 626  * If the socket breaks, the session will be terminated.
 627  */
 628 int client_read_to(char *buf, int bytes, int timeout)
 629 {
 630         int len,rlen;
 631         fd_set rfds;
 632         int fd;
 633         struct timeval tv;
 634         int retval;
 635
 636 #ifdef HAVE_OPENSSL
 637         if (CC->redirect_ssl) {
 638                 return (client_read_ssl(buf, bytes, timeout));
 639         }
 640 #endif
 641         len = 0;
 642         fd = CC->client_socket;
 643         while(len<bytes) {
 644                 FD_ZERO(&rfds);
 645                 FD_SET(fd, &rfds);
 646                 tv.tv_sec = timeout;
 647                 tv.tv_usec = 0;
 648
 649                 retval = select( (fd)+1,
 650                                  &rfds, NULL, NULL, &tv);
 651
 652                 if (FD_ISSET(fd, &rfds) == 0) {
 653                         return(0);
 654                 }
 655
 656                 rlen = read(fd, &buf[len], bytes-len);
 657                 if (rlen<1) {
 658                         /* The socket has been disconnected! */
 659                         CC->kill_me = 1;
 660                         return(-1);
 661                 }
 662                 len = len + rlen;
 663         }
 664         return(1);
 665 }
 666
 667 /*
 668  * Read data from the client socket with default timeout.
 669  * (This is implemented in terms of client_read_to() and could be
 670  * justifiably moved out of sysdep.c)
 671  */
 672 INLINE int client_read(char *buf, int bytes)
 673 {
 674         return(client_read_to(buf, bytes, config.c_sleeping));
 675 }
 676
 677
 678 /*
 679  * client_getln()   ...   Get a LF-terminated line of text from the client.
 680  * (This is implemented in terms of client_read() and could be
 681  * justifiably moved out of sysdep.c)
 682  */
 683 int client_getln(char *buf, int bufsize)
 684 {
 685         int i, retval;
 686
 687         /* Read one character at a time.
 688          */
 689         for (i = 0;;i++) {
 690                 retval = client_read(&buf[i], 1);
 691                 if (retval != 1 || buf[i] == '\n' || i == (bufsize-1))
 692                         break;
 693         }
 694
 695         /* If we got a long line, discard characters until the newline.
 696          */
 697         if (i == (bufsize-1))
 698                 while (buf[i] != '\n' && retval == 1)
 699                         retval = client_read(&buf[i], 1);
 700
 701         /* Strip the trailing LF, and the trailing CR if present.
 702          */
 703         buf[i] = 0;
 704         while ( (i > 0)
 705                 && ( (buf[i - 1]==13)
 706                      || ( buf[i - 1]==10)) ) {
 707                 i--;
 708                 buf[i] = 0;
 709         }
 710         if (retval < 0) safestrncpy(&buf[i], "000", bufsize - i);
 711         return(retval);
 712 }
 713
 714
 715 /*
 716  * Cleanup any contexts that are left lying around
 717  */
 718 void context_cleanup(void)
 719 {
 720         struct CitContext *ptr = NULL;
 721         struct CitContext *rem = NULL;
 722
 723         /*
 724          * Clean up the contexts.
 725          * There are no threads so no critical_section stuff is needed.
 726          */
 727         ptr = ContextList;
 728
 729         /* We need to update the ContextList because some modules may want to itterate it
 730          * Question is should we NULL it before iterating here or should we just keep updating it
 731          * as we remove items?
 732          *
 733          * Answer is to NULL it first to prevent modules from doing any actions on the list at all
 734          */
 735         ContextList=NULL;
 736         while (ptr != NULL){
 737                 /* Remove the session from the active list */
 738                 rem = ptr->next;
 739                 --num_sessions;
 740
 741                 lprintf(CTDL_DEBUG, "Purging session %d\n", ptr->cs_pid);
 742                 RemoveContext(ptr);
 743                 free (ptr);
 744                 ptr = rem;
 745         }
 746 }
 747
 748
 749
 750 void close_masters (void)
 751 {
 752         struct ServiceFunctionHook *serviceptr;
 753
 754         /*
 755          * close all protocol master sockets
 756          */
 757         for (serviceptr = ServiceHookTable; serviceptr != NULL;
 758             serviceptr = serviceptr->next ) {
 759
 760                 if (serviceptr->tcp_port > 0)
 761                 {
 762                         CtdlLogPrintf(CTDL_INFO, "Closing listener on port %d\n",
 763                                 serviceptr->tcp_port);
 764                         serviceptr->tcp_port = 0;
 765                 }
 766
 767                 if (serviceptr->sockpath != NULL)
 768                         CtdlLogPrintf(CTDL_INFO, "Closing listener on '%s'\n",
 769                                 serviceptr->sockpath);
 770
 771                 close(serviceptr->msock);
 772                 /* If it's a Unix domain socket, remove the file. */
 773                 if (serviceptr->sockpath != NULL) {
 774                         unlink(serviceptr->sockpath);
 775                         serviceptr->sockpath = NULL;
 776                 }
 777         }
 778 }
 779
 780
 781 /*
 782  * The system-dependent part of master_cleanup() - close the master socket.
 783  */
 784 void sysdep_master_cleanup(void) {
 785
 786         close_masters();
 787
 788         context_cleanup();
 789
 790 #ifdef HAVE_OPENSSL
 791         destruct_ssl();
 792 #endif
 793         CtdlDestroyProtoHooks();
 794         CtdlDestroyDeleteHooks();
 795         CtdlDestroyXmsgHooks();
 796         CtdlDestroyNetprocHooks();
 797         CtdlDestroyUserHooks();
 798         CtdlDestroyMessageHook();
 799         CtdlDestroyCleanupHooks();
 800         CtdlDestroyFixedOutputHooks();
 801         CtdlDestroySessionHooks();
 802         CtdlDestroyServiceHook();
 803         CtdlDestroyRoomHooks();
 804         CtdlDestroyDirectoryServiceFuncs();
 805         #ifdef HAVE_BACKTRACE
 806         eCrash_Uninit();
 807         #endif
 808 }
 809
 810
 811
 812 /*
 813  * Terminate another session.
 814  * (This could justifiably be moved out of sysdep.c because it
 815  * no longer does anything that is system-dependent.)
 816  */
 817 void kill_session(int session_to_kill) {
 818         struct CitContext *ptr;
 819
 820         begin_critical_section(S_SESSION_TABLE);
 821         for (ptr = ContextList; ptr != NULL; ptr = ptr->next) {
 822                 if (ptr->cs_pid == session_to_kill) {
 823                         ptr->kill_me = 1;
 824                 }
 825         }
 826         end_critical_section(S_SESSION_TABLE);
 827 }
 828
 829 pid_t current_child;
 830 void graceful_shutdown(int signum) {
 831         kill(current_child, signum);
 832         unlink(file_pid_file);
 833         exit(0);
 834 }
 835
 836
 837 /*
 838  * Start running as a daemon.
 839  */
 840 void start_daemon(int unused) {
 841         int status = 0;
 842         pid_t child = 0;
 843         FILE *fp;
 844         int do_restart = 0;
 845
 846         current_child = 0;
 847
 848         /* Close stdin/stdout/stderr and replace them with /dev/null.
 849          * We don't just call close() because we don't want these fd's
 850          * to be reused for other files.
 851          */
 852         chdir(ctdl_run_dir);
 853
 854         child = fork();
 855         if (child != 0) {
 856                 exit(0);
 857         }
 858
 859         signal(SIGHUP, SIG_IGN);
 860         signal(SIGINT, SIG_IGN);
 861         signal(SIGQUIT, SIG_IGN);
 862
 863         setsid();
 864         umask(0);
 865         freopen("/dev/null", "r", stdin);
 866         freopen("/dev/null", "w", stdout);
 867         freopen("/dev/null", "w", stderr);
 868
 869         do {
 870                 current_child = fork();
 871
 872                 signal(SIGTERM, graceful_shutdown);
 873
 874                 if (current_child < 0) {
 875                         perror("fork");
 876                         exit(errno);
 877                 }
 878
 879                 else if (current_child == 0) {
 880                         return; /* continue starting citadel. */
 881                 }
 882
 883                 else {
 884                         fp = fopen(file_pid_file, "w");
 885                         if (fp != NULL) {
 886                                 fprintf(fp, ""F_PID_T"\n", getpid());
 887                                 fclose(fp);
 888                         }
 889                         waitpid(current_child, &status, 0);
 890                 }
 891
 892                 do_restart = 0;
 893
 894                 /* Did the main process exit with an actual exit code? */
 895                 if (WIFEXITED(status)) {
 896
 897                         /* Exit code 0 means the watcher should exit */
 898                         if (WEXITSTATUS(status) == 0) {
 899                                 do_restart = 0;
 900                         }
 901
 902                         /* Exit code 101-109 means the watcher should exit */
 903                         else if ( (WEXITSTATUS(status) >= 101) && (WEXITSTATUS(status) <= 109) ) {
 904                                 do_restart = 0;
 905                         }
 906
 907                         /* Any other exit code means we should restart. */
 908                         else {
 909                                 do_restart = 1;
 910                         }
 911                 }
 912
 913                 /* Any other type of termination (signals, etc.) should also restart. */
 914                 else {
 915                         do_restart = 1;
 916                 }
 917
 918         } while (do_restart);
 919
 920         unlink(file_pid_file);
 921         exit(WEXITSTATUS(status));
 922 }
 923
 924
 925
 926 /*
 927  * Generic routine to convert a login name to a full name (gecos)
 928  * Returns nonzero if a conversion took place
 929  */
 930 int convert_login(char NameToConvert[]) {
 931         struct passwd *pw;
 932         int a;
 933
 934         pw = getpwnam(NameToConvert);
 935         if (pw == NULL) {
 936                 return(0);
 937         }
 938         else {
 939                 strcpy(NameToConvert, pw->pw_gecos);
 940                 for (a=0; a<strlen(NameToConvert); ++a) {
 941                         if (NameToConvert[a] == ',') NameToConvert[a] = 0;
 942                 }
 943                 return(1);
 944         }
 945 }
 946
 947 /*
 948  * Purge all sessions which have the 'kill_me' flag set.
 949  * This function has code to prevent it from running more than once every
 950  * few seconds, because running it after every single unbind would waste a lot
 951  * of CPU time and keep the context list locked too much.  To force it to run
 952  * anyway, set "force" to nonzero.
 953  */
 954 void dead_session_purge(int force) {
 955         struct CitContext *ptr, *ptr2;          /* general-purpose utility pointer */
 956         struct CitContext *rem = NULL;  /* list of sessions to be destroyed */
 957
 958         if (force == 0) {
 959                 if ( (time(NULL) - last_purge) < 5 ) {
 960                         return; /* Too soon, go away */
 961                 }
 962         }
 963         time(&last_purge);
 964
 965         if (try_critical_section(S_SESSION_TABLE))
 966                 return;
 967
 968         ptr = ContextList;
 969         while (ptr) {
 970                 ptr2 = ptr;
 971                 ptr = ptr->next;
 972
 973                 if ( (ptr2->state == CON_IDLE) && (ptr2->kill_me) ) {
 974                         /* Remove the session from the active list */
 975                         if (ptr2->prev) {
 976                                 ptr2->prev->next = ptr2->next;
 977                         }
 978                         else {
 979                                 ContextList = ptr2->next;
 980                         }
 981                         if (ptr2->next) {
 982                                 ptr2->next->prev = ptr2->prev;
 983                         }
 984
 985                         --num_sessions;
 986                         /* And put it on our to-be-destroyed list */
 987                         ptr2->next = rem;
 988                         rem = ptr2;
 989                 }
 990         }
 991         end_critical_section(S_SESSION_TABLE);
 992
 993         /* Now that we no longer have the session list locked, we can take
 994          * our time and destroy any sessions on the to-be-killed list, which
 995          * is allocated privately on this thread's stack.
 996          */
 997         while (rem != NULL) {
 998                 CtdlLogPrintf(CTDL_DEBUG, "Purging session %d\n", rem->cs_pid);
 999                 RemoveContext(rem);
1000                 ptr = rem;
1001                 rem = rem->next;
1002                 free(ptr);
1003         }
1004 }
1005
1006
1007
1008
1009
1010 /*
1011  * masterCC is the context we use when not attached to a session.  This
1012  * function initializes it.
1013  */
1014 void InitializeMasterCC(void) {
1015         memset(&masterCC, 0, sizeof(struct CitContext));
1016         masterCC.internal_pgm = 1;
1017         masterCC.cs_pid = 0;
1018 }
1019
1020
1021
1022
1023
1024
1025 /*
1026  * Bind a thread to a context.  (It's inline merely to speed things up.)
1027  */
1028 INLINE void become_session(struct CitContext *which_con) {
1029         citthread_setspecific(MyConKey, (void *)which_con );
1030 }
1031
1032
1033
1034 /*
1035  * This loop just keeps going and going and going...
1036  */
1037 /*
1038  * FIXME:
1039  * This current implimentation of worker_thread creates a bottle neck in several situations
1040  * The first thing to remember is that a single thread can handle more than one connection at a time.
1041  * More threads mean less memory for the system to run in.
1042  * So for efficiency we want every thread to be doing something useful or waiting in the main loop for
1043  * something to happen anywhere.
1044  * This current implimentation requires worker threads to wait in other locations, after it has
1045  * been committed to a single connection which is very wasteful.
1046  * As an extreme case consider this:
1047  * A slow client connects and this slow client sends only one character each second.
1048  * With this current implimentation a single worker thread is dispatched to handle that connection
1049  * until such times as the client timeout expires, an error occurs on the socket or the client
1050  * completes its transmission.
1051  * THIS IS VERY BAD since that thread could have handled a read from many more clients in each one
1052  * second interval between chars.
1053  *
1054  * It is my intention to re-write this code and the associated client_getln, client_read functions
1055  * to allow any thread to read data on behalf of any connection (context).
1056  * To do this I intend to have this main loop read chars into a buffer stored in the context.
1057  * Once the correct criteria for a full buffer is met then we will dispatch a thread to
1058  * process it.
1059  * This worker thread loop also needs to be able to handle binary data.
1060  */
1061
1062 void *worker_thread(void *arg) {
1063         int i;
1064         int highest;
1065         struct CitContext *ptr;
1066         struct CitContext *bind_me = NULL;
1067         fd_set readfds;
1068         int retval = 0;
1069         struct CitContext *con= NULL;   /* Temporary context pointer */
1070         struct ServiceFunctionHook *serviceptr;
1071         int ssock;                      /* Descriptor for client socket */
1072         struct timeval tv;
1073         int force_purge = 0;
1074         int m;
1075
1076
1077         while (!CtdlThreadCheckStop()) {
1078
1079                 /* make doubly sure we're not holding any stale db handles
1080                  * which might cause a deadlock.
1081                  */
1082                 cdb_check_handles();
1083 do_select:      force_purge = 0;
1084                 bind_me = NULL;         /* Which session shall we handle? */
1085
1086                 /* Initialize the fdset. */
1087                 FD_ZERO(&readfds);
1088                 highest = 0;
1089
1090                 begin_critical_section(S_SESSION_TABLE);
1091                 for (ptr = ContextList; ptr != NULL; ptr = ptr->next) {
1092                         if (ptr->state == CON_IDLE) {
1093                                 FD_SET(ptr->client_socket, &readfds);
1094                                 if (ptr->client_socket > highest)
1095                                         highest = ptr->client_socket;
1096                         }
1097                         if ((bind_me == NULL) && (ptr->state == CON_READY)) {
1098                                 bind_me = ptr;
1099                                 ptr->state = CON_EXECUTING;
1100                         }
1101                 }
1102                 end_critical_section(S_SESSION_TABLE);
1103
1104                 if (bind_me) {
1105                         goto SKIP_SELECT;
1106                 }
1107
1108                 /* If we got this far, it means that there are no sessions
1109                  * which a previous thread marked for attention, so we go
1110                  * ahead and get ready to select().
1111                  */
1112
1113                 /* First, add the various master sockets to the fdset. */
1114                 for (serviceptr = ServiceHookTable; serviceptr != NULL;
1115                 serviceptr = serviceptr->next ) {
1116                         m = serviceptr->msock;
1117                         FD_SET(m, &readfds);
1118                         if (m > highest) {
1119                                 highest = m;
1120                         }
1121                 }
1122
1123                 if (!CtdlThreadCheckStop()) {
1124                         tv.tv_sec = 1;          /* wake up every second if no input */
1125                         tv.tv_usec = 0;
1126                         retval = CtdlThreadSelect(highest + 1, &readfds, NULL, NULL, &tv);
1127                 }
1128
1129                 if (CtdlThreadCheckStop()) return(NULL);
1130
1131                 /* Now figure out who made this select() unblock.
1132                  * First, check for an error or exit condition.
1133                  */
1134                 if (retval < 0) {
1135                         if (errno == EBADF) {
1136                                 CtdlLogPrintf(CTDL_NOTICE, "select() failed: (%s)\n",
1137                                         strerror(errno));
1138                                 goto do_select;
1139                         }
1140                         if (errno != EINTR) {
1141                                 CtdlLogPrintf(CTDL_EMERG, "Exiting (%s)\n", strerror(errno));
1142                                 CtdlThreadStopAll();
1143                         } else if (!CtdlThreadCheckStop()) {
1144                                 CtdlLogPrintf(CTDL_DEBUG, "Interrupted select.\n");
1145                                 goto do_select;
1146                         }
1147                 }
1148                 else if(retval == 0) {
1149                         goto SKIP_SELECT;
1150                 }
1151                 /* Next, check to see if it's a new client connecting
1152                  * on a master socket.
1153                  */
1154                 else for (serviceptr = ServiceHookTable; serviceptr != NULL;
1155                      serviceptr = serviceptr->next ) {
1156
1157                         if (FD_ISSET(serviceptr->msock, &readfds)) {
1158                                 ssock = accept(serviceptr->msock, NULL, 0);
1159                                 if (ssock >= 0) {
1160                                         CtdlLogPrintf(CTDL_DEBUG,
1161                                                 "New client socket %d\n",
1162                                                 ssock);
1163
1164                                         /* The master socket is non-blocking but the client
1165                                          * sockets need to be blocking, otherwise certain
1166                                          * operations barf on FreeBSD.  Not a fatal error.
1167                                          */
1168                                         if (fcntl(ssock, F_SETFL, 0) < 0) {
1169                                                 CtdlLogPrintf(CTDL_EMERG,
1170                                                         "citserver: Can't set socket to blocking: %s\n",
1171                                                         strerror(errno));
1172                                         }
1173
1174                                         /* New context will be created already
1175                                          * set up in the CON_EXECUTING state.
1176                                          */
1177                                         con = CreateNewContext();
1178
1179                                         /* Assign our new socket number to it. */
1180                                         con->client_socket = ssock;
1181                                         con->h_command_function =
1182                                                 serviceptr->h_command_function;
1183                                         con->h_async_function =
1184                                                 serviceptr->h_async_function;
1185                                         con->ServiceName =
1186                                                 serviceptr->ServiceName;
1187
1188                                         /* Determine whether it's a local socket */
1189                                         if (serviceptr->sockpath != NULL)
1190                                                 con->is_local_socket = 1;
1191
1192                                         /* Set the SO_REUSEADDR socket option */
1193                                         i = 1;
1194                                         setsockopt(ssock, SOL_SOCKET,
1195                                                 SO_REUSEADDR,
1196                                                 &i, sizeof(i));
1197
1198                                         become_session(con);
1199                                         begin_session(con);
1200                                         serviceptr->h_greeting_function();
1201                                         become_session(NULL);
1202                                         con->state = CON_IDLE;
1203                                         goto do_select;
1204                                 }
1205                         }
1206                 }
1207
1208                 /* It must be a client socket.  Find a context that has data
1209                  * waiting on its socket *and* is in the CON_IDLE state.  Any
1210                  * active sockets other than our chosen one are marked as
1211                  * CON_READY so the next thread that comes around can just bind
1212                  * to one without having to select() again.
1213                  */
1214                 begin_critical_section(S_SESSION_TABLE);
1215                 for (ptr = ContextList; ptr != NULL; ptr = ptr->next) {
1216                         if ( (FD_ISSET(ptr->client_socket, &readfds))
1217                            && (ptr->state != CON_EXECUTING) ) {
1218                                 ptr->input_waiting = 1;
1219                                 if (!bind_me) {
1220                                         bind_me = ptr;  /* I choose you! */
1221                                         bind_me->state = CON_EXECUTING;
1222                                 }
1223                                 else {
1224                                         ptr->state = CON_READY;
1225                                 }
1226                         }
1227                 }
1228                 end_critical_section(S_SESSION_TABLE);
1229
1230 SKIP_SELECT:
1231                 /* We're bound to a session */
1232                 if (bind_me != NULL) {
1233                         become_session(bind_me);
1234
1235                         /* If the client has sent a command, execute it. */
1236                         if (CC->input_waiting) {
1237                                 CC->h_command_function();
1238                                 CC->input_waiting = 0;
1239                         }
1240
1241                         /* If there are asynchronous messages waiting and the
1242                          * client supports it, do those now */
1243                         if ((CC->is_async) && (CC->async_waiting)
1244                            && (CC->h_async_function != NULL)) {
1245                                 CC->h_async_function();
1246                                 CC->async_waiting = 0;
1247                         }
1248
1249                         force_purge = CC->kill_me;
1250                         become_session(NULL);
1251                         bind_me->state = CON_IDLE;
1252                 }
1253
1254                 dead_session_purge(force_purge);
1255                 do_housekeeping();
1256         }
1257         /* If control reaches this point, the server is shutting down */
1258         return(NULL);
1259 }
1260
1261
1262
1263
1264 /*
1265  * SyslogFacility()
1266  * Translate text facility name to syslog.h defined value.
1267  */
1268 int SyslogFacility(char *name)
1269 {
1270         int i;
1271         struct
1272         {
1273                 int facility;
1274                 char *name;
1275         }   facTbl[] =
1276         {
1277                 {   LOG_KERN,   "kern"          },
1278                 {   LOG_USER,   "user"          },
1279                 {   LOG_MAIL,   "mail"          },
1280                 {   LOG_DAEMON, "daemon"        },
1281                 {   LOG_AUTH,   "auth"          },
1282                 {   LOG_SYSLOG, "syslog"        },
1283                 {   LOG_LPR,    "lpr"           },
1284                 {   LOG_NEWS,   "news"          },
1285                 {   LOG_UUCP,   "uucp"          },
1286                 {   LOG_LOCAL0, "local0"        },
1287                 {   LOG_LOCAL1, "local1"        },
1288                 {   LOG_LOCAL2, "local2"        },
1289                 {   LOG_LOCAL3, "local3"        },
1290                 {   LOG_LOCAL4, "local4"        },
1291                 {   LOG_LOCAL5, "local5"        },
1292                 {   LOG_LOCAL6, "local6"        },
1293                 {   LOG_LOCAL7, "local7"        },
1294                 {   0,            NULL          }
1295         };
1296         for(i = 0; facTbl[i].name != NULL; i++) {
1297                 if(!strcasecmp(name, facTbl[i].name))
1298                         return facTbl[i].facility;
1299         }
1300         enable_syslog = 0;
1301         return LOG_DAEMON;
1302 }
1303
1304
1305 /********** MEM CHEQQER ***********/
1306
1307 #ifdef DEBUG_MEMORY_LEAKS
1308
1309 #undef malloc
1310 #undef realloc
1311 #undef strdup
1312 #undef free
1313
1314 void *tracked_malloc(size_t size, char *file, int line) {
1315         struct igheap *thisheap;
1316         void *block;
1317
1318         block = malloc(size);
1319         if (block == NULL) return(block);
1320
1321         thisheap = malloc(sizeof(struct igheap));
1322         if (thisheap == NULL) {
1323                 free(block);
1324                 return(NULL);
1325         }
1326
1327         thisheap->block = block;
1328         strcpy(thisheap->file, file);
1329         thisheap->line = line;
1330
1331         begin_critical_section(S_DEBUGMEMLEAKS);
1332         thisheap->next = igheap;
1333         igheap = thisheap;
1334         end_critical_section(S_DEBUGMEMLEAKS);
1335
1336         return(block);
1337 }
1338
1339
1340 void *tracked_realloc(void *ptr, size_t size, char *file, int line) {
1341         struct igheap *thisheap;
1342         void *block;
1343
1344         block = realloc(ptr, size);
1345         if (block == NULL) return(block);
1346
1347         thisheap = malloc(sizeof(struct igheap));
1348         if (thisheap == NULL) {
1349                 free(block);
1350                 return(NULL);
1351         }
1352
1353         thisheap->block = block;
1354         strcpy(thisheap->file, file);
1355         thisheap->line = line;
1356
1357         begin_critical_section(S_DEBUGMEMLEAKS);
1358         thisheap->next = igheap;
1359         igheap = thisheap;
1360         end_critical_section(S_DEBUGMEMLEAKS);
1361
1362         return(block);
1363 }
1364
1365
1366
1367 void tracked_free(void *ptr) {
1368         struct igheap *thisheap;
1369         struct igheap *trash;
1370
1371         free(ptr);
1372
1373         if (igheap == NULL) return;
1374         begin_critical_section(S_DEBUGMEMLEAKS);
1375         for (thisheap = igheap; thisheap != NULL; thisheap = thisheap->next) {
1376                 if (thisheap->next != NULL) {
1377                         if (thisheap->next->block == ptr) {
1378                                 trash = thisheap->next;
1379                                 thisheap->next = thisheap->next->next;
1380                                 free(trash);
1381                         }
1382                 }
1383         }
1384         if (igheap->block == ptr) {
1385                 trash = igheap;
1386                 igheap = igheap->next;
1387                 free(trash);
1388         }
1389         end_critical_section(S_DEBUGMEMLEAKS);
1390 }
1391
1392 char *tracked_strdup(const char *s, char *file, int line) {
1393         char *ptr;
1394
1395         if (s == NULL) return(NULL);
1396         ptr = tracked_malloc(strlen(s) + 1, file, line);
1397         if (ptr == NULL) return(NULL);
1398         strncpy(ptr, s, strlen(s));
1399         return(ptr);
1400 }
1401
1402 void dump_heap(void) {
1403         struct igheap *thisheap;
1404
1405         for (thisheap = igheap; thisheap != NULL; thisheap = thisheap->next) {
1406                 CtdlLogPrintf(CTDL_CRIT, "UNFREED: %30s : %d\n",
1407                         thisheap->file, thisheap->line);
1408         }
1409 }
1410
1411 #endif /*  DEBUG_MEMORY_LEAKS */