home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / srev13h.zip / init_sta.a80 < prev    next >
Text File  |  2000-05-16  |  17KB  |  413 lines

  1. /*     ---------- Static, user Changeable Parameters for srefiltr.80  -------------
  2.        As of sre-http ver 1.3d, sre-http uses a seperate
  3.        file for these "static" parameters -- these values are read ONLY
  4.        when goserve/sre first start.
  5.  
  6.        In contrast, "dynamic" parameters in INITFILT.80 are monitored -- they can be
  7.        changed without restarting goserve/sre.
  8.  
  9.       Note: this file is read at GoServe/SRE startup, and then "INTERPRETed".
  10.             It MUST contain valid REXX code -- with comments between / *     * / (no
  11.             spaces between the asterisk and the slash).
  12.      
  13. Variable list:
  14.  
  15.   always_check_privs:  Flag to "check client privileges even if it's a public url"
  16.   BackupServerList: ip addresses of servers to distribute to under load
  17.   ce_gzip: enable on-the-fly GZIP content encoding
  18.   cgi_bin_pieces: Send pieces of CGI-BIN output as they become available
  19.   cgi_post_long_get: Convert long GET requests to POST requests
  20.   custom_inits: Comma delimited list of "custom initialization procedures"
  21.   default_enryption: the default encryption method
  22.   delta_encoding_enable: enable delta encoding
  23.   delta_encoding_maxsize: maximum size of delta encoding cache
  24.   digest_auth: Ask for "digest" authorization 
  25.   dir_cache_size: size of the directory-listing cache
  26.   dir_cache_duration: lifespan of entries in the directory-listing cache
  27.   delay_seconds: time delay for SRE-http to check parameter files for changes
  28.   dynssi_maxage: set "max-age" parameter for dynamic ssis
  29.   empty_path_ok: CGI-BIN control; what to do if no path_info recieved
  30.   enable_encryption: enable sre-http encryption
  31.   event_check: check for events
  32.   get_decode_options: Enable URL-decoding of options of GET requests 
  33.   hit_superuser_suppress: modify HIT_OWNER_SUPPRESS to check for SUPERUSERS
  34.   ncsa_ismap: substring(s) that signals "this is an NCSA mappable image request"
  35.   cern_ismap: substring(s) that signals "this is a CERN mappable image request"
  36.   head_to_get: tell addons that HEAD requests are GET
  37.   key_preface: optional preface for server side include keywords
  38.   logon_limit:  maximum # of attempts, per minute per client
  39.   LoadThreshold: Used with BACKUPSERVERLIST (load at which transfer occurs)
  40.   main_server: An IP address for a "main server" 
  41.   message_scramble: used by messages boxes to encode passwords and nonces
  42.   never_imagemaps: suppess check if this is an imagemap
  43.   never_publicurls: suppress checking for publicurls
  44.   no_remote_config: Suppress remote configuration
  45.   no_no_record: Suppress the !NORECORD directive
  46.   pmprintf_opt: Output type for SRE-http's audit file
  47.   pre_reply_procedure: a "last-second" hook into sre
  48.   put_no_overwrite: Allow PUT method requests to overwrite existing files
  49.   proxy_cache: Allow proxy (and sreproxy)caching
  50.   quick_interp: Shorthand for INTERPRET FILE
  51.   quick_interp_code: Shorthand for INTERPRET CODE
  52.   quick_replace: Shorthand for REPLACE
  53.   range_at_end: Check for range info at end of request string
  54.   realm_1st_priv: If need be, use first resource privilege as the realm
  55.   record_cache_lines: Size of RECORD_ALL_FILE cache
  56.   sem_maxwait: waiting time till threads check their queue
  57.   ssi_extensions: extensions for which the ssi_shtml_only parameter applies
  58.   ssi_cache_size: size of the ssi-cache
  59.   ssi_cache_duration: lifespan of entries in the ssi-cache
  60.   ssi_cache_stamp: Type of "trigger" check (used with ssi-cache)
  61.   suppress_gzip_te: Suppress on-the-fly gzip
  62.   user_logon_proc: Name of an alternate "user logon procedure"
  63.   wild_sels_ok: Use * in selectors to find best matching file
  64.  
  65.   See INITFILT.DOC for a discussion of what these do.
  66.  
  67.   Note: The essential difference between parameters here, and in INITFILT.80,
  68.         is that these are updated ONLY when GoServe is re-started.
  69.         In contrast, INITFILT.80 parameters are checked (and possibly updated)
  70.         every "delay_seconds" (default value is 15) seconds.
  71.  
  72.         The notion is that these are more fundamental paramters, which
  73.         will need modification less frequently then INITFILT.80 parameters.
  74.  
  75.                            ------------------                              */
  76.  
  77. /*BEGIN  ---  (this line is used by the EDITSREF.CMD SRE-http utility)*/
  78.  
  79. /* Set to 1 if you want to check for privileges  
  80.        (using inhouseips, owner, additional privileges, 
  81.        and authorization stuff) 
  82.       when the request string matches a public_URL 
  83.    Set to 0 to NOT check for these privs.
  84.    This may "unnecessarily slow things down", but may be
  85.    required if further privilege checks are
  86.    done by SRE-http addons */
  87. always_check_privs=1
  88.  
  89. /* This space delimited list contains ip addresses of backup servers
  90.   It's used in conjunction with LOADTHRESHOLD (it's ignored if 
  91.   loadthreshold=0 */
  92. BackupServerList = 'www2.hursley.ibm.com  '
  93.  
  94. /* Enable on-the-fly GZIP content-encoding. This can be
  95.   overridden by an CE_GZIP selector-specific advanced-option.
  96.   1=enable,0=disable */
  97. ce_gzip=0
  98.  
  99. /* Set to 1 or if you want SRE-http to send "pieces" of 
  100.    CGI-BIN output as they become available.
  101.       0-- send all the output (wait until script finishes)
  102.     1 or  2-- filerexx mode 
  103.    Note that !CGI-BIN_n (n=2,3,4, or 5) will over ride this. */
  104. cgi_bin_pieces=0
  105.  
  106. /* To  work around this environment and command line argument size limits
  107.    SRE-http can convert long GET requests into POST requests.  
  108.    To do this, set CGI_POST_LONG_GET=nnnn, where nnnn is a maxium
  109.    tolerable size (i.e.; nnnn=1000).
  110.    Note that 0 means "never convert", and 1 means "245" */
  111. cgi_Post_long_get=1000
  112.  
  113. /* A comma delimited list of custom (i.e.; user written) initialization 
  114.    procedures.  These will be called ONLY when goserve/SRE-http starts.
  115.    Each entry in this list should point to an "external REXX procedure";
  116.    you can include a (non-comma containing) argument list after the 
  117.    procedure name.
  118.    If you do NOT wish to run any custom initialization procedures, set
  119.    this to blank (or to 0) */
  120. custom_inits=0
  121.  
  122.  
  123. /* the default encryption method (used with !ENCRYPT/SELECTOR or
  124.    with SET ENCRYPT (in an advanced-options file).
  125.    Two methods are provided with sre-http:SRE_A and SRE_B. If
  126.    you set DEFAULT_ENCRYPTION='' or =0, then SRE_A is used */
  127. default_encryption='SRE_A'
  128.  
  129. /* enable support for delta-encoding 
  130.     0 = disable
  131.     1 = allow sel-specific support for delta encoding
  132.     2 = allow delta encoding for all requests 
  133.    NOTE: please read DELTA.DOC before enabling delta-encoding*/
  134. delta_encoding_enable=0 
  135.  
  136. /* size of the delta_encoding_cache, in kbytes
  137.    Note: did you create a DELTAS subdirectory (under your
  138.          TEMPDATA_DIR directory)?    */
  139. delta_encoding_maxsize=5000
  140.  
  141.  
  142. /* Set to 1 to also send a WWW-Authenticate: Digest .... 
  143.    (as well as the older WWW-Authenticate: Basic .... )
  144.    on authorization request (0=just send Basic) */
  145. digest_auth=1
  146.   
  147. /* Set the "duration" of entries (in days) for entries in the 
  148.   !DIR (directory)  cache. */
  149. dir_cache_duration=3
  150.  
  151. /* Set the maximum size (in Kbytes) of the directory-listing-cache.
  152.   This is used by the !dir facility of SRE-http */
  153. dir_cache_size=1000
  154.  
  155. /* Delay_seconds controls how frequently SRE-http 
  156.    checks input files for updates.  
  157.    Larger values mean more time between checks. */
  158. delay_seconds=15
  159.  
  160. /* set "max-age" parameter for dynamic ssis. Used to allow 
  161.    short term caching of documents with dynamic SSI's 
  162.     0 means "always revalidate immediately" */
  163. dynssi_maxage=0         
  164.  
  165. /* Empty_path_ok is a CGI-BIN option: it controls the
  166.    value of path_info (and path_translated)
  167.    when no "path information" is sent with the cgi-bin request. 
  168.      If =1, set path_info (and path_translated)='' 
  169.            (the ICS et al standard)
  170.      If =0, use / (and data_directory) (the GOHTTP standard
  171.    Note that !CGI-BIN_1 and !CGI-BIN_0 over ride this. */
  172. empty_path_ok=1
  173.   
  174.  
  175. /* Enable SRE-http encryption:
  176.   0 : disable
  177.   1 : enable for  non-addon responses
  178.   2 : enable for all responses
  179.   3 : force encryption of ALL response */
  180. enable_encryption=2
  181.  
  182. /* Check for events.
  183.    SRE-http's monitor daemon can check a set of administrator specified
  184.    events.  These events, which are specified in EVENTS.CFG, 
  185.    will be checked every EVENT_CHECK minutes.
  186.    To never check events, set EVENT_CHECK=0
  187.    To check every 15 minutes, set EVENT_CHECK=15  */
  188. event_check=0
  189.  
  190. /* Enable "url decoding" of options included in a GET request.
  191.    When a GET request contains "options" (after a ?), SRE-http
  192.    can URL-decode the options list -- converting + into spaces,
  193.    and & into &, etc. 
  194.    This list is sent to SRE-http addons.  URL decoding can save
  195.    the addon a few processing steps; but can cause troubles when
  196.    & = and other such characters may be included in the "list of options".
  197.    To enable: get_decode_options=1
  198.               get_decode_options=0 will suppress this decoding */
  199. get_decode_options=1
  200.  
  201. /* tell addons that HEAD methods are VERB methods. Some older addons
  202.  don't recognize HEADs (note that on HEAD requests goserve never sends 
  203.  the body of a response, even if one is produced.
  204.  To enable this,  set head_to_get=1 */
  205. head_to_get=0
  206.  
  207. /* Controls whether HIT_OWNER_SUPPRESS also applies to SUPERUSERS.
  208.    If 1, then it does.  If 0, then it does not.
  209.    Note: if HIT_OWNER_SUPPRESS is not enabled, then 
  210.          hit_superuser_suppress is ignored */
  211. hit_superuser_suppress=1
  212.  
  213. /* Indicators for "mappable image" requests: 
  214.    NSCA  style .MAP files*/
  215. ncsa_ismap='mapimage/ mapnsca/ cgi-bin/mapimage '
  216.  
  217. /* Indicators for "mappable image" requests: 
  218.     CERN style .MAP files*/
  219. cern_ismap='mapcern/ cgi-bin/htimage/'
  220.  
  221. /* If non-zero, modifies the REPLACE keywords  
  222.    Note: key_preface="#" is NOT allowed! */
  223. key_preface=0    
  224.  
  225.  
  226. /*  Allow this many simultaneous connections before 
  227.     attempting load balancing.
  228.     It's used in conjunction with BACKUPSERVERLIST 
  229.     Note: 0 means "do not perform load balancing
  230.           To load balance ALL requests (say, with a 
  231.           custom load balancer addon, set loadthreshold=0.5 */
  232. LoadThreshold =0
  233.  
  234. /* Sets the maximum number of unsuccessful "logon" attempts,
  235.    per minute per ip address.  
  236.    Set to 0 for "unlimited" attempts.
  237.    Note that a value of 1 may cause problems. */
  238. logon_limit=0
  239.  
  240. /* The numeric IP address of a "main server".  Certain HEAD requests from 
  241.    this main server are expedited (i.e.;!PING). This is currently used to 
  242.    implement dynamic load balancing. 
  243.     Set MAIN_SERVER=0 to suppress, 
  244.     set MAIN_SERVER='' to use "own IP address" */
  245. main_server=' '
  246.  
  247.  
  248. /* This is used to "encrypt" domessage passwords, and when creating
  249. nonces.  change it for a wee bit extra security */
  250. message_scramble=12415
  251.  
  252. /* Set to 1 to suppress SRE-http from checking if a request is an imagemap
  253.    request. Use this ONLY IF YOU NEVER USE SERVER SIDE IMAGEMAPS
  254.    (using it will save a fraction of a second on some requests) */
  255. never_imagemaps=0
  256.  
  257. /* Set to 1 to suppress SRE-http from checking  for public_urls;
  258.    use it only if you never use public_urls
  259.    (setting never_publicurls=1 will save a fraction of a second on some requests) */
  260. never_publicurls=0
  261.  
  262. /* If you want to suppress the use of the !NORECORD directive,
  263.    set NO_NO_RECORD=1 */
  264. no_no_record=0
  265.  
  266. /* This enables/disables SRE-http's remote configurator
  267.   (using the various HTML FORMS).
  268.    0 = Allow remote configuration (for clients with a
  269.        SUPERUSER privilege)
  270.    1 = Allow configuration ONLY form the server's IP address
  271.    2 = Do NOT allow remote configuration
  272.  Note: option 0 can be overridden in the various *CFG.CMD files */
  273. NO_REMOTE_CONFIG=0
  274.  
  275.  
  276. /* Type of SRE-http auditing:
  277.   pmprintf_OPT= 1 : Use PMPRINTF window
  278.                     2 : PMPRINTF window and srehttp.log file
  279.                     3:  srehttp.log only
  280.   Note: use VERBOSE (in INITFILT.80) to control the 
  281.         extent of "SRE-http auditing" */
  282. pmprintf_opt=1
  283.  
  284.  
  285. /* Name of a procedure to call just before sending response to a client.
  286.    This procdedure can be used to modify the response.
  287.    It should equal 0 (to NOT call a "pre-reply" procedure), or
  288.    it should be a fully qualfied filename (of an external rexx procedure) */
  289. pre_reply_procedure=0
  290.  
  291. /* Allow PUT method requests to overwrite pre-existing files 
  292.    (on your server).
  293.    Set to 1 to NOT ALLOW overwriting, 0 to allow */
  294. put_no_overwrite=1
  295.  
  296. /* Allow proxies (and/or sreproxy) to cache the url
  297.    0=disallow 
  298.    1= allow
  299.    2= allow, but force revalidation by all caches
  300.    3= allow, but force revaliation by shared (proxy) caches
  301. for all values but 0, sreproxy will cache (given that sreproxy is being used)*/
  302. proxy_cache=1
  303.  
  304. /* Short hand character to use instead of INTERPRET FILE 
  305.   in server side include keyphrases.  
  306.    (do NOT use comma character)
  307.    For example,        use  <!-- $ DIRINFO.RXX -->
  308.                 instead of  <!-- INTERPRET FILE DIRINFO.RXX -- > */
  309. quick_interp='$'
  310.  
  311. /* Short hand character to use instead of INTERPRET CODE 
  312.    in server side include keyphrases.  
  313.    (do NOT use comma character)
  314.    For example,  use  <!-- # t=time() ; say " Time is " t -->
  315.                  use  <!-- INTERPRET CODE t=time() ; say " Time is " t --> */
  316. quick_interp_Code='#'
  317.  
  318. /* Short hand character to use instead of REPLACE 
  319.    in server side include keyphrases.  
  320.    (do NOT use comma character)
  321.    For example,        use  <!-- # PHRASE1 hello+kids -->
  322.                 instead of  <!-- REPLACE PHRASE1 HELLO+KIDS -- > */
  323. quick_replace='%'
  324.  
  325.  
  326. /* Check for range information at the end of a request
  327.    string (after a ;). This supplements the !RANGE
  328.    syntax.
  329.       0 = Do NOT look for this info 
  330.       1 = Do look
  331. */
  332. range_at_end=0
  333.  
  334. /* If the allow_access file does not specify a realm, 
  335.    then use the first resoruce privilege as the realm. 
  336.    1=Yes, 0=no; if 0, then use the default_realm */
  337. realm_1st_priv=0
  338.  
  339. /* This sets the size (in entries_ of the "recordall_file" 
  340.   cache. If you do NOT want to cache the recordall_File, 
  341.   set this to 0
  342.   Enabling caching (by using non-0 values0 speeds up 
  343.   throughput, but risks minor errors in counts) */
  344. record_cache_lines=0
  345.  
  346.  
  347. /* Controls "wait on queue" maximum time delay (in milli seconds) */
  348. sem_maxwait=15000
  349.  
  350. /* the list of "SSI capable" extensions (used if SSI_SHTML_ONLY='YES') */
  351. ssi_extensions=' SHT SHTML HTML-SSI HTM-SSI '
  352.  
  353. /* Set the size of the server-side-include (SSI) 
  354.    cache, in kilobytes.
  355.   Once cached files (saved to disk) exceed this amount,
  356.   older entries will be deleted.
  357.   A value of 0 means "do NOT cache".
  358.   Example: 1000 means  1M. */
  359. ssi_cache_size=5000
  360.  
  361. /* Set the "lifespan" of ssi-cache entries, in days 
  362.   (fractional values are allowed).  SSI-cache entries 
  363.    older then this will be deleted */
  364. ssi_cache_duration=1
  365.  
  366. /* Set the "type" of trigger checking of ssi-cache
  367.    entries. You can the time (TIME), the date (DATE),
  368.     the time and date (TIMEDATE), the size (SIZE),
  369.     or all 3 (ALL). */
  370. ssi_CACHE_stamp='ALL'
  371.  
  372.  
  373. /* Suppress on-the-fly GZIPping of files. 
  374.    If =0, then a TE: gzip  request header will cause SRE-http to gzip (and chunk)
  375.            responses 
  376.    If =1, then a TE: gzip request header is ignored */
  377. suppress_gzip_te=0
  378.  
  379. /* Name of an external procedure to use instead of 
  380.    SRE-http's built-in "username/password" lookup procedure. 
  381.    Leave blank to use SRE-http's built in logon procedure.
  382.    Note: the possibly host specific value of the
  383.          user_logon_enable parameter (in INITFILT.80)
  384.          can override user_logon_proc */
  385. user_logon_proc=' '
  386.  
  387. /* Flag to tell SRE to use * as wildcards in the action
  388.    portion of GET requests.
  389.    If =1, then use best wildcard match in directory
  390.    If =11, then display one match, or dir of multiple
  391.             matches in directory
  392.    If =2, then use best in directory and subdirectories
  393.    If =22, then display one match, or dir of multiple 
  394.            matches in directory and subdirectories
  395.    If =0, then DO not search (* in sel will cause a
  396.           notfound response)
  397.    CAUTION: use of this MIGHT subvert access controls */
  398. wild_sels_ok=11
  399.  
  400.  
  401. /* pre initialization value of verbose == used when sre starts */
  402. verbose=1
  403.  
  404.  
  405. /*INIT_STA_VERSION_xxx is used by the INSTALL program (to check for changes). 
  406.  You should not change it's value */
  407.  
  408. INIT_STA_version_13h=5
  409.  
  410. /*END  ---  (this line is used by the EDITSREF.CMD utility)*/
  411.  
  412.  
  413.