regina/README_SAFE

   1 This file explains the features of Regina that are disabled when Regina
   2 is run in "restricted" mode.
   3
   4 Restricted mode is used in situations where you need to guarantee that
   5 the author of a Rexx program is unable to affect the user's environment.
   6 Situations where a restricted mode is applicable include, using Regina as
   7 a database procedural language, or as language plugin for a Web browser.
   8
   9 Features of Regina that are disabled in restricted mode are:
  10   - LINEOUT, CHAROUT BIFs
  11   - POPEN BIF
  12   - "OPEN WRITE", "OPEN BOTH" subcommands of STREAM BIF
  13   - The "built-in" environments eg. SYSTEM, CMD or PATH of ADDRESS command
  14   - Setting the value of a variable in the external environment with
  15     VALUE BIF.
  16   - Calling external functions
  17   - RXFUNCADD BIF
  18
  19 To run Regina in restricted mode, you can start the Regina interpreter
  20 from the command line with the '-r' switch, or when using the Rexx SAA API,
  21 "ORing", RESTRICTED_REXX to the CallType parameter of RexxStart() function.
  22