CHANGES

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