home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1998 May / Pcwk5b98.iso / WEBSERVE / PI3 / PI3WEB.EXE / Pi3Docs / Examples / Config / Features.pi3 < prev    next >
Encoding:
Text File  |  1997-10-31  |  35.6 KB  |  1,188 lines
  1. <HTML><TITLE>Features.pi3</TITLE><BODY><PRE>#!Pi3
  2.  
  3. # ===
  4. #
  5. # Top level configuration file
  6. #
  7. #    ** IMPORTANT **
  8. #    If you do nothing else then do this:
  9. #
  10.  
  11. #... ###### Customize server settings
  12.  
  13. # Skip below to the definition of 'MainVirtualHostInformation', change
  14. # the settings for Hostname (*Mandatory* redirects will not work without
  15. # this!) and Administrator (optional).
  16. #
  17. # ===
  18.  
  19. # Include  standard IO and server stuff
  20. include ../Conf/IO.cnf
  21. include ../Conf/Server.cnf
  22. include ../Conf/Pi3API.cnf
  23.  
  24. # ---
  25. #
  26. # IO Object for main listening socket.
  27. #
  28. # ---
  29. <Object>
  30.     Name ServerIOObject
  31.     Class TCPIPIOClass
  32.     Type Passive
  33.  
  34. # A hostname must be specified for the Pi3Web HTTP server. The hostname
  35. # will be the used by the server to identify itself in URLs generated
  36. # for redirects and will also be used to lookup the IP address that this
  37. # server will listen on.
  38.     BindHost localhost
  39.  
  40. # A TCP port must be specified for this HTTP server. The TCP port
  41. # is the port that the HTTP will listen for requests on. This is
  42. # typically 80 for HTTP servers. 
  43. #
  44. # Note that UNIX operating systems normally require that the server
  45. # initially run as user 'root' to bind on ports between 0 and 1024
  46.     BindPort 80
  47.  
  48. # Timeout accepting connections. -1 specifies no timeout.
  49.     AcceptTimeout -1
  50.  
  51. # Specify timeout for sending data. -1 specifies no timeout. 
  52.  
  53.     RecvTimeout 60
  54.  
  55. # Specify timeout for receiving data. -1 specifies no timeout. 
  56.     SendTimeout 45
  57.     PeerIPVariable STRING:RemoteAddr
  58.     PeerHostNameVariable STRING:RemoteHost
  59.     LocalAddressVariable STRING:LocalAddr
  60.  
  61. # Flags
  62. #
  63. #   OwnDB - Object adds its own DB, rather than use the parents
  64. #               this is necessary to avoid collision of values placed in
  65. #               the DB between different connection. 
  66. #
  67. #   SetPeerAddress - IP address of remote peer with be put
  68. #               into the specified variable.
  69. #
  70. #   DNSReverseLookup - Use reverse DNS to get the hostname of the 
  71. #               peer and place it in the specified variable.
  72. #
  73. #   SetLocalAddress - Put local address in the specified variable.
  74.     Flags OwnDB|SetPeerAddress|DNSReverseLookup|SetLocalAddress
  75.  
  76. # Pointer to file with lockfile name, to avoid collisions on accept
  77. # with multiple processes
  78.     AcceptLockFile  "../Logs/lockfile.txt"
  79. </Object>
  80.  
  81. # ---
  82. #
  83. # Main virtual host object.
  84. #
  85. # ---
  86. <Object>
  87.     Name MainVirtualHostInformation
  88.     Class VirtualHostClass
  89.  
  90. # Administrator for the primary virtual host
  91.     Administrator webmaster@localhost
  92.  
  93. # Hostname that this server uses in redirects.
  94.     HostName localhost
  95.  
  96. # Port that the server uses in redirects.
  97. # Specify it only if it is not the standard port for the protocol in
  98. # use, i.e. 80 for HTTP and 443 for HTTPS
  99. #    ServerPort 80
  100.  
  101. </Object>
  102.  
  103. # ---
  104. #
  105. #    Thread dispatch object
  106. #
  107. #   This is an instance of MultiThreadedIOServerClass with appropriate
  108. #   parameters
  109. #
  110. # ---
  111. <Object>
  112.     Name ThreadPoolDispatcher
  113.     Class MultiThreadedIOServerClass
  114.  
  115. # The IOObject is the object that will be used for the listening socket
  116. # it can be a real IOObject (such as TCP/IP), as test IO object which 
  117. # feeds stub data into the server or a filter IO object which encrpts
  118. # or logs data passed through it.
  119. #
  120. #    Example test IO object:
  121. #     IOObject TestIOObject
  122. #
  123. #    Log IO to file:
  124. #    IOObject <A HREF="/pidocs/Objects/IO.html#SnoopIO">SnoopIO</A> IOObject="ServerIOObject" OutFile="./snoop.dbg"
  125. #
  126.     IOObject ServerIOObject
  127.  
  128. # Dispatch accepted IO connection to the HTTPLogicObject
  129.     LogicObject HTTPLogicObject
  130.  
  131. # Number of threads to use 
  132.     MaxThreads 10
  133.  
  134. # Number of requests to exit after
  135.     ExitAfter 1000
  136.  
  137. </Object>
  138.  
  139. # ---
  140. #
  141. # Main Pi3 object. 
  142. #
  143. # This is an instance of the UNIXDaemonClass to fork the server into
  144. # one monitor process and 'NumberOfProcesses' child processes. 
  145. #
  146. # The monitor process automatically starts a new child processes whenever
  147. # a child process exits.
  148. #
  149. # ---
  150. <Object>
  151.     Name Main
  152.     Class UNIXDaemonClass
  153.  
  154. # Actual class to accept new IO requests and dispatch them
  155.     ServerObject ThreadPoolDispatcher
  156.     PIDFile "../Logs/pid.log"
  157.     RLimitCpu Maximum
  158.  
  159. # User that child processes will run as. Server must run as root to 
  160. # be able to change to the specified user. A user id number can be
  161. # specified with #number. Server which start with root privileges should
  162. # change to a user id with lesser privileges for security reasons.
  163. #   User nobody
  164.  
  165. # Group that child processes will run as. Server must run as root to
  166. # be able to change to a different group. A group id number can be
  167. # specified with #number.
  168. #   Group #-1
  169.  
  170. # generate a server unique lockfile name and write it into
  171. # Logs/lockfile.txt
  172.     LockFileName "../Logs/lockfile.txt"
  173.  
  174. # Message to write just before the server is ready to start accepting
  175. # connections.
  176. # default
  177.     Message "Pi3Web HTTP Server Started"
  178.  
  179. # Specify the number of processes. 
  180.  
  181.     NumberOfProcesses 8
  182.  
  183. </Object>
  184.  
  185.  
  186.  
  187. # ===
  188. #
  189. # Features.pi3
  190. #
  191. #    Showcase features of Pi3Web server. Use this configuration
  192. #    only for personal or workgroup use. Its not optimal
  193. #    for use on the public internet. Here's why:
  194. #
  195. #        - Performance is slower because of all the extra
  196. #    handlers that are added in and the funky things that they
  197. #    do.
  198. #
  199. #        - Bigger and more complex is less secure against
  200. #    attack than smaller and featureless. The server created
  201. #    by this configuration is bigger and more complex.
  202. #
  203. # ===
  204.  
  205.  
  206. #
  207. # Load library definitions for classes used here.
  208. #
  209. include ../Conf/HTTP.cnf
  210. include ../Conf/Fcgi.cnf
  211. include ../Conf/Plugins.cnf
  212. include ../Conf/ISAPI.cnf
  213.  
  214. # ---
  215. #
  216. # Documentation is handled as HTML regardless of file extension. Also,
  217. # files have headers and footers attached to make them pretty.
  218. #
  219. # ---
  220. <Object>
  221.     Name DocumentMapper
  222.     Class PathMapperClass
  223.     #
  224.     # leave calling card
  225.     #
  226.     <A HREF="/pidocs/Objects/HTTP.html#Action">Action</A> "&dbreplace(response,string,ObjectMap,Pi3Docs)"
  227. </Object>
  228.  
  229. # ---
  230. #
  231. # CGIMapper
  232. #
  233. #    Instance of PathMapperClass to Map <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A> URLs
  234. #
  235. #    <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A> Scripts set PATH_INFO. 
  236. #
  237. # ---
  238. <Object>
  239.     Name CGIMapper
  240.     Class PathMapperClass
  241.     CaseSensitive "No"
  242.     #
  243.     # Subdirectories below the mapping directory should be put in path info
  244.     #
  245.     PathInfo "Yes"
  246.     #
  247.     # Set the 'ObjectMap' variable in the response DB if this map is
  248.     # successful
  249.     #
  250.     <A HREF="/pidocs/Objects/HTTP.html#Action">Action</A> "&dbreplace(response,string,ObjectMap,Scripts)"
  251. </Object>
  252.  
  253. # ---
  254. #
  255. # WinCGIMapper and FCGIMapper
  256. #
  257. #     Like CGIMapper, except it leaves a different marker to cause
  258. #     a different object to handle the request.
  259. #
  260. # ---
  261. <Object>
  262.     Name WinCGIMapper
  263.     Class PathMapperClass
  264.     PathInfo "Yes"
  265.     <A HREF="/pidocs/Objects/HTTP.html#Action">Action</A> "&dbreplace(response,string,ObjectMap,WinScripts)"
  266. </Object>
  267. <Object>
  268.     Name FCGIMapper
  269.     Class PathMapperClass
  270.     PathInfo "Yes"
  271.     <A HREF="/pidocs/Objects/HTTP.html#Action">Action</A> "&dbreplace(response,string,ObjectMap,FastCGIScripts)"
  272. </Object>
  273.  
  274. # ---
  275. #
  276. # AdminMapper
  277. #
  278. # For protected spaces
  279. #
  280. # ---
  281. <Object>
  282.     Name AdminMapper
  283.     Class PathMapperClass
  284.  
  285.     #
  286.     # Set the authentication realm so the <A HREF="/pidocs/Objects/HTTP.html#BasicAuth">BasicAuth</A> handler kicks in
  287.     <A HREF="/pidocs/Objects/HTTP.html#Action">Action</A> "&dbreplace(response,string,AuthenticationRealm,Admin)"
  288. </Object>
  289.  
  290. # ---
  291. #
  292. # AccessLogger
  293. #
  294. #    An instance of ExpressionLoggerClass configured to generate an 
  295. #    logfile
  296. #
  297. # ---
  298. <Object>
  299.     Name AccessLogger
  300.     Class ExpressionLoggerClass
  301.  
  302.     #
  303.     # Append
  304.     #
  305.     OpenMode "a"
  306.     #
  307.     # Line to log 
  308.     Expression "$A $h - [$t] \"$r\" $s $b$M"
  309. </Object>
  310.  
  311. # ---
  312. #
  313. # Start
  314. #
  315. #    Handle initial phases of requests, typically before we have enough
  316. #    information to select different execution paths
  317. #
  318. # ---
  319. <Object>
  320.     Name Start
  321.     Class FlexibleHandlerClass
  322.     Init <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  323.     Headers <A HREF="/pidocs/Objects/HTTP.html#ReadRequestHeaders">ReadRequestHeaders</A>
  324.  
  325.     #
  326.     # The handler 'VirtualHosts' is described below
  327.     #
  328.     HostMap VirtualHosts
  329.  
  330.     #
  331.     # Mapping virtual paths to example directory with 'DirListType' set
  332.     #
  333.     Mapping DirectoryMappings
  334.  
  335.     #
  336.     # Default mappings
  337.     #
  338.     Mapping <A HREF="/pidocs/Objects/HTTP.html#MapToErrorDocument">MapToErrorDocument</A> \
  339.         IgnoreStatus="0 200" \
  340.         DefaultMessage="/errors/unknown.htm" \
  341.         301="/errors/301.ssi" \
  342.         304="/errors/304.htm" \
  343.         400="/errors/400.htm" \
  344.         401="/errors/401.ssi" \
  345.         403="/errors/403.ssi" \
  346.         404="/errors/404.ssi" \
  347.         500="/errors/500.ssi" \
  348.         501="/errors/501.htm"
  349.     Mapping <A HREF="/pidocs/Objects/Plugins.html#UserDirectory">UserDirectory</A> UserDirectoryRoot="/home/" \
  350.         HTMLDirectory="/public_html"
  351.     Mapping CGIMapper From="/cgi-bin/" To="cgi-bin/"
  352.     Mapping WinCGIMapper From="/cgi-win/" To="cgi-win/"
  353.     Mapping FCGIMapper From="/cgi-fcgi/" To="cgi-fcgi/"
  354.     Mapping DocumentMapper From="/pidocs/" To="Pi3Docs/" 
  355.     Mapping <A HREF="/pidocs/Objects/HTTP.html#PathMapper">PathMapper</A> From="/errors/" To="Fragment/" 
  356.     Mapping <A HREF="/pidocs/Objects/HTTP.html#PathMapper">PathMapper</A> From="/icons/" To="Icons/" 
  357.  
  358. # mapping to view logfiles disabled
  359. #    Mapping <A HREF="/pidocs/Objects/HTTP.html#PathMapper">PathMapper</A> From="/logs/" To="Logs/" 
  360.  
  361.     Mapping AdminMapper From="/admin/" To="Logs/" 
  362.     Mapping <A HREF="/pidocs/Objects/HTTP.html#PathMapper">PathMapper</A> From="/Pi3Expressions/" To="**internal**/" \
  363.         Action="&dbreplace(response,string,ObjectMap,Pi3Expr)" \
  364.         PathInfo="Yes"
  365.     Mapping <A HREF="/pidocs/Objects/HTTP.html#PathMapper">PathMapper</A> From="/isapi/" To="Isapi/" \
  366.         Action="&dbreplace(response,string,ObjectMap,ISAPI)" \
  367.         PathInfo="Yes"
  368.  
  369.     #
  370.     # Mapping specific to Host2
  371.     #
  372.     Mapping Host2Mappings
  373.  
  374.     #
  375.     # Mapping specific to MainVirtualHostInformation
  376.     #
  377.     Mapping Host1Mappings
  378. </Object>
  379.  
  380. # ---
  381. #
  382. # Default
  383. #
  384. #    Handle requests that other handlers have passed up
  385. #
  386. # ---
  387. <Object>
  388.     Name Default
  389.     Class FlexibleHandlerClass
  390.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#DirectoryExists">DirectoryExists</A> IndexFile="index.html" IndexFile="index.htm"
  391.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="EF" RefuseStatus=404
  392.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="F" RefuseStatus=403
  393.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  394.     CheckAuth <A HREF="/pidocs/Objects/HTTP.html#BasicAuth">BasicAuth</A> Realm="Admin"
  395.     CheckAuth <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  396.     CheckAccess <A HREF="/pidocs/Objects/HTTP.html#AccessByFile">AccessByFile</A> RequirePermissions="R"
  397.  
  398.     #
  399.     # Cause a '501 Not Implemented' Message for requests that
  400.     # are not 'GET' or 'HEAD', i.e.
  401.     #    if !( Method=='GET' || Method=='HEAD' ) 
  402.     #    then
  403.     #        set status = 501
  404.     #    endif
  405.     #
  406.     CheckType Condition="¬(&or(&cmpi($m,GET),&cmpi($m,HEAD)))" \
  407.         <A HREF="/pidocs/Objects/HTTP.html#StatusCode">StatusCode</A> StatusCode="501"
  408.     CheckType <A HREF="/pidocs/Objects/HTTP.html#ConditionalGet">ConditionalGet</A>
  409.     CheckType <A HREF="/pidocs/Objects/HTTP.html#CheckForDirectory">CheckForDirectory</A> SetType="internal/x-directory"
  410.  
  411.     #
  412.     # Otherwise: Set the media type based on the file extension
  413.     #
  414.     CheckType <A HREF="/pidocs/Objects/HTTP.html#MIMETypeByExtension">MIMETypeByExtension</A> 
  415.  
  416.     #
  417.     # Return 'COMPLETED' so an internal error will not be raised
  418.     #
  419.     CheckType <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode="COMPLETED"
  420.  
  421.     #
  422.     # Most requests refer to a file, so put that first 
  423.     #
  424.     # Handle the request by sending a file if
  425.     #    - The Value of ObjectMap in the response DB is ""
  426.     #    AND
  427.     #    - The Media type of the resource does not match internal/* 
  428.     #
  429.     Handle Condition="&and(¬(&dblookup(response,string,ObjectMap)),\
  430. ¬(®exp('internal/*',$c)))" <A HREF="/pidocs/Objects/HTTP.html#SendFile">SendFile</A>
  431.     Handle Condition="&cmp($c,internal/x-directory)" DirectoryIndexes
  432.     Handle Condition="&cmp($c,internal/x-server-parsed-html)" <A HREF="/pidocs/Objects/HTTP.html#SendSSI">SendSSI</A> \
  433.         Exec=Yes ExecFileFixup="\
  434. /* exec file="" maps to Standard <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A> (Scripts) */\
  435. &dbreplace(response,string,ObjectMap,Scripts)\
  436. &dbreplace(response,rfc822,Content-Type,internal/x-cgi)"
  437.     Handle Condition="&cmp($c,internal/x-imagemap)" <A HREF="/pidocs/Objects/Plugins.html#ImageMap">ImageMap</A>
  438.     Handle <A HREF="/pidocs/Objects/HTTP.html#SendFile">SendFile</A>
  439.     Log AccessLogger File="Logs/access.txt"
  440.     Log <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  441.     Destroy <A HREF="/pidocs/Objects/HTTP.html#DeleteTemporaryFiles">DeleteTemporaryFiles</A>
  442. </Object>
  443.  
  444. # ---
  445. #
  446. # Documentation
  447. #
  448. #    Handler sequence for documentation.
  449. #
  450. # ---
  451. <Object>
  452.     Name Documentation
  453.     Class FlexibleHandlerClass
  454.  
  455.     #
  456.     # Only execute this sequence for the documentation (check for
  457.     # the appropriate marker).
  458.     #
  459.     # Don't handle special resource types (internal/...)
  460.     #
  461.     Condition "&and(&cmp(&dblookup(response,string,ObjectMap),Pi3Docs),\
  462. ¬(®exp('internal/*',$c)))"
  463.  
  464.     #
  465.     # Check if file is a directory
  466.     # 
  467.     CheckType <A HREF="/pidocs/Objects/HTTP.html#CheckForDirectory">CheckForDirectory</A> SetType="internal/x-directory"
  468.  
  469.     #
  470.     # Lookup media type by extension
  471.     #
  472.     CheckType <A HREF="/pidocs/Objects/HTTP.html#MIMETypeByExtension">MIMETypeByExtension</A>
  473.  
  474.     #
  475.     # Force all non-internal media types to 'text/html'
  476.     #
  477.     CheckType Condition="¬(®exp('internal/*',$c))" <A HREF="/pidocs/Objects/HTTP.html#Action">Action</A> \
  478.         Pi3Expression="&dbreplace(response,rfc822,Content-Type,text/html)"
  479.  
  480.     #
  481.     # Return 'COMPLETED' so as not to fall into other cases
  482.     #
  483.     CheckType <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode="COMPLETED"
  484.  
  485.     #
  486.     # For documentation, Send documentation with header and footer
  487.     #
  488.     Handle <A HREF="/pidocs/Objects/HTTP.html#SendFile">SendFile</A> HeaderPattern="<BODY BACKGROUND="/icons/\
  489. &if(&cmpi($o,MainVirtualHostInformation),Pi3Tile.gif,H2Tile.gif)"/*background depends on vhost*/\
  490. BGCOLOR="#FFFFFF">\n"
  491. </Object>
  492.  
  493. # ---
  494. #
  495. # FastCGIIOObject
  496. # 
  497. # IOObject for communicating with fast <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A> application servers. This
  498. # one uses the TCP/IP transport.
  499. #
  500. # ---
  501. <Object>
  502.     Name FastCGIIOObject
  503.     Class TCPIPIOClass
  504.     Type Active
  505.  
  506.     # Timeouts. -1 specifies no timeout.
  507.     RecvTimeout 20
  508.     SendTimeout 20
  509. </Object>
  510.  
  511. # ---
  512. # 
  513. # Scripts, WinScripts, ISAPI, FastCGIScripts, Pi3Expr
  514. #
  515. #    Handler sequences for resources which have mapped to these
  516. #     respective types
  517. #
  518. # ---
  519. <Object>
  520.     Name Scripts
  521.     Class FlexibleHandlerClass
  522.     Condition "&cmp(&dblookup(response,string,ObjectMap),Scripts)"
  523.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="EFD" RefuseStatus=404
  524.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="F" RefuseStatus=403
  525.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  526.     CheckAccess <A HREF="/pidocs/Objects/HTTP.html#AccessByFile">AccessByFile</A> RequirePermissions="X"
  527.     CheckType <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  528.     Handle StandardCGI
  529. </Object>
  530. <Object>
  531.     Name WinScripts
  532.     Class FlexibleHandlerClass
  533.     Condition "&cmp(&dblookup(response,string,ObjectMap),WinScripts)"
  534.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="EFD" RefuseStatus=404
  535.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="F" RefuseStatus=403
  536.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  537.     CheckAccess <A HREF="/pidocs/Objects/HTTP.html#AccessByFile">AccessByFile</A> RequirePermissions="X"
  538.     CheckType <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  539.     Handle WinCGI
  540. </Object>
  541. <Object>
  542.     Name ISAPI
  543.     Class FlexibleHandlerClass
  544.     Condition "&cmp(&dblookup(response,string,ObjectMap),ISAPI)"
  545.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="EFD" RefuseStatus=404
  546.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="F" RefuseStatus=403
  547.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  548.     CheckAccess <A HREF="/pidocs/Objects/HTTP.html#AccessByFile">AccessByFile</A> RequirePermissions="X"
  549.     CheckType <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  550.     Handle <A HREF="/pidocs/Objects/ISAPI.html#ISAPI20">ISAPI20</A>
  551. </Object>
  552. <Object>
  553.     Name FastCGIScripts
  554.     Class FlexibleHandlerClass
  555.     Condition "&cmp(&dblookup(response,string,ObjectMap),FastCGIScripts)"
  556.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="EFD" RefuseStatus=404
  557.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#RefuseFileByMask">RefuseFileByMask</A> AllowFileMask="F" RefuseStatus=403
  558.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  559.     CheckAccess <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode="COMPLETED"
  560.     CheckType <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode="COMPLETED"
  561.     Handle <A HREF="/pidocs/Objects/Fcgi.html#FastCGI">FastCGI</A> \
  562.         IOObject="FastCGIIOObject" \
  563.         Variable="AUTH_TYPE=$x" \
  564.         Variable="CONTENT_LENGTH=$Y" \
  565.         Variable="CONTENT_TYPE=$C" \
  566.         Variable="HTTPS=$g" \
  567.         Variable="&if($K,HTTPS_KEYSIZE=$K,)" \
  568.         Variable="&if($K,HTTPS_SECRETKEYSIZE=$G,)" \
  569.         Variable="PATH_INFO=$I" \
  570.         Variable="PATH_TRANSLATED=$Z" \
  571.         Variable="QUERY_STRING=$q" \
  572.         Variable="REMOTE_ADDR=$A" \
  573.         Variable="REMOTE_HOST=$h" \
  574.         Variable="REMOTE_IDENT=$i" \
  575.         Variable="REMOTE_USER=$u" \
  576.         Variable="REQUEST_METHOD=$m" \
  577.         Variable="SCRIPT_NAME=$z" \
  578.         Variable="SERVER_NAME=$v" \
  579.         Variable="SERVER_PORT=&if($p,$p,&if($K,443,80))" \
  580.         Variable="SERVER_PROTOCOL=$H" \
  581.         Variable="SERVER_SOFTWARE=$S"
  582. </Object>
  583. <Object>
  584.     Name Pi3Expr
  585.     Class FlexibleHandlerClass
  586.     Condition "&cmp(&dblookup(response,string,ObjectMap),Pi3Expr)"
  587.     CheckPath <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode="COMPLETED"
  588.     CheckAccess <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode="COMPLETED"
  589.     CheckType <A HREF="/pidocs/Objects/HTTP.html#ReturnCode">ReturnCode</A> ReturnCode=COMPLETED
  590.     Handle <A HREF="/pidocs/Objects/HTTP.html#SendPi3Expression">SendPi3Expression</A> HTTPEquiv="Content-Type: text/html" \
  591.         Pi3Expression="\
  592. /*                                             */\
  593. /*                                             */\
  594. /* A Large <A HREF="/pidocs/Objects/Pi3API.html#Pi3Expression">Pi3Expression</A> to send to the client */\
  595. /*              in one go                      */\
  596. /*                                             */\
  597. /*   This will generate a dynamic HTML page    */\
  598. /*                                             */\
  599. <TITLE>Pi3Expressions - DB Dump</TITLE>\
  600. <HTML><BODY BACKGROUND="/icons/Pi3Tile.gif">\
  601. <CENTER><H2>Pi3Expressions - DB Dump</H2>\
  602. <A NAME="index">$M\
  603. <UL>$M\
  604. <LI><A HREF="#connection">Connection DB</A>$M\
  605. <LI><A HREF="#request">Request DB</A>$M\
  606. <LI><A HREF="#response">Response DB</A>$M\
  607. <LI><A HREF="#host">Host DB</A>$M\
  608. </UL>$M\
  609. <HR>$M\
  610. <A NAME="connection">$M\
  611. <H3>Dump of Connection DB <I>dblookup(connection,...)</I></H3>$M\
  612. <TABLE BORDER=1 CELLPADDING=5><TH>Type<TH>Variable<TH>Value$M\
  613. &dblookup(connection,string,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  614. &dblookup(connection,rfc822,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  615. &dblookup(connection,opaque,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  616. </TABLE>\
  617. <A HREF="#index">Index</A>$M\
  618. <HR>$M\
  619. <A NAME="request">$M\
  620. <H3>Dump of Request DB <I>dblookup(request,...)</I></H3>$M\
  621. <TABLE BORDER=1 CELLPADDING=5><TH>Type<TH>Variable<TH>Value$M\
  622. &dblookup(request,string,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  623. &dblookup(request,rfc822,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  624. &dblookup(request,opaque,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  625. </TABLE>\
  626. <A HREF="#index">Index</A>$M\
  627. <HR>$M\
  628. <A NAME="response">$M\
  629. <H3>Dump of Response DB <I>dblookup(response,...)</I></H3>$M\
  630. <TABLE BORDER=1 CELLPADDING=5><TH>Type<TH>Variable<TH>Value$M\
  631. &dblookup(response,string,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  632. &dblookup(response,rfc822,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  633. &dblookup(response,opaque,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  634. </TABLE>\
  635. <A HREF="#index">Index</A>$M\
  636. <HR>$M\
  637. <A NAME="host">$M\
  638. <H3>Dump of Host DB <I>dblookup(host,...)</I></H3>$M\
  639. <TABLE BORDER=1 CELLPADDING=5><TH>Type<TH>Variable<TH>Value$M\
  640. &dblookup(host,string,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  641. &dblookup(host,rfc822,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  642. &dblookup(host,opaque,,,<TR><TD><B>&_(2)</B><TD>&_(1)<TD>&_()$M)\
  643. </TABLE>\
  644. <A HREF="#index">Index</A>$M\
  645. </CENTER><HR></BODY></HTML>"
  646.  
  647. </Object>
  648.  
  649. # ---
  650. #
  651. #    Virtual hosting handlers and configuration
  652. #
  653. # ---
  654.  
  655. #
  656. # Host2 Virtual host object
  657. <Object>
  658.     Name Host2
  659.     Class VirtualHostClass
  660.     Administrator mr_web@Host2.dom
  661.     HostName www.johnroy.com/host2
  662.     ServerPort 80
  663. </Object>
  664.  
  665. #
  666. # Virtual host mappings
  667. #
  668. <Object>
  669.     Name VirtualHosts
  670.     Class FlexibleHandlerClass
  671.  
  672.     #
  673.     # if the URL starts with '/host2/' assign to virtual host 2
  674.     #
  675.     HostMap <A HREF="/pidocs/Objects/HTTP.html#VirtualHostByURL">VirtualHostByURL</A> VirtualHostObject="Host2" URLPath="/host2/"
  676.  
  677.     #
  678.     # Introduce a mapping
  679.     Mapping Host2Mappings
  680. </Object>
  681.  
  682. #
  683. # Override some mappings for Host2 only
  684. #
  685. <Object>
  686.     Name Host2Mappings
  687.     Class FlexibleHandlerClass
  688.  
  689.     #
  690.     # These mappings only apply to Host2
  691.     #
  692.     Condition "&cmp($o,Host2)"
  693.  
  694.     #
  695.     # map to second document root
  696.     #
  697.     Mapping <A HREF="/pidocs/Objects/HTTP.html#PathMapper">PathMapper</A> From="/" To="WebRoot2/"
  698. </Object>
  699.  
  700. #
  701. # Host1 mappings
  702. #
  703. <Object>
  704.     Name Host1Mappings
  705.     Class FlexibleHandlerClass
  706.     #
  707.     # These mappings only apply to MainVirtualHostInformation
  708.     #
  709.     Condition "&cmp($o,MainVirtualHostInformation)"
  710.     #
  711.     # map to first document root
  712.     #
  713.     Mapping <A HREF="/pidocs/Objects/HTTP.html#PathMapper">PathMapper</A> From="/" To="WebRoot/"
  714. </Object>
  715.  
  716. # ---
  717. #
  718. # HTTPLogicObject
  719. #
  720. #     HTTP Logic object, dispatches requests to all other handlers
  721. #
  722. # ---
  723. <Object>
  724.     Name HTTPLogicObject
  725.     Class HTTPDispatcherClass
  726.     Handlers Start Scripts WinScripts FastCGIScripts Documentation Pi3Expr ISAPI Default
  727.     KeepOpen On
  728.     ServerRoot ./../
  729.     ServerStamp Pi3Web/0.9b4
  730.     DefaultHost MainVirtualHostInformation
  731.     MIMEFile "Fragment/Mime.typ"
  732.     DefaultMIMEType "application/octet-stream"
  733.     ErrorLogFile "Logs/error.txt"
  734.  
  735.     # Specifying a file for DebugLogFile effectively turns on debugging
  736. #    DebugLogFile "Logs/debug.txt"
  737.  
  738.     #
  739.     # The following to directives specify expressions to be logged
  740.     # before and after each handler execution respectively.
  741.     # The expression as given logs process/thread and handler context
  742.     # information indented to the nested handler level.
  743.     #
  744.     # Timing information is also given for performance tuning.
  745.     #
  746.     # This logging information is EXTREMELY verbose. Don't even
  747.     # think about using it in a production server
  748.     #
  749.     DebugBeforeHandler "[$P:$k] &align(,$X)&align(,$X) |--> $T \
  750. -------- &align($N,12) &align($R,12) $n \"$r\" $s"
  751.     DebugAfterHandler "[$P:$k] &align(,$X)&align(,$X) |<-- $T \
  752. &align($D,8) &align($N,12) &align($R,12) $n \"$r\" $s"
  753. </Object>
  754.  
  755. # ---
  756. #
  757. #    Directory listing handlers and configuration
  758. #
  759. # ---
  760. <Object>
  761.     Name DirectoryMappings
  762.     Class FlexibleHandlerClass
  763.  
  764.     #
  765.     # 1..Simple HTML
  766.     #
  767.     # simple HTML, no icons or descriptions
  768.     Mapping DocumentMapper From="/dir_SimpleHTML/" To="Pi3Docs/features/" \
  769.         Action="&dbreplace(response,string,DirListType,SimpleHTML)"
  770.  
  771.     #
  772.     # 2..Simple DOS like format with alternate name
  773.     # 
  774.     Mapping DocumentMapper From="/dir_DOS/" To="Pi3Docs/features/" \
  775.         Action="&dbreplace(response,string,DirListType,DOS)"
  776.  
  777.     #
  778.     # 3..Fixed pitch HTML with icons and descriptions
  779.     # plain HTML
  780.     Mapping DocumentMapper From="/dir_TableHTML/" \
  781.         To="Pi3Docs/features/" \
  782.         Action="&dbreplace(response,string,DirListType,TableHTML)"
  783.  
  784.     #
  785.     # 4..HTML with tables
  786.     #
  787.     # HTML with tables
  788.     Mapping DocumentMapper From="/dir_PlainHTML/" To="Pi3Docs/features/" \
  789.         Action="&dbreplace(response,string,DirListType,PlainHTML)"
  790.  
  791.     # 
  792.     # 5..Raw tab delimited text
  793.     #
  794.     # Tab delimited text
  795.     Mapping DocumentMapper From="/dir_TDT/" To="Pi3Docs/features/" \
  796.         Action="&dbreplace(response,string,DirListType,TDT)"
  797. </Object>
  798.  
  799. #
  800. # Directory Indexes
  801. #
  802. <Object>
  803.     Name DirectoryIndexes
  804.     Class FlexibleHandlerClass
  805.  
  806.     # 1..Simple HTML
  807.     Handle Condition="&cmp(&dblookup(response,string,DirListType),SimpleHTML)" \
  808.         SimpleHTML
  809.  
  810.     # 2..Simple DOS format
  811.     Handle Condition="&cmp(&dblookup(response,string,DirListType),DOS)" DOS
  812.  
  813.     # 3..Plain HTML
  814.     Handle Condition="&cmp(&dblookup(response,string,DirListType),PlainHTML)" \
  815.         PlainHTML 
  816.  
  817.     # 4..HTML with tables
  818.     Handle Condition="&cmp(&dblookup(response,string,DirListType),TableHTML)" \
  819.          TableHTML 
  820.  
  821.     # 5..Raw tab delimited text
  822.     Handle Condition="&cmp(&dblookup(response,string,DirListType),TDT)" TDT
  823.  
  824.     #
  825.     # The default index type used for examples other than the
  826.     # sample directory will be a table HTML index
  827.     #
  828.     Handle TableHTML
  829. </Object>
  830.  
  831. # ---
  832. #
  833. # Simple HTML
  834. #
  835. # ---
  836. <Object>
  837.     Name SimpleHTML
  838.     Class DirectoryIndexClass
  839.     HeaderPattern "<HTML><TITLE>Simple index of %p</TITLE>\
  840. <H2>Simple index of %p</H2>\n"
  841.     ListTop "\
  842. <PRE><B>\
  843. &align(Name,23) \
  844. &align(Size,6)  \
  845. &align(Last Modified,18)\
  846. \n<HR SIZE=1 NOSHADE></B>\n"
  847.     FilePattern "\
  848. <A HREF="%r">&align(&abbrev(%n,23,...)</A>,27) /*    link to file */\
  849. &align(%s,6)  /*                                    size */\
  850. &align(%l,18)/*                                        last modified date */\
  851. \n"
  852.     LastModifiedFormat "%d-%b-%y %H:%M"
  853.     Include "*"
  854.     SwapFileName ".. Parent Directory"
  855.     ListBottom "</PRE>\n"
  856.     FooterPattern "<HR SIZE=1 NOSHADE>\
  857. Contact the hostmaster <A HREF="mailto:$a"<I>$a</I></A>.\
  858. </HTML>"
  859.     HeaderFile "HEADER"
  860.     FooterFile "README"
  861.     Exclude "."
  862.     Exclude "~*"
  863.     Exclude ".desc"
  864.     Exclude "README"
  865.     Exclude "HEADER"
  866.     Options " Name | Size | RelPath "
  867. </Object>
  868.  
  869. # ---
  870. #
  871. # Simple DOS formatted index
  872. #
  873. # ---
  874. <Object>
  875.     Name DOS
  876.     Class DirectoryIndexClass
  877.     HeaderPattern "<HTML><TITLE>DOS style index of %p - </TITLE>\
  878. <H2>DOS style index of %p - </H2>\n\
  879. "
  880.     ListTop "<PRE>\
  881. &align(Last Modified,24,left)\
  882. &align(Size,14) \
  883. &align('(8,3) Name',12) \
  884. Name \n<HR SIZE=1 NOSHADE>"
  885.     FilePattern "\
  886. &align(%l,24)\
  887. &if(%b,&align('<DIR>',18,left),&align(%s,14,right)) \
  888. <A HREF="%r">&align(&abbrev(%a,12,...)</A>,16,left) \
  889. <A HREF="%r">%n</A> \n"
  890.     LastModifiedFormat "%d/%m/%y  %I:%M%p"
  891.     Include "*"
  892.     DescriptionFile ".desc"
  893.     ListBottom "</PRE>\n"
  894.     FooterPattern "<HR SIZE=1 NOSHADE>\
  895. Contact the hostmaster <A HREF="mailto:$a"<I>$a</I></A>.\
  896. </HTML>"
  897.     HeaderFile "HEADER"
  898.     FooterFile "README"
  899.     Exclude "."
  900.     Exclude "~*"
  901.     Exclude ".desc"
  902.     Exclude "README"
  903.     Exclude "HEADER"
  904.     Options " AltName | Name | FormatSize | RelPath "
  905. </Object>
  906.  
  907. # ---
  908. #
  909. # Plain HTML directory listing with icons
  910. #
  911. # ---
  912. <Object>
  913.     Name PlainHTML
  914.     Class DirectoryIndexClass
  915.     HeaderPattern "<HTML><TITLE>Plain HTML index of %p</TITLE>\
  916. <BODY BACKGROUND="/icons/\
  917. &if(&cmpi($o,MainVirtualHostInformation),Pi3Tile.gif,H2Tile.gif)"/*background depends on vhost*/\
  918. BGCOLOR="#FFFFFF">\
  919. <H2>Plain HTML index of %p</H2>\n"
  920.     ListTop "\
  921. <PRE>\
  922. <IMG SRC="/icons/blank.gif" BORDER=NONE ALT="  ">\
  923.  &align(Name,23) &align(Last Modified,18)\
  924. &align(Size,6)  Description\n<HR SIZE=1 NOSHADE>"
  925.     FilePattern "\
  926. <A HREF="%r"><IMG SRC="%i" BORDER=NONE ALT="[]"></A>/*icon is a link */\
  927.  <A HREF="%r">&align(&abbrev(%n,23,...)</A>,27) /*    link to file */\
  928. &align(%l,18)/*                                        last modified date */\
  929. &align(%s,6)  /*                                    size */\
  930. &if(%d,%d,<I>%c</I>)/*                                description, or MIME */\
  931. \n"
  932.     LastModifiedFormat "%d-%b-%y %H:%M"
  933.     Include "*"
  934.     MIMEIcon "text/html /icons/layout.gif"
  935.     MIMEIcon "text/x-code /icons/c.gif"
  936.     MIMEIcon "text/x-perl /icons/p.gif"
  937.     MIMEIcon "text/* /icons/text.gif"
  938.     MIMEIcon "internal/x-directory /icons/folder.gif"
  939.     MIMEIcon "audio/* /icons/sound2.gif"
  940.     MIMEIcon "image/* /icons/image2.gif"
  941.     MIMEIcon "application/x-uuencoded /icons/uuencoded.gif"
  942.     MIMEIcon "application/x-tar /icons/compressed.gif"
  943.     MIMEIcon "application/x-gzip /icons/compressed.gif"
  944.     MIMEIcon "application/x-sh /icons/script.gif"
  945.     MIMEIcon "application/* /icons/binary.gif"
  946.     MIMEIcon "x-world/x-vrml /icons/burst.gif"
  947.     MIMEIcon "*/* /icons/unknown.gif"
  948.     DescriptionFile ".desc"
  949.     SwapFileName ".. Parent Directory"
  950.     ListBottom "</PRE>\n"
  951.     FooterPattern "<HR SIZE=1 NOSHADE>\
  952. Contact the hostmaster <A HREF="mailto:$a"<I>$a</I></A>.\
  953. </BODY></HTML>"
  954.     HeaderFile "HEADER"
  955.     FooterFile "README"
  956.     Exclude "."
  957.     Exclude "~*"
  958.     Exclude ".desc"
  959.     Exclude "README"
  960.     Exclude "HEADER"
  961.     Options " Name | AbbrevSize | RelPath | Icon | MIMEType "
  962. </Object>
  963.  
  964. # ---
  965. #
  966. # Directory listing with HTML tables
  967. #
  968. # ---
  969. <Object>
  970.     Name TableHTML
  971.     Class DirectoryIndexClass
  972.     HeaderPattern "<HTML><TITLE>Enhanced HTML index of %p</TITLE>\
  973. <BODY BACKGROUND="/icons/\
  974. &if(&cmpi($o,MainVirtualHostInformation),Pi3Tile.gif,H2Tile.gif)"/*background depends on vhost*/\
  975. BGCOLOR="#FFFFFF">\
  976. <H2>Enhanced HTML index of %p</H2>\n"
  977.     ListTop "<CENTER><TABLE CELLSPACING=0 CELLPADDING=0 WIDTH=100'%'>\
  978. <TR>\
  979. <TH NOWARP ALIGN=LEFT>\
  980. <IMG SRC="/icons/blank.gif" ALIGN=MIDDLE BORDER=NONE ALT="">\
  981. <TH NOWRAP ALIGN=LEFT>Name<BR><HR SIZE=1 NOSHADE>\
  982. <TH NOWRAP ALIGN=LEFT>Size<BR><HR SIZE=1 NOSHADE>\
  983. <TH NOWRAP ALIGN=LEFT>Last Modified<BR><HR SIZE=1 NOSHADE>\
  984. <TH NOWRAP ALIGN=LEFT>Description<BR><HR SIZE=1 NOSHADE>\n"
  985.     FilePattern "<TR>\
  986. <TD NOWRAP ALIGN=LEFT VALIGN=TOP>\
  987. <A HREF="%r"><IMG SRC="%i" BORDER=NONE ALIGN=MIDDLE ALT=""></A>\
  988. <TD NOWRAP ALIGN=LEFT VALIGN=TOP><A HREF="%r">&abbrev(%n,20,...)</A>\
  989. <TD NOWRAP ALIGN=LEFT VALIGN=TOP>%s<TD>%l\
  990. <TD NOWRAP ALIGN=LEFT VALIGN=TOP>&if(%d,%d,<I>%c</I>)\n"
  991.     ListBottom "</TABLE></CENTER>\n"
  992.     LastModifiedFormat "%d-%b-%y %H:%M"
  993.     Include "*"
  994.     MIMEIcon "text/html /icons/layout.gif"
  995.     MIMEIcon "text/x-code /icons/c.gif"
  996.     MIMEIcon "text/x-perl /icons/p.gif"
  997.     MIMEIcon "text/* /icons/text.gif"
  998.     MIMEIcon "internal/x-directory /icons/folder.gif"
  999.     MIMEIcon "audio/* /icons/sound2.gif"
  1000.     MIMEIcon "image/* /icons/image2.gif"
  1001.     MIMEIcon "application/x-uuencoded /icons/uuencoded.gif"
  1002.     MIMEIcon "application/x-tar /icons/compressed.gif"
  1003.     MIMEIcon "application/x-gzip /icons/compressed.gif"
  1004.     MIMEIcon "application/x-sh /icons/script.gif"
  1005.     MIMEIcon "application/* /icons/binary.gif"
  1006.     MIMEIcon "x-world/x-vrml /icons/burst.gif"
  1007.     MIMEIcon "*/* /icons/unknown.gif"
  1008.     DescriptionFile ".desc"
  1009.     SwapFileName ".. Parent Directory"
  1010.     FooterPattern "<HR SIZE=1 NOSHADE>\
  1011. Contact the hostmaster <A HREF="mailto:$a"<I>$a</I></A>.\
  1012. </BODY></HTML>"
  1013.     HeaderFile "HEADER"
  1014.     FooterFile "README"
  1015.     Exclude "."
  1016.     Exclude "~*"
  1017.     Exclude ".desc"
  1018.     Exclude "README"
  1019.     Exclude "HEADER"
  1020.     Options " Name | AbbrevSize | RelPath | Icon | MIMEType "
  1021. </Object>
  1022.  
  1023. # ---
  1024. #
  1025. # Raw tab delimited directory index. For input into other
  1026. # applications. This data could be cut and pasted into a 
  1027. # spreadsheet application.
  1028. #
  1029. # ---
  1030. <Object>
  1031.     Name TDT
  1032.     Class DirectoryIndexClass
  1033.     FilePattern "%r\t%n\t%l\t%s\t%c\n"
  1034.     LastModifiedFormat "%d-%b-%y %H:%M"
  1035.     Include "*"
  1036.     Exclude "."
  1037.     Exclude "~*"
  1038.     Exclude ".desc"
  1039.     Exclude "README"
  1040.     Exclude "HEADER"
  1041.     HTTPEquiv "Content-Type: text/plain"
  1042.     Options " Name | Size | RelPath "
  1043. </Object>
  1044.  
  1045. # ---
  1046. #
  1047. # CGIFileIOObject
  1048. #     
  1049. #    IOObject used for communication between web browser and
  1050. #    server.
  1051. #
  1052. # ---
  1053. <Object>
  1054.     Name CGIFileIOObject
  1055.     Class PipeIOClass
  1056.     ReadTimeout -1
  1057.     WriteTimeout 10
  1058.     NoYield "Read"
  1059. </Object>
  1060.  
  1061. # ---
  1062. #
  1063. # StandardCGI
  1064. #
  1065. # Configuration for Standard <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A>
  1066. #
  1067. # ---
  1068. <Object>
  1069.     Name StandardCGI
  1070.     Class CGIClass
  1071.     
  1072.     # Specify the IO object use to communicate with the <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A> program
  1073.     FileIOObject CGIFileIOObject
  1074.  
  1075.     # Snoop IO objects can be instantiated in the IO chain with a line
  1076.     # like this. They log all IO trafic. This is useful for debugging.
  1077. #    FileIOObject SnoopIOObject IOObject="CGIFileIOObject" OutFile="cgi.dbg" 
  1078.  
  1079.     DefaultCommandLine "%p%q"
  1080.     CommandLineByExt .bat="cmd.exe /c %p%q"
  1081.     CommandLineByExt .cmd="cmd.exe /c %p%q"
  1082.     CommandLineByExt .pl="perl %p%q"
  1083.     IncludeParentsEnvironment Yes
  1084.     EnvironmentSize 8192
  1085.     
  1086.     # These are the environment variables that are sent to the
  1087.     # <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A> program
  1088.     Variable "AUTH_TYPE=$x"
  1089.     Variable "CONTENT_LENGTH=$Y"
  1090.     Variable "CONTENT_TYPE=$C"
  1091.     Variable "HTTPS=$g"
  1092.     Variable "&if($K,HTTPS_KEYSIZE=$K,)"
  1093.     Variable "&if($K,HTTPS_SECRETKEYSIZE=$G,)"
  1094.     Variable "GATEWAY_INTERFACE=CGI/1.1"
  1095.     Variable "PATH_INFO=$I"
  1096.     Variable "PATH_TRANSLATED=$Z"
  1097.     Variable "QUERY_STRING=$q"
  1098.     Variable "REMOTE_ADDR=$A"
  1099.     Variable "REMOTE_HOST=$h"
  1100.     Variable "REMOTE_IDENT=$i"
  1101.     Variable "REMOTE_USER=$u"
  1102.     Variable "REQUEST_METHOD=$m"
  1103.     Variable "SCRIPT_NAME=$z"
  1104.     Variable "SERVER_NAME=$v"
  1105.     Variable "SERVER_PORT=&if($p,$p,&if($K,443,80))"
  1106.     Variable "SERVER_PROTOCOL=$H"
  1107.     Variable "SERVER_SOFTWARE=$S"
  1108.     ExtraHeaders Yes
  1109.     ExtraHeadersPrefix "HTTP_"
  1110.     ExtraHeadersIgnore "Content-Type Content-Length"
  1111.     SendCRLF Yes
  1112. </Object>
  1113.  
  1114. # ---
  1115. #
  1116. # WinCGI
  1117. #
  1118. # Handle windows <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A>
  1119. #
  1120. # ---
  1121. <Object>
  1122.     Name WinCGI
  1123.     Class CGIClass
  1124.     FileIOObject CGIFileIOObject
  1125.     DefaultCommandLine "%p %d"
  1126.     IncludeParentsEnvironment Yes
  1127.     EnvironmentSize 8192
  1128.     Variable "AUTH_TYPE=$x"
  1129.     Variable "CONTENT_LENGTH=$Y"
  1130.     Variable "CONTENT_TYPE=$C"
  1131.     Variable "HTTPS=$g"
  1132.     Variable "&if($K,HTTPS_KEYSIZE=$K,)"
  1133.     Variable "&if($K,HTTPS_SECRETKEYSIZE=$G,)"
  1134.     Variable "GATEWAY_INTERFACE=CGI/1.1"
  1135.     Variable "PATH_INFO=$I"
  1136.     Variable "PATH_TRANSLATED=$Z"
  1137.     Variable "QUERY_STRING=$q"
  1138.     Variable "REMOTE_ADDR=$A"
  1139.     Variable "REMOTE_HOST=$h"
  1140.     Variable "REMOTE_IDENT=$i"
  1141.     Variable "REMOTE_USER=$u"
  1142.     Variable "REQUEST_METHOD=$m"
  1143.     Variable "SCRIPT_NAME=$z"
  1144.     Variable "SERVER_NAME=$v"
  1145.     Variable "SERVER_PORT=&if($p,$p,&if($K,443,80))"
  1146.     Variable "SERVER_PROTOCOL=$H"
  1147.     Variable "SERVER_SOFTWARE=$S"
  1148.     ExtraHeaders Yes
  1149.     ExtraHeadersPrefix "HTTP_"
  1150.     ExtraHeadersIgnore "Content-Type Content-Length"
  1151.  
  1152.     # Generate windows <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A> filenames by preappending the
  1153.     # process id to the unique identifier.
  1154.     DataFile "cgi-temp/$P_%u.ini"
  1155.     StdinFile "cgi-temp/$P_%u.in"
  1156.     StdoutFile "cgi-temp/$P_%u.out"
  1157.     DataBlock "\
  1158. [CGI]$M\
  1159. Request Protocol=$H$M\
  1160. Request Method=$m$M\
  1161. Physical Path=$f$M\
  1162. <A HREF="/pidocs/Objects/HTTP.html#CGI">CGI</A> Version=CGI/1.1 (Win)$M\
  1163. Content Type=$C/* short for  &dblookup(request,rfc822,Content-Type)*/$M\
  1164. Content Length=$Y/* short for &dblookup(request,rfc822,Content-Length)*/$M\
  1165. $M\
  1166. [Accept]$M\
  1167. $M\
  1168. [System]$M\
  1169. Output File=%o$M\
  1170. Content File=%i$M\
  1171. $M\
  1172. [Accept]$M\
  1173. $M\
  1174. [Extra Headers]$M\
  1175. $M\
  1176. [Form Literal]$M\
  1177. $M\
  1178. [Form External]$M\
  1179. $M\
  1180. [Form File]$M\
  1181. $M\
  1182. [Form Huge]$M\
  1183. $M\
  1184. "
  1185.     SendCRLF Yes
  1186. </Object>
  1187.  
  1188. </PRE></BODY></HTML>