2 FCGI_StartFilterData - fcgi_stdio compatibility library
5 #include "fcgi_stdio.h"
8 FCGI_StartFilterData(void);
12 Enables a FastCGI Filter application to begin reading its filter
13 input data from stdin.
15 In order to call FCGI_StartFilterData, the FastCGI
16 application should have been invoked in the Filter role
17 (getenv("FCGI_ROLE") == "FILTER"), and should have read
18 stdin to EOF, consuming the entire FCGI_STDIN data stream.
19 The call to FCGI_StartFilterData positions stdin at the
22 If the preconditions are not met (e.g. the application has
23 not read stdin to EOF), FCGI_StartFilterData returns
24 a negative result, and the application will get EOF on attempts
27 The application can determine the number of bytes available
28 on FCGI_DATA by performing atoi(getenv("FCGI_DATA_LENGTH")).
29 If fewer than this many bytes are delievered on stdin after
30 calling FCGI_StartFilterData, the application should perform
31 an application-specific error response. If the application
32 normally makes an update, most likely it should abort the update.
34 The application can determine last modification time of the
35 filter input data by performing getenv("FCGI_DATA_LAST_MOD").
36 This allows applications to perform caching based on last
41 0 for successful call, < 0 for error.
49 Copyright (c) 1996 Open Market, Inc.
50 See the file "LICENSE.TERMS" for information on usage and redistribution
51 of this file, and for a DISCLAIMER OF ALL WARRANTIES.
52 $Id: FCGI_StartFilterData.3,v 1.1 1997/09/16 15:36:26 stanleyg Exp $