Date: Fri, 23 Jul 1999 23:45:06 -0400
Message-Id: <199907240345.XAA13748@Mail.MeepZor.Com>
From: Rodent of Unusual Size <Ken.Coar@Golux.Com>
To: Apache HTTP developers <new-httpd@Apache.Org>
Subject: [STATUS] (apache-apr) Fri Jul 23 23:45:06 EDT 1999
Sender: new-httpd-owner@apache.org
Precedence: bulk
Reply-To: new-httpd@apache.org

Apache Portable Runtime STATUS:
Last modified at [$Date: 1999/06/30 19:01:01 $]

Release:

    0.1  : In pre-alpha development

Plan:

    Everyone discuss and wrangle out the issues on new-httpd,
    and commit changes as appropriate.

Showstoppers:
Committed Code Changes:

    . docs/ directory created and initial function pre-spec added
    . include/ directory created and start of APRStatus macros added
    . pthreads/ directory tree created and populated with latest
      work on Apache 1.3.5-dev port to pthreads inserted

Available Patches:
In progress:
    Logging statements
        We have some comments along the lines of "log this here".
        Let's actually make those logs at some point. 

    Modules
        Ensure thread safety.  Does not include mod_proxy, yet.
	Modules that don't work:
            mod_digest.c     --Anybody have a client that can transmit Digest
			       Auth?

	Questionable modules: (Not tested.)         
	    mod_log_agent.c   -- Are we keeping these in 2.0 after Ken's
            mod_log_referer.c -- mod_log_config changes.  If yes, I'll test
			      -- them later.
    
    Warning scrubbing
        Get rid of all reasonable warnings with the strictest compiler flags,
        to help weed out bugs

    Everything

Needs patch:

  With AIX 4.2, if MaxRequestsPerChild is low (e.g. 5) and
  ThreadsPerChild is high (e.g. 64), the signal delivered to sigwait
  gets dropped on the floor. The hypothesis is that the signals blocked
  by pthread_sigmask aren't kept pending as they should be, so when
  worker threads exit quickly and signal the sigwait thread before the
  sigwait() call has been entered, the thread never gets the signal.

Open issues:

  * Whether every APR routine should return a status code
  * What the status codes should look like
  * Bringing in the libap stuff

  * Optimize Optimize Optimize

  FEATURE SET FOR APR

Closed issues:
    Accept Thread Serialization
        Implemented as a blocking queue.  1 accept thread passes connection
        to queue (size of queue is config directive, default # of threads).
        All other threads block on queue.
    Process/Thread hybridization
        put monitor process back into place.  Was removed for initial port, 
	it's time we make sure the server is running, and if not, start 
	it again.
    Bringing this code up-to-date with the changes in the 1.3 branch.
        It's now up-to-date as of the morning of Feb 6th, 1999.
    Scoreboard
	Design the scoreboard appropriately for a hybrid process web
	server. This includes adding a tid field to the scoreboard.
    Signal Handling
        Investigate signal handling in Apache-pthreads.  SIGUSR1 is not a
	usable signal on Linux 2.0, because pthreads uses it to communicate
	between threads.  SIGWINCH was used for graceful restarts.
    Process/thread management
        Put (back) in the logic to manage the number of processes.
	Managing threads per process other than with a configuration
	constant is in doubt.
    Accept Serialization across Processes
	We now use one mutex per socket.
    Timeouts.  (only soft timeouts)
	Keepalive and Initail Conection timeouts are done.  Are there others?
	CGI?
    Modules that work:
        mod_env.c mod_negotiation.c mod_autoindex.c mod_dir.c mod_cgi.c 
        mod_actions.c mod_speling.c mod_userdir.c mod_alias.c 
        mod_expires.c mod_headers.c mod_so.c mod_setenvif.c 
        mod_auth_anon.c mod_access.c mod_include.c mod_imap.c 
        mod_log_config.c mod_asis.c mod_rewrite.c mod_mime.c 
        mod_usertrack.c mod_unique_id.c mod_cern_meta.c
        mod_auth.c (I'm assuming mod_auth* also work)
        mod_mime_magic.c mod_status.c mod_mmap_static.c
    Mod_proxy