httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From r..@locus.apache.org
Subject cvs commit: apache-2.0/src/modules/mpm/mpmt Makefile.in config.m4 mpm.h mpm_default.h mpmt.c scoreboard.c scoreboard.h
Date Fri, 07 Jul 2000 17:35:46 GMT
rbb         00/07/07 10:35:44

  Modified:    src/main mpm_common.c
               src/modules/mpm config.m4
  Added:       src/modules/mpm/mpmt Makefile.in config.m4 mpm.h
                        mpm_default.h mpmt.c scoreboard.c scoreboard.h
  Log:
  Initial version of the mpmt MPM.  This MPM can emulate dexter, mpmt_pthread,
  and prefork.  This basically just combines a lot of common code.  This
  builds and serves pages in all three modes, but I don't think killing
  the server works in any of them.  The configuration system hasn't changed
  at all, so using --with-mpm=(prefork|dexter|mpmt_pthread) all work.
  
  My goal is to remove the three separate MPMs in a few days, and then work
  on merging one of the BeOS and the OS/2 MPMs into this as well.  :-)
  
  Revision  Changes    Path
  1.18      +2 -2      apache-2.0/src/main/mpm_common.c
  
  Index: mpm_common.c
  ===================================================================
  RCS file: /home/cvs/apache-2.0/src/main/mpm_common.c,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- mpm_common.c	2000/06/22 18:28:06	1.17
  +++ mpm_common.c	2000/07/07 17:35:38	1.18
  @@ -78,10 +78,10 @@
   #include <sys/time.h> /* for timeval definitions */
   #endif
   
  -#if defined(DEXTER_MPM) || defined(MPMT_BEOS_MPM) || defined(BEOS_MPM)
  +#if defined(DEXTER) || defined(MPMT_BEOS_MPM) || defined(BEOS_MPM)
   #define CHILD_TABLE 1
   #define CHILD_INFO_TABLE     ap_child_table
  -#elif defined(MPMT_PTHREAD_MPM) || defined (PREFORK_MPM)
  +#elif defined(MPMT_PTHREAD) || defined (NO_THREADS)
   #define SCOREBOARD 1
   #define CHILD_INFO_TABLE     ap_scoreboard_image->parent
   #endif 
  
  
  
  1.18      +23 -2     apache-2.0/src/modules/mpm/config.m4
  
  Index: config.m4
  ===================================================================
  RCS file: /home/cvs/apache-2.0/src/modules/mpm/config.m4,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- config.m4	2000/06/12 17:04:39	1.17
  +++ config.m4	2000/07/07 17:35:41	1.18
  @@ -32,9 +32,30 @@
   APACHE_CHECK_SIGWAIT_ONE_ARG
   
   APACHE_FAST_OUTPUT(modules/mpm/Makefile)
  +
   MPM_NAME=$apache_cv_mpm
  -MPM_DIR=modules/mpm/$MPM_NAME
  -MPM_LIB=$MPM_DIR/lib${MPM_NAME}.la
  +if test "$MPM_NAME" = "prefork" ; then
  +    MPM_NAME="mpmt_pthread"
  +    EXTRA_CFLAGS="$EXTRA_CFLAGS -DNO_THREADS"
  +
  +    ac_cv_enable_threads="no"
  +    AC_CACHE_SAVE
  +fi
  +
  +if test "$MPM_NAME" = "mpmt_pthread" ; then
  +    EXTRA_CFLAGS="$EXTRA_CFLAGS -DMPMT_PTHREAD"
  +elif test "$MPM_NAME" = "dexter" ; then
  +    EXTRA_CFLAGS="$EXTRA_CFLAGS -DDEXTER"
  +fi
  +
  +if test "$MPM_NAME" = "dexter" -o "$MPM_NAME" = "mpmt_pthread"; then
  +    MPM_DIR=modules/mpm/mpmt;
  +    MPM_LIB=$MPM_DIR/libmpmt.la
  +    MPM_NAME="mpmt"
  +else
  +    MPM_DIR=modules/mpm/$MPM_NAME
  +    MPM_LIB=$MPM_DIR/lib${MPM_NAME}.la
  +fi
   
   APACHE_SUBST(MPM_NAME)
   MODLIST="$MODLIST mpm_${MPM_NAME}"
  
  
  
  1.1                  apache-2.0/src/modules/mpm/mpmt/Makefile.in
  
  Index: Makefile.in
  ===================================================================
  
  LTLIBRARY_NAME    = libmpmt.la
  LTLIBRARY_SOURCES = mpmt.c scoreboard.c
  
  include $(top_srcdir)/build/ltlib.mk
  
  
  
  1.1                  apache-2.0/src/modules/mpm/mpmt/config.m4
  
  Index: config.m4
  ===================================================================
  dnl ## XXX - Need a more thorough check of the proper flags to use
  
  if test "$MPM_NAME" = "mpmt_pthread" -o "$MPM_NAME" = "dexter" ; then
      ac_cv_enable_threads="yes"
      AC_CACHE_SAVE
  
      APACHE_FAST_OUTPUT(modules/mpm/mpmt/Makefile)
  
      APACHE_MPM_PTHREAD
  fi
  
  dnl Obsolete scoreboard code uses this.
      AC_CHECK_HEADERS(sys/times.h)
      AC_CHECK_FUNCS(times)
  
  
  
  1.1                  apache-2.0/src/modules/mpm/mpmt/mpm.h
  
  Index: mpm.h
  ===================================================================
  /* ====================================================================
   * The Apache Software License, Version 1.1
   *
   * Copyright (c) 2000 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Apache" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   *
   * Portions of this software are based upon public domain software
   * originally written at the National Center for Supercomputing Applications,
   * University of Illinois, Urbana-Champaign.
   */
  #include "scoreboard.h"
  #include "unixd.h"
  
  #ifndef APACHE_MPM_MPMT_H
  #define APACHE_MPM_MPMT_H
  
  #define MPMT_MPM
  
  #ifdef DEXTER
  /* Table of child status */
  #define SERVER_DEAD 0
  #define SERVER_DYING 1
  #define SERVER_ALIVE 2
  
  typedef struct ap_ctable{
      pid_t pid;
      unsigned char status;
  } ap_ctable;
  #endif
  
  #ifdef DEXTER
  /* variables only needed for dexter */
  extern ap_ctable ap_child_table[HARD_SERVER_LIMIT];
  #elif defined(MPMT_PTHREAD)
  /* variables only needed for mpmt_pthread */
  extern int ap_threads_per_child;
  extern int ap_max_requests_per_child;
  extern int ap_extended_status;
  extern unsigned int ap_my_pid;
  extern scoreboard *ap_scoreboard_image;
  #endif
  
  /* variables needed for ANY mpmt MPM */
  extern server_rec *ap_server_conf;
  extern int ap_max_daemons_limit;
  
  #endif /* APACHE_MPM_MPMT_PTHREAD_H */
  
  
  
  1.1                  apache-2.0/src/modules/mpm/mpmt/mpm_default.h
  
  Index: mpm_default.h
  ===================================================================
  /* ====================================================================
   * The Apache Software License, Version 1.1
   *
   * Copyright (c) 2000 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Apache" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   *
   * Portions of this software are based upon public domain software
   * originally written at the National Center for Supercomputing Applications,
   * University of Illinois, Urbana-Champaign.
   */
  
  #ifndef APACHE_MPM_DEFAULT_H
  #define APACHE_MPM_DEFAULT_H
  
  /* Number of servers to spawn off by default --- also, if fewer than
   * this free when the caretaker checks, it will spawn more.
   */
  #ifndef DEFAULT_START_DAEMON
  #if defined(DEXTER)
  #define DEFAULT_START_DAEMON 2
  
  /* In Dexter, we also have to know how many threads each server should
   * start by default.
   */
  
  #ifndef DEFAULT_START_THREAD
  #define DEFAULT_START_THREAD 5
  #endif
  
  #elif defined(MPMT_PTHREAD)
  #define DEFAULT_START_DAEMON 5
  #endif   /* defined MPMT_PTHREAD */
  #endif   /* ndef DEFAULT_START_DAEMON */
  
  /* Maximum number of *free* servers --- more than this, and
   * they will die off.
   */
  
  #ifndef DEFAULT_MAX_FREE_DAEMON
  #define DEFAULT_MAX_FREE_DAEMON 10
  #endif
  
  /* Minimum --- fewer than this, and more will be created */
  
  #ifndef DEFAULT_MIN_FREE_DAEMON
  #define DEFAULT_MIN_FREE_DAEMON 5
  #endif
  
  /* Limit on the total --- clients will be locked out if more servers than
   * this are needed.  It is intended solely to keep the server from crashing
   * when things get out of hand.
   *
   * We keep a hard maximum number of servers, for two reasons --- first off,
   * in case something goes seriously wrong, we want to stop the fork bomb
   * short of actually crashing the machine we're running on by filling some
   * kernel table.  Secondly, it keeps the size of the scoreboard file small
   * enough that we can read the whole thing without worrying too much about
   * the overhead.
   */
  #ifdef NO_THREADS
  #define HARD_SERVER_LIMIT 256
  #endif
  #ifndef HARD_SERVER_LIMIT
  #define HARD_SERVER_LIMIT 8 
  #endif
  
  /* Limit on the threads per process.  Clients will be locked out if more than
   * this  * HARD_SERVER_LIMIT are needed.
   *
   * We keep this for one reason it keeps the size of the scoreboard file small
   * enough that we can read the whole thing without worrying too much about
   * the overhead.
   */
  #ifdef NO_THREADS
  #define HARD_THREAD_LIMIT 1
  #endif
  #ifndef HARD_THREAD_LIMIT
  #define HARD_THREAD_LIMIT 64 
  #endif
  
  #ifdef NO_THREADS
  #define DEFAULT_THREADS_PER_CHILD 1
  #endif
  #ifndef DEFAULT_THREADS_PER_CHILD
  #define DEFAULT_THREADS_PER_CHILD 50
  #endif
  
  /* File used for accept locking, when we use a file */
  #ifndef DEFAULT_LOCKFILE
  #define DEFAULT_LOCKFILE "logs/accept.lock"
  #endif
  
  /* Scoreboard file, if there is one */
  #ifndef DEFAULT_SCOREBOARD
  #define DEFAULT_SCOREBOARD "logs/apache_runtime_status"
  #endif
  
  /* Where the main/parent process's pid is logged */
  #ifndef DEFAULT_PIDLOG
  #define DEFAULT_PIDLOG "logs/httpd.pid"
  #endif
  
  /*
   * Interval, in microseconds, between scoreboard maintenance.
   */
  #ifndef SCOREBOARD_MAINTENANCE_INTERVAL
  #define SCOREBOARD_MAINTENANCE_INTERVAL 1000000
  #endif
  
  /* Number of requests to try to handle in a single process.  If <= 0,
   * the children don't die off.
   */
  #ifndef DEFAULT_MAX_REQUESTS_PER_CHILD
  #define DEFAULT_MAX_REQUESTS_PER_CHILD 10000
  #endif
  
  #endif /* AP_MPM_DEFAULT_H */
  
  
  
  1.1                  apache-2.0/src/modules/mpm/mpmt/mpmt.c
  
  Index: mpmt.c
  ===================================================================
  /* ====================================================================
   * The Apache Software License, Version 1.1
   *
   * Copyright (c) 2000 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Apache" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   *
   * Portions of this software are based upon public domain software
   * originally written at the National Center for Supercomputing Applications,
   * University of Illinois, Urbana-Champaign.
   */
  
  #define CORE_PRIVATE 
   
  #include "apr_portable.h"
  #include "apr_file_io.h"
  #include "apr_thread_proc.h"
  #include "ap_config.h"
  #include "httpd.h" 
  #include "http_main.h" 
  #include "http_log.h" 
  #include "http_config.h"        /* for read_config */ 
  #include "http_core.h"                /* for get_remote_host */ 
  #include "http_connection.h"
  #include "ap_mpm.h"
  #include "unixd.h"
  #include "mpm_common.h"
  #include "iol_socket.h"
  #include "ap_listen.h"
  #include "scoreboard.h" 
  #include "mpm_default.h"
  #include "mpm.h" 
  
  #ifdef HAVE_UNISTD_H
  #include <unistd.h>
  #endif
  #ifdef HAVE_NETINET_TCP_H
  #include <netinet/tcp.h>
  #endif
  #ifdef HAVE_SYS_SOCKET_H
  #include <sys/socket.h>
  #endif
  #ifdef HAVE_SYS_WAIT_H
  #include <sys/wait.h> 
  #endif
  #include <pthread.h>
  #include <signal.h>
  
  /*
   * Actual definitions of config globals
   */
  
  #ifdef DEXTER
  static int max_threads = 0;
  struct ap_ctable ap_child_table[HARD_SERVER_LIMIT];
  #endif
  
  #ifndef DEXTER
  static time_t ap_restart_time = 0;
  API_VAR_EXPORT int ap_extended_status = 0;
  
  /* The structure used to pass unique initialization info to each thread */
  typedef struct {
      int pid;
      int tid;
      int sd;
      ap_pool_t *tpool; /* "pthread" would be confusing */
  } proc_info;
  #endif
  
  int ap_threads_per_child = 0; /* Worker threads per child started at startup */
  int ap_max_requests_per_child = 0;
  static const char *ap_pid_fname = NULL;
  API_VAR_EXPORT const char *ap_scoreboard_fname = NULL;
  static int ap_daemons_to_start = 0;
  static int min_spare_threads = 0;
  static int max_spare_threads = 0;
  static int workers_may_exit = 0;
  static int requests_this_child;
  static int num_listensocks = 0;
  static ap_socket_t **listensocks;
  
  /*
   * The max child slot ever assigned, preserved across restarts.  Necessary
   * to deal with MaxClients changes across SIGWINCH restarts.  We use this
   * value to optimize routines that have to scan the entire scoreboard.
   */
  int ap_max_daemons_limit = -1;
  
  static char ap_coredump_dir[MAX_STRING_LEN];
  
  static ap_file_t *pipe_of_death_in = NULL;
  static ap_file_t *pipe_of_death_out = NULL;
  static pthread_mutex_t pipe_of_death_mutex;
  
  /* *Non*-shared http_main globals... */
  
  server_rec *ap_server_conf;
  
  /* one_process --- debugging mode variable; can be set from the command line
   * with the -X flag.  If set, this gets you the child_main loop running
   * in the process which originally started up (no detach, no make_child),
   * which is a pretty nice debugging environment.  (You'll get a SIGHUP
   * early in standalone_main; just continue through.  This is the server
   * trying to kill off any child processes which it might have lying
   * around --- Apache doesn't keep track of their pids, it just sends
   * SIGHUP to the process group, ignoring it in the root process.
   * Continue through and you'll be fine.).
   */
  
  static int one_process = 0;
  
  #ifdef DEBUG_SIGSTOP
  int raise_sigstop_flags;
  #endif
  
  static ap_pool_t *pconf;                /* Pool for config stuff */
  static ap_pool_t *pchild;                /* Pool for httpd child stuff */
  
  #ifdef DEXTER
  static ap_pool_t *thread_pool_parent; /* Parent of per-thread pools */
  static pthread_mutex_t thread_pool_parent_mutex;
  #endif
  
  static int child_num;   /* This can be gotten rid of in time.  look for the 
                             the conn_rec stuff to see how.  rbb */
  
  unsigned int ap_my_pid; /* Linux getpid() doesn't work except in main 
                             thread. Use this instead */
  /* Keep track of the number of worker threads currently active */
  /* These could probably all go away too with a little work. */
  static int worker_thread_count;
  static pthread_mutex_t worker_thread_count_mutex;
  static pthread_attr_t worker_thread_attr;
  
  #ifdef DEXTER
  static int worker_thread_free_ids[HARD_THREAD_LIMIT];
  
  /* Keep track of the number of idle worker threads */
  static int idle_thread_count;
  static pthread_mutex_t idle_thread_count_mutex;
  #endif
  
  /* Locks for accept serialization */
  #ifdef NO_SERIALIZED_ACCEPT
  #define SAFE_ACCEPT(stmt) APR_SUCCESS
  #else
  #define SAFE_ACCEPT(stmt) (stmt)
  #endif
  static pthread_mutex_t thread_accept_mutex = PTHREAD_MUTEX_INITIALIZER;
  static ap_lock_t *process_accept_mutex;
  static const char *lock_fname;
  
  API_EXPORT(int) ap_get_max_daemons(void)
  {
      return ap_max_daemons_limit;
  }
  
  /* a clean exit from a child with proper cleanup */ 
  static void clean_child_exit(int code) __attribute__ ((noreturn));
  static void clean_child_exit(int code)
  {
      if (pchild) {
          ap_destroy_pool(pchild);
      }
      exit(code);
  }
  
  /* handle all varieties of core dumping signals */
  static void sig_coredump(int sig)
  {
      chdir(ap_coredump_dir);
      ap_signal(sig, SIG_DFL);
      kill(ap_my_pid, sig);
      /* At this point we've got sig blocked, because we're still inside
       * the signal handler.  When we leave the signal handler it will
       * be unblocked, and we'll take the signal... and coredump or whatever
       * is appropriate for this particular Unix.  In addition the parent
       * will see the real signal we received -- whereas if we called
       * abort() here, the parent would only see SIGABRT.
       */
  }
  
  static void just_die(int sig)
  {
      clean_child_exit(0);
  }
  
  /*****************************************************************
   * Connection structures and accounting...
   */
  
  /* volatile just in case */
  static int volatile shutdown_pending;
  static int volatile restart_pending;
  static int volatile is_graceful;
  #ifndef DEXTER
  ap_generation_t volatile ap_my_generation;
  #endif
  
  /*
   * ap_start_shutdown() and ap_start_restart(), below, are a first stab at
   * functions to initiate shutdown or restart without relying on signals. 
   * Previously this was initiated in sig_term() and restart() signal handlers, 
   * but we want to be able to start a shutdown/restart from other sources --
   * e.g. on Win32, from the service manager. Now the service manager can
   * call ap_start_shutdown() or ap_start_restart() as appropiate.  Note that
   * these functions can also be called by the child processes, since global
   * variables are no longer used to pass on the required action to the parent.
   *
   * These should only be called from the parent process itself, since the
   * parent process will use the shutdown_pending and restart_pending variables
   * to determine whether to shutdown or restart. The child process should
   * call signal_parent() directly to tell the parent to die -- this will
   * cause neither of those variable to be set, which the parent will
   * assume means something serious is wrong (which it will be, for the
   * child to force an exit) and so do an exit anyway.
   */
  
  void ap_start_shutdown(void)
  {
      if (shutdown_pending == 1) {
          /* Um, is this _probably_ not an error, if the user has
           * tried to do a shutdown twice quickly, so we won't
           * worry about reporting it.
           */
          return;
      }
      shutdown_pending = 1;
  }
  
  /* do a graceful restart if graceful == 1 */
  void ap_start_restart(int graceful)
  {
  
      if (restart_pending == 1) {
          /* Probably not an error - don't bother reporting it */
          return;
      }
      restart_pending = 1;
      is_graceful = graceful;
  }
  
  static void sig_term(int sig)
  {
      ap_start_shutdown();
  }
  
  static void restart(int sig)
  {
  #ifndef WIN32
      ap_start_restart(sig == SIGWINCH);
  #else
      ap_start_restart(1);
  #endif
  }
  
  static void set_signals(void)
  {
  #ifndef NO_USE_SIGACTION
      struct sigaction sa;
  
      sigemptyset(&sa.sa_mask);
      sa.sa_flags = 0;
  
      if (!one_process) {
          sa.sa_handler = sig_coredump;
  #if defined(SA_ONESHOT)
          sa.sa_flags = SA_ONESHOT;
  #elif defined(SA_RESETHAND)
          sa.sa_flags = SA_RESETHAND;
  #endif
          if (sigaction(SIGSEGV, &sa, NULL) < 0)
              ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGSEGV)");
  #ifdef SIGBUS
          if (sigaction(SIGBUS, &sa, NULL) < 0)
              ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGBUS)");
  #endif
  #ifdef SIGABORT
          if (sigaction(SIGABORT, &sa, NULL) < 0)
              ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGABORT)");
  #endif
  #ifdef SIGABRT
          if (sigaction(SIGABRT, &sa, NULL) < 0)
              ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGABRT)");
  #endif
  #ifdef SIGILL
          if (sigaction(SIGILL, &sa, NULL) < 0)
              ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGILL)");
  #endif
          sa.sa_flags = 0;
      }
      sa.sa_handler = sig_term;
      if (sigaction(SIGTERM, &sa, NULL) < 0)
          ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGTERM)");
  #ifdef SIGINT
      if (sigaction(SIGINT, &sa, NULL) < 0)
          ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGINT)");
  #endif
  #ifdef SIGXCPU
      sa.sa_handler = SIG_DFL;
      if (sigaction(SIGXCPU, &sa, NULL) < 0)
          ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGXCPU)");
  #endif
  #ifdef SIGXFSZ
      sa.sa_handler = SIG_DFL;
      if (sigaction(SIGXFSZ, &sa, NULL) < 0)
          ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGXFSZ)");
  #endif
  #ifdef SIGPIPE
      sa.sa_handler = SIG_IGN;
      if (sigaction(SIGPIPE, &sa, NULL) < 0)
          ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGPIPE)");
  #endif
  
      /* we want to ignore HUPs and WINCH while we're busy processing one */
      sigaddset(&sa.sa_mask, SIGHUP);
      sigaddset(&sa.sa_mask, SIGWINCH);
      sa.sa_handler = restart;
      if (sigaction(SIGHUP, &sa, NULL) < 0)
          ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGHUP)");
      if (sigaction(SIGWINCH, &sa, NULL) < 0)
          ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "sigaction(SIGWINCH)");
  #else
      if (!one_process) {
          ap_signal(SIGSEGV, sig_coredump);
  #ifdef SIGBUS
          ap_signal(SIGBUS, sig_coredump);
  #endif /* SIGBUS */
  #ifdef SIGABORT
          ap_signal(SIGABORT, sig_coredump);
  #endif /* SIGABORT */
  #ifdef SIGABRT
          ap_signal(SIGABRT, sig_coredump);
  #endif /* SIGABRT */
  #ifdef SIGILL
          ap_signal(SIGILL, sig_coredump);
  #endif /* SIGILL */
  #ifdef SIGXCPU
          ap_signal(SIGXCPU, SIG_DFL);
  #endif /* SIGXCPU */
  #ifdef SIGXFSZ
          ap_signal(SIGXFSZ, SIG_DFL);
  #endif /* SIGXFSZ */
      }
  
      ap_signal(SIGTERM, sig_term);
  #ifdef SIGHUP
      ap_signal(SIGHUP, restart);
  #endif /* SIGHUP */
  #ifdef SIGWINCH
      ap_signal(SIGWINCH, restart);
  #endif /* SIGWINCH */
  #ifdef SIGPIPE
      ap_signal(SIGPIPE, SIG_IGN);
  #endif /* SIGPIPE */
  
  #endif
  }
  
  static void process_child_status(ap_proc_t *pid, ap_wait_t status)
  {
      /* Child died... if it died due to a fatal error,
          * we should simply bail out.
          */
      if ((WIFEXITED(status)) &&
          WEXITSTATUS(status) == APEXIT_CHILDFATAL) {
          ap_log_error(APLOG_MARK, APLOG_ALERT|APLOG_NOERRNO, 0, ap_server_conf,
                          "Child %ld returned a Fatal error... \n"
                          "Apache is exiting!",
                          (long)pid->pid);
          exit(APEXIT_CHILDFATAL);
      }
      if (WIFSIGNALED(status)) {
          switch (WTERMSIG(status)) {
          case SIGTERM:
          case SIGHUP:
          case SIGUSR1:
          case SIGKILL:
              break;
          default:
  #ifdef SYS_SIGLIST
  #ifdef WCOREDUMP
              if (WCOREDUMP(status)) {
                  ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_NOTICE,
                               0, ap_server_conf,
                               "child pid %ld exit signal %s (%d), "
                               "possible coredump in %s",
                               (long)pid->pid, (WTERMSIG(status) >= NumSIG) ? "" :
                               SYS_SIGLIST[WTERMSIG(status)], WTERMSIG(status),
                               ap_coredump_dir);
              }
              else {
  #endif
                  ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_NOTICE,
                               0, ap_server_conf,
                               "child pid %ld exit signal %s (%d)", 
                               (long)pid->pid,
                               SYS_SIGLIST[WTERMSIG(status)], WTERMSIG(status));
  #ifdef WCOREDUMP
              }
  #endif
  #else
              ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_NOTICE,
                           0, ap_server_conf,
                           "child pid %ld exit signal %d",
                           (long)pid->pid, WTERMSIG(status));
  #endif
          }
      }
  }
  
  static int setup_listeners(server_rec *s)
  {
      ap_listen_rec *lr;
      int num_listeners = 0;
      if (ap_listen_open(s->process, s->port)) {
         return 0;
      }
      for (lr = ap_listeners; lr; lr = lr->next) {
          num_listeners++;
      }
      return num_listeners;
  }
  
  /*****************************************************************
   * Here follows a long bunch of generic server bookkeeping stuff...
   */
  
  #if defined(TCP_NODELAY) && !defined(MPE) && !defined(TPF)
  static void sock_disable_nagle(int s) 
  {
      /* The Nagle algorithm says that we should delay sending partial
       * packets in hopes of getting more data.  We don't want to do
       * this; we are not telnet.  There are bad interactions between
       * persistent connections and Nagle's algorithm that have very severe
       * performance penalties.  (Failing to disable Nagle is not much of a
       * problem with simple HTTP.)
       *
       * In spite of these problems, failure here is not a shooting offense.
       */
      int just_say_no = 1;
  
      if (setsockopt(s, IPPROTO_TCP, TCP_NODELAY, (char *) &just_say_no,
                     sizeof(int)) < 0) {
          ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf,
                      "setsockopt: (TCP_NODELAY)");
      }
  }
  
  #else
  #define sock_disable_nagle(s)        /* NOOP */
  #endif
  
  int ap_graceful_stop_signalled(void)
  {
      /* XXX - Does this really work? - Manoj */
      return is_graceful;
  }
  
  /*****************************************************************
   * Child process main loop.
   */
  
  static void process_socket(ap_pool_t *p, ap_socket_t *sock, long conn_id)
  {
      BUFF *conn_io;
      conn_rec *current_conn;
      ap_iol *iol;
      int csd;
      ap_status_t rv;
      int my_child_num = conn_id / HARD_THREAD_LIMIT;
      int my_thread_num = conn_id % HARD_THREAD_LIMIT;
  
      if ((rv = ap_get_os_sock(&csd, sock)) != APR_SUCCESS) {
          ap_log_error(APLOG_MARK, APLOG_ERR, rv, NULL, "ap_get_os_sock");
      }
  
      if (csd >= FD_SETSIZE) {
          ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_WARNING, 0, NULL,
                       "new file descriptor %d is too large; you probably need "
                       "to rebuild Apache with a larger FD_SETSIZE "
                       "(currently %d)", 
                       csd, FD_SETSIZE);
          ap_close_socket(sock);
          return;
      }
  
      sock_disable_nagle(csd);
  
      iol = ap_iol_attach_socket(p, sock);
  
  #ifndef DEXTER
      /* TODO -- scoreboard stuff that needs to be finished rbb */
      (void) ap_update_child_status(my_child_num, my_thread_num,  
                                    SERVER_BUSY_READ, (request_rec *) NULL);
  #endif
      conn_io = ap_bcreate(p, B_RDWR);
      ap_bpush_iol(conn_io, iol);
  
      current_conn = ap_new_apr_connection(p, ap_server_conf, conn_io, sock,
                                           conn_id);
  
      ap_process_connection(current_conn);
      ap_lingering_close(current_conn);
  }
  
  static void *worker_thread(void *);
  
  #ifdef DEXTER
  /* Starts a thread as long as we're below max_threads */
  static int start_thread(void)
  {
      pthread_t thread;
  
      pthread_mutex_lock(&worker_thread_count_mutex);
      if (worker_thread_count < max_threads) {
          if (pthread_create(&thread, &worker_thread_attr, worker_thread,
            &worker_thread_free_ids[worker_thread_count])) {
              ap_log_error(APLOG_MARK, APLOG_ALERT, errno, ap_server_conf,
                           "pthread_create: unable to create worker thread");
              /* In case system resources are maxxed out, we don't want
                 Apache running away with the CPU trying to fork over and
                 over and over again if we exit. */
              sleep(10);
              workers_may_exit = 1;
              pthread_mutex_unlock(&worker_thread_count_mutex);
              return 0;
          }
          else {
              worker_thread_count++;
          }
      }
      else {
          static int reported = 0;
  
          if (!reported) {
              ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, ap_server_conf,
                           "server reached MaxThreadsPerChild setting, consider raising the"
                           " MaxThreadsPerChild or NumServers settings");
              reported = 1;
          }
          pthread_mutex_unlock(&worker_thread_count_mutex);
          return 0;
      }
      pthread_mutex_unlock(&worker_thread_count_mutex);
      return 1;
  
  }
  #else
  /* Starts a thread as long as we're below max_threads */
  static int start_thread(void)
  {
      proc_info *my_info = NULL;
      pthread_t thread;
  
      my_info = (proc_info *)malloc(sizeof(proc_info));
      if (my_info == NULL) {
          ap_log_error(APLOG_MARK, APLOG_ALERT, errno, ap_server_conf,
                       "malloc: out of memory");
          clean_child_exit(APEXIT_CHILDFATAL);
      }
      my_info->pid = child_num;
      my_info->tid = worker_thread_count;
      my_info->sd = 0;
      ap_create_pool(&my_info->tpool, pchild);
  
      /* We are creating threads right now */
      (void) ap_update_child_status(child_num, worker_thread_count, 
                                    SERVER_STARTING, (request_rec *) NULL);
  #ifndef NO_THREADS
      if (pthread_create(&thread, &worker_thread_attr, worker_thread, my_info)) {
          ap_log_error(APLOG_MARK, APLOG_ALERT, errno, ap_server_conf,
                       "pthread_create: unable to create worker thread");
          /* In case system resources are maxxed out, we don't want
             Apache running away with the CPU trying to fork over and
             over and over again if we exit. */
          sleep(10);
         clean_child_exit(APEXIT_CHILDFATAL);
      }
  #else
      worker_thread(my_info);
      /* The SIGTERM shouldn't let us reach this point, but just in case... */
      clean_child_exit(APEXIT_OK);
  #endif
  
      /* We let each thread update it's own scoreboard entry.  This is done
       * because it let's us deal with tid better.
       */
  }
  #endif
  
  /* Sets workers_may_exit if we received a character on the pipe_of_death */
  static void check_pipe_of_death(void)
  {
      pthread_mutex_lock(&pipe_of_death_mutex);
      if (!workers_may_exit) {
          ap_status_t ret;
          char pipe_read_char;
          ap_ssize_t n = 1;
  
          ret = ap_recv(listensocks[0], &pipe_read_char, &n);
          if (ap_canonical_error(ret) == APR_EAGAIN) {
              /* It lost the lottery. It must continue to suffer
               * through a life of servitude. */
          }
          else {
              /* It won the lottery (or something else is very
               * wrong). Embrace death with open arms. */
              workers_may_exit = 1;
          }
      }
      pthread_mutex_unlock(&pipe_of_death_mutex);
  }
  
  #ifdef DEXTER
  /* idle_thread_count should be incremented before starting a worker_thread */
  
  static void *worker_thread(void *arg)
  {
      ap_socket_t *csd = NULL;
      ap_pool_t *tpool;           /* Pool for this thread           */
      ap_pool_t *ptrans;          /* Pool for per-transaction stuff */
      ap_socket_t *sd = NULL;
      int srv;
      int curr_pollfd, last_pollfd = 0;
      int thread_just_started = 1;
      int thread_num = *((int *) arg);
      long conn_id = child_num * HARD_THREAD_LIMIT + thread_num;
      ap_pollfd_t *pollset;
      int n;
      ap_status_t rv;
  
      pthread_mutex_lock(&thread_pool_parent_mutex);
      ap_create_pool(&tpool, thread_pool_parent);
      pthread_mutex_unlock(&thread_pool_parent_mutex);
      ap_create_pool(&ptrans, tpool);
  
      ap_setup_poll(&pollset, num_listensocks+1, tpool);
      for(n=0 ; n <= num_listensocks ; ++n)
          ap_add_poll_socket(pollset, listensocks[n], APR_POLLIN);
  
      while (!workers_may_exit) {
          workers_may_exit |= (ap_max_requests_per_child != 0) && (requests_this_child <= 0);
          if (workers_may_exit) break;
          if (!thread_just_started) {
              pthread_mutex_lock(&idle_thread_count_mutex);
              if (idle_thread_count < max_spare_threads) {
                  idle_thread_count++;
                  pthread_mutex_unlock(&idle_thread_count_mutex);
              }
              else {
                  pthread_mutex_unlock(&idle_thread_count_mutex);
                  break;
              }
          }
          else {
              thread_just_started = 0;
          }
          pthread_mutex_lock(&thread_accept_mutex);
          if (workers_may_exit) {
              pthread_mutex_unlock(&thread_accept_mutex);
              break;
          }                                                                               if ((rv = SAFE_ACCEPT(ap_lock(process_accept_mutex)))
              != APR_SUCCESS) {
              ap_log_error(APLOG_MARK, APLOG_EMERG, rv, ap_server_conf,
                           "ap_lock failed. Attempting to shutdown "
                           "process gracefully.");
              workers_may_exit = 1;
          }
  
          while (!workers_may_exit) {
              ap_int16_t event;
              srv = ap_poll(pollset, &n, -1);
  
              if (srv != APR_SUCCESS) {
                  if (ap_canonical_error(srv) == APR_EINTR) {
                      continue;
                  }
  
                  /* ap_poll() will only return errors in catastrophic
                   * circumstances. Let's try exiting gracefully, for now. */
                  ap_log_error(APLOG_MARK, APLOG_ERR, srv, (const server_rec *)
                               ap_server_conf, "ap_poll: (listen)");                              workers_may_exit = 1;
              }
              if (workers_may_exit) break;
  
              ap_get_revents(&event, listensocks[0], pollset);
              if (event & APR_POLLIN) {
                  /* A process got a signal on the shutdown pipe. Check if we're
                   * the lucky process to die. */
                  check_pipe_of_death();
                  continue;
              }
  
              if (num_listensocks == 1) {
                  sd = ap_listeners->sd;
                  goto got_fd;
              }
              else {
                  /* find a listener */
                  curr_pollfd = last_pollfd;
                  do {
                      curr_pollfd++;                                                                  if (curr_pollfd > num_listensocks) {
                          curr_pollfd = 1;
                      }
                      /* XXX: Should we check for POLLERR? */
                      ap_get_revents(&event, listensocks[curr_pollfd], pollset);
                      if (event & APR_POLLIN) {
                          last_pollfd = curr_pollfd;
                          sd = listensocks[curr_pollfd];
                          goto got_fd;
                      }
                  } while (curr_pollfd != last_pollfd);
              }
          }
      got_fd:
          if (!workers_may_exit) {
              if ((rv = ap_accept(&csd, sd, ptrans)) != APR_SUCCESS) {
                  ap_log_error(APLOG_MARK, APLOG_ERR, rv, ap_server_conf, "ap_accept");
              }
              if ((rv = SAFE_ACCEPT(ap_unlock(process_accept_mutex)))
                  != APR_SUCCESS) {                                                               ap_log_error(APLOG_MARK, APLOG_EMERG, rv, ap_server_conf,
                               "ap_unlock failed. Attempting to shutdown "
                               "process gracefully.");
                  workers_may_exit = 1;
              }
              pthread_mutex_unlock(&thread_accept_mutex);
              pthread_mutex_lock(&idle_thread_count_mutex);
              if (idle_thread_count > min_spare_threads) {
                  idle_thread_count--;
              }
              else {
                  if (!start_thread()) {
                      idle_thread_count--;
                  }
              }
              pthread_mutex_unlock(&idle_thread_count_mutex);
              process_socket(ptrans, csd, conn_id);                                           requests_this_child--;
          } else {
              if ((rv = SAFE_ACCEPT(ap_unlock(process_accept_mutex)))
                  != APR_SUCCESS) {                                                               ap_log_error(APLOG_MARK, APLOG_EMERG, rv, ap_server_conf,
                               "ap_unlock failed. Attempting to shutdown "
                               "process gracefully.");
                  workers_may_exit = 1;
              }
              pthread_mutex_unlock(&thread_accept_mutex);
              pthread_mutex_lock(&idle_thread_count_mutex);
              idle_thread_count--;
              pthread_mutex_unlock(&idle_thread_count_mutex);
              break;
          }
          ap_clear_pool(ptrans);
      }
  
      pthread_mutex_lock(&thread_pool_parent_mutex);
      ap_destroy_pool(tpool);
      pthread_mutex_unlock(&thread_pool_parent_mutex);
      pthread_mutex_lock(&worker_thread_count_mutex);
      worker_thread_count--;
      worker_thread_free_ids[worker_thread_count] = thread_num;
      if (worker_thread_count == 0) {                                                     /* All the threads have exited, now finish the shutdown process
           * by signalling the sigwait thread */
          kill(ap_my_pid, SIGTERM);
      }
      pthread_mutex_unlock(&worker_thread_count_mutex);
  
      return NULL;
  }
  #else
  static void * worker_thread(void * dummy)
  {
      proc_info * ti = dummy;
      int process_slot = ti->pid;
      int thread_slot = ti->tid;
      ap_pool_t *tpool = ti->tpool;
      ap_socket_t *csd = NULL;
      ap_pool_t *ptrans;                /* Pool for per-transaction stuff */
      ap_socket_t *sd = NULL;
      int n;
      int curr_pollfd, last_pollfd = 0;
      ap_pollfd_t *pollset;
      ap_status_t rv;
  
      free(ti);
  
      ap_create_pool(&ptrans, tpool);
  
      pthread_mutex_lock(&worker_thread_count_mutex);
      worker_thread_count++;
      pthread_mutex_unlock(&worker_thread_count_mutex);
  
      ap_setup_poll(&pollset, num_listensocks+1, tpool);
      for(n=0 ; n <= num_listensocks ; ++n)
          ap_add_poll_socket(pollset, listensocks[n], APR_POLLIN);
  
      /* TODO: Switch to a system where threads reuse the results from earlier
         poll calls - manoj */
      while (!workers_may_exit) {
          workers_may_exit |= (ap_max_requests_per_child != 0) && (requests_this_child <= 0);
          if (workers_may_exit) break;
  
          (void) ap_update_child_status(process_slot, thread_slot, SERVER_READY, 
                                        (request_rec *) NULL);
          pthread_mutex_lock(&thread_accept_mutex);
          if (workers_may_exit) {
              pthread_mutex_unlock(&thread_accept_mutex);
              break;
          }
          if ((rv = SAFE_ACCEPT(ap_lock(process_accept_mutex)))
              != APR_SUCCESS) {
              ap_log_error(APLOG_MARK, APLOG_EMERG, rv, ap_server_conf,
                           "ap_lock failed. Attempting to shutdown "
                           "process gracefully.");
              workers_may_exit = 1;
          }
  
          while (!workers_may_exit) {
              ap_status_t ret;
              ap_int16_t event;
  
              ret = ap_poll(pollset, &n, -1);
              if (ret != APR_SUCCESS) {
                  if (ap_canonical_error(ret) == APR_EINTR) {
                      continue;
                  }
  
                  /* ap_poll() will only return errors in catastrophic
                   * circumstances. Let's try exiting gracefully, for now. */
                  ap_log_error(APLOG_MARK, APLOG_ERR, ret, (const server_rec *)
                               ap_server_conf, "ap_poll: (listen)");
                  workers_may_exit = 1;
              }
  
              if (workers_may_exit) break;
  
              ap_get_revents(&event, listensocks[0], pollset);
              if (event & APR_POLLIN) {
                  /* A process got a signal on the shutdown pipe. Check if we're
                   * the lucky process to die. */
                  check_pipe_of_death();
                  continue;
              }
  
              if (num_listensocks == 1) {
                  sd = ap_listeners->sd;
                  goto got_fd;
              }
              else {
                  /* find a listener */
                  curr_pollfd = last_pollfd;
                  do {
                      curr_pollfd++;
                      if (curr_pollfd > num_listensocks) {
                          curr_pollfd = 1;
                      }
                      /* XXX: Should we check for POLLERR? */
                      ap_get_revents(&event, listensocks[curr_pollfd], pollset);
                      if (event & APR_POLLIN) {
                          last_pollfd = curr_pollfd;
                          sd=listensocks[curr_pollfd];
                          goto got_fd;
                      }
                  } while (curr_pollfd != last_pollfd);
              }
          }
      got_fd:
          if (!workers_may_exit) {
              if ((rv = ap_accept(&csd, sd, ptrans)) != APR_SUCCESS) {
                  ap_log_error(APLOG_MARK, APLOG_ERR, rv, ap_server_conf, 
                               "ap_accept");
              }
              if ((rv = SAFE_ACCEPT(ap_unlock(process_accept_mutex)))
                  != APR_SUCCESS) {
                  ap_log_error(APLOG_MARK, APLOG_EMERG, rv, ap_server_conf,
                               "ap_unlock failed. Attempting to shutdown "
                               "process gracefully.");
                  workers_may_exit = 1;
              }
              pthread_mutex_unlock(&thread_accept_mutex);
              process_socket(ptrans, csd, process_slot * HARD_THREAD_LIMIT + thread_slot);
              requests_this_child--;
          }
          else {
              if ((rv = SAFE_ACCEPT(ap_unlock(process_accept_mutex)))
                  != APR_SUCCESS) {
                  ap_log_error(APLOG_MARK, APLOG_EMERG, rv, ap_server_conf,
                               "ap_unlock failed. Attempting to shutdown "
                               "process gracefully.");
                  workers_may_exit = 1;
              }
              pthread_mutex_unlock(&thread_accept_mutex);
              break;
          }
          ap_clear_pool(ptrans);
      }
  
      ap_destroy_pool(tpool);
      ap_update_child_status(process_slot, thread_slot, SERVER_DEAD,
          (request_rec *) NULL);
      pthread_mutex_lock(&worker_thread_count_mutex);
      worker_thread_count--;
      if (worker_thread_count == 0) {
          /* All the threads have exited, now finish the shutdown process
           * by signalling the sigwait thread */
          kill(ap_my_pid, SIGTERM);
      }
      pthread_mutex_unlock(&worker_thread_count_mutex);
  
      return NULL;
  }
  #endif
  
  static void child_main(int child_num_arg)
  {
      sigset_t sig_mask;
      int signal_received;
      int i;
      ap_listen_rec *lr;
      ap_status_t rv;
  
  
      ap_my_pid = getpid();
      child_num = child_num_arg;
      ap_create_pool(&pchild, pconf);
  
      /*stuff to do before we switch id's, so we have permissions.*/
  #ifndef DEXTER
      reopen_scoreboard(pchild);
  #endif
      rv = SAFE_ACCEPT(ap_child_init_lock(&process_accept_mutex, lock_fname,
                       pchild));
      if (rv != APR_SUCCESS) {
          ap_log_error(APLOG_MARK, APLOG_EMERG, rv, ap_server_conf,
                       "Couldn't initialize cross-process lock in child");
          clean_child_exit(APEXIT_CHILDFATAL);
      }
  
      if (unixd_setup_child()) {
          clean_child_exit(APEXIT_CHILDFATAL);
      }
  
      ap_child_init_hook(pchild, ap_server_conf);
  
      /*done with init critical section */
  
      /* All threads should mask signals out, accoring to sigwait(2) man page */
      sigfillset(&sig_mask);
  
  #if defined(SIGPROCMASK_SETS_THREAD_MASK) || defined (NO_THREADS)
      if (sigprocmask(SIG_SETMASK, &sig_mask, NULL) != 0) {
          ap_log_error(APLOG_MARK, APLOG_ALERT, errno, ap_server_conf, "sigprocmask");
      }
  #else
      if (pthread_sigmask(SIG_SETMASK, &sig_mask, NULL) != 0) {
          ap_log_error(APLOG_MARK, APLOG_ALERT, errno, ap_server_conf, "pthread_sigmask");
      }
  #endif
  
      requests_this_child = ap_max_requests_per_child;
      
      /* Set up the pollfd array */
      listensocks = ap_pcalloc(pchild,
                              sizeof(*listensocks) * (num_listensocks + 1));
  #if APR_FILES_AS_SOCKETS
      ap_socket_from_file(&listensocks[0], pipe_of_death_in);
  #endif
      for (lr = ap_listeners, i = 1; i <= num_listensocks; lr = lr->next, ++i)
          listensocks[i]=lr->sd;
  
      /* Setup worker threads */
  #ifdef DEXTER
      if (ap_threads_per_child > max_threads) {
          ap_threads_per_child = max_threads;
      }
      idle_thread_count = ap_threads_per_child;
  
      for (i = 0; i < max_threads; i++) {
          worker_thread_free_ids[i] = i;
      }
      ap_create_pool(&thread_pool_parent, pchild);
      pthread_mutex_init(&thread_pool_parent_mutex, NULL);
      pthread_mutex_init(&idle_thread_count_mutex, NULL);
  #endif
      worker_thread_count = 0;
      pthread_mutex_init(&worker_thread_count_mutex, NULL);
      pthread_mutex_init(&pipe_of_death_mutex, NULL);
      pthread_attr_init(&worker_thread_attr);
  #ifdef PTHREAD_ATTR_SETDETACHSTATE_ARG2_ADDR
      {
          int on = 1;
  
          pthread_attr_setdetachstate(&worer_thread_attr, &on);
      }
  #else
      pthread_attr_setdetachstate(&worker_thread_attr, PTHREAD_CREATE_DETACHED);
  #endif
      for (i=0; i < ap_threads_per_child; i++) {
          /* start_thread shouldn't fail here */
          if (!start_thread()) {
              break;
          }
      }
  #ifndef DEXTER
      pthread_attr_destroy(&worker_thread_attr);
  #endif
      /* This thread will be the one responsible for handling signals */
      sigemptyset(&sig_mask);
      sigaddset(&sig_mask, SIGTERM);
      sigaddset(&sig_mask, SIGINT);
      ap_sigwait(&sig_mask, &signal_received);
      switch (signal_received) {
          case SIGTERM:
          case SIGINT:
              just_die(signal_received);
              break;
          default:
              ap_log_error(APLOG_MARK, APLOG_ALERT, errno, ap_server_conf,
              "received impossible signal: %d", signal_received);
              just_die(SIGTERM);
      }
  }
  
  static int make_child(server_rec *s, int slot, time_t now) 
  {
      int pid;
  
      if (slot + 1 > ap_max_daemons_limit) {
          ap_max_daemons_limit = slot + 1;
      }
  
      if (one_process) {
          set_signals();
  #ifdef DEXTER
          /* TODO scoreboard stuff -- rbb */
          ap_child_table[slot].pid = getpid();
          ap_child_table[slot].status = SERVER_ALIVE;
  #else
          ap_scoreboard_image->parent[slot].pid = getpid();
  #endif
          child_main(slot);
      }
  
  #ifndef DEXTER
          /* TODO scoreboard stuff -- rbb */
      /* Tag this slot as occupied so that perform_idle_server_maintenance
       * doesn't try to steal it */
      (void) ap_update_child_status(slot, 0, SERVER_STARTING, (request_rec *) NULL);
  #endif
  
      if ((pid = fork()) == -1) {
          ap_log_error(APLOG_MARK, APLOG_ERR, errno, s, "fork: Unable to fork new process");
  
  #ifndef DEXTER
          /* TODO scoreboard stuff -- rbb */
  
          /* fork didn't succeed. Fix the scoreboard or else
           * it will say SERVER_STARTING forever and ever
           */
          (void) ap_update_child_status(slot, 0, SERVER_DEAD, (request_rec *) NULL);
  #endif
  
          /* In case system resources are maxxed out, we don't want
           *  Apache running away with the CPU trying to fork over and
           *  over and over again.
           */
          sleep(10);
  
          return -1;
      }
  
      if (!pid) {
  #ifdef AIX_BIND_PROCESSOR
        /* By default, AIX binds to a single processor.  This bit unbinds
           children which will then bind to another CPU.
        */
  #include <sys/processor.h>
          int status = bindprocessor(BINDPROCESS, (int)getpid(),
                                 PROCESSOR_CLASS_ANY);
          if (status != OK)
              ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_WARNING, 
                           ap_server_conf, "processor unbind failed %d", status);
  #endif
  
          RAISE_SIGSTOP(MAKE_CHILD);
  
  #ifndef DEXTER
          /* TODO:  This needs to be seriously looked into */
          ap_signal(SIGTERM, just_die);
  #endif
          child_main(slot);
  
          return 0;
      }
      /* else */
  #ifdef DEXTER
          /* TODO scoreboard stuff -- rbb */
      ap_child_table[slot].pid = pid;
      ap_child_table[slot].status = SERVER_ALIVE;
  #else
      ap_scoreboard_image->parent[slot].pid = pid;
  #endif
      return 0;
  }
  
  /* start up a bunch of children */
  #ifdef DEXTER
  static int startup_children(int number_to_start)
  #else
  static void startup_children(int number_to_start)
  #endif
  {
      int i;
  
      for (i = 0; number_to_start && i < ap_daemons_to_start; ++i) {
  #ifdef DEXTER
          /* TODO:  scoreboard stuff -- rbb */
          if (ap_child_table[i].status != SERVER_DEAD) {
  #else
          if (ap_scoreboard_image->parent[i].pid != 0) {
  #endif
              continue;
          }
          if (make_child(ap_server_conf, i, 0) < 0) {
              break;
          }
          --number_to_start;
      }
  #ifdef DEXTER
      return number_to_start;
  #endif
  }
  
  /*
   * idle_spawn_rate is the number of children that will be spawned on the
   * next maintenance cycle if there aren't enough idle servers.  It is
   * doubled up to MAX_SPAWN_RATE, and reset only when a cycle goes by
   * without the need to spawn.
   */
  static int idle_spawn_rate = 1;
  #ifndef MAX_SPAWN_RATE
  #define MAX_SPAWN_RATE        (32)
  #endif
  static int hold_off_on_exponential_spawning;
  
  #ifdef DEXTER
  static void perform_idle_server_maintenance(void)
  {
      int i;
      time_t now = 0;
      int free_length;
      int free_slots[MAX_SPAWN_RATE];
      int last_non_dead = -1;
  
      /* initialize the free_list */
      free_length = 0;
  
      for (i = 0; i < ap_daemons_to_start; ++i) {
          if (ap_child_table[i].status == SERVER_DEAD) {
              if (free_length < idle_spawn_rate) {
                  free_slots[free_length] = i;
                  ++free_length;
              }
          }
          else {
              last_non_dead = i;
          }
  
          if (i >= ap_max_daemons_limit && free_length >= idle_spawn_rate) {
              break;
          }
      }
      ap_max_daemons_limit = last_non_dead + 1;
  
      if (free_length > 0) {
          for (i = 0; i < free_length; ++i) {
              make_child(ap_server_conf, free_slots[i], now);
          }
          /* the next time around we want to spawn twice as many if this
           * wasn't good enough, but not if we've just done a graceful
           */
          if (hold_off_on_exponential_spawning) {
              --hold_off_on_exponential_spawning;
          }
          else if (idle_spawn_rate < MAX_SPAWN_RATE) {
              idle_spawn_rate *= 2;
          }
      }
      else {
          idle_spawn_rate = 1;
      }
  }
  #else
  static void perform_idle_server_maintenance(void)
  {
      int i, j;
      int idle_thread_count;
      thread_score *ss;
      time_t now = 0;
      int free_length;
      int free_slots[MAX_SPAWN_RATE];
      int last_non_dead;
      int total_non_dead;
      ap_ssize_t one = 1;
      ap_status_t rv;
  
      /* initialize the free_list */
      free_length = 0;
  
      idle_thread_count = 0;
      last_non_dead = -1;
      total_non_dead = 0;
  
      ap_sync_scoreboard_image();
      for (i = 0; i < ap_max_daemons_limit; ++i) {
          /* Initialization to satisfy the compiler. It doesn't know
           * that ap_threads_per_child is always > 0 */
          int status = SERVER_DEAD;
          int any_dying_threads = 0;
          int all_dead_threads = 1;
          int idle_thread_addition = 0;
  
          if (i >= ap_max_daemons_limit && free_length == idle_spawn_rate)
              break;
          for (j = 0; j < ap_threads_per_child; j++) {
              ss = &ap_scoreboard_image->servers[i][j];
              status = ss->status;
  
              any_dying_threads = any_dying_threads || (status == SERVER_DEAD)
                                      || (status == SERVER_GRACEFUL);
              all_dead_threads = all_dead_threads && (status == SERVER_DEAD);
  
              /* We consider a starting server as idle because we started it
               * at least a cycle ago, and if it still hasn't finished starting
               * then we're just going to swamp things worse by forking more.
               * So we hopefully won't need to fork more if we count it.
               * This depends on the ordering of SERVER_READY and SERVER_STARTING.
               */
              if (status <= SERVER_READY) {
                  ++idle_thread_addition;
              }
          }
          if (all_dead_threads && free_length < idle_spawn_rate) {
              free_slots[free_length] = i;
              ++free_length;
          }
          if (!all_dead_threads) {
              last_non_dead = i;
          }
          if (!any_dying_threads) {
              ++total_non_dead;
              idle_thread_count += idle_thread_addition;
          }
      }
      ap_max_daemons_limit = last_non_dead + 1;
  
      if (idle_thread_count > max_spare_threads) {
          /* Kill off one child */
          char char_of_death = '!';
          if ((rv = ap_write(pipe_of_death_out, &char_of_death, &one)) != APR_SUCCESS) {
              ap_log_error(APLOG_MARK, APLOG_WARNING, rv, ap_server_conf, "write pipe_of_death");
          }
          idle_spawn_rate = 1;
      }
      else if (idle_thread_count < min_spare_threads) {
          /* terminate the free list */
          if (free_length == 0) {
              /* only report this condition once */
              static int reported = 0;
              
              if (!reported) {
                  ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_ERR, 0, ap_server_conf,
                               "server reached MaxClients setting, consider"
                               " raising the MaxClients setting");
                  reported = 1;
              }
              idle_spawn_rate = 1;
          }
          else {
              
              if (idle_spawn_rate >= 8) {
                  ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_INFO, 0, ap_server_conf,
                               "server seems busy, (you may need "
                               "to increase StartServers, ThreadsPerChild "
                               "or Min/MaxSparetThreads), "
                               "spawning %d children, there are around %d idle "
                               "threads, and %d total children", idle_spawn_rate,
                               idle_thread_count, total_non_dead);
              }
              for (i = 0; i < free_length; ++i) {
                  make_child(ap_server_conf, free_slots[i], now);
              }
              /* the next time around we want to spawn twice as many if this
               * wasn't good enough, but not if we've just done a graceful
               */
              if (hold_off_on_exponential_spawning) {
                  --hold_off_on_exponential_spawning;
              }
              else if (idle_spawn_rate < MAX_SPAWN_RATE) {
                  idle_spawn_rate *= 2;
              }
          }
      }
      else {
        idle_spawn_rate = 1;
      }
  }
  #endif
  
  static void server_main_loop(int remaining_children_to_start)
  {
      int child_slot;
      ap_wait_t status;
      ap_proc_t pid;
      int i;
  
      while (!restart_pending && !shutdown_pending) {
          ap_wait_or_timeout(&status, &pid, pconf);
          
          if (pid.pid != -1) {
              process_child_status(&pid, status);
  #ifdef DEXTER
          /* TODO:  scoreboard stuff -- rbb */
              /* non-fatal death... note that it's gone in the child table and
               * clean out the status table. */
              child_slot = -1;
              for (i = 0; i < ap_max_daemons_limit; ++i) {
                  if (ap_child_table[i].pid == pid.pid) {
                      int j;
  
                      child_slot = i;
                      for (j = 0; j < HARD_THREAD_LIMIT; j++) {
                          ap_dexter_force_reset_connection_status(i * HARD_THREAD_LIMIT + j);
                      }
                      break;
                  }
              }
              if (child_slot >= 0) {
                  ap_child_table[child_slot].status = SERVER_DEAD;
  #else
              /* non-fatal death... note that it's gone in the scoreboard. */
              child_slot = find_child_by_pid(&pid);
              if (child_slot >= 0) {
                  ap_mpmt_pthread_force_reset_connection_status(child_slot);
                  for (i = 0; i < ap_threads_per_child; i++)
                      ap_update_child_status(child_slot, i, SERVER_DEAD, (request_rec *) NULL);
  #endif
                  
                  if (remaining_children_to_start
  #ifdef DEXTER
                      && child_slot < ap_daemons_to_start) {
  #else
                      && child_slot < ap_max_daemons_limit) {
  #endif
                      /* we're still doing a 1-for-1 replacement of dead
                       * children with new children
                       */
                      make_child(ap_server_conf, child_slot, time(NULL));
                      --remaining_children_to_start;
                  }
  #ifdef APR_HAS_OTHER_CHILD
              }
              else if (ap_reap_other_child(&pid, status) == 0) {
                  /* handled */
  #endif
              }
              else if (is_graceful) {
                  /* Great, we've probably just lost a slot in the
                   * scoreboard.  Somehow we don't know about this child.
                   */
                  ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_WARNING, 0,
                               ap_server_conf,
                               "long lost child came home! (pid %ld)",
                               (long)pid.pid);
              }
              /* Don't perform idle maintenance when a child dies,
               * only do it when there's a timeout.  Remember only a
               * finite number of children can die, and it's pretty
               * pathological for a lot to die suddenly.
               */
              continue;
          }
          else if (remaining_children_to_start) {
              /* we hit a 1 second timeout in which none of the previous
               * generation of children needed to be reaped... so assume
               * they're all done, and pick up the slack if any is left.
               */
  #ifdef DEXTER
              remaining_children_to_start = \
                  startup_children(remaining_children_to_start);
  #else
              startup_children(remaining_children_to_start);
              remaining_children_to_start = 0;
  #endif
              /* In any event we really shouldn't do the code below because
               * few of the servers we just started are in the IDLE state
               * yet, so we'd mistakenly create an extra server.
               */
              continue;
          }
  
          perform_idle_server_maintenance();
      }
  }
  
  int ap_mpm_run(ap_pool_t *_pconf, ap_pool_t *plog, server_rec *s)
  {
      int remaining_children_to_start;
      ap_status_t rv;
      ap_ssize_t one = 1;
      int i;
  
      pconf = _pconf;
      ap_server_conf = s;
      rv = ap_create_pipe(&pipe_of_death_in, &pipe_of_death_out, pconf);
      if (rv != APR_SUCCESS) {
          ap_log_error(APLOG_MARK, APLOG_ERR, rv,
                       (const server_rec*) ap_server_conf,
                       "ap_create_pipe (pipe_of_death)");
          exit(1);
      }
  
      if ((rv = ap_set_pipe_timeout(pipe_of_death_in, 0)) != APR_SUCCESS) {
          ap_log_error(APLOG_MARK, APLOG_ERR, rv,
                       (const server_rec*) ap_server_conf,
                       "ap_set_pipe_timeout (pipe_of_death)");
          exit(1);
      }
      ap_server_conf = s;
      if ((num_listensocks = setup_listeners(ap_server_conf)) < 1) {
          /* XXX: hey, what's the right way for the mpm to indicate a fatal error? */
          ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_ALERT, 0, s,
              "no listening sockets available, shutting down");
          return 1;
      }
      ap_log_pid(pconf, ap_pid_fname);
  
      /* Initialize cross-process accept lock */
      lock_fname = ap_psprintf(_pconf, "%s.%u",
                               ap_server_root_relative(_pconf, lock_fname),
                               ap_my_pid);
      rv = ap_create_lock(&process_accept_mutex, APR_MUTEX, APR_CROSS_PROCESS,
                     lock_fname, _pconf);
      if (rv != APR_SUCCESS) {
          ap_log_error(APLOG_MARK, APLOG_EMERG, rv, s,
                       "Couldn't create cross-process lock");
          return 1;
      }
  
  
      if (!is_graceful) {
          reinit_scoreboard(pconf);
      }
  #ifdef DEXTER
      /* TODO:  scoreboard stuff -- rbb */
      /* Initialize the child table */
      if (!is_graceful) {
          for (i = 0; i < HARD_SERVER_LIMIT; i++) {
              ap_child_table[i].status = SERVER_DEAD;
          }
      }
  #endif
  
      set_signals();
      /* Don't thrash... */
  #ifndef DEXTER
      if (max_spare_threads < min_spare_threads + ap_threads_per_child)
          max_spare_threads = min_spare_threads + ap_threads_per_child;
  #endif
      /* If we're doing a graceful_restart then we're going to see a lot
       * of children exiting immediately when we get into the main loop
       * below (because we just sent them SIGWINCH).  This happens pretty
       * rapidly... and for each one that exits we'll start a new one until
       * we reach at least daemons_min_free.  But we may be permitted to
       * start more than that, so we'll just keep track of how many we're
       * supposed to start up without the 1 second penalty between each fork.
       */
      remaining_children_to_start = ap_daemons_to_start;
  #ifndef DEXTER
      if (remaining_children_to_start > ap_max_daemons_limit) {
          remaining_children_to_start = ap_max_daemons_limit;
      }
  #endif
      if (!is_graceful) {
  #ifdef DEXTER
          remaining_children_to_start = \
              startup_children(remaining_children_to_start);
  #else
          startup_children(remaining_children_to_start);
          remaining_children_to_start = 0;
  #endif
      }
      else {
          /* give the system some time to recover before kicking into
              * exponential mode */
          hold_off_on_exponential_spawning = 10;
      }
  
      ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_NOTICE, 0, ap_server_conf,
                  "%s configured -- resuming normal operations",
                  ap_get_server_version());
      ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_INFO, 0, ap_server_conf,
                  "Server built: %s", ap_get_server_built());
      restart_pending = shutdown_pending = 0;
  
      server_main_loop(remaining_children_to_start);
  
      if (shutdown_pending) {
          /* Time to gracefully shut down:
           * Kill child processes, tell them to call child_exit, etc...
           */
          if (unixd_killpg(getpgrp(), SIGTERM) < 0) {
              ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "killpg SIGTERM");
          }
          ap_reclaim_child_processes(1);                /* Start with SIGTERM */
      
          /* cleanup pid file on normal shutdown */
          {
              const char *pidfile = NULL;
              pidfile = ap_server_root_relative (pconf, ap_pid_fname);
              if ( pidfile != NULL && unlink(pidfile) == 0)
                  ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_INFO, 0,
                               ap_server_conf,
                               "removed PID file %s (pid=%ld)",
                               pidfile, (long)getpid());
          }
      
          ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_NOTICE, 0, ap_server_conf,
              "caught SIGTERM, shutting down");
      
          return 1;
      }
  
      /* we've been told to restart */
      ap_signal(SIGHUP, SIG_IGN);
  
      if (one_process) {
          /* not worth thinking about */
          return 1;
      }
  
  #ifndef DEXTER
      /* advance to the next generation */
      /* XXX: we really need to make sure this new generation number isn't in
       * use by any of the children.
       */
      ++ap_my_generation;
      ap_scoreboard_image->global.running_generation = ap_my_generation;
      update_scoreboard_global();
  #endif
  
      if (is_graceful) {
  #ifndef DEXTER
          int j;
  #endif
          char char_of_death = '!';
  
          ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_NOTICE, 0, ap_server_conf,
                      "SIGWINCH received.  Doing graceful restart");
  
  
          /* This is mostly for debugging... so that we know what is still
           * gracefully dealing with existing request.
           */
          
  #ifdef DEXTER
          for (i = 0; i < ap_daemons_to_start; ++i) {
              if (ap_child_table[i].status != SERVER_DEAD) {
                  ap_child_table[i].status = SERVER_DYING;
              }
          }
  #else
          for (i = 0; i < ap_max_daemons_limit; ++i) {
                for (j = 0; j < ap_threads_per_child; j++) { 
                  if (ap_scoreboard_image->servers[i][j].status != SERVER_DEAD) {
                      ap_scoreboard_image->servers[i][j].status = SERVER_GRACEFUL;
                  }
              } 
          }
  #endif
          /* give the children the signal to die */
  #ifdef DEXTER
          for (i = 0; i < ap_daemons_to_start; ++i) {
  #else
          for (i = 0; i < ap_max_daemons_limit;) {
  #endif
              if ((rv = ap_write(pipe_of_death_in, &char_of_death, &one)) 
                   != APR_SUCCESS) {
                  if (ap_canonical_error(rv) == APR_EINTR) continue;
                  ap_log_error(APLOG_MARK, APLOG_WARNING, rv, ap_server_conf, 
                               "write pipe_of_death");
              }
          }
      }
      else {
        /* Kill 'em all.  Since the child acts the same on the parents SIGTERM 
         * and a SIGHUP, we may as well use the same signal, because some user
         * pthreads are stealing signals from us left and right.
         */
          if (unixd_killpg(getpgrp(), SIGTERM) < 0) {
              ap_log_error(APLOG_MARK, APLOG_WARNING, errno, ap_server_conf, "killpg SIGTERM");
          }
          ap_reclaim_child_processes(1);                /* Start with SIGTERM */
          ap_log_error(APLOG_MARK, APLOG_NOERRNO|APLOG_NOTICE, 0, ap_server_conf,
                      "SIGHUP received.  Attempting to restart");
      }
  #ifndef DEXTER
      if (!is_graceful) {
          ap_restart_time = time(NULL); 
      }
  #endif
      return 0;
  }
  
  static void mpmt_pre_config(ap_pool_t *pconf, ap_pool_t *plog, ap_pool_t *ptemp)
  {
      static int restart_num = 0;
  
      one_process = !!getenv("ONE_PROCESS");
  
      /* sigh, want this only the second time around */
      if (restart_num++ == 1) {
          is_graceful = 0;
  
          if (!one_process) {
              ap_detach();
          }
          ap_my_pid = getpid();
      }
  
      unixd_pre_config();
      ap_listen_pre_config();
      ap_daemons_to_start = DEFAULT_START_DAEMON;
      min_spare_threads = DEFAULT_MIN_FREE_DAEMON * DEFAULT_THREADS_PER_CHILD;
      max_spare_threads = DEFAULT_MAX_FREE_DAEMON * DEFAULT_THREADS_PER_CHILD;
      ap_max_daemons_limit = HARD_SERVER_LIMIT;
      ap_threads_per_child = DEFAULT_THREADS_PER_CHILD;
      ap_pid_fname = DEFAULT_PIDLOG;
      ap_scoreboard_fname = DEFAULT_SCOREBOARD;
      lock_fname = DEFAULT_LOCKFILE;
      ap_max_requests_per_child = DEFAULT_MAX_REQUESTS_PER_CHILD;
  #ifdef DEXTER
      max_threads = HARD_THREAD_LIMIT;
      ap_dexter_set_maintain_connection_status(1);
  #else
      ap_extended_status = 0;
  #endif
      ap_cpystrn(ap_coredump_dir, ap_server_root, sizeof(ap_coredump_dir));
  }
  
  static void mpmt_hooks(void)
  {
      INIT_SIGLIST()
      one_process = 0;
  
      ap_hook_pre_config(mpmt_pre_config, NULL, NULL, AP_HOOK_MIDDLE);
  }
  
  
  static const char *set_pidfile(cmd_parms *cmd, void *dummy, const char *arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      if (cmd->server->is_virtual) {
          return "PidFile directive not allowed in <VirtualHost>";
      }
      ap_pid_fname = arg;
      return NULL;
  }
  
  static const char *set_scoreboard(cmd_parms *cmd, void *dummy,
                                    const char *arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      ap_scoreboard_fname = arg;
      return NULL;
  }
  
  static const char *set_lockfile(cmd_parms *cmd, void *dummy, const char *arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      lock_fname = arg;
      return NULL;
  }
  
  static const char *set_daemons_to_start(cmd_parms *cmd, void *dummy,
                                          const char *arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      ap_daemons_to_start = atoi(arg);
      return NULL;
  }
  
  static const char *set_min_spare_threads(cmd_parms *cmd, void *dummy,
                                           const char *arg)
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      min_spare_threads = atoi(arg);
      if (min_spare_threads <= 0) {
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      "WARNING: detected MinSpareThreads set to non-positive.");
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      "Resetting to 1 to avoid almost certain Apache failure.");
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      "Please read the documentation.");
         min_spare_threads = 1;
      }
         
      return NULL;
  }
  
  static const char *set_max_spare_threads(cmd_parms *cmd, void *dummy,
                                           const char *arg)
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      max_spare_threads = atoi(arg);
      return NULL;
  }
  
  static const char *set_server_limit (cmd_parms *cmd, void *dummy,
                                       const char *arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      ap_max_daemons_limit = atoi(arg);
      if (ap_max_daemons_limit > HARD_SERVER_LIMIT) {
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      "WARNING: MaxClients of %d exceeds compile time limit "
                      "of %d servers,", ap_max_daemons_limit, HARD_SERVER_LIMIT);
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      " lowering MaxClients to %d.  To increase, please "
                      "see the", HARD_SERVER_LIMIT);
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      " HARD_SERVER_LIMIT define in %s.",
                      AP_MPM_HARD_LIMITS_FILE);
         ap_max_daemons_limit = HARD_SERVER_LIMIT;
      } 
      else if (ap_max_daemons_limit < 1) {
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, "WARNING: Require MaxClients > 0, setting to 1\n");
          ap_max_daemons_limit = 1;
      }
      return NULL;
  }
  
  static const char *set_threads_per_child (cmd_parms *cmd, void *dummy,
                                            const char *arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      ap_threads_per_child = atoi(arg);
      if (ap_threads_per_child > HARD_THREAD_LIMIT) {
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                       "WARNING: ThreadsPerChild of %d exceeds compile time"
                       "limit of %d threads,", ap_threads_per_child,
                       HARD_THREAD_LIMIT);
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                       " lowering ThreadsPerChild to %d. To increase, please"
                       " see the", HARD_THREAD_LIMIT);
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                       " HARD_THREAD_LIMIT define in %s.",
                       AP_MPM_HARD_LIMITS_FILE);
      }
      else if (ap_threads_per_child < 1) {
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                       "WARNING: Require ThreadsPerChild > 0, setting to 1");
          ap_threads_per_child = 1;
      }
      return NULL;
  }
  
  #ifdef DEXTER
  static const char *set_max_threads(cmd_parms *cmd, void *dummy, const char *arg)
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {                                                                  return err;
      }
  
      max_threads = atoi(arg);
      if (max_threads > HARD_THREAD_LIMIT) {
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL,
                      "WARNING: detected MaxThreadsPerChild set higher than");
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL,
                      "HARD_THREAD_LIMIT. Resetting to %d", HARD_THREAD_LIMIT);
          max_threads = HARD_THREAD_LIMIT;
      }
      return NULL;
  }
  #endif
  
  static const char *set_max_requests(cmd_parms *cmd, void *dummy,
                                      const char *arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      ap_max_requests_per_child = atoi(arg);
  
      return NULL;
  }
  
  static const char *set_coredumpdir (cmd_parms *cmd, void *dummy,
                                      const char *arg) 
  {
      ap_finfo_t finfo;
      const char *fname;
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      fname = ap_server_root_relative(cmd->pool, arg);
      if ((ap_stat(&finfo, fname, cmd->pool) != APR_SUCCESS) || 
          (finfo.filetype != APR_DIR)) {
          return ap_pstrcat(cmd->pool, "CoreDumpDirectory ", fname, 
                            " does not exist or is not a directory", NULL);
      }
      ap_cpystrn(ap_coredump_dir, fname, sizeof(ap_coredump_dir));
      return NULL;
  }
  
  static const command_rec mpmt_cmds[] = {
  UNIX_DAEMON_COMMANDS
  LISTEN_COMMANDS
  AP_INIT_TAKE1("PidFile", set_pidfile, NULL, RSRC_CONF,
      "A file for logging the server process ID"),
  AP_INIT_TAKE1("ScoreBoardFile", set_scoreboard, NULL, RSRC_CONF,
      "A file for Apache to maintain runtime process management information"),
  AP_INIT_TAKE1("LockFile", set_lockfile, NULL, RSRC_CONF,
      "The lockfile used when Apache needs to lock the accept() call"),
  AP_INIT_TAKE1("StartServers", set_daemons_to_start, NULL, RSRC_CONF,
    "Number of child processes launched at server startup"),
  AP_INIT_TAKE1("MinSpareThreads", set_min_spare_threads, NULL, RSRC_CONF,
    "Minimum number of idle children, to handle request spikes"),
  AP_INIT_TAKE1("MaxSpareThreads", set_max_spare_threads, NULL, RSRC_CONF,
    "Maximum number of idle children"),
  AP_INIT_TAKE1("MaxClients", set_server_limit, NULL, RSRC_CONF,
    "Maximum number of children alive at the same time"),
  #ifdef DEXTER
  AP_INIT_TAKE1("MaxThreadsPerChild", set_max_threads, NULL, RSRC_CONF,
                "Maximum number of threads per child"),                           
  #else
  AP_INIT_TAKE1("ThreadsPerChild", set_threads_per_child, NULL, RSRC_CONF,
    "Number of threads each child creates"),
  #endif
  AP_INIT_TAKE1("MaxRequestsPerChild", set_max_requests, NULL, RSRC_CONF,
    "Maximum number of requests a particular child serves before dying."),
  AP_INIT_TAKE1("CoreDumpDirectory", set_coredumpdir, NULL, RSRC_CONF,
    "The location of the directory Apache changes to before dumping core"),
  { NULL }
  };
  
  module MODULE_VAR_EXPORT mpm_mpmt_module = {
      MPM20_MODULE_STUFF,
      NULL,                       /* hook to run before apache parses args */
      NULL,                        /* create per-directory config structure */
      NULL,                        /* merge per-directory config structures */
      NULL,                        /* create per-server config structure */
      NULL,                        /* merge per-server config structures */
      mpmt_cmds,                /* command ap_table_t */
      NULL,                        /* handlers */
      mpmt_hooks                /* register_hooks */
  };
  
  
  
  
  1.1                  apache-2.0/src/modules/mpm/mpmt/scoreboard.c
  
  Index: scoreboard.c
  ===================================================================
  /* ====================================================================
   * The Apache Software License, Version 1.1
   *
   * Copyright (c) 2000 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Apache" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   *
   * Portions of this software are based upon public domain software
   * originally written at the National Center for Supercomputing Applications,
   * University of Illinois, Urbana-Champaign.
   */
  
  #include "apr_portable.h"
  #include "ap_config.h"
  #include "httpd.h"
  #include "http_log.h"
  #include "http_main.h"
  #include "http_core.h"
  #include "http_config.h"
  #include "unixd.h"
  #include "http_conf_globals.h"
  #include "mpm_status.h"
  #include "mpm.h"
  #include "scoreboard.h"
  #ifdef HAVE_SYS_TYPES_H
  #include <sys/types.h>
  #endif
  
  #ifdef DEXTER
  static scoreboard *ap_scoreboard_image = NULL;
  
  /*****************************************************************
   *
   * Dealing with the scoreboard... a lot of these variables are global
   * only to avoid getting clobbered by the longjmp() that happens when
   * a hard timeout expires...
   *
   * We begin with routines which deal with the file itself...
   */
  
  #if APR_HAS_SHARED_MEMORY
  #include "apr_shmem.h"
  
  static ap_shmem_t *scoreboard_shm = NULL;
  
  static ap_status_t cleanup_shared_mem(void *d)
  {
      ap_shm_free(scoreboard_shm, ap_scoreboard_image);
      ap_scoreboard_image = NULL;
      ap_shm_destroy(scoreboard_shm);
      return APR_SUCCESS;
  }
  
  static void setup_shared_mem(ap_pool_t *p)
  {
      char buf[512];
      const char *fname;
  
      fname = ap_server_root_relative(p, ap_scoreboard_fname);
      if (ap_shm_init(&scoreboard_shm, SCOREBOARD_SIZE + 40, fname, p) != APR_SUCCESS) {
          ap_snprintf(buf, sizeof(buf), "%s: could not open(create) scoreboard",
                      ap_server_argv0);
          perror(buf);
          exit(APEXIT_INIT);
      }
      ap_scoreboard_image = ap_shm_malloc(scoreboard_shm, SCOREBOARD_SIZE);
      if (ap_scoreboard_image == NULL) {
          ap_snprintf(buf, sizeof(buf), "%s: cannot allocate scoreboard",
                      ap_server_argv0);
          perror(buf);
          ap_shm_destroy(scoreboard_shm);
          exit(APEXIT_INIT);
      }
      ap_register_cleanup(p, NULL, cleanup_shared_mem, ap_null_cleanup);
  }
  
  void reinit_scoreboard(ap_pool_t *p)
  {
      if (ap_scoreboard_image == NULL) {
          setup_shared_mem(p);
      }
      memset(ap_scoreboard_image, 0, SCOREBOARD_SIZE);
  }
  #endif   /* APR_SHARED_MEM */
  
  /****
   * Above code is shmem code. Below code is interacting with the shmem
   ****/
  
  static int maintain_connection_status = 1;
  
  void ap_dexter_set_maintain_connection_status(int flag) {
      maintain_connection_status = flag;
      return;
  }
  
  /* Useful to erase the status of children that might be from previous
   * generations */
  void ap_dexter_force_reset_connection_status(long conn_id)
  {
      int i;
  
      for (i = 0; i < STATUSES_PER_CONNECTION; i++) {
          ap_scoreboard_image->table[conn_id][i].key[0] = '\0';
      }
  }
  
  void ap_reset_connection_status(long conn_id)
  {
      if (maintain_connection_status) {
          ap_dexter_force_reset_connection_status(conn_id);
      }
  }
  
  /* Don't mess with the string you get back from this function */
  const char *ap_get_connection_status(long conn_id, const char *key)
  {
      int i = 0;
      status_table_entry *ss;
  
      if (!maintain_connection_status) return "";
      while (i < STATUSES_PER_CONNECTION) {
          ss = &(ap_scoreboard_image->table[conn_id][i]);
          if (ss->key[0] == '\0') {                                                           break;
          }
          if (0 == strcmp(ss->key, key)) {
              return ss->value;
          }
      }
  
      return NULL;
  }
  
  ap_array_header_t *ap_get_connections(ap_pool_t *p)
  {
      int i;
      ap_array_header_t *connection_list;
      long *array_slot;
  
      connection_list = ap_make_array(p, 0, sizeof(long));
      /* We assume that there is a connection iff it has an entry in the status
       * table. Connections without any status sound problematic to me, so this
       * is probably for the best. - manoj */
      for (i = 0; i < ap_max_daemons_limit*HARD_THREAD_LIMIT; i++) {
          if (ap_scoreboard_image->table[i][0].key[0] != '\0') {
              array_slot = ap_push_array(connection_list);
              *array_slot = i;
          }
      }
      return connection_list;
  }
  
  ap_array_header_t *ap_get_connection_keys(ap_pool_t *p, long conn_id)
  {
      int i = 0;
      status_table_entry *ss;
      ap_array_header_t *key_list;
      char **array_slot;
  
      key_list = ap_make_array(p, 0, KEY_LENGTH * sizeof(char));
      while (i < STATUSES_PER_CONNECTION) {
          ss = &(ap_scoreboard_image->table[conn_id][i]);
          if (ss->key[0] == '\0') {
              break;
          }
          array_slot = ap_push_array(key_list);
          *array_slot = ap_pstrdup(p, ss->key);
          i++;
      }
      return key_list;
  }
  
  /* Note: no effort is made here to prevent multiple threads from messing with
   * a single connection at the same time. ap_update_connection_status should
   * only be called by the thread that owns the connection */
  
  void ap_update_connection_status(long conn_id, const char *key,
                                   const char *value)
  {
      int i = 0;
      status_table_entry *ss;
  
      if (!maintain_connection_status) return;
      while (i < STATUSES_PER_CONNECTION) {
          ss = &(ap_scoreboard_image->table[conn_id][i]);
          if (ss->key[0] == '\0') {
              break;
          }                                                                               if (0 == strcmp(ss->key, key)) {
              ap_cpystrn(ss->value, value, VALUE_LENGTH);
              return;
          }
          i++;
      }
      /* Not found. Add an entry for this value */
      if (i >= STATUSES_PER_CONNECTION) {
          /* No room. Oh well, not much anyone can do about it. */
          return;
      }
      ap_cpystrn(ss->key, key, KEY_LENGTH);
      ap_cpystrn(ss->value, value, VALUE_LENGTH);
      return;
  }
  
  ap_array_header_t *ap_get_status_table(ap_pool_t *p)
  {
      int i, j;
      ap_array_header_t *server_status;
      ap_status_table_row_t *array_slot;
      status_table_entry *ss;
  
      server_status = ap_make_array(p, 0, sizeof(ap_status_table_row_t));
  
      /* Go ahead and return what's in the connection status table even if we
       * aren't maintaining it. We can at least look at what children from
       * previous generations are up to. */
  
      for (i = 0; i < ap_max_daemons_limit*HARD_THREAD_LIMIT; i++) {
          if (ap_scoreboard_image->table[i][0].key[0] == '\0')
              continue;
          array_slot = ap_push_array(server_status);
          array_slot->data = ap_make_table(p, 0);
          array_slot->conn_id = i;
  
          for (j = 0; j < STATUSES_PER_CONNECTION; j++) {
              ss = &(ap_scoreboard_image->table[i][j]);
              if (ss->key[0] != '\0') {
                  ap_table_add(array_slot->data, ss->key, ss->value);
              }
              else {
                  break;
              }
          }
      }
      return server_status;
  }
  #else
  scoreboard *ap_scoreboard_image = NULL;
  new_scoreboard *ap_new_scoreboard_image = NULL;
  static int maintain_connection_status = 1;
  /*****************************************************************
   *
   * Dealing with the scoreboard... a lot of these variables are global
   * only to avoid getting clobbered by the longjmp() that happens when
   * a hard timeout expires...
   *
   * We begin with routines which deal with the file itself... 
   */
  
  #if APR_HAS_SHARED_MEMORY
  #include "apr_shmem.h"
  
  static ap_shmem_t *scoreboard_shm = NULL;
  
  static ap_status_t cleanup_shared_mem(void *d)
  {
      ap_shm_free(scoreboard_shm, ap_scoreboard_image);
      ap_scoreboard_image = NULL;
      ap_shm_destroy(scoreboard_shm);
  
      return APR_SUCCESS;
  }
  
  static void setup_shared_mem(ap_pool_t *p)
  {
      char buf[512];
      const char *fname;
  
      fname = ap_server_root_relative(p, ap_scoreboard_fname);
      if (ap_shm_init(&scoreboard_shm, SCOREBOARD_SIZE + NEW_SCOREBOARD_SIZE + 40, fname, p) != APR_SUCCESS) {
          ap_snprintf(buf, sizeof(buf), "%s: could not open(create) scoreboard",
                      ap_server_argv0);
          perror(buf);
          exit(APEXIT_INIT);
      }
      ap_scoreboard_image = ap_shm_malloc(scoreboard_shm, SCOREBOARD_SIZE);
      ap_new_scoreboard_image = ap_shm_malloc(scoreboard_shm, NEW_SCOREBOARD_SIZE);
      if (ap_scoreboard_image == NULL || ap_new_scoreboard_image == NULL) {
          ap_snprintf(buf, sizeof(buf), "%s: cannot allocate scoreboard",
                      ap_server_argv0);
          perror(buf);
          ap_shm_destroy(scoreboard_shm);
          exit(APEXIT_INIT);
      }
      ap_register_cleanup(p, NULL, cleanup_shared_mem, ap_null_cleanup);
      ap_scoreboard_image->global.running_generation = 0;
  }
  
  void reopen_scoreboard(ap_pool_t *p)
  {
  }
  #endif   /* APR_SHARED_MEM */
  
  /* Called by parent process */
  void reinit_scoreboard(ap_pool_t *p)
  {
      int running_gen = 0;
      if (ap_scoreboard_image)
  	running_gen = ap_scoreboard_image->global.running_generation;
      if (ap_scoreboard_image == NULL) {
          setup_shared_mem(p);
      }
      memset(ap_scoreboard_image, 0, SCOREBOARD_SIZE);
      ap_scoreboard_image->global.running_generation = running_gen;
  }
  
  /* Routines called to deal with the scoreboard image
   * --- note that we do *not* need write locks, since update_child_status
   * only updates a *single* record in place, and only one process writes to
   * a given scoreboard slot at a time (either the child process owning that
   * slot, or the parent, noting that the child has died).
   *
   * As a final note --- setting the score entry to getpid() is always safe,
   * since when the parent is writing an entry, it's only noting SERVER_DEAD
   * anyway.
   */
  
  ap_inline void ap_sync_scoreboard_image(void)
  {
  }
  
  API_EXPORT(int) ap_exists_scoreboard_image(void)
  {
      return (ap_scoreboard_image ? 1 : 0);
  }
  
  static ap_inline void put_scoreboard_info(int child_num, int thread_num, 
  				       thread_score *new_score_rec)
  {
      /* XXX - needs to be fixed to account for threads */
  #ifdef SCOREBOARD_FILE
      lseek(scoreboard_fd, (long) child_num * sizeof(thread_score), 0);
      force_write(scoreboard_fd, new_score_rec, sizeof(thread_score));
  #endif
  }
  
  void update_scoreboard_global(void)
  {
  #ifdef SCOREBOARD_FILE
      lseek(scoreboard_fd,
  	  (char *) &ap_scoreboard_image->global -(char *) ap_scoreboard_image, 0);
      force_write(scoreboard_fd, &ap_scoreboard_image->global,
  		sizeof ap_scoreboard_image->global);
  #endif
  }
  
  void increment_counts(int child_num, int thread_num, request_rec *r)
  {
      long int bs = 0;
      thread_score *ss;
  
      ss = &ap_scoreboard_image->servers[child_num][thread_num];
  
      if (r->sent_bodyct)
  	ap_bgetopt(r->connection->client, BO_BYTECT, &bs);
  
  #ifdef HAVE_TIMES
      times(&ss->times);
  #endif
      ss->access_count++;
      ss->my_access_count++;
      ss->conn_count++;
      ss->bytes_served += (unsigned long) bs;
      ss->my_bytes_served += (unsigned long) bs;
      ss->conn_bytes += (unsigned long) bs;
  
      put_scoreboard_info(child_num, thread_num, ss);
  
  }
  
  API_EXPORT(int) find_child_by_pid(ap_proc_t *pid)
  {
      int i;
      int max_daemons_limit = ap_get_max_daemons();
  
      for (i = 0; i < max_daemons_limit; ++i)
  	if (ap_scoreboard_image->parent[i].pid == pid->pid)
  	    return i;
  
      return -1;
  }
  
  int ap_update_child_status(int child_num, int thread_num, int status, request_rec *r)
  {
      int old_status;
      thread_score *ss;
      parent_score *ps;
  
      if (child_num < 0)
  	return -1;
  
      ss = &ap_scoreboard_image->servers[child_num][thread_num];
      old_status = ss->status;
      ss->status = status;
  
      ps = &ap_scoreboard_image->parent[child_num];
      
      if ((status == SERVER_READY  || status == SERVER_ACCEPTING)
  	&& old_status == SERVER_STARTING) {
          ss->tid = pthread_self();
  	ps->worker_threads = ap_threads_per_child;
      }
  
      if (ap_extended_status) {
  	if (status == SERVER_READY || status == SERVER_DEAD) {
  	    /*
  	     * Reset individual counters
  	     */
  	    if (status == SERVER_DEAD) {
  		ss->my_access_count = 0L;
  		ss->my_bytes_served = 0L;
  	    }
  	    ss->conn_count = (unsigned short) 0;
  	    ss->conn_bytes = (unsigned long) 0;
  	}
  	if (r) {
  	    conn_rec *c = r->connection;
  	    ap_cpystrn(ss->client, ap_get_remote_host(c, r->per_dir_config,
  				  REMOTE_NOLOOKUP), sizeof(ss->client));
  	    if (r->the_request == NULL) {
  		    ap_cpystrn(ss->request, "NULL", sizeof(ss->request));
  	    } else if (r->parsed_uri.password == NULL) {
  		    ap_cpystrn(ss->request, r->the_request, sizeof(ss->request));
  	    } else {
  		/* Don't reveal the password in the server-status view */
  		    ap_cpystrn(ss->request, ap_pstrcat(r->pool, r->method, " ",
  					       ap_unparse_uri_components(r->pool, &r->parsed_uri, UNP_OMITPASSWORD),
  					       r->assbackwards ? NULL : " ", r->protocol, NULL),
  				       sizeof(ss->request));
  	    }
  	    ss->vhostrec =  r->server;
  	}
      }
      
      put_scoreboard_info(child_num, thread_num, ss);
      return old_status;
  }
  
  void ap_time_process_request(int child_num, int thread_num, int status)
  {
      thread_score *ss;
  
      if (child_num < 0)
  	return;
  
      ss = &ap_scoreboard_image->servers[child_num][thread_num];
  
      if (status == START_PREQUEST) {
          ss->start_time = ap_now(); 
      }
      else if (status == STOP_PREQUEST) {
          ss->stop_time = ap_now(); 
      }
      put_scoreboard_info(child_num, thread_num, ss);
  }
  
  /* Useful to erase the status of children that might be from previous
   * generations */
  void ap_mpmt_pthread_force_reset_connection_status(long conn_id)
  {
      int i;
  
      for (i = 0; i < STATUSES_PER_CONNECTION; i++) {                                     ap_new_scoreboard_image->table[conn_id][i].key[0] = '\0';
      }                                                                           }
  
  void ap_reset_connection_status(long conn_id)
  {
      if (maintain_connection_status) {
          ap_mpmt_pthread_force_reset_connection_status(conn_id);
      }
  }
  
  /* Don't mess with the string you get back from this function */
  const char *ap_get_connection_status(long conn_id, const char *key)
  {
      int i = 0;
      status_table_entry *ss;
  
      if (!maintain_connection_status) return "";
      while (i < STATUSES_PER_CONNECTION) {                                               ss = &(ap_new_scoreboard_image->table[conn_id][i]);
          if (ss->key[0] == '\0') {                                                           break;
          }
          if (0 == strcmp(ss->key, key)) {
              return ss->value;
          }
      }
  
      return NULL;
  }
  
  ap_array_header_t *ap_get_connections(ap_pool_t *p)
  {
      int i;
      ap_array_header_t *connection_list;
      long *array_slot;
      int max_daemons_limit = ap_get_max_daemons();
  
      connection_list = ap_make_array(p, 0, sizeof(long));
      /* We assume that there is a connection iff it has an entry in the status
       * table. Connections without any status sound problematic to me, so this
       * is probably for the best. - manoj */
      for (i = 0; i < max_daemons_limit*HARD_THREAD_LIMIT; i++) {
           if (ap_new_scoreboard_image->table[i][0].key[0] != '\0') {
              array_slot = ap_push_array(connection_list);
              *array_slot = i;
          }
      }
      return connection_list;
  }
  
  ap_array_header_t *ap_get_connection_keys(ap_pool_t *p, long conn_id)
  {
      int i = 0;
      status_table_entry *ss;
      ap_array_header_t *key_list;
      char **array_slot;
  
      key_list = ap_make_array(p, 0, KEY_LENGTH * sizeof(char));
      while (i < STATUSES_PER_CONNECTION) {
          ss = &(ap_new_scoreboard_image->table[conn_id][i]);
          if (ss->key[0] == '\0') {
              break;
          }
          array_slot = ap_push_array(key_list);
          *array_slot = ap_pstrdup(p, ss->key);
          i++;
      }
      return key_list;
  }
  
  /* Note: no effort is made here to prevent multiple threads from messing with
   * a single connection at the same time. ap_update_connection_status should
   * only be called by the thread that owns the connection */
  
  void ap_update_connection_status(long conn_id, const char *key,
                                   const char *value)
  {
      int i = 0;
      status_table_entry *ss;
  
      if (!maintain_connection_status) return;
      while (i < STATUSES_PER_CONNECTION) {
          ss = &(ap_new_scoreboard_image->table[conn_id][i]);
          if (ss->key[0] == '\0') {                                                           break;
          }                                                                               if (0 == strcmp(ss->key, key)) {
              ap_cpystrn(ss->value, value, VALUE_LENGTH);
              return;
          }
          i++;
      }
      /* Not found. Add an entry for this value */
      if (i >= STATUSES_PER_CONNECTION) {
          /* No room. Oh well, not much anyone can do about it. */
          return;
      }
      ap_cpystrn(ss->key, key, KEY_LENGTH);
      ap_cpystrn(ss->value, value, VALUE_LENGTH);
      return;
  }
  
  ap_array_header_t *ap_get_status_table(ap_pool_t *p)
  {
      int i, j;
      ap_array_header_t *server_status;
      ap_status_table_row_t *array_slot;
      int max_daemons_limit = ap_get_max_daemons();
      status_table_entry *ss;
  
      server_status = ap_make_array(p, 0, sizeof(ap_status_table_row_t));
  
      /* Go ahead and return what's in the connection status table even if we
       * aren't maintaining it. We can at least look at what children from
       * previous generations are up to. */
  
      for (i = 0; i < max_daemons_limit*HARD_THREAD_LIMIT; i++) {
          if (ap_new_scoreboard_image->table[i][0].key[0] == '\0')
              continue;
          array_slot = ap_push_array(server_status);
          array_slot->data = ap_make_table(p, 0);
          array_slot->conn_id = i;
  
          for (j = 0; j < STATUSES_PER_CONNECTION; j++) {
              ss = &(ap_new_scoreboard_image->table[i][j]);
              if (ss->key[0] != '\0') {
                  ap_table_add(array_slot->data, ss->key, ss->value);
              }
              else {
                  break;
              }
          }
      }
      return server_status;
  }
  #endif
  
  
  
  
  
  1.1                  apache-2.0/src/modules/mpm/mpmt/scoreboard.h
  
  Index: scoreboard.h
  ===================================================================
  /* ====================================================================
   * The Apache Software License, Version 1.1
   *
   * Copyright (c) 2000 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Apache" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   *
   * Portions of this software are based upon public domain software
   * originally written at the National Center for Supercomputing Applications,
   * University of Illinois, Urbana-Champaign.
   */
  
  #ifndef APACHE_SCOREBOARD_H
  #define APACHE_SCOREBOARD_H
  #include <pthread.h>
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  #ifdef HAVE_SYS_TIMES_H
  #include <sys/time.h>
  #include <sys/times.h>
  #elif defined(TPF)
  #include <time.h>
  #endif
  
  #include "mpm_default.h"	/* For HARD_.*_LIMIT */
  
  /*The optimized timeout code only works if we're not using a scoreboard file*/
  #if defined(USE_MEM_BASED_SCOREBOARD)
  #define OPTIMIZE_TIMEOUTS
  #endif
  
  #ifdef DEXTER
  
  void reinit_scoreboard(ap_pool_t *p);
  
  API_EXPORT(void) reopen_scoreboard(ap_pool_t *p);
  
  /* The stuff for Dexter's status table */
  
  #include "mpm_status.h"
  
  void ap_dexter_set_maintain_connection_status(int flag);
  void ap_dexter_force_reset_connection_status(long conn_id);
  #define KEY_LENGTH 16
  #define VALUE_LENGTH 64
  typedef struct {
      char key[KEY_LENGTH];
      char value[VALUE_LENGTH];
  } status_table_entry;
  
  #define STATUSES_PER_CONNECTION 10
  
  typedef struct {
      status_table_entry
          table[HARD_SERVER_LIMIT*HARD_THREAD_LIMIT][STATUSES_PER_CONNECTION];
  } scoreboard;
  
  #define SCOREBOARD_SIZE         sizeof(scoreboard)
  
  API_VAR_EXPORT extern const char *ap_scoreboard_fname;
  
  #else
  
  /* Scoreboard info on a process is, for now, kept very brief --- 
   * just status value and pid (the latter so that the caretaker process
   * can properly update the scoreboard when a process dies).  We may want
   * to eventually add a separate set of long_score structures which would
   * give, for each process, the number of requests serviced, and info on
   * the current, or most recent, request.
   *
   * Status values:
   */
  
  #define SERVER_DEAD 0
  #define SERVER_STARTING 1	/* Server Starting up */
  #define SERVER_READY 2		/* Waiting for connection (or accept() lock) */
  #define SERVER_BUSY_READ 3	/* Reading a client request */
  #define SERVER_BUSY_WRITE 4	/* Processing a client request */
  #define SERVER_BUSY_KEEPALIVE 5	/* Waiting for more requests via keepalive */
  #define SERVER_BUSY_LOG 6	/* Logging the request */
  #define SERVER_BUSY_DNS 7	/* Looking up a hostname */
  #define SERVER_GRACEFUL 8	/* server is gracefully finishing request */
  #define SERVER_ACCEPTING 9	/* thread is accepting connections */
  #define SERVER_QUEUEING	10      /* thread is putting connection on the queue */
  #define SERVER_NUM_STATUS 11	/* number of status settings */
  
  /* A "virtual time" is simply a counter that indicates that a child is
   * making progress.  The parent checks up on each child, and when they have
   * made progress it resets the last_rtime element.  But when the child hasn't
   * made progress in a time that's roughly timeout_len seconds long, it is
   * sent a SIGALRM.
   *
   * vtime is an optimization that is used only when the scoreboard is in
   * shared memory (it's not easy/feasible to do it in a scoreboard file).
   * The essential observation is that timeouts rarely occur, the vast majority
   * of hits finish before any timeout happens.  So it really sucks to have to
   * ask the operating system to set up and destroy alarms many times during
   * a request.
   */
  typedef unsigned vtime_t;
  
  /* Type used for generation indicies.  Startup and every restart cause a
   * new generation of children to be spawned.  Children within the same
   * generation share the same configuration information -- pointers to stuff
   * created at config time in the parent are valid across children.  For
   * example, the vhostrec pointer in the scoreboard below is valid in all
   * children of the same generation.
   *
   * The safe way to access the vhost pointer is like this:
   *
   * short_score *ss = pointer to whichver slot is interesting;
   * parent_score *ps = pointer to whichver slot is interesting;
   * server_rec *vh = ss->vhostrec;
   *
   * if (ps->generation != ap_my_generation) {
   *     vh = NULL;
   * }
   *
   * then if vh is not NULL it's valid in this child.
   *
   * This avoids various race conditions around restarts.
   */
  typedef int ap_generation_t;
  
  /* stuff which is thread specific */
  typedef struct {
  #ifdef OPTIMIZE_TIMEOUTS
      vtime_t cur_vtime;		/* the child's current vtime */
      unsigned short timeout_len;	/* length of the timeout */
  #endif
      pthread_t tid;
      unsigned char status;
      unsigned long access_count;
      unsigned long bytes_served;
      unsigned long my_access_count;
      unsigned long my_bytes_served;
      unsigned long conn_bytes;
      unsigned short conn_count;
      ap_time_t start_time;
      ap_time_t stop_time;
  #ifdef HAVE_TIMES
      struct tms times;
  #endif
  #ifndef OPTIMIZE_TIMEOUTS
      time_t last_used;
  #endif
      char client[32];		/* Keep 'em small... */
      char request[64];		/* We just want an idea... */
      server_rec *vhostrec;	/* What virtual host is being accessed? */
                                  /* SEE ABOVE FOR SAFE USAGE! */
  } thread_score;
  
  typedef struct {
      ap_generation_t running_generation;	/* the generation of children which
                                           * should still be serving requests. */
  } global_score;
  
  /* stuff which the parent generally writes and the children rarely read */
  typedef struct {
      pid_t pid;
      ap_generation_t generation;	/* generation of this child */
      int worker_threads;
  #ifdef OPTIMIZE_TIMEOUTS
      time_t last_rtime;		/* time(0) of the last change */
      vtime_t last_vtime;		/* the last vtime the parent has seen */
  #endif
  } parent_score;
  
  typedef struct {
      thread_score servers[HARD_SERVER_LIMIT][HARD_THREAD_LIMIT];
      parent_score parent[HARD_SERVER_LIMIT];
      global_score global;
  } scoreboard;
  
  #define KEY_LENGTH 16
  #define VALUE_LENGTH 64
  typedef struct {
      char key[KEY_LENGTH];
      char value[VALUE_LENGTH];
  } status_table_entry;
  
  #define STATUSES_PER_CONNECTION 10
  
  typedef struct {
      status_table_entry
          table[HARD_SERVER_LIMIT*HARD_THREAD_LIMIT][STATUSES_PER_CONNECTION];
  } new_scoreboard;
  
  #define SCOREBOARD_SIZE		sizeof(scoreboard)
  #define NEW_SCOREBOARD_SIZE	sizeof(new_scoreboard)
  #ifdef TPF
  #define SCOREBOARD_NAME		"SCOREBRD"
  #define SCOREBOARD_FRAMES		SCOREBOARD_SIZE/4095 + 1
  #endif
  
  API_EXPORT(int) ap_exists_scoreboard_image(void);
  void reinit_scoreboard(ap_pool_t *p);
  void cleanup_scoreboard(void);
  API_EXPORT(void) ap_sync_scoreboard_image(void);
  void ap_mpmt_pthread_force_reset_connection_status(long conn_id);
  
  API_EXPORT(void) reopen_scoreboard(ap_pool_t *p);
  
  ap_inline void ap_sync_scoreboard_image(void);
  void increment_counts(int child_num, int thread_num, request_rec *r);
  void update_scoreboard_global(void);
  API_EXPORT(int) find_child_by_pid(ap_proc_t *pid);
  int ap_update_child_status(int child_num, int thread_num, int status, request_rec *r);
  void ap_time_process_request(int child_num, int thread_num, int status);
  
  
  API_VAR_EXPORT extern scoreboard *ap_scoreboard_image;
  API_VAR_EXPORT extern const char *ap_scoreboard_fname;
  
  API_VAR_EXPORT extern ap_generation_t volatile ap_my_generation;
  
  /* for time_process_request() in http_main.c */
  #define START_PREQUEST 1
  #define STOP_PREQUEST  2
  
  #endif
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif	/* !APACHE_SCOREBOARD_H */
  
  
  

Mime
View raw message