You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@locus.apache.org on 2000/07/27 02:16:32 UTC

cvs commit: apache-2.0/src/modules/mpm/perchild .cvsignore Makefile.in config.m4 mpm.h mpm_default.h perchild.c scoreboard.c scoreboard.h

rbb         00/07/26 17:16:32

  Modified:    src/main mpm_common.c
               src/modules/mpm config.m4
  Added:       src/modules/mpm/perchild .cvsignore Makefile.in config.m4
                        mpm.h mpm_default.h perchild.c scoreboard.c
                        scoreboard.h
  Log:
  Add a new MPM.  Currently this is almost an exact copy of the dexter MPM.
  In time, this will be the MPM that allows each child process to have a
  unique user id.  I need a place to work and keep track of my changes.
  Don't expect this to work until next week sometime.
  
  Revision  Changes    Path
  1.28      +1 -1      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.27
  retrieving revision 1.28
  diff -u -r1.27 -r1.28
  --- mpm_common.c	2000/07/27 00:04:11	1.27
  +++ mpm_common.c	2000/07/27 00:16:31	1.28
  @@ -81,7 +81,7 @@
   #include <sys/socket.h> /* for setsockopt prototype */
   #endif
   
  -#if defined(DEXTER_MPM) || defined(MPMT_BEOS_MPM) || defined(BEOS_MPM) || defined(PERCHILD)
  +#if defined(DEXTER_MPM) || defined(MPMT_BEOS_MPM) || defined(BEOS_MPM) || defined(PERCHILD_MPM)
   #define CHILD_TABLE 1
   #define CHILD_INFO_TABLE     ap_child_table
   #elif defined(MPMT_PTHREAD) || defined(PREFORK_MPM)
  
  
  
  1.26      +2 -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.25
  retrieving revision 1.26
  diff -u -r1.25 -r1.26
  --- config.m4	2000/07/25 23:48:21	1.25
  +++ config.m4	2000/07/27 00:16:31	1.26
  @@ -1,7 +1,7 @@
   AC_MSG_CHECKING(which MPM to use)
   AC_ARG_WITH(mpm,
   [  --with-mpm=MPM          Choose the process model for Apache to use.
  -                          MPM={dexter,mpmt_beos,mpmt_pthread,prefork,spmt_os2}],[
  +               MPM={dexter,mpmt_beos,mpmt_pthread,prefork,spmt_os2,perchild}],[
     APACHE_MPM=$withval
   ],[
     APACHE_MPM=mpmt_pthread
  @@ -18,7 +18,7 @@
   
   apache_cv_mpm=$APACHE_MPM
   	
  -if test "$apache_cv_mpm" = "mpmt_pthread" -o "$apache_cv_mpm" = "dexter"; then
  +if test "$apache_cv_mpm" = "mpmt_pthread" -o "$apache_cv_mpm" = "dexter" -o "$apache_cv_mpm" = "perchild"; then
     PTHREADS_CHECK
     AC_MSG_CHECKING([for which threading library to use])
     AC_MSG_RESULT($threads_result)
  
  
  
  1.1                  apache-2.0/src/modules/mpm/perchild/.cvsignore
  
  Index: .cvsignore
  ===================================================================
  .deps
  .libs
  *.lo
  *.la
  Makefile
  
  
  
  1.1                  apache-2.0/src/modules/mpm/perchild/Makefile.in
  
  Index: Makefile.in
  ===================================================================
  
  LTLIBRARY_NAME    = libperchild.la
  LTLIBRARY_SOURCES = perchild.c scoreboard.c
  
  include $(top_srcdir)/build/ltlib.mk
  
  
  
  1.1                  apache-2.0/src/modules/mpm/perchild/config.m4
  
  Index: config.m4
  ===================================================================
  dnl ## XXX - Need a more thorough check of the proper flags to use
  
  if test "$MPM_NAME" = "perchild" ; then
      ac_cv_enable_threads="yes"
      AC_CACHE_SAVE
  
      APACHE_FAST_OUTPUT(modules/mpm/$MPM_NAME/Makefile)
      APACHE_MPM_PTHREAD
  fi
  
  
  
  1.1                  apache-2.0/src/modules/mpm/perchild/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 "httpd.h"
  #include "mpm_default.h"
  #include "unixd.h"
  
  #ifndef APACHE_MPM_PERCHILD_H
  #define APACHE_MPM_PERCHILD_H
  
  #define PERCHILD_MPM
  
  /* 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;
  
  extern int ap_max_daemons_limit;
  extern ap_ctable ap_child_table[HARD_SERVER_LIMIT];
  extern server_rec *ap_server_conf;
  extern char ap_coredump_dir[MAX_STRING_LEN];
  
  #endif /* APACHE_MPM_PERCHILD_H */
  
  
  
  1.1                  apache-2.0/src/modules/mpm/perchild/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 threads to spawn off by default --- also, if fewer than
   * this free when the caretaker checks, it will spawn more.
   */
  #ifndef DEFAULT_START_THREAD
  #define DEFAULT_START_THREAD 5
  #endif
  
  /* Maximum number of *free* server threads --- more than this, and
   * they will die off.
   */
  
  #ifndef DEFAULT_MAX_SPARE_THREAD
  #define DEFAULT_MAX_SPARE_THREAD 10
  #endif
  
  /* Minimum --- fewer than this, and more will be created */
  
  #ifndef DEFAULT_MIN_SPARE_THREAD
  #define DEFAULT_MIN_SPARE_THREAD 5
  #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.
   */
  #ifndef HARD_THREAD_LIMIT
  #define HARD_THREAD_LIMIT 64 
  #endif
  
  /* Number of servers to spawn off by default
   */
  #ifndef DEFAULT_NUM_DAEMON
  #define DEFAULT_NUM_DAEMON 2
  #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.
   */
  #ifndef HARD_SERVER_LIMIT
  #define HARD_SERVER_LIMIT 8 
  #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/perchild/perchild.c
  
  Index: perchild.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 "ap_config.h"
  #include "apr_strings.h"
  #include "apr_portable.h"
  #include "apr_file_io.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 "mpm_default.h"
  #include "mpm.h"
  #include "scoreboard.h"
  
  #ifdef HAVE_UNISTD_H
  #include <unistd.h>
  #endif
  #include <poll.h>
  #ifdef HAVE_SYS_SOCKET_H
  #include <sys/socket.h>
  #endif
  #ifdef HAVE_NETINET_TCP_H
  #include <netinet/tcp.h>
  #endif
  #include <pthread.h>
  #include <signal.h>
  
  /*
   * Actual definitions of config globals
   */
  
  static int threads_to_start = 0;         /* Worker threads per child */
  static int min_spare_threads = 0;
  static int max_spare_threads = 0;
  static int max_threads = 0;
  static int max_requests_per_child = 0;
  static const char *ap_pid_fname=NULL;
  API_VAR_EXPORT const char *ap_scoreboard_fname=NULL;
  static int num_daemons=0;
  static int workers_may_exit = 0;
  static int requests_this_child;
  static int num_listenfds = 0;
  static ap_socket_t **listenfds;
  
  struct ap_ctable ap_child_table[HARD_SERVER_LIMIT];
  
  /*
   * The max child slot ever assigned, preserved across restarts.  Necessary
   * to deal with NumServers changes across SIGWINCH restarts.  We use this
   * value to optimize routines that have to scan the entire child table.
   *
   * XXX - It might not be worth keeping this code in. There aren't very
   * many child processes in this MPM.
   */
  int ap_max_daemons_limit = -1;
  
  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 */
  static ap_pool_t *thread_pool_parent; /* Parent of per-thread pools */
  static pthread_mutex_t thread_pool_parent_mutex;
  
  static int child_num;
  static unsigned int my_pid; /* Linux getpid() doesn't work except in 
                        main thread. Use this instead */
  /* Keep track of the number of worker threads currently active */
  static int worker_thread_count;
  static pthread_mutex_t worker_thread_count_mutex;
  static int worker_thread_free_ids[HARD_THREAD_LIMIT];
  static pthread_attr_t worker_thread_attr;
  
  /* Keep track of the number of idle worker threads */
  static int idle_thread_count;
  static pthread_mutex_t idle_thread_count_mutex;
  
  /* Locks for accept serialization */
  #ifdef NO_SERIALIZED_ACCEPT
  #define SAFE_ACCEPT(stmt) APR_SUCCESS
  #else
  #define SAFE_ACCEPT(stmt) (stmt)
  static ap_lock_t *process_accept_mutex;
  #endif /* NO_SERIALIZED_ACCEPT */
  static const char *lock_fname;
  static pthread_mutex_t thread_accept_mutex = PTHREAD_MUTEX_INITIALIZER;
  
  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)
  {
      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(getpid(), 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;
  
  /*
   * 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
  }
  
  /*****************************************************************
   * Here follows a long bunch of generic server bookkeeping stuff...
   */
  
  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;
  
      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;
      }
  
      ap_sock_disable_nagle(csd);
      iol = ap_iol_attach_socket(p, sock);
      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 *);
  
  /* 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;
  
  }
  /* 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) {
          int ret;
          char pipe_read_char;
          ap_ssize_t n = 1;
  
          ret = ap_recv(listenfds[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);
  }
  
  /* 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_listenfds+1, tpool);
      for(n=0 ; n <= num_listenfds ; ++n)
          ap_add_poll_socket(pollset, listenfds[n], APR_POLLIN);
  
      while (!workers_may_exit) {
          workers_may_exit |= (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, listenfds[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_listenfds == 1) {
                  sd = ap_listeners->sd;
                  goto got_fd;
              }
              else {
                  /* find a listener */
                  curr_pollfd = last_pollfd;
                  do {
                      curr_pollfd++;
                      if (curr_pollfd > num_listenfds) {
                          curr_pollfd = 1;
                      }
                      /* XXX: Should we check for POLLERR? */
                      ap_get_revents(&event, listenfds[curr_pollfd], pollset);
                      if (event & APR_POLLIN) {
                          last_pollfd = curr_pollfd;
                          sd = listenfds[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(my_pid, SIGTERM);
      }
      pthread_mutex_unlock(&worker_thread_count_mutex);
  
      return NULL;
  }
  
  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;
  
      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.*/
  
      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);
  
  #ifdef SIGPROCMASK_SETS_THREAD_MASK
      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 = max_requests_per_child;
      
      /* Set up the pollfd array */
      listenfds = ap_pcalloc(pchild, sizeof(*listenfds) * (num_listenfds + 1));
  #if APR_FILES_AS_SOCKETS
      ap_socket_from_file(&listenfds[0], pipe_of_death_in);
  #endif
      for (lr = ap_listeners, i = 1; i <= num_listenfds; lr = lr->next, ++i)
          listenfds[i]=lr->sd;
  
      /* Setup worker threads */
  
      if (threads_to_start > max_threads) {
          threads_to_start = max_threads;
      }
      idle_thread_count = threads_to_start;
      worker_thread_count = 0;
      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);
      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(&worker_thread_attr, &on);
      }
  #else
      pthread_attr_setdetachstate(&worker_thread_attr, PTHREAD_CREATE_DETACHED);
  #endif
  
      /* We are creating worker threads right now */
      for (i=0; i < threads_to_start; i++) {
          /* start_thread shouldn't fail here */
          if (!start_thread()) {
              break;
          }
      }
  
      /* 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();
          ap_child_table[slot].pid = getpid();
          ap_child_table[slot].status = SERVER_ALIVE;
  	child_main(slot);
      }
  
      if ((pid = fork()) == -1) {
          ap_log_error(APLOG_MARK, APLOG_ERR, errno, s,
                       "fork: Unable to fork new process");
  	/* 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, errno, 
                           ap_server_conf, "processor unbind failed %d", status);
  #endif
  
          RAISE_SIGSTOP(MAKE_CHILD);
  
  	/* XXX - For an unthreaded server, a signal handler will be necessary
          ap_signal(SIGTERM, just_die);
  	*/
          child_main(slot);
  
  	return 0;
      }
      /* else */
      ap_child_table[slot].pid = pid;
      ap_child_table[slot].status = SERVER_ALIVE;
  
      return 0;
  }
  
  /* start up a bunch of children */
  static int startup_children(int number_to_start)
  {
      int i;
  
      for (i = 0; number_to_start && i < num_daemons; ++i) {
  	if (ap_child_table[i].status != SERVER_DEAD) {
  	    continue;
  	}
  	if (make_child(ap_server_conf, i, 0) < 0) {
  	    break;
  	}
  	--number_to_start;
      }
      return number_to_start;
  }
  
  
  /*
   * spawn_rate is the number of children that will be spawned on the
   * next maintenance cycle if there aren't enough servers.  It is
   * doubled up to MAX_SPAWN_RATE, and reset only when a cycle goes by
   * without the need to spawn.
   */
  static int spawn_rate = 1;
  #ifndef MAX_SPAWN_RATE
  #define MAX_SPAWN_RATE	(32)
  #endif
  static int hold_off_on_exponential_spawning;
  
  static void perform_child_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 < num_daemons; ++i) {
          if (ap_child_table[i].status == SERVER_DEAD) {
              if (free_length < spawn_rate) {
                  free_slots[free_length] = i;
                  ++free_length;
              }
          }
          else {
              last_non_dead = i;
          }
  
  	if (i >= ap_max_daemons_limit && free_length >= 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 (spawn_rate < MAX_SPAWN_RATE) {
  	    spawn_rate *= 2;
  	}
      }
      else {
          spawn_rate = 1;
      }
  }
  
  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) {
              ap_process_child_status(&pid, status);
              /* 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_perchild_force_reset_connection_status(i * HARD_THREAD_LIMIT + j);
                      }
                      break;
                  }
              }
              if (child_slot >= 0) {
                  ap_child_table[child_slot].status = SERVER_DEAD;
                  
  		if (remaining_children_to_start
  		    && child_slot < num_daemons) {
  		    /* 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;
  		}
  #if 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
  		 * child table.  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.
  	     */
  	    remaining_children_to_start = \
  	    	startup_children(remaining_children_to_start);
  	    /* 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_child_maintenance();
      }
  }
  
  int ap_mpm_run(ap_pool_t *_pconf, ap_pool_t *plog, server_rec *s)
  {
      int remaining_children_to_start;
      int i;
      ap_status_t rv;
      ap_ssize_t one = 1;
  
      pconf = _pconf;
      ap_server_conf = s;
      if ((rv = ap_create_pipe(&pipe_of_death_in, &pipe_of_death_out, pconf)) 
          != 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_listenfds = ap_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),
                               my_pid);
      rv = SAFE_ACCEPT(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);
      }
      /* Initialize the child table */
      if (!is_graceful) {
          for (i = 0; i < HARD_SERVER_LIMIT; i++) {
              ap_child_table[i].status = SERVER_DEAD;
          }
      }
  
      set_signals();
  
      /* 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 = num_daemons;
      if (!is_graceful) {
  	remaining_children_to_start = \
  	    startup_children(remaining_children_to_start);
      }
      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;
      }
  
      if (is_graceful) {
          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.
           */
  	
  	for (i = 0; i < num_daemons; ++i) {
  	    if (ap_child_table[i].status != SERVER_DEAD) {
  	        ap_child_table[i].status = SERVER_DYING;
  	    } 
  	}
  	/* give the children the signal to die */
          for (i = 0; i < num_daemons;) {
              if ((rv = ap_write(pipe_of_death_out, &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");
              }
              i++;
          }
      }
      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");
      }
      return 0;
  }
  
  static void perchild_pre_config(ap_pool_t *p, 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();
  	}
  
  	my_pid = getpid();
      }
  
      unixd_pre_config();
      ap_listen_pre_config();
      num_daemons = DEFAULT_NUM_DAEMON;
      threads_to_start = DEFAULT_START_THREAD;
      min_spare_threads = DEFAULT_MIN_SPARE_THREAD;
      max_spare_threads = DEFAULT_MAX_SPARE_THREAD;
      max_threads = HARD_THREAD_LIMIT;
      ap_pid_fname = DEFAULT_PIDLOG;
      ap_scoreboard_fname = DEFAULT_SCOREBOARD;
      lock_fname = DEFAULT_LOCKFILE;
      max_requests_per_child = DEFAULT_MAX_REQUESTS_PER_CHILD;
      ap_perchild_set_maintain_connection_status(1);
  
      ap_cpystrn(ap_coredump_dir, ap_server_root, sizeof(ap_coredump_dir));
  }
  
  static void perchild_hooks(void)
  {
      INIT_SIGLIST()
      one_process = 0;
  
      ap_hook_pre_config(perchild_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_num_daemons (cmd_parms *cmd, void *dummy, const char *arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      num_daemons = atoi(arg);
      if (num_daemons > HARD_SERVER_LIMIT) {
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      "WARNING: NumServers of %d exceeds compile time limit "
                      "of %d servers,", num_daemons, HARD_SERVER_LIMIT);
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      " lowering NumServers 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);
         num_daemons = HARD_SERVER_LIMIT;
      } 
      else if (num_daemons < 1) {
  	ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                       "WARNING: Require NumServers > 0, setting to 1");
  	num_daemons = 1;
      }
      return NULL;
  }
  
  static const char *set_threads_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;
      }
  
      threads_to_start = atoi(arg);
      if (threads_to_start > HARD_THREAD_LIMIT) {
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                       "WARNING: StartThreads of %d exceeds compile time"
                       " limit of %d threads,", threads_to_start,
                       HARD_THREAD_LIMIT);
          ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                       " lowering StartThreads 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 (threads_to_start < 1) {
  	ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                       "WARNING: Require StartThreads > 0, setting to 1");
  	threads_to_start = 1;
      }
      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);
      if (max_spare_threads >= HARD_THREAD_LIMIT) {
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      "WARNING: detected MinSpareThreads set higher than");
         ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL, 
                      "HARD_THREAD_LIMIT. Resetting to %d", HARD_THREAD_LIMIT);
         max_spare_threads = HARD_THREAD_LIMIT;
      }
      return NULL;
  }
  
  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;
  }
  
  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;
      }
  
      max_requests_per_child = atoi(arg);
  
      return NULL;
  }
  
  static const char *set_maintain_connection_status(cmd_parms *cmd,
                                                    void *dummy, int arg) 
  {
      const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
      if (err != NULL) {
          return err;
      }
  
      ap_perchild_set_maintain_connection_status(arg != 0);
      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 char *set_childprocess(cmd_parms *cmd, void *dummy, const char *arg) 
  {
  }
  /*
      if (unlink(sconf->sockname) < 0 &&
          errno != ENOENT) {
          ap_log_error(APLOG_MARK, APLOG_ERR, errno, main_server,
                       "Couldn't unlink unix domain socket %s",
                       sconf->sockname);
          /* just a warning; don't bail out
      }
  
      if ((sd = socket(AF_UNIX, SOCK_STREAM, 0)) < 0) {
          ap_log_error(APLOG_MARK, APLOG_ERR, errno, main_server,
                       "Couldn't create unix domain socket");
          return errno;
      }
  
      memset(&unix_addr, 0, sizeof(unix_addr));
      unix_addr.sun_family = AF_UNIX;
      strcpy(unix_addr.sun_path, sconf->sockname);
  
      omask = umask(0077); /* so that only Apache can use socket 
      rc = bind(sd, (struct sockaddr *)&unix_addr, sizeof(unix_addr));
  */
  
  
  
  
  
  
  static const command_rec perchild_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("NumServers", set_num_daemons, NULL, RSRC_CONF,
                "Number of children alive at the same time"),
  AP_INIT_TAKE1("StartThreads", set_threads_to_start, NULL, RSRC_CONF,
                "Number of threads each child creates"),
  AP_INIT_TAKE1("MinSpareThreads", set_min_spare_threads, NULL, RSRC_CONF,
                "Minimum number of idle threads per child, to handle request spikes"),
  AP_INIT_TAKE1("MaxSpareThreads", set_max_spare_threads, NULL, RSRC_CONF,
                "Maximum number of idle threads per child"),
  AP_INIT_TAKE1("MaxThreadsPerChild", set_max_threads, NULL, RSRC_CONF,
                "Maximum number of threads per child"),
  AP_INIT_TAKE1("MaxRequestsPerChild", set_max_requests, NULL, RSRC_CONF,
                "Maximum number of requests a particular child serves before dying."),
  AP_INIT_FLAG("ConnectionStatus", set_maintain_connection_status, NULL, RSRC_CONF,
               "Whether or not to maintain status information on current connections"),
  AP_INIT_TAKE1("CoreDumpDirectory", set_coredumpdir, NULL, RSRC_CONF,
                "The location of the directory Apache changes to before dumping core"),
  AP_INIT_TAKE1("ChildProcess", set_childprocess, NULL, RSRC_CONF,
                "Which child process is responsible for serving this virtual host"),
  { NULL }
  };
  
  module MODULE_VAR_EXPORT mpm_perchild_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 */
      perchild_cmds,		/* command ap_table_t */
      NULL,			/* handlers */
      perchild_hooks 		/* register_hooks */
  };
  
  
  
  
  1.1                  apache-2.0/src/modules/mpm/perchild/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_strings.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 "scoreboard.h"
  #include "mpm.h" /* for ap_max_daemons_limit */
  #ifdef HAVE_SYS_TYPES_H
  #include <sys/types.h>
  #endif
  
  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_perchild_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_perchild_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_perchild_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;
  }
  
  
  
  1.1                  apache-2.0/src/modules/mpm/perchild/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 TPF
  #include <time.h>
  #else
  #include <sys/times.h>
  #endif /* TPF */
  
  #include "mpm_default.h"	/* For HARD_.*_LIMIT */
  
  /* The generic shared memory chunk code */
  void reinit_scoreboard(ap_pool_t *p);
  
  API_EXPORT(void) reopen_scoreboard(ap_pool_t *p);
  
  /* The stuff for perchild's status table */
  
  #include "mpm_status.h"
  
  void ap_perchild_set_maintain_connection_status(int flag);
  void ap_perchild_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;
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif	/* !APACHE_SCOREBOARD_H */