FCGI_StartFilterData.3

命名
     FCGI_StartFilterData - fcgi_stdio兼容库

摘要
     #include "fcgi_stdio.h"

     int
     FCGI_StartFilterData(void);


说明
     开启一个FastCGI过滤器应用来开始从stdin读取其过滤输入数据。

     为了调用FCGI_StartFilterData，FastCGI应用应当已经
     作为过滤器角色被调用（getenv("FCGI_ROLE") == "FILTER"），
     而且应当已经读取stdin到EOF，即吸取整个FCGI_STDIN数据流。
     对FCGI_StartFilterData的调用定位stdin到FCGI_DATA的开始处。

     如果前提条件不满足（例如应用没有读取stdin到EOF），
     FCGI_StartFilterData返回负的结果，
     而且应用在尝试从stdin读取时将得到EOF。

     通过执行atoi(getenv("FCGI_DATA_LENGTH"))，应用能够确定FCGI_DATA上
     可用的字节数。如果少于这个数，在调用FCGI_StartFilterData之后
     很多字节被交回stdin，应用应当完成一次特定于应用的错误响应。
     如果应用进行正常的更新，很可能它会中止更新。

     通过执行getenv("FCGI_DATA_LAST_MOD")，应用能够确定过滤输入数据的
     最近修改时间。这允许应用执行基于最近修改时间的缓存操作。

     
返回值
     成功调用时为0，出错时< 0。

请参阅
     FCGI_Accept(3)
     FCGI_SetExitStatus(3)
     cgi-fcgi(1)

历史记录
     Copyright (c) 1996 Open Market, Inc.
     关于本文件的用法和再分发信息，以及无担保说明，请参阅。
     $Id: FCGI_StartFilterData.3,v 1.1.1.1 1997/09/16 15:36:26 stanleyg Exp $