CHANGES

   1 2.2.13
   2
   3  *) [*nix] When autoupdate is enabled touch the socket when restarting
   4     the processes to prevent further requests.
   5     Eckebrecht von Pappenheim [evp@heise.de]
   6
   7  *) Apache 2.0 support.
   8
   9  *) [WIN32] Don't read from a potentially closed named pipe.
  10     Philip Gladstone [philip@okena.com]
  11
  12  *) Require the Apache version 1.3.6 or later to eliminate some signal
  13     handling funk.
  14
  15  *) [WIN32] Use asyncronous io with named pipes instead of polled
  16     nonblocking io.  This should eliminate the last of the npipe issues.
  17
  18  *) Handle an application returning a complete and valid response without
  19     having consumed all of the data sent to it.
  20
  21  *) Consume remaining client data (RESPONDERs only) if any.
  22
  23  *) Add support for backing off attempts to start applications that continuously
  24     fail to start.  Three new macros defined in mod_fastcgi.h control this
  25     behaviour: MAX_FAILED_STARTS, RUNTIME_SUCCESS_INTERVAL, FAILED_STARTS_DELAY
  26
  27  *) [WIN32] Add (back) support for use of TerminateProcess() to accomodate
  28     applications that do not (properly) support the shutdown event (this
  29     feature was introduced in fcgi2 2.2.2 and improved in 2.2.4).  The
  30     new macro WIN32_SHUTDOWN_GRACEFUL_WAIT in mod_fastcgi.h conrols the
  31     interval between signaling a proper shutdown and wacking the process(s)
  32     with a TerminateProcess().
  33
  34  *) [WIN32] Don't set the OVERLAPPED_IO flag on NamedPipe listen HANDLEs -
  35     setting it was just plain broken.
  36
  37  *) [WIN32] Fix the accept mutex - all applications were sharing one!?
  38
  39  *) Fix 'FastCgiConfig -autoUpdate'.
  40
  41  *) Fix 'FastCgiConfig -flush'.
  42
  43  *) Prevent silly maxProcesses and processSlack combinations.
  44     Dmitry Dorofeev [dima@yasp.com]
  45
  46  *) Properly handle the killing of idle processes when one takes a long time
  47     to exit once signaled down (or the config is funky).
  48     Dmitry Dorofeev [dima@yasp.com]
  49
  50  *) Always kill the youngest instance of an application.  Suggested by
  51     Dmitry Dorofeev [dima@yasp.com]
  52
  53 2.2.12
  54
  55  *) Delay the logging of write errors to the pm to account for shutdown/restart.
  56
  57  *) (Win32) An assortment of fixes.
  58
  59  *) Fix some broken casts that were likely the cause of an assert.
  60
  61  *) Win32. Eliminate forward slashes from the named pipe path name.
  62     Gerald Richter [richter@ecos.de]
  63
  64  *) SIGUSR2 is no longer blocked in the process manager and the fastcgi
  65     applications it spawns. [ryans@amazon.com]
  66
  67  *) Added support for the -flush argument to FastCgiConfig.
  68     Eric Sit [esit@alum.mit.edu]
  69
  70  *) Change the "which call to module_init() is this" check to a more
  71     reliable approach.  Doru Petrescu [pdoru@kappa.ro]
  72
  73  *) Close the old pipe file descriptor in apache main on USR1/HUP
  74     (elimnates a small leak).  James E. Jurach Jr. jjurach@fundsxpress.com
  75
  76  *) Fix a bug in fcgi_config_set_authoritative_slot(). Tetsuya Furukawa
  77     [tetsuya@secom-sis.co.jp]
  78
  79  *) Eliminate the use of locks to assist in the clean shutdown of
  80     applications.  Instead, it is assumed that applications handle
  81     termination signals properly (this is now embedded in the C
  82     application lib).
  83
  84  *) Fix Win32 process termination.  Proper operation requires the use of
  85     an updated application lib (termination is now signalled with an
  86         Event and handled by specialized thread).
  87
  88  *) Docs cleanup.  Andrew Benham [adsb@bigfoot.com]
  89
  90  *) Added code so if the last instance of a dynamic application died without
  91     provocation, then don't restart it if singleThreshold > 0 (i.e. if the
  92     configuration allows the last instance to be killed, then allow it to die).
  93     Andrew Benham [adsb@bigfoot.com]
  94
  95  *) Fix the loadFactor calculation used to determine when dyanmic
  96     applications could be killed off due to low demand [adsb@bigfoot.com].
  97
  98  *) Fix a deadlock condition that could occur with Win32 named
  99     pipes (dynamic).
 100
 101  *) Fix a potential deadlock condition when FastCGI application
 102     sent responses while still reading the client request (POST data).
 103
 104 2.2.10
 105
 106  *) Allow absolute pathnames in the -socket argument.  Suggested by
 107     Christian Jaeger [christian.jaeger@sl.ethz.ch].
 108
 109  *) Don't invoke suexec when the user/group for the fastcgi application
 110     is the same as the apache main server.  This is consistent with
 111     apache's suexec handling.  Suggested by Nikolaus Rath [Nikolaus@rath.org].
 112
 113  *) Reset the apache drop dead timer upon successful read or writes
 114     to/from the client.  This eliminates timeouts that were occuring
 115     during the large file transfers to/from slow clients.
 116
 117  *) Support generic wrappers such as cgiwrap by eliminating dependencies
 118     on Apache's SUEXEC, renaming the FastCgiSuexec directive
 119     FastCgiWrapper and eliminating any checks regarding the target
 120     application (this is the repsonibility of the wrapper).
 121
 122  *) Fix a nasty bug that occurred when a client aborted a POST request
 123     before the connection to a dynamic FastCGI application was opened.
 124     The application's lock file descriptor wasn't setup but was being
 125     closed which resulted in FD0 being closed.  Normally this is open to
 126     /dev/null and should pose no problems except that because the FD
 127     was available it was being returned by Apache's accept().  This
 128     caused it to be registered for pool cleanup.  mod_cgi though moves
 129     the CGI stdin pipe to FD0 and thus it was getting waxed during pool
 130     cleanup.  Problem identified by checksum@163.net.
 131
 132 Changes with mod_fastcgi 2.2.8
 133
 134  *) Eliminate the concept of disabled applications.  If a failure
 135     occurs trying to setup an application (e.g. bind() error) its
 136     tried repeatedly every init-start-delay seconds.
 137
 138  *) Tweak to Makefile.tmpl to support DSOs.  Dave Hill [ddhill@zk3.dec.com]
 139
 140 Changes with mod_fastcgi 2.2.6
 141
 142  *) Shutdown the PM when Apache appears to have disappeared.
 143
 144  *) seteuid() tweak for HP-UX 11.  Milton L. Hankins [mlh@swl.msd.ray.com]
 145
 146  *) (Win32) More dynamic fixes.
 147
 148  *) (Win32) Eliminate the per application named pipe mutex.  Its now
 149     per process to keep the lib happy (the use _FCGI_MUTEX_ should
 150     removed from the lib).  This allows pipe-based applications to
 151     now handle multiple simoultanous requests (one per process).
 152
 153  *) Increase the number of open FDs we look to close when spawning apps.
 154
 155  *) Prevent an assert from popping unnecessarily.
 156
 157  *) (Win32) Add support for interpretter scripts.
 158
 159  *) (Win32) Fix named pipe handling (problems with large responses).
 160
 161  *) (Win32) Remove the "can exec" check.
 162
 163 Changes with mod_fastcgi 2.2.4
 164
 165  *) Beta WinNT support.  David Allen [djallen@raleigh.ibm.com] and
 166     Rob Saccoccio [robs@chelsea.net]
 167
 168  *) Remove request type restriction (GET and POST only) in order to support
 169     Web DAV requests.  Scott Robertson [sroberts@codeit.com]
 170
 171  *) Allow requests for URLs such as /server/some/other/qualifier to match a
 172     FastCGI server defined as /server.  This was done primarily for Java
 173         Servlets, but is generically useful.
 174
 175  *) Change the comm between the PM and the request handlers from a regular
 176     file to a pipe and an assortment of other dynamic fixes.
 177
 178  *) Log dynamic process termination scheduling and the resulting
 179     process exit notification.
 180
 181  *) Change the default singleThreshhold from 10 to 0 to prevent the last dynamic
 182     application process from being killed off due to low demand.
 183
 184  *) Clean up FastCGI application pathnames (e.g. remove duplicate slashes).
 185
 186  *) Fix bugs that prevented dynamic processes from being shutdown when
 187     the load subsided.  Lars Heete [heete@do.isst.fhg.de]
 188
 189  *) Prevent dynamic processes from being scheduled to be started before
 190     the init-start-delay or restart-delay period expires.  This prevents
 191         the queuing of process start requests while an application which has
 192         a long initialization period starts up.
 193
 194  *) When suexec is enabled, allow the process manager to become root again in
 195     order to signal applications it spawned.
 196
 197  *) Change the "server started" log message level from INFO to WARN.
 198
 199  *) Fix dynamic server "Connection Refused" handling.
 200
 201  *) Fix demand-based dynamic process spawing (uses a more portable approach).
 202
 203  *) Add -idle-timeout arg to FastCgiServer, FastCgiExternalServer, and
 204     FastCgiConfig.  mod_fastcgi will now abort a connection if inactive for
 205         longer than this period.  It applies to the initiation of connections as
 206         well (and thus is similar to appConnTimeout).  Default is 30 seconds.
 207
 208  *) appConnTimeout is 0 by default now resulting in blocking connect()s.  This
 209     is more platform portable/predicable.
 210
 211  *) Leave STDOUT and STDERR open to the main server error_log.  This should
 212     eliminate a pile of protocol errors and having to track down 3rd party
 213     libs writing to stderr inadvertantly.  This doesn't mean these shouldn't
 214     be fixed in the application to use the FastCGI I/O, it just allows these
 215     applications to run when previously they'd crash and burn.
 216
 217  *) Add the pass-header arg to server directives.
 218
 219  *) Allow supplementary groups to be passed to spawned FastCGI applications (as
 220     is done for CGI) - at least until PR2580 is resolved.
 221
 222  *) Initialize the default (empty) environment in a more socially acceptable
 223     way.
 224
 225  *) Miscellaneous doc improvements based on notes I've collected up over the
 226     last few months.
 227
 228  *) Fix a bug in the stderr handling introduced in 2.2.2.  There were conditions
 229     that resulted in not or improperly terminated strings.
 230
 231  *) Fix the call to setsockopt() to disable Nagle.  [based on a bug report by
 232     Johannes Plassmann <johannes.plassmann@pdb.siemens.de>]
 233
 234 Changes with mod_fastcgi 2.2.2
 235
 236  *) Added support for blocking connect()s by setting appConnTimeout to 0.
 237     Non-blocking connect()s (the default) can be troublesome on some platforms.
 238     Its expected that blocking connect()s will become the default (and
 239     non-blocking connect()s will become optional) in the next release.
 240
 241  *) Dump a compile time error if the version of Apache is too old.
 242
 243  *) Wrap the SIGPIPE handler manipulation code such that it is only applicable
 244     to Apache releases prior to 1.3.6.
 245
 246  *) Minor tweaks for RUSSIAN_APACHE.  [Sergey Gershtein <sg@mplik.ru>]
 247
 248  *) Dynamic updates:
 249
 250     Always restart a failed dynamic application if it is the last instance.
 251     This means there once started there will always be at least one process
 252     instance of a dynamic application.
 253
 254     Send PLEASE_START to the PM when a connect() results in an ECONNREFUSED.
 255     ECONNREFUSED means the listen queue is full (or there isn't one).  Asking
 256     the PM to start (another) application instance may help empty it faster.
 257
 258     Change two sleep() calls to select() based snoozes because alarm() is in
 259     effect and sleep() and alarm() don't always play nice together.
 260
 261     Fixed a couple of error messages.
 262
 263  *) Fix -listen-queue-depth arg on FastCgiConfig (dynamic).  Previously it
 264     was ignored and the default was always used.
 265
 266  *) Allow the -initial-env argument to be used to pass variables from the
 267     Apache process environment to the FastCGI server (by specifying a
 268     variable name without the "=" or a value).  [suggested by
 269     Martin Lichtin <lichtin@oanda.com>]
 270
 271  *) Cleanup some debug macros.
 272
 273  *) Improved script stderr handling.  [based on suggestions by
 274     David Birnbaum <davidb@chelsea.net>]
 275
 276  *) Added IRIX and FreeBSD to the list of supported platforms and other minor
 277     updates to the INSTALL doc.
 278
 279  *) Changed the default listen-queue-depth (FCGI_DEFAULT_LISTEN_Q) from
 280     5 to 100.  Its still configurable with the -listen-queue-depth option.
 281     This should help eliminate the FAQ - Why do I see "Connection Refused"
 282     messages in the log?
 283
 284  *) Fix a bug in FastCgiExternalServer that broke support for external servers
 285     on other hosts.  [Dave Neuer <dneuer@futuristics.net>]
 286
 287 Changes with mod_fastcgi 2.2.1
 288
 289  *) Updates to the INSTALL doc to describe building as a DSO.
 290
 291  *) If the FastCgiIpcDir directive was in use and "httpd -t" was issued while
 292     Apache was running ("apachectl restart" does this), the contents of the
 293     dynamic directory (dynamic sockets and the mbox) would be blown away
 294     (a 2.1b1 bug).
 295
 296  *) Add an extern declaration for ap_sys_siglist (its exposed but not in any
 297     Apache header file) to prevent a compile error on systems without
 298     SYS_SIGLIST defined.
 299
 300  *) During auth requests, the subprocess_env table was left holding variables
 301     sent to the auth FastCGI server (including REMOTE_PASSWD!) which means they
 302     were passed to other processing phases (such as CGI/FastCGI).  The
 303     subprocess_env is now restored to its pre-auth condition.
 304
 305  *) Added a FastCGI Authorizer Role compatibility mode which implements the
 306     specification to the tee.  Use -compat arg with any of the Auth server
 307     directives.  This is intended for new and existing FastCGI authorizer
 308     applications that require compatibility with other server implementations.
 309
 310  *) Fix logging from the process manager.  Previously, all calls to the
 311     logging routines used NULL for the server_rec.  This works fine in a dev
 312     environment, but results in most of these messages being tossed by
 313     log_error_core() because DEFAULT_LOGLEVEL is too low.  Odd logic.
 314
 315  *) Always setup fr->header so that in the event the FastCGI server
 316     doesn't get a valid FastCGI protocol header over the wire, we
 317     can still print our error message to the log from do_work().
 318
 319  *) Fix a compile error in open_connection_to_fs() on systems with TCP_NODELAY
 320     defined (Don Locrasto [locrasto@iceminer.com]).
 321
 322 Changes with mod_fastcgi 2.2.0
 323
 324  *) Serious rewrite of mod_fastcgi.html.  An example conf will have
 325     to wait until another time - I'm burned out on docs updates.
 326
 327  *) Add to the mod_fastcgi to the server version string.
 328
 329  *) SCO doesn't like the const in the arg to inet_addr() and
 330     gethostbyname().
 331
 332  *) Use Apache's NET_SIZE_T to get the correct arg type for getsockopt().
 333
 334  *) Deleted redundant header files from fcgi.h.
 335
 336  *) Full path names are no longer required for directives which take
 337     file names as arguments.  Like other Apache directives you can
 338     specify paths from server_root (don't start with a "/").
 339
 340  *) The fcgiKillMgr is gone.  This intermediate process sat between
 341     the Apache parent and the FastCGI Process Manager under Apache
 342     1.2.         The process manager tries to name itself fcgi_pm (it used
 343     to be fcgiProcMgr).
 344
 345  *) Authentication, Authorization, and Access phases are now
 346     supported. I've bent the FastCgi spec a bit: as many of the standard
 347     environment variables (that were easy) are sent (the spec says don't
 348     send some by name), all headers (except Status) sent by the auth
 349     FastCgi server are passed to subprocesses (CGI/FastCGI invocations)
 350     as environment variables rather than just those prefixed by
 351     "Variable-".  Custom responses for auth failures aren't supported
 352     (yet.. we'll see what the demand for this is like).  In addition to
 353     the FastCGI protocol defined environment variable "FCGI_ROLE" being
 354     set to "AUTHORIZER" an environment variable "FCGI_APACHE_ROLE" is
 355     set indicating which of the three phases is being processed.  See
 356     the docs for info on the new per-directory directives:
 357
 358         FastCgiAuthenticator, FastCgiAuthenticatorAuthoritative,
 359         FastCgiAuthorizer, FastCgiAuthorizerAuthoritative,
 360         FastCgiAccessChecker, FastCgiAccessCheckerAuthoritative
 361
 362  *) The code has been broken into logical chunks making figuring it
 363     out much easier.  All of the #defines a user may want to change are
 364     now in mod_fastcgi.h.
 365
 366  *) All the logging has been converted to the "supported" Apache
 367     logging routines, ap_log_error() and ap_log_rerror().  Log entries
 368     for request specific errors should now be directed to the correct
 369     server errorlog (if your running more than one).  Some attempt has
 370     been made at setting appropriate log levels (comments of course are
 371     welcome) and printing errno info when its of value.  All of log
 372     messages now have "FastCGI" in them (nice for grep).
 373
 374  *) All of the calls to Apache routines have been updated to the ap_
 375     convention, eliminating the need for the compat header.
 376
 377  *) By default we no longer flush every piece of data we get from the
 378     FastCGI server to the client.  This allows the FastCGI server to
 379     release without having to wait for the client flush to complete.
 380     The old behaviour can revived with the -flush argument to AppClass.
 381
 382  *) I renamed some of the directives for consistency (the old names
 383     still work).
 384
 385         AppClass -> FastCgiServer,
 386         FCGIConfig -> FastCgiConfig,
 387         ExternalAppClass -> FastCgiExternalServer
 388
 389  *) Directive arguments are no longer case sensitive.
 390
 391  *) The module now uses hard_timeout() rather than soft_timeout.  This
 392     means that the module will longjump out of the request if the
 393     drop-dead timeout expires (set with Apache's Timeout directive, the
 394     default is 5min) or if the client closes the connection (SIGPIPE).
 395     This is more typical for a Apache modules and I'm not convinced we
 396     properly handle all of the error cases well enough to use
 397     soft_timeout (I can think of one place we don't anyway). This means
 398     your FastCGI application can see SIGPIPE.
 399
 400  *) SIGPIPE is now ignored by default in FastCGI servers spawned by
 401     Apache.  Without this the default behaviour is exit().
 402
 403  *) It should (I think) run now under DSO now.
 404
 405  *) The bug which prevented sending of binary data in 2.1b1 is fixed.
 406
 407  *) The broken -initial-env bug ins 2.1b1 is fixed.
 408
 409  *) Maybe some other stuff.
 410
 411
 412
 413 *** Well there's a big gap here.  Maybe I'll go back and extract the CVS
 414 commit notes and stick 'em in here.. when I get some free time. ;)
 415
 416     --robs  (8 Feb 99)
 417
 418
 419 *** Originally from docs/README..
 420
 421 Apache[X1.03.01]/mod_fastcgi[02.00.05] 19970909 unsupported
 422 From: Stanley Gambarin <stanleyg@cs.bu.edu>
 423
 424  *) Yet more changes to the source distribution.  Separated out
 425     the Tcl dynamic string and buffer libraries into separate files.
 426     Did the same for the OS library, however, it is not really an
 427     abstraction... more like a bunch of wrappers.  Added to DEVNOTES
 428     a note about the problem of Apache not allowing including header
 429     file more than once.
 430
 431 Apache[X1.03.01]/mod_fastcgi[02.00.04] 19970908 unsupported
 432 From: Stanley Gambarin <stanleyg@cs.bu.edu>
 433
 434  *) More changes to the installation scripts.  Theoretically we
 435     should be able to to use the same Makefile/installation script
 436     for both Apache 1.2.x and 1.3.x.  Need some sort of the abstraction
 437     layer to use the same source code for both 1.2.x and 1.3.x sources.
 438
 439 Apache[X1.03.01]/mod_fastcgi[02.00.03] 19970905 unsupported
 440 From: Stanley Gambarin <stanleyg@cs.bu.edu>
 441
 442  *) Created Makefile to compile the module into the archive library,
 443     just like the proxy module.  Also initial draft of the installation
 444     script, which should work for both 1.2 and 1.3 sources of Apache.
 445
 446 Apache[01.02.04]/mod_fastcgi[02.00.02] 19970903 unsupported
 447 From: Stanley Gambarin <stanleyg@cs.bu.edu>
 448
 449  *) More source reorg.  Separated out some header files.  Need much
 450     more work on this.  Updated the TODO file.  Added fcgivers.h and
 451     CHANGES     file to track the history.
 452
 453 Apache[01.02.04]/mod_fastcgi[02.00.01] 19970902 unsupported
 454 From: Stanley Gambarin <stanleyg@cs.bu.edu>
 455
 456  *) Source reorganization.  This is done to provide a basis for later
 457     functionality implementation.  See TODO file for more information
 458     of what possible future enhancements are possible/desired.
 459
 460 Apache[01.02.04]/mod_fastcgi[02.00.00] 19970902 unsupported
 461 From:  David MacKenzie <djm@va.pubnix.com>
 462
 463  *) Create the "dynamic" dir and "mbox" as the user specified in the
 464     User and Group directives instead of as root.  They are created with
 465     restrictive permissions, and then the module checks to see whether the
 466     user specified in the User and Group directives has read, write, and
 467     execute permissions on them.  Those permissions had been explicitly
 468     denied by creating them as "root".
 469
 470  *) Some documentation was garbled or incomplete.
 471
 472  *) When a FastCGI application can't be execl'd, the code used a
 473     value of errno that may have been stomped on by intervening system
 474     calls.  That happened on BSD/OS 2.1, where the error_log was
 475     reporting errno=25 (NOTTY) instead of the correct errno=13 (EACCES).
 476     An intervening stdio call was setting errno as a side-effect, which
 477     it has the right to do.
 478
 479  *) Erroneous fprintf arguments, a missing return value, an unused
 480     function, missing declarations, and other problems detected by gcc
 481     -Wall.
 482
 483  *) Duplicated code to create the lock file name merged into a single
 484     function, closing several memory leaks.
 485
 486  *) FCGIConfig -minProcesses didn't allow a value of 0, so the last
 487     FCGI app in a given dynamic class would live forever, even if it
 488     hadn't been requested for weeks.
 489
 490  *) The test for whether to keep looking for dynamic app victims to
 491     kill was backwards, so no dynamic apps were ever selected as
 492     victims.
 493
 494  *) The killInterval and updateInterval were being ignored; the
 495     sigsuspend() forced recalculations only when a child died,
 496     instead of at the intervals specified.
 497
 498  *) When a dynamic app couldn't be started, the program SEGV'd when
 499     trying to free the ipcAddrPtr twice.
 500
 501  *) Remove the dead lock file and socket when cleaning up after a
 502         server whose last child has been killed, so the FastCGIHandler
 503     isn't fooled into thinking there is still a process serving
 504     that app.
 505
 506  *) Make file locking robust in the presence of signals.
 507
 508  *) Rename some badly named variables.
 509
 510  *) Fix typos in many comments.
 511
 512  *) Fix some memory and file descriptor leaks.
 513
 514  *) Make the blocking kill of a server closer to working.
 515
 516  *) More fixes to calculations in dynamic application management.
 517
 518
 519 *** Originally from docs/README.OMI..
 520
 521 What's New: Version 2.0b1, 16 Apr 1997
 522
 523  *) Implemented a mechanism by which FastCGI applications are started by
 524     the web server on the first request and continue running.  Also,  a
 525     heuristics have been implemented to allow for dynamic killing of the
 526     running FastCGI apps.  The configuration options are supplied via
 527         the new FCGIConfig directive, that is described in the
 528         mod_fastcgi.html
 529
 530  *) When performing internal redirect, since the original request's body
 531     has already been read, do not allow the redirected request to think
 532     that is has one [body].
 533
 534  *) More conditional compilation for OS/2.
 535
 536  *) Fixed occassional  "Assertion failed: len > 0, file mod_fastcgi.c"
 537
 538  *) Fixed "failed assertion `count >= 0 && count <= bufPtr->length'"
 539
 540  *) Added bflush() call after bwrite() in DrainReqOutBuf function to
 541     force some output to be written in the period of inactivity. This
 542     circumvents the Apache's buffering during the server-push.
 543
 544  *) Added a header-parser function placeholder for compatibility with an
 545     Apache source code.
 546
 547  *) Additional checks have been placed with regard to permissions of the
 548     FastCGI processes.  These include the existence of the  file,
 549     ExecCGI and IncludesNOEXEC checks, disallowing of nph- scripts, etc.
 550
 551  *) Implemented a restart cleanup, so that no parentlesses FastCGI
 552         applications are left after Apache is restarted and/or terminated.
 553         This was accomplished via two independent mechanisms, where the
 554         first one prevents a start of the process manager on the first
 555         reading of the configuration files.  The second mechanism deals away
 556         from Apache's  implementation of fork() (via spawn_child()) and
 557         implements its own forking, thus removing any dependencies on the
 558         Apache to cleanup  processes during termination phase.
 559
 560  *) Removed the definition of the Sigfunc, as Apache 2.0b10 defines it
 561     itself in the file conf.h
 562
 563 What's New: Version 1.4.3, 15 Jan 1997
 564
 565  *) Fixed compilation warnings for various platforms, as well as
 566         conditional compilation for OS/2.
 567
 568 What's New: Version 1.4.2, 12 Dec 1996
 569
 570  *) mod_fastcgi.c is ported to Apache 1.2b.  Any further development
 571         will proceed under this version of Apache web server.
 572
 573  *) As the result of porting, the "include virtual" construct of SSI
 574         will now work correctly using either <Location> or <Directory>
 575         directive.
 576
 577 What's New: Version 1.4.1, 4 Dec 1996
 578
 579  *) Checks have been removed from the ScanCGIHeaders that provided
 580     for the presence of both Status and Location headers as being
 581     an error.  Contradictory to CGI/1.1 Internet Draft, both of
 582     these headers are used by the current CGI applications.
 583
 584 What's New: Version 1.4, 22 Nov 1996
 585
 586  *) Added the -port option to AppClass, allowing TCP/IP communication.
 587     Added the -socket option to AppClass, allowing Unix domain
 588     communication via a configurable pathname.
 589
 590  *) Added the ExternalAppClass directive, allowing TCP/IP
 591     communication with remote FastCGI applications.
 592
 593  *) The handler had its own code for generating HTTP response headers;
 594     now it uses Apache's.  This reduces the size of the module.
 595     More importantly, it fixes the bug in which "include virtual"
 596     sees the HTTP response headers.
 597
 598  *) The response header parser performed very little checking.
 599     Now the parser enforces the guidelines in the CGI/1.1
 600     Internet-Draft: Status and Location are mutually exclusive,
 601     Location can only be a response to GET or HEAD,
 602     CGI response headers can't be repeated, etc.  (The CGI response
 603     headers are the ones the handler interprets: Status, Location,
 604     and Content-type.)
 605
 606  *) The response header parser used to miss CGI headers
 607     with no whitespace after the colon, e.g. "Status:200 OK".
 608
 609  *) The response header parser sometimes interpreted the first line
 610     of content as an RFC822 continuation line.
 611
 612  *) The handler implemented a nonstandard version of Location
 613     which never used internal redirects.  The handler
 614     now attempts to implement Location as specified in the
 615     CGI/1.1 Internet-Draft.  The module documentation explains
 616     the new behavior.
 617
 618  *) Error log entries from the response header parser were
 619     pretty uninformative; they are better now.  If a header is
 620     malformed, the log entry includes it.  If the headers are
 621     unterminated rather than malformed, the log entry says that,
 622     and says how many bytes were received from the app.
 623
 624  *) When the application manager forked a new process, and that
 625     process ran into trouble before executing the first instruction
 626     of application code, the process used to exit with status =
 627     errno.  This made certain configuration problems (e.g. incorrect
 628     file permissions when server parent is root) quite difficult
 629     to pin down.  Now the failing child process opens up the error log
 630     and writes an informative entry before exiting.
 631
 632  *) The module now correctly handles a slash at the end of the
 633     DocumentRoot directive.  This was a one-line fix.
 634
 635 What's New: Version 1.3.3, 17 Oct 1996
 636
 637  *) The module now registers its request handler under the name
 638     fastcgi-script in addition to the name application/x-httpd-fcgi.
 639     This was a one-line addition to the module, but had quite
 640     a large impact on the documentation and sample configuration.
 641
 642 What's New: Version 1.3.2, 27 Sept 1996
 643
 644  *) On some systems (SunOS, Linux?), fopen for append has a bug
 645     that strikes when two processes append to the same file.
 646     This bug causes the process manager to corrupt the error log.
 647     Work around the bug by calling open, then fdopen.  A patch
 648     to Apache 1.1.1 is also required, as described in mod_fastcgi.html.
 649     (Reported by Bob Ramstad.)
 650
 651 What's New: Version 1.3.1, 17 Sept 1996
 652
 653  *) On Linux and SunOS, the Apache default user_id (-1) is not a
 654     legal value of uid_t, so cast it.  (Reported by Bob Ramstad,
 655     Scott Langley, others.)
 656
 657  *) On some systems (Linux, some Solaris?, Irix?), connect requires
 658     write access to a Unix Domain socket, so provide it.  (Reported
 659     by Scott Langley, freeform@wired.com, others.)
 660
 661  *) If you hit a .fcg file, but there's no AppClass defined, the
 662     error should be NOT_FOUND instead of SERVER_ERROR.  (Reported
 663     by Michael Smith.)
 664
 665 What's New: Version 1.3, 4 Sept 1996
 666
 667  *) Module sometimes busy-waited in FastCgiDoWork.  Fixed.
 668
 669  *) Module violated the Apache buff abstraction.
 670     Fixed.  Might now work with SSL (not tested).
 671     As part of the fix, eliminated support for
 672     Apache 1.0x versions.
 673
 674  *) Module failed to chmod the Unix domain listening sockets
 675     it created, so protections were set according to the current
 676     umask.  Fixed.
 677
 678  *) Module forked too many process manager processes: One
 679     per AppClass.  When the Apache parent ran as root, these
 680     process manager processes ran as root.  New process
 681     manager is a single process (only started if AppClass is
 682     used) and runs with same privileges as other children.
 683     The new process manager doesn't do any polling, so
 684     there's less system overhead than before.
 685
 686  *) AppClass insisted on getting at least two arguments.  Fixed.
 687
 688  *) Module used setjmp/longjmp, causing compiler warnings
 689     on some platforms (e.g. Linux.)  The module no longer
 690     uses setjmp/longjmp.
 691
 692  *) Module created listening sockets in /tmp, where they were
 693     sometimes wiped out by cleanup scripts.  Added FastCgiIpcDir
 694     directive to give control over the location of listening
 695     sockets.
 696
 697  *) Module wrote error log entries without a timestamp.  Fixed.
 698
 699  *) AppClass directive wrote error messages to stderr in addition
 700     to returning a char * message to the Apache core.  Fixed.
 701
 702 What's New: Version 1.2, 3 June 1996
 703
 704  *) Ported from Apache-1.0-based code to Apache-1.1b2 internals by
 705     Ralf S. Engelschall
 706     <rse@en.muc.de>
 707     Add version string: APACHEVERSION macro to mod_fastcgi.c
 708
 709  *) chown FastCGI socket to user_id and setuid to user_id for app
 710     class processes
 711
 712  *) Modify GetFromStream() by having it call an OS dependent
 713     function GetStreamSize(FILE *) which uses FILE internal data member.
 714     Linux users might need to modify GetStreamSize().
 715
 716 What's New: Version 1.1, 10 May 1996
 717
 718  *) If you specify a non-existent executable in the AppClass directive,
 719         or if the file exists and it does not have execute permission you
 720         get a constant stream of error messages telling you that "program
 721         terminated due to a signal".
 722
 723  *) The mod_fastcgi module should use the standard Apache error logging
 724         facility instead of writing to stderr.
 725
 726 Version 1.0, 30 April 1996
 727
 728